Windsurf

Set up dkod with Windsurf — Codeium's AI-powered IDE.

Quick Setup

Paste the prompt below into Windsurf's Cascade chat. It will automatically install and configure the dkod CLI.

Install MCP

Connect Windsurf to dkod's MCP server for direct access to semantic code tools.

Cloud (dkod.io)

Add to your MCP configuration (~/.codeium/windsurf/mcp_config.json):

{
  "mcpServers": {
    "dkod": {
      "serverUrl": "https://api.dkod.io/mcp"
    }
  }
}

Windsurf will prompt for authentication on first use. Once connected, dkod tools are available directly in Cascade.

Self-Hosted

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

Point to your local dkod server:

{
  "mcpServers": {
    "dkod": {
      "serverUrl": "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

Initialize & Authenticate

# Authenticate via browser (cloud only)
dk login

# Open a session (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 with Cascade

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