zai-org / zai-org/feedback

ACP (Agent Client Protocol) support for ZCode

Open
#286 2 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

priority: P2
Dominant language
No language data
Stars
22
Forks
1
PR merge metrics
No merged PRs in 30d

Description

ZCode is a great harness, but it can currently only be driven through the desktop app or the undocumented zcode app-server protocol. Orchestration tools and editors (Zed, Neovim, JetBrains, agent frameworks) standardize on the Agent Client Protocol — Claude Code, Codex, Gemini CLI, Cursor, OpenCode, and GitHub Copilot all ship ACP implementations, and it's the reason they can be composed programmatically.

Today, programmatic ZCode use is blocked by:

  1. No ACP surface in the CLI.
  2. The app-server protocol being undocumented, with version skew between the front-end and the agent bundle.
  3. OAuth credentials being device-encrypted, so headless/CI/sandbox runs cannot reuse a desktop login (an explicit API-key provider config is required).

Request: an officially supported ACP mode for ZCode (even experimental, e.g. zcode --acp), registered in the ACP registry. Community interest exists — third parties have already built GLM ACP agents against the Coding Plan endpoint to fill this gap. Happy to test pre-releases.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reviewing the CLI entry points for the undocumented zcode app-server protocol and the existing OAuth credential handling. Compare the required ACP surface with the ACP registry, including headless API-key configuration and front-end/agent-bundle versioning. Done means an officially supported, testable ACP mode such as zcode --acp is available for orchestration tools.

Written by the indexing model from the issue text.

Assessment

Domain
api, authentication, cli
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Active
Clarity
Needs clarification
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.