crew-assistant
A personal assistant that runs your projects through small teams of agents
- Language
- Go
- Version
- 0.23.0
- License
- PolyForm Perimeter 1.0.0
- Category
- CLI Tool
A Go daemon and dashboard that turns what you want into a brief, hands it to a small team of Claude Code and Codex sessions — a writer drafts, a reviewer checks the draft against the brief — and asks you only for decisions: a finished draft to approve, a question the brief can't answer, or a problem the team can't fix. Code teams research, implement, review and QA in a private clone, then land as a branch, a fast-forward or a pull request.
Features
Decisions are the only thing that needs you — approve a draft, answer a reviewer's question, or choose what happens at the round limit, from the dashboard, chat or Slack
Independent review by default — the draft team writes on Claude and reviews on Codex, so the reviewer is not checking its own work
Code teams — a researcher plans before anything is written, an implementer changes a private clone, reviewers read the change and QA runs your check
Landing is yours to set — a new branch, a fast-forward of main as one commit, or a GitHub pull request the team shepherds through review and CI
Team members with memory — named specialists keep what a turn taught them as learnings, never about one project, and read one only when it applies
A live board — each request shows its stage, how long its role has run, its tool calls and changed files, and says why it is waiting
Sandboxed roles — every role runs headless through lib-agent-harness under the CLI's own OS sandbox, proved before any credentialed launch
Usage floors — roles leave part of each Codex and Claude window unused, and a task waits for the reset instead of failing
Connections, not a registry — lin, agent-slack, agent-fathom and agent-notion answer bounded read queries; credentials stay with each CLI
Private by default — local pairing codes, optional Tailscale Serve for named users, and no public Funnel
Install
Homebrew
$ brew install shhac/tap/crew-assistant GitHub Release (macOS)
$ curl -L https://github.com/shhac/crew-assistant/releases/latest/download/crew-assistant-darwin-arm64.tar.gz | tar xz Go Install
$ go install github.com/shhac/crew-assistant/cmd/crew-assistant@latest Build from Source
$ git clone https://github.com/shhac/crew-assistant.git && cd crew-assistant && make build Getting Started
Try the demo first: it starts with fictional projects at every stage and decisions waiting, disables integrations, never runs a model, and removes its state on exit. For your own assistant, crew-assistant needs a logged-in Codex or Claude Code CLI for each engine your teams use.
01 · Open the demo
$ crew-assistant serve --demo --open A throwaway sample in a temporary state directory, so you can see the board, inbox and team pages before setting anything up.
02 · Write your config and log in
$ crew-assistant init && crew-assistant model login Add --engine claude to log in any other engine your teams use. Config holds credential environment variable names, never secret values.
03 · Check everything, without inference
$ crew-assistant doctor Checks configuration and logins, and proves for each installed CLI that team roles can run under its sandbox.
04 · Run the daemon
$ crew-assistant serve --open Only one daemon owns a state file. serve --no-dispatch observes without running any team work.
Usage
$ crew-assistant chat 'Draft a thank-you note to the launch team' $ crew-assistant status $ crew-assistant task list $ crew-assistant task checkout <id> $ crew-assistant task adopt <id> $ crew-assistant pause $ crew-assistant config list