codev

codev - Project Management CLI

The codev command manages project setup, maintenance, and framework-level operations.

Synopsis

codev <command> [options]

Commands

codev init

Create a new codev project.

codev init [project-name] [options]

Arguments:

• project-name - Name of the project (optional, prompts if not provided)

Options:

• -y, --yes - Use defaults without prompting

Description:

Creates a minimal codev project structure:

• codev/specs/ - Specification files
• codev/plans/ - Implementation plans
• codev/reviews/ - Review documents
• CLAUDE.md / AGENTS.md - AI agent instructions
• .gitignore - Standard ignores

Framework files (protocols, roles) are provided by the embedded skeleton at runtime, not copied to the project.

Examples:

# Interactive creation
codev init

# Create with name
codev init my-app

# Non-interactive with defaults
codev init my-app -y

---

codev adopt

Add codev to an existing project.

codev adopt [options]

Options:

• -y, --yes - Skip conflict prompts

Description:

Adds codev structure to the current directory. Detects existing files (CLAUDE.md, AGENTS.md) and prompts before overwriting.

Use this when you want to add codev to a project that already has code.

Examples:

# Add to current project
cd existing-project
codev adopt

# Skip prompts for conflicts
codev adopt -y

---

codev doctor

Check system dependencies.

codev doctor

Description:

Verifies that all required dependencies are installed and properly configured:

Core Dependencies (required):

• Node.js (>= 18.0.0)
• git (>= 2.5.0)
• gh (GitHub CLI, authenticated)

AI CLI Dependencies (at least one required):

• Claude (@anthropic-ai/claude-code)
• Gemini (gemini-cli)
• Codex (@openai/codex)

Exit Codes:

• 0 - All OK or warnings only
• 1 - Required dependencies missing

Example:

codev doctor