Concepts

The model: sessions, worktrees, roles, hooks, and agents.

• Sessions What a session is, the main session that coordinates them, and the worktree and lifecycle model underneath.
• Roles Named presets in settings.kdl that bundle an agent, a system prompt, and config defaults into a reusable identity.
• Hooks Shell commands that fire on session lifecycle events — and the git-safety check that runs on discard.
• Agents The coding agents a session can run — Claude and Codex today — and how each is launched, resumed, and authenticated.