{"versions":{"0.2.1":{"name":"@autohandai/autohand-acp","version":"0.2.1","description":"ACP adapter for the Autohand CLI","type":"module","bin":{"autohand-acp":"dist/index.js"},"main":"dist/index.js","types":"dist/index.d.ts","scripts":{"build":"tsc","start":"node dist/index.js","dev":"npm run build && npm run start","lint":"eslint src","test:e2e":"node --test tests/e2e/*.test.mjs","test":"npm run build && npm run test:e2e","prepublishOnly":"npm run build"},"keywords":["autohand","acp","agent","cli","zed"],"author":{"name":"Autohand AI"},"publishConfig":{"access":"public"},"license":"Apache-2.0","repository":{"type":"git","url":"git+https://github.com/autohandai/autohand-acp.git"},"bugs":{"url":"https://github.com/autohandai/autohand-acp/issues"},"homepage":"https://github.com/autohandai/autohand-acp#readme","engines":{"node":">=18.17.0"},"dependencies":{"@agentclientprotocol/sdk":"0.12.0"},"devDependencies":{"@types/node":"^24.10.0","@typescript-eslint/eslint-plugin":"^8.48.1","@typescript-eslint/parser":"^8.48.1","eslint":"^9.39.1","typescript":"^5.9.3"},"_id":"@autohandai/autohand-acp@0.2.1","gitHead":"ad2efed4183b26778cbf0494ece87e46f5548126","_nodeVersion":"24.3.0","_npmVersion":"11.4.2","dist":{"integrity":"sha512-PokurjUKOdoCS6NJXCoDg5Ze+5Cwvn/RG5+6gzeEfZ/0UtmpFDOFoEdYGGvg/1HLX/oWWuY3K0xoPJFYWBpuVA==","shasum":"d3a40713a8be50da9d9070e21d0729377b935c71","tarball":"http://123.232.10.234:8212/nexus/content/groups/npm-public/@autohandai/autohand-acp/-/autohand-acp-0.2.1.tgz","fileCount":24,"unpackedSize":298878,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQC+emzYaX3d7azymZGBPeZfMhuJH9f5q1sX6VuuFob9qAIhANcAMxVCl/JGUmlw8dFelvB+2MOK5nfdd+XihOHkOrFk"}],"size":60693},"_npmUser":{"name":"anonymous","email":"igor@autohand.ai"},"directories":{},"maintainers":[{"name":"anonymous","email":"igor@autohand.ai"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/autohand-acp_0.2.1_1769655476700_0.8073466466948238"},"_hasShrinkwrap":false,"_cnpmcore_publish_time":"2026-01-29T02:57:56.846Z","publish_time":1769655476846,"_source_registry_name":"default","contributors":[]}},"dist-tags":{"latest":"0.2.1"},"name":"@autohandai/autohand-acp","time":{"created":"2026-02-05T01:53:00.135Z","modified":"2026-02-05T01:53:00.852Z","0.2.1":"2026-01-29T02:57:56.846Z"},"readme":"# Autohand CLI for Zed\n\nUse [Autohand CLI](https://github.com/autohandai/code-cli) from [Zed](https://zed.dev) and other [ACP-compatible](https://agentclientprotocol.com) editors!\n\n## Features\n\n- **File Operations**: Read, write, search, and modify files\n- **Terminal Commands**: Execute shell commands with output streaming\n- **Session Management**: Resume previous sessions, fork conversations\n- **Permission Controls**: External (Zed UI), auto-approve, or restricted modes\n- **Dynamic Titles**: Auto-generated session names from your first message\n- **Image Support**: Paste screenshots for visual context\n- **Slash Commands**: `/help`, `/new`, `/model`, `/mode`, `/resume`, `/threads`, `/status`, and more\n- **TODO/Planning**: Visual task tracking in Zed's UI\n- **MCP Integration**: Connect to HTTP/SSE MCP servers\n\nLearn more about the [Agent Client Protocol](https://agentclientprotocol.com/).\n\n## Installation\n\n### Option 1: Zed Extension (Recommended)\n\nOnce published to the Zed Extension Registry:\n\n1. Open Zed\n2. Go to **Extensions** (`Cmd+Shift+X`)\n3. Search for \"Autohand CLI\"\n4. Click **Install**\n5. Open Agent Panel and select \"Autohand CLI\" from the `+` menu\n\n### Option 2: Manual Settings\n\nAdd to your Zed settings (`~/.config/zed/settings.json`):\n\n```json\n{\n  \"agent_servers\": {\n    \"Autohand CLI\": {\n      \"command\": \"npx\",\n      \"args\": [\"@autohandai/autohand-acp\"],\n      \"env\": {\n        \"AUTOHAND_PERMISSION_MODE\": \"external\"\n      }\n    }\n  }\n}\n```\n\n### Option 3: npm Global Install\n\n```bash\nnpm install -g @autohandai/autohand-acp\n```\n\nThen add to Zed settings:\n\n```json\n{\n  \"agent_servers\": {\n    \"Autohand CLI\": {\n      \"command\": \"autohand-acp\",\n      \"env\": {\n        \"AUTOHAND_PERMISSION_MODE\": \"external\"\n      }\n    }\n  }\n}\n```\n\n### Other ACP Clients\n\nThis adapter works with any ACP-compatible client. [Submit a PR](https://github.com/autohandai/autohand-acp/pulls) to add documentation for your editor!\n\n## Requirements\n\n- Node.js >= 18.17\n- `autohand` CLI installed and configured (`~/.autohand/config.json`)\n\n## Configuration\n\nEnvironment variables control how the adapter launches Autohand:\n\n| Variable | Description | Default |\n|----------|-------------|---------|\n| `AUTOHAND_CMD` | Path or command name for Autohand | `autohand` |\n| `AUTOHAND_CONFIG` | Path to config file | `~/.autohand/config.json` |\n| `AUTOHAND_MODEL` | Override the model | - |\n| `AUTOHAND_PERMISSION_MODE` | `auto`, `external`, `restricted`, `unrestricted`, `ask` | `auto` |\n| `AUTOHAND_DRY_RUN` | Set to `1` for dry-run mode | - |\n| `AUTOHAND_AUTO_COMMIT` | Set to `1` to auto-commit changes | - |\n| `AUTOHAND_AVAILABLE_MODELS` | Comma-separated model IDs | - |\n| `AUTOHAND_INCLUDE_HISTORY` | Set to `1` to include prior turns | - |\n\n### Permission Modes\n\n- **auto**: Auto-confirm risky actions (`--yes`)\n- **external**: Forward permission requests to Zed via ACP (recommended for interactive use)\n- **restricted**: Deny all dangerous operations automatically\n- **unrestricted**: Run without any approval prompts (use with caution)\n- **ask**: Run without flags (may hang if prompts appear)\n\n## File Mentions\n\nFile mentions work automatically in Zed. When you reference a file using `@filename`:\n\n1. The adapter reads the file content\n2. Embeds it in the prompt sent to Autohand CLI\n3. Autohand can then analyze or modify the file\n\nThis enables context-aware assistance without manually copying file contents.\n\n## External Permission Mode\n\nWhen `AUTOHAND_PERMISSION_MODE=external`, the adapter starts a local HTTP server that Autohand CLI calls to request permissions:\n\n1. Adapter starts permission server on localhost\n2. Passes `AUTOHAND_PERMISSION_CALLBACK_URL` to Autohand CLI\n3. Autohand CLI calls the URL when it needs permission\n4. Adapter forwards to Zed via ACP `requestPermission`\n5. User sees Allow/Reject buttons in Zed\n6. Decision is returned to Autohand CLI\n\nThis requires Autohand CLI v0.6+ with external callback support.\n\n## Slash Commands\n\n| Command | Description |\n|---------|-------------|\n| `/help` | Show available commands |\n| `/new` | Start a new conversation |\n| `/model [name]` | Select or change model |\n| `/mode [name]` | Select mode (default/ask/code) |\n| `/resume [id]` | Resume a previous session |\n| `/threads` | List and switch between sessions |\n| `/sessions` | List recent sessions |\n| `/session` | Show current session info |\n| `/status` | Show Autohand status |\n| `/init` | Create AGENTS.md file |\n| `/undo` | Undo last file change |\n\n## Development\n\n```bash\nnpm install\nnpm run build\nnpm run test\nnpm run lint\n```\n\n### Local Testing\n\n```bash\n# Build local distribution\n./scripts/build-local.sh\n\n# Start local server (in separate terminal)\ncd dist-local && python3 -m http.server 8765\n\n# Copy dev config and install in Zed\ncp extension.dev.toml extension.toml\n# Then in Zed: \"zed: install dev extension\" -> select this folder\n```\n\n## Publishing\n\n### One-Command Release\n\n```bash\n./scripts/release.sh patch   # 0.1.1 -> 0.1.2\n./scripts/release.sh minor   # 0.1.1 -> 0.2.0\n./scripts/release.sh major   # 0.1.1 -> 1.0.0\n./scripts/release.sh 0.2.5   # Set specific version\n```\n\nThis script will:\n1. ✅ Bump version in `package.json` and `extension.toml`\n2. ✅ Run tests\n3. ✅ Commit and tag\n4. ✅ Push to GitHub (triggers CI build)\n5. ✅ Guide you through Zed registry submission\n\n## License\n\nApache-2.0","users":{}}