Prerequisites

You need Node.js 18+. That’s it.

brew install node

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash - && sudo apt-get install -y nodejs

sudo dnf install -y nodejs npm

sudo pacman -S --noconfirm nodejs npm

The setup wizard installs everything else it needs (tmux, lsof, gh) once Aigon is on your PATH.

Install Aigon

npm install -g @senlabsai/aigon@latest
aigon setup

sudo npm install -g @senlabsai/aigon@latest
aigon setup

The wizard walks you through agent install, terminal preference, and dashboard start — see Setup wizard for the eight steps.

Add Aigon to your project

cd /path/to/your/project
aigon apply
aigon install-agent cc ag          # Claude Code + Antigravity

Agent codes — install whichever you have access to: cc Claude Code · ag Antigravity CLI · cx Codex CLI · cu Cursor · op OpenCode · km Kimi Code CLI · am Amp · cp GitHub Copilot CLI. Inside any of them, invoke Aigon commands as /aigon:feature-do 07 (or $aigon-feature-do 07 for Codex, /aigon-feature-do 07 for Copilot).

Start using Aigon

Go to http://localhost:4100  — the wizard started the server during install. The Pipeline view shows your features across kanban lanes.

New to Aigon? Walk through the Brewboard tutorial first — it’s a small Next.js seed repo with six pre-written feature specs ready to run. The tutorial gets you cloning, applying Aigon, and watching the dashboard drive a real feature in ~10 minutes. Setup offers the seed clone interactively; aigon setup --yes never clones it.

brew install caddy      # macOS — see caddyserver.com/docs/install for Linux
aigon proxy install     # installs Caddy as a system daemon on port 80 (requires sudo)

Your first feature

Via the dashboard (recommended)

Make sure you’re on the Pipeline view, then pick your project (or Brewboard) from the left-hand sidebar. The kanban below shows that repo’s features spread across the six lanes.

1. New feature — click the + New feature button. Fill in a title and a short description, save. The card lands in Inbox.
2. Prioritise — click Prioritise on the card. The permanent F<ID> is already allocated; this moves it to Backlog.
3. Start — pick an agent and model in the modal. Aigon creates the workspace and starts the configured session host, then moves to In Progress. Click the card to watch live.
4. Code review (optional) — click Code Review for a pass by a different agent. Reviewer diversity catches blind spots a same-model reviewer misses.
5. Close — runs gitleaks + semgrep gates, merges to main, runs tests, moves to Done.

Via an agent CLI

Inside Claude Code (or any installed agent), the fastest path is /aigon:feature-now:

/aigon:feature-now dark-mode
Add a dark mode toggle to the top-right header.
Default to system preference. Store choice in localStorage.

The agent creates a spec with its permanent F<ID>, sets up the workspace, and starts implementing — all in one conversation.

For more control, use individual commands: feature-create → feature-prioritise → feature-start → feature-do → feature-code-review → feature-close.

Updating Aigon

npm update -g @senlabsai/aigon@latest
aigon apply --all

Re-applies templates across every registered repo. See Applying Aigon updates for finer-grained control.

What’s next

• Drive Mode — hands-on implementation with one agent
• Fleet Mode — multiple agents competing in parallel against the same spec
• Autonomous Mode — hands-off long-running loops
• Research Workflow — answer open questions before turning them into features
• Feedback Workflow — triage user feedback into prioritised work
• Execution Modes — Drive, Fleet, Autopilot, and Swarm