Skip to main content
Version: latest

getting started

kasmos turns your terminal into a multi-agent orchestration IDE — managing concurrent AI agent sessions in isolated git worktrees with a unified TUI for plans, topics, and lifecycle stages.

in this section​

  • prerequisites — what you need before installing: tmux, gh, and at least one supported AI CLI
  • installation — Homebrew, go install, the install script, and GitHub Releases
  • first run — git-repo requirement, project config directory, and the TUI keybindings reference
  • setup wizard — the 3-step Bubble Tea wizard, harness detection, agent role assignment, and the scaffold it writes

quick start​

From inside any git repository, run:

kas setup       # configure harnesses and scaffold project files
kas             # launch the TUI

kas is the interactive entry point. make build and just build produce a kas binary directly; just install also creates an optional kms short alias under $(go env GOPATH)/bin.

what kasmos manages​

  1. tasks — stored in the global SQLite task store at ~/.config/kasmos/taskstore.db; use kas task list to inspect
  2. topics — group related plans; only one plan per topic can be implementing at a time
  3. waves — plans are split into phases (## Wave N headers); tasks within a wave run in parallel
  4. agents — spawned in tmux sessions or via the sdk backend with dedicated git worktrees; live output is visible in the TUI preview pane
  5. review — a reviewer agent validates the implementation before kasmos prompts for merge approval