Keep an eye on your AI coding agents.
When several Agents work on one project, you soon lose track of who is doing what, what is blocked and who is waiting for you. a-stack gives your Agents a shared Task graph and a message thread for each Task. You watch it all live in your browser, and an Agent that needs a decision asks you there.
Reports, Task mail and answered questions stay when an Agent compacts, crashes or hits its limit, so a new Agent can pick up where the last one stopped.
Works with Claude Code, Codex, Pi and OpenCode (with hooks), Herdr (optional, not on Windows) and any agent with a shell, such as Copilot CLI, Cursor CLI or Gemini CLI. Runs on Linux, macOS and Windows.
- You, or your coding agent, create a Session for the team in your project folder.
- The Agents register themselves in the Session. One of them becomes the Orchestrator.
- The Orchestrator divides the work into Tasks, assigns Agents to them and sets which Tasks depend on other Tasks.
- The Agents update their Tasks, write reports and send Task mail to the other Agents on the same Task.
- When an Agent needs your input, it marks its Task as Needs you, with a question.
- You follow the work in a browser view. It is read-only, except that you can answer a Needs you question there.
The Agents use the a-stack command line for all of this. a-stack is one binary with one SQLite database. It keeps all data on your computer, listens only on 127.0.0.1 and needs no account. You can opt into HTTPS access over Tailscale. View links work once, and releases are signed. Windows support is new and not yet tested on a real Windows machine.
If your Agents run in Herdr, a-stack can also tell an Agent to check its mail when another Agent mentions it. This is optional.
The view has three tabs:
- Now opens first. Its columns show the Tasks that need you, the Tasks in progress, the Tasks waiting for other Tasks and the Tasks that finished recently. A list beside them shows the latest changes.
- Graph shows which Task waits for which. Finished Tasks shrink to one line, so the open work stands out. Zoomed out, cards become colored blocks, and a minimap shows where you are.
- Agents shows a card per Agent, the most urgent first, with its open Tasks and its done Tasks folded away.
Select a Task to see its report, its dependencies and its Task mail. The view reads the mail but cannot send it or change anything.
Short clips in the browser view guide show the graph, the archive and the Agents tab.
Old work is archived so that it does not clutter the graph. a-stack archives a finished Task when all the Tasks that depend on it are finished too, or one day after it finished. You or the Orchestrator can also archive a Task with a-stack task archive. The Archived button shows archived Tasks again.
curl -fsSL https://github.com/mzmzeee/a-stack/releases/latest/download/install.sh | shThe script works on Linux and macOS, on amd64 and arm64. It installs the a-stack binary in ~/.local/bin. It checks the download against the release checksums before it installs. For other versions, other folders, a manual download, go install (it needs a C compiler) or a build from source, see Install.
On Windows, run this in PowerShell instead. It installs a-stack.exe in %LOCALAPPDATA%\Programs\a-stack, adds that folder to your user PATH and checks the download against the release checksums. Windows support is new; see On Windows for what differs and what is not yet tried on a real Windows machine.
irm https://github.com/mzmzeee/a-stack/releases/latest/download/install.ps1 | iexOr use a package manager. With Homebrew, on macOS or Linux:
brew install mzmzeee/tap/a-stackWith Scoop, on Windows:
scoop bucket add mzmzeee https://github.com/mzmzeee/scoop-bucket
scoop install mzmzeee/a-stackTo update, run a-stack update; it refreshes unchanged skill and hook files, restarts a running installed service and checks its version. If you installed with Homebrew or Scoop, update with brew upgrade or scoop update a-stack instead. See Update.
To start a-stack at login and restart it after a crash, run a-stack service install. It uses systemd on Linux, launchd on macOS and Task Scheduler on Windows. See Start a-stack automatically.
For Tab completion, run a-stack completion install.
Teach your coding agents to use a-stack. You do this once:
a-stack skill installThen start your coding agent in your project folder and ask it to use a-stack as the Orchestrator, with your goal. For example: "Use a-stack and be the Orchestrator. Goal: add OAuth login." The agent makes a Session for the folder, plans the Tasks and registers the other Agents. It starts them itself, or gives you a short brief to paste into each one. If no a-stack service runs, the agent runs a-stack service install and tells you.
To watch the team, run a-stack in the project folder:
cd ~/code/my-project
a-stack # open the Session of this folder in your browser
a-stack -r # pick another SessionIf no service runs, a-stack starts one in this terminal. It stops when you press Ctrl-C or close the terminal. To keep it running, run a-stack service install.
To brief the coding agent yourself, run a-stack new --orchestrator 01-orchestrator in the project folder. It makes the Session, registers and appoints the Orchestrator, opens the view and prints a brief to paste into your coding agent, with the command that installs its hooks. See Hand your Session to an Orchestrator. To try a whole team on throwaway state first, follow Getting started.
- Getting started: set up a team of three Agents and take one Task from start to finish.
- Workspaces, Sessions and Agents: register Agents, recover credentials, close and reopen Sessions.
- Tasks and the Task graph: create and assign Tasks, report progress, ask questions, add dependencies.
- Task mail: send and read messages, mention Agents, send urgent mail and request acknowledgements.
- Browser view: open the view and read what it shows.
- Watch from the terminal:
a-stack status,a-stack watchanda-stack statuslineshow what needs you, with a bell, opt-in desktop notices and a Claude Code status line. - Agent tools over MCP:
a-stack mcpexposes one Agent's Task and mail tools to Claude Code, Codex, Pi and other MCP clients. - Agent hooks:
a-stack hook installreminds Claude Code, Codex, Pi and OpenCode agents of their Tasks after a compaction, reports their runtime state, keeps them from stopping without a report and tells them about new Task mail. - Mention notices: set up hook-only or Herdr pane notices, understand Stalled waits and keep human panes quiet.
- Remote service: share a Session with a friend over Tailscale, or connect to your service through a named HTTPS profile.
- Local service: the state directory, credentials, command output, the HTTP API, backup and restore.
- Agent skill: run
a-stack skill installto teach your coding agents to work in an a-stack Session. - Performance: stress test results with many Agents, and how to run the test.
To see all commands, run a-stack --help. To see the flags of one command, run a-stack help COMMAND, for example a-stack help task create.
Read CONTRIBUTING.md for the development setup and the checks.
a-stack is released under the MIT License.


