ACP support now lives in Autohand Code CLI. This repository is retired because the CLI includes its own native Agent Client Protocol server. Use Autohand Code v0.9.8 or a newer release.
autohand --acp
# Equivalent:
autohand --mode acpFor installation, updates, issues, and contributions, go to autohandai/code-cli. See the ACP integration guide for editor configuration.
- Install or update Autohand Code CLI to v0.9.8 or newer.
- Run
autohand --setupin a terminal if you have not configured authentication and a model. Existing CLI configuration stays in~/.autohand/. - Replace the
autohand-acpexecutable (ornpx @autohandai/autohand-acp) with the absolute path toautohand, and set its arguments to["--acp"]or["--mode", "acp"]. - Start a new agent connection in your editor.
The process launch contract for any client that supports local ACP over stdio is:
{
"command": "/absolute/path/to/autohand",
"args": ["--acp"],
"env": {}
}On Windows, use the path to autohand.exe. Client configuration field names may differ; consult the editor-specific examples.
For example, a custom Zed agent entry is:
{
"agent_servers": {
"Autohand Code": {
"type": "custom",
"command": "/absolute/path/to/autohand",
"args": ["--acp"],
"env": {}
}
}
}Remove adapter-only settings such as AUTOHAND_PERMISSION_MODE. The native CLI uses its normal configuration and exposes permission modes through ACP. Keep credentials in your CLI configuration rather than copying them into editor settings.
The registry migration keeps the existing autohand ID and Autohand Code display name, and changes the entry from the adapter package to the native v0.9.8 CLI archives for macOS, Linux, and Windows. Once registry PR #702 is merged and published, refresh or update the existing agent in your editor. Until then, use the manual configuration above.
The original registry integration was added in agentclientprotocol/registry#14.
Existing adapter releases and source remain available for historical use. They will receive no further updates here. New installations should use the native CLI; report issues in autohandai/code-cli.
ACP uses newline-delimited JSON over stdin/stdout. Native ACP mode reserves stdout for protocol messages and writes diagnostics to stderr. Clients that support terminal authentication can launch autohand --setup separately from the ACP connection.