Claude Code

Set up dkod with Claude Code — Anthropic's agentic coding CLI.

Recommended: Install the Plugin

The dkod plugin bundles everything — MCP tools, the parallel execution skill, agents, and commands — into a single install.

/plugin marketplace add dkod-io/dkod-plugin
/plugin install dkod@dkod

You get MCP tools (including dk_review for code review intelligence), the /dkod skill, /dkod:status, /dkod:push, /dkod:watch, /dkod:land commands, and a pre-built parallel execution agent. /dkod:land is a convenience command that chains dk_approve → dk_merge → dk_push into one step. On first use, a browser window opens for GitHub OAuth authentication.

Alternative: Install MCP Directly

If you prefer to install just the MCP server without the full plugin:

Cloud (dkod.io)

claude mcp add --transport http dkod https://api.dkod.io/mcp

Claude Code will open a browser window for authentication on first use. Once authenticated, dkod tools (semantic search, file operations, changeset submission) are available directly in your Claude Code session.

Self-Hosted

For self-hosted setups, see the Self-Hosted quickstart.

Point to your local dkod server:

claude mcp add --transport http dkod http://localhost:8080/mcp

For self-hosted, set your auth token before use:

export DKOD_AUTH_TOKEN=your-secret-token

Install the CLI

# Install via Cargo (requires Rust)
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source "$HOME/.cargo/env"
cargo install dk-cli

Authenticate & Initialize

# Authenticate via browser (cloud only)
dk login

# Open a session on a repository (auto-detects from git remote)
dk init

For self-hosted setups, skip dk login and set export DKOD_AUTH_TOKEN=your-secret-token and export DKOD_GRPC_ADDR=http://localhost:50051, then run dk init.

Usage

Once configured, you can use the dkod CLI in your workflow:

# Search code semantically
dk search "authentication middleware"

# Check project status
dk status

# View changes
dk diff

# Commit and push
dk commit -m "Fix token refresh logic"
dk push