Skip to Content
DocsGuidesSetup wizard

aigon setup runs once after install. It has eight persisted steps, each skippable. aigon setup --resume retries skipped, failed, or incomplete work without repeating completed steps. Use repeatable --step <id> when you only need to retry a named step; global-setup --force regenerates machine configuration and does not restart the wizard.

  1. Prerequisites — verifies Node, npm, Git, GitHub CLI (gh), tmux, and lsof; offers to install missing optionals (gh, tmux, lsof); prompts for Git identity if not configured; runs gh auth login if needed.
  2. Terminal preference (macOS) — iTerm2, Warp, Terminal.app, Ghostty, or cmux. Linux auto-detects GNOME Terminal / Kitty / xterm and falls back to tmux.
  3. Agent install — multi-select from Claude Code, Antigravity CLI, Codex CLI, Cursor, OpenCode, Kimi, Amp, and GitHub Copilot CLI. Nothing is preselected; pick agents to install and authenticate using each agent’s registry metadata.
  4. Optional seed clone — clones the brewboard-seed  demo repo, runs aigon apply, registers it with the dashboard, and persists the target path for later steps.
  5. Repo scan — scans ~/src for Git repos and offers to register them with the dashboard.
  6. Dashboard — optional persistent, loopback-only server start. Setup verifies its health endpoint before marking the step complete and reports the log/remediation path if it fails.
  7. Brewboard demo — opt-in walkthrough that starts a supervised feature using an available installed agent against the selected seed repo.
  8. Vault — optional backup setup: creates or points at a private aigon-vault repo and runs an initial push.

Re-running a step

aigon setup --resume          # pick up where you left off
aigon setup --step server     # retry only the dashboard step
aigon global-setup --force    # regenerate machine configuration

aigon setup --yes is deliberately conservative: it does not install agents, clone Brewboard, register existing repositories, authenticate, start the dashboard, or run a demo. Command help is also read-only: aigon setup --help never runs setup.

What if I skip the wizard entirely?

You can. Install agents with aigon install-agent <code>, start the dashboard with aigon server start --persistent, and run aigon doctor to verify your environment. See the Dashboard guide for the manual path.

Last updated on
Tutorial: BrewboardDashboard