CoDev

CoDev — AI Coding Agent Hub. Install, configure, and manage multiple AI coding agents.

Requires Node.js ≥ 22.21 (Node 24+ recommended).

Install

npm install -g codev-ai

Then run:

codevhub doctor    # check your environment and network first
codevhub install

After install, go to your project and type codev, claude, codex, or opencode to launch.

CodeGraph integration

When you run codevhub install or codevhub config, CoDev also installs CodeGraph — a local, MCP-based, pre-indexed code-knowledge-graph tool — and wires it into each agent you select (Claude Code, Codex, OpenCode, etc.). Because your codebase is pre-indexed, agents can look up symbols, references, and structure straight from the graph instead of repeatedly grepping and reading files to find their way around. That means fewer tool calls and fewer tokens per task — the agent spends its context on the work rather than on rediscovering the codebase.

Initialize your project

cd your-project
codevhub init        # initialize + index the current project (one time)

Switching between self-hosted and proprietary models

CoDev points your agents at a self-hosted AI gateway, but you can flip any agent back to its own provider (Anthropic for Claude Code, OpenAI for Codex, and so on) — and back to the gateway again — whenever you like. Because CoDev backs up your original config before it changes anything, the round-trip is safe and repeatable.

Go back to the proprietary models

Restore each agent's pre-CoDev config:

codevhub restore claude     # one agent
codevhub restore codex
codevhub restore opencode
codevhub restore            # every agent at once

codevhub restore <agent> swaps the backup back over the live config, so the agent talks to its own provider again. With no argument, codevhub restore reverts every agent at once.

Use the self-hosted models

Re-point your already-installed agents at the gateway and pick a model:

codevhub config

After each switching, if you have a session running, you might need to restart it with claude -c, codex resume, or opencode -c to resume your progress.

Removing CoDev entirely

codevhub remove

After confirmation, this reverts your machine to its pre-CoDev state — including running codegraph uninstall to remove CodeGraph's MCP wiring from your agents. Add --yes (or -y) to skip the confirmation prompt.

CoDev itself is still installed globally — finish with:

npm uninstall -g codev-ai

Then restart your terminal.