🐬 Dive Agent v21 — Autonomous Coding Daemon

Your personal AI engineer, always running. Install once, connect via MCP to Codex, ZCode, or Claude Desktop.

Quick Start

npm install -g dive-agent
dive-agent init              # Create config + API token
# Set provider key: export ANTHROPIC_API_KEY=sk-ant-...
dive-agent start             # Start daemon
dive-agent status            # Check health
dive-agent mcp-setup         # Configure IDE MCP connection

Setup by IDE

Codex (OpenCode)

dive-agent mcp-setup --codex
# Restart Codex — Dive Agent tools appear in MCP

ZCode

dive-agent mcp-setup --zcode
# Restart ZCode

Claude Desktop

dive-agent mcp-setup --claude
# Restart Claude Desktop

Manual MCP config goes to:

• Codex: ~/.codex/mcp.json
• ZCode: ~/.zcode/mcp.json
• Claude: %APPDATA%/Claude/claude_desktop_config.json (Win) or ~/Library/Application Support/Claude/claude_desktop_config.json (Mac)

MCP Tools

Once connected, your IDE can use:

| Tool | Description | |---|---| | dive_task | Submit coding task — agent reads, writes, tests, grades | | dive_status | Check task results | | dive_health | Daemon health, cycles, queue, stats | | dive_tools | List all available agent tools | | dive_codebase | Explore project — find files, symbols, entrypoints |

Commands

| Command | Description | |---|---| | dive-agent init | Initialize config + generate API token | | dive-agent start | Start daemon in background | | dive-agent stop | Stop daemon | | dive-agent status | Check daemon health | | dive-agent mcp-setup | Configure MCP for all platforms | | dive-agent mcp-setup --codex | Codex only | | dive-agent mcp-setup --zcode | ZCode only | | dive-agent mcp-setup --claude | Claude Desktop only | | dive-agent version | Show version |

Configuration

# Required: at least one provider key
ANTHROPIC_API_KEY=sk-ant-...
DEEPSEEK_API_KEY=sk-...
OPENAI_API_KEY=sk-...

# Optional
DIVE_API_TOKEN=<auto-generated>    # API auth token
DIVE_DATA_DIR=C:\DiveData          # Default: %LOCALAPPDATA%\DiveAgent\v21

Endpoints

| Port | Service | |---|---| | :4200 | Live dashboard | | :18890 | REST API, /live, /ready, /health, /tasks, /meta | | :18889 | MCP HTTP mode |

Requirements

• Node.js >= 24
• Git (for worktree isolation)
• Provider API key (Anthropic, DeepSeek, or OpenAI)

Version: 21.0.1-rc.8 | Build: 38/38 | Rating: 86/100