Creating Sessions

Press a in the dashboard to create a new agent session. The session creator guides you through directory selection and skill assignment.

Directory selection

The session creator uses the z zsh plugin to suggest directories ranked by frecency (frequency + recency). Start typing a path and suggestions appear automatically.

The z plugin is optional. Without it, you can type full paths manually.

Skill selection

After choosing a directory, select a skill that determines the agent’s workflow:

Skill Purpose
feature New feature development with TDD in an isolated git worktree
fix Bug fix with root cause analysis
chore Non-code changes (docs, config, CI)
refactor Code restructuring with test preservation
investigate Research and analysis without code changes
pr PR review and iteration workflow
rca Root cause analysis for incidents

Each skill loads a specialized prompt that guides the agent through the appropriate workflow — including branching strategy, testing requirements, and delivery steps.

Effort levels

The dashboard pins a Claude Code thinking-effort level on every spawned session and switches it dynamically as the agent works:

  • Every dashboard-spawned session starts with --effort {effort.default} (default: high) — Claude Code pins this at the session level.
  • When the agent enters plan mode (EnterPlanMode), the agent-state-fast adapter hook dispatches /effort {effort.plan} (default: high) into the pane and restores default on plan exit. With both keys set to high (the shipped default) the swap is a no-op; raise effort.plan to xhigh or max if you want planning to think deeper than implementation.
  • The feature, fix, and refactor skills additionally declare effort: max in their frontmatter. This applies only when the skill is invoked as a slash command (/feature, /fix, /refactor) inside an existing session — not when the dashboard launches a new agent with one of those skills selected.

Override the defaults in settings.toml under the [effort] section. Valid levels: low, medium, high, xhigh, max.

What happens next

The dashboard:

  1. Creates a new tmux pane
  2. Starts Claude Code in the selected directory with the chosen skill
  3. The adapter hooks begin writing agent state files
  4. The agent appears in the dashboard list within seconds