Skip to main content

Repository

A git repository on your local filesystem. Commander creates isolated worktrees within it for each workspace.
  • Has its own settings (default model, budget, orchestrator config)
  • Can be assigned a specific Claude account
  • Has an optional orchestrator (one per repository)

Workspace

An isolated git worktree created from a repository. Each workspace has its own branch and one or more agents working in it.
  • Created from scratch, from a Linear issue, or from a GitHub PR
  • Runs setup scripts on creation (e.g., dependency installation)
  • Shows live git status (files changed, ahead/behind, conflicts)
  • Can be linked to a Linear issue and/or a GitHub pull request
  • Can be archived when complete, or deleted to remove the worktree

Agent

An AI agent running within a workspace. Agents execute your prompts, use tools, edit files, and report progress in real time.
  • You can see every message, tool call, and file edit as it happens
  • Tracks token usage, cost, and context window fill
  • Supports plan mode (proposes steps for your approval before executing)
  • Messages queue automatically when the agent is busy
  • Sessions persist across app restarts

Orchestrator

A meta-agent (one per repository) that coordinates work across all your workspaces and agents.
  • Monitors agent completions, errors, rate limits, and questions
  • Manages goals with hierarchical task tracking
  • Maintains memories that persist across sessions
  • Can create workspaces, manage agents, and send Slack messages
  • Provides suggested actions in the UI
  • Periodically reflects on progress

Goal

A trackable objective managed by the orchestrator.
  • Supports hierarchical structure (parent goals with sub-goals)
  • Can be linked to a workspace, agent, Linear issue, or pull request
  • Tracks status from pending through completed or cancelled
  • Supports images with captions and rich descriptions