{"_id":"@alchemystai/pi","name":"@alchemystai/pi","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@alchemystai/pi","version":"0.1.0","description":"Pi extension for AlchemystAI Context Layer — persistent, retrievable memory for coding sessions","type":"module","scripts":{"typecheck":"tsc --noEmit"},"pi":{"extensions":["./src/index.ts"],"skills":["./skills"]},"keywords":["pi-package","pi-extension","alchemyst","context","memory","ai"],"license":"MIT","devDependencies":{"@earendil-works/pi-ai":"^0.80.3","@earendil-works/pi-coding-agent":"^0.80.3","typebox":"^1.3.3","typescript":"^6.0.3"},"_id":"@alchemystai/pi@0.1.0","gitHead":"db6d10e54614a950b7241f7b5eb860f3ecd9e883","_nodeVersion":"22.23.1","_npmVersion":"10.9.8","dist":{"integrity":"sha512-1nHuH6TXDYR5jQp8/T3xiHp9GU5Xt+VKwrr9w71mGvXCrro7x1UZi6rY5yhfmr+gmbpxVgMRPQI8qRBbWbzOAg==","shasum":"d7a567895d9ef56381c8f0d18965feefe19bb683","tarball":"https://registry.npmjs.org/@alchemystai/pi/-/pi-0.1.0.tgz","fileCount":14,"unpackedSize":39068,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDt6ly1pquM+kUvo3zHeGQ602st2JU+W7/IbRczFVas/QIgOFk1JoUHVWCzezxhKOiMllVXyce0dZBlwDg+ENrnIkQ="}]},"_npmUser":{"name":"anuran-roy","email":"anuranroy02@gmail.com"},"directories":{},"maintainers":[{"name":"anuran-roy","email":"anuranroy02@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/pi_0.1.0_1783186109532_0.148539532978202"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-04T17:28:29.387Z","0.1.0":"2026-07-04T17:28:29.688Z","modified":"2026-07-04T17:28:29.919Z"},"maintainers":[{"name":"anuran-roy","email":"anuranroy02@gmail.com"}],"description":"Pi extension for AlchemystAI Context Layer — persistent, retrievable memory for coding sessions","keywords":["pi-package","pi-extension","alchemyst","context","memory","ai"],"license":"MIT","readme":"# @alchemystai/pi\n\nPi extension for AlchemystAI Context Layer — persistent, retrievable memory for coding sessions.\n\n## Installation\n\n### Via git (recommended)\n\n```bash\npi install git:github.com/AlchemystAI/pi-alchemyst\n```\n\n### Via npm (if published)\n\n```bash\npi install npm:@alchemystai/pi\n```\n\n### Local installation for testing\n\n```bash\n# Clone the repository\ngit clone https://github.com/AlchemystAI/pi-alchemyst ~/.pi/agent/extensions/pi-alchemyst\n```\n\n## Setup\n\n1. Get your API key from [AlchemystAI Platform](https://platform.getalchemystai.com)\n2. Configure the extension in Pi:\n\n```\nUse the alchemyst_configure tool to set your API key:\n- apiKey: \"your-jwt-token-here\"\n- defaultScope: \"internal\" or \"external\" (optional)\n- groupName: [\"project-name\"] (optional, for categorizing context)\n```\n\nThis saves your configuration to `~/.config/pi-alchemyst/config.json`. It persists across sessions — you only need to do this once.\n\nYou can also pre-configure by creating the file manually:\n\n```json\n{\n  \"apiKey\": \"your-jwt-bearer-token\",\n  \"groupName\": [\"pi\", \"my-project\"]\n}\n```\n\n## Available Tools\n\n| Tool | Description |\n|------|-------------|\n| `alchemyst_context_search` | Search stored context for decisions, docs, and reference material |\n| `alchemyst_context_add` | Save context to Alchemyst for future retrieval |\n| `alchemyst_context_ask` | Ask questions grounded in your stored context |\n| `alchemyst_memory_add` | Persist conversation turns to Alchemyst memory |\n| `alchemyst_memory_update` | Update saved memory entries |\n| `alchemyst_configure` | Configure the Alchemyst API key and settings |\n\n## Context Arithmetic Best Practices\n\nAlchemyst uses context arithmetic to filter and rank context. Use hierarchical groupName tags:\n\n```\nLayer 1: Domain (e.g., \"engineering\", \"docs\")\nLayer 2: Project/Categories (e.g., \"api-v2\", \"auth\")\nLayer 3: Specifics (e.g., \"decisions\", \"patterns\")\n```\n\nExample: `groupName: [\"engineering\", \"backend\", \"auth\"]`\n\n## Features\n\n- **Persistent Memory**: Save important decisions and recall them later\n- **Context Search**: Find relevant docs across all your projects\n- **Hierarchical Tagging**: Use groupName tags for precise context filtering\n- **Session Memory**: Persist conversation history across sessions\n- **Security Guards**: Automatically blocks secrets and sensitive data\n\n## Environment Variables\n\n- `ALCHEMYST_API_KEY`: Your Alchemyst API JWT token\n- `ALCHEMYST_BASE_URL`: Override API endpoint (optional)\n- `ALCHEMYST_DEFAULT_SCOPE`: \"internal\" or \"external\" (optional)\n- `ALCHEMYST_GROUP_NAME`: Comma-separated tags (optional)\n\nEnvironment variables take priority over saved values — useful for per-session overrides.\n\n## License\n\nMIT","readmeFilename":"README.md","_rev":"1-290a5263b928779ce0166a6f2906823b"}