Skip to content
This repository was archived by the owner on Oct 21, 2026. It is now read-only.
autohandaiPublic archive

About

Archived adapter. Native ACP is built into Autohand Code CLI: autohand --acp or autohand --mode acp. See autohandai/code-cli.

Resources

Stars

12 stars

Watchers

0 watching

Forks

Repository files navigation

Autohand ACP adapter — archived

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 acp

For installation, updates, issues, and contributions, go to autohandai/code-cli. See the ACP integration guide for editor configuration.

Migrate an existing editor configuration

  1. Install or update Autohand Code CLI to v0.9.8 or newer.
  2. Run autohand --setup in a terminal if you have not configured authentication and a model. Existing CLI configuration stays in ~/.autohand/.
  3. Replace the autohand-acp executable (or npx @autohandai/autohand-acp) with the absolute path to autohand, and set its arguments to ["--acp"] or ["--mode", "acp"].
  4. 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.

ACP Registry users

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.

Legacy adapter

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.

License

Apache-2.0.

About

Archived adapter. Native ACP is built into Autohand Code CLI: autohand --acp or autohand --mode acp. See autohandai/code-cli.

Resources

Stars

12 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages