Getting started

Quick start

Initialize one repository, launch an agent, and inspect the local activity ClaudeKit records.

This is the smallest useful ClaudeKit workflow. It creates local project state, launches the agent you already use, and records the session locally after it exits.

Initialize a repository

From the repository root, create ClaudeKit's private local state.

cd path/to/repository
ck init

This creates .claudekit-local/. The first wrapped session also creates it automatically, but ck init gives you an explicit starting point.

Choose an optional default agent

ck setup claude
# or
ck setup codex

Use ck setup without an agent in an interactive terminal to choose from detected local agents.

Launch your normal agent through ClaudeKit

ck claude
# or
ck codex

ClaudeKit passes normal command-line arguments through to the agent and records the session locally. It does not press Send, change your prompt, or run background agent work.

Review the work ClaudeKit recorded

ck sessions
ck stats
ck status

Use ck guide any time for the complete command directory.