零栈AI工作流

Installation

In order to install zerostack, you must have Cargo and git installed. Then, run:

```bash

Quick start

```bash

Loop usage

/loop Implement the user authentication system
/loop stop
/loop status

• /loop <prompt> — Start a loop with the given prompt
• /loop stop — Stop the active loop
• /loop status — Show current loop state

Each iteration includes the original task, the evolving LOOP_PLAN.md, a summary of the previous iteration, and any validation output. Non-slash input is blocked while a loop is active.

Git worktree usage

The worktrees integrations offers 3 slash commands:

Example workflow for git worktrees

1. Create — /worktree feature-x creates a new branch and worktree directory and moves you there.
2. Work — Use zerostack normally; changes stay on the feature branch.
3. Merge — /wt-merge tells the agent to merge the branch, push, clean up, and return to the main repo.
4. Exit — /wt-exit immediately returns to the main repo without merging.

ACP usage

```bash

Optional: sandbox mode

Install bubblewrap for --sandbox, which runs every bash command inside an isolated environment to protect your system from accidental or malicious damage:

```bash

Configuration

See docs/CONFIG.md for config file location, accepted keys, provider aliases, permission rules, and MCP server configuration.

You can run /prompt autoconfig in order to use a specialized agent that allows to navigate the documentation and customize your zerostack setup.

ACP config

In ~/.local/share/zerostack/config.json:

{
  "acp_servers": {
    "my-editor": {
      "host": "127.0.0.1",
      "port": 7243
    }
  }
}

ACP mode requires setting up an LLM provider (the standard --provider, --model, and API key env vars apply). Without it, zerostack cannot process prompts.

Set your API key (OpenRouter is default)

export OPENROUTER_API_KEY="[api_key]"

With ACP (Agent Communication Protocol) support for editor integration

cargo install zerostack --features acp

Git worktrees integration

zerostack provides a branch-per-task workflow using git worktrees. You can create, work in, merge, and exit worktrees entirely from the chat UI.

NOTE The git worktrees integration is an experimental feature.

Side questions (`/btw`)

/btw <message> asks a quick "by the way" question in parallel with the main agent, without interrupting it. Like /queue, it works even while the agent is busy. It forks the current context (including a trace of the agent's in-flight turn, when one is running) and answers using four read-only tools (read, grep, find_files, list_dir); it cannot write files or run commands. It then prints the reply inline. Nothing is written to conversation history, and its token usage is tracked separately in the status bar as btw:…. Press Ctrl-C to cancel an in-flight /btw without disturbing the main agent.

You can point a question at a specific file with @: pick /btw from the command menu, then type @ to open the file picker (for example /btw then @src/main.rs then "how does this work?"), and /btw reads the file you reference.