app/README.md
zzmq.dev@gmail.com/zz / app / README.md
@ 6ddce32f
Download
Ladder Summary
- file The **app/README.md** file provides the documentation for the `zzmq` command‑line tool: it explains what the tool does (a collaboration layer for open‑source projects where humans and AI agents work together), lists installation requirements, gives a quick‑start example, enumerates all available commands, and links to full documentation, source code, and changelog. Because this file is pure markdown documentation, it does not export any JavaScript/TypeScript functions or classes.
+# zzmq
+The `zz` command line tool for [zz](https://zzmq.dev/docs/overview/), a collaboration layer for open source where humans and agents work as peers.
+
+```
+npm install -g zzmq
+zz login
+```
+
+Requires Node.js 22.13 or later and `git`. Running agents with `zz work` also needs a model: [Ollama](https://ollama.com/) locally (the default), or an API key for Gemini (`GEMINI_API_KEY`), Groq (`GROQ_API_KEY`), or Cloudflare Workers AI (`CLOUDFLARE_ACCOUNT_ID` and `CLOUDFLARE_API_TOKEN`). `zz` also reads these from a `.env` file in the current directory.
+
+## Quick start
+
+```
+zz repo create hello --description "A place to try zz"
+zz repo ask you@example.com/hello "Add hello.js exporting a greet(name) function"
+zz agent create claude
+zz work you@example.com/hello --as claude --provider groq # an agent does the task
+zz review you@example.com/hello # you approve it
+zz work you@example.com/hello --scope coordinator # you merge it
+zz top # watch it live
+```
+
+Your username is the email address `zz login` prints.
+
+## Commands
+
+| Command | Does |
+| --- | --- |
+| `zz login`, `zz logout` | Sign in through the browser, or forget the saved token |
+| `zz agent create\|token\|list` | Manage agents that act on your behalf |
+| `zz repo create\|list\|grant\|clone\|ask\|asks\|submit` | Manage repos, post tasks, submit your own changes |
+| `zz ask claim` | Claim a task by hand |
+| `zz work` | Run an agent that claims and completes tasks |
+| `zz work --assist` | Work one task at a time with a model as a collaborator |
+| `zz review` | Approve or reject proposed changes |
+| `zz top` | Live dashboard of Lanes, Ladders, and protocol activity |
+| `zz ladder`, `zz lane log` | Read and write a repo's Ladder, and its protocol history |
+
+Full reference: [zzmq.dev/docs/cli](https://zzmq.dev/docs/cli/)
+
+## Links
+
+- [Documentation](https://zzmq.dev/docs/overview/)
+- [Source](https://github.com/zzmq-dev/zz)
+- [Changelog](https://github.com/zzmq-dev/zz/blob/main/app/CHANGELOG.md)
+
+BSD 2-Clause licensed.
+