dkod

title: Quickstart description: Install the CLI, capture your first session, browse with dkod log and dkod show.

Quickstart

Get dkod running in under a minute.

Install the CLI

Choose your preferred method:

# Shell script (macOS / Linux)
curl -fsSL https://dkod.io/install.sh | sh

# Homebrew
brew install dkod

# Cargo
cargo install dkod-cli

Verify the installation:

dkod --version

Initialize a repo

cd your-project
dkod init

This installs agent hooks and creates .dkod/config.toml with default settings (redaction on, all agents enabled).

Capture a session

Wrap any supported agent with dkod capture:

dkod capture claude-code

The CLI wraps the agent invocation, captures the transcript and diff, and stores them as a git ref when the session ends.

Browse your sessions

List all sessions in the repo:

dkod log

Output:

s-a1b2c3  claude-code  "refactor auth middleware"   3m ago   12 files
s-d4e5f6  codex        "add rate limiting"           1h ago    4 files

View a specific session:

dkod show s-a1b2c3

Push sessions to remote

Sessions ride on git push — no separate command:

git push origin main

Session refs under refs/dkod/ are pushed alongside your branch.

View in the desktop app

Download dkod App and open your repo folder. The app reads session refs locally and shows a timeline with replay.

Next steps