DEPENDENCIES.md

Codev Dependencies

This document describes all dependencies required to run Codev and Agent Farm.

Quick Check

Run the doctor command to verify your installation:

codev doctor

---

Core Dependencies (Required)

These are required for Agent Farm to function.

Node.js

Requirement	Value
Minimum Version	18.0.0
Purpose	Runtime for Agent Farm server

Installation:

# macOS
brew install node

# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs

# Verify
node --version  # Should show v18.x or higher

git

Requirement	Value
Minimum Version	2.5.0
Purpose	Version control, worktree support for builders

Installation:

# macOS (usually pre-installed with Xcode)
xcode-select --install

# Ubuntu/Debian
sudo apt install git

# Verify
git --version  # Should show 2.5.x or higher

gh (GitHub CLI)

Requirement	Value
Minimum Version	Latest
Purpose	Creating PRs, managing issues, GitHub operations

Installation:

# macOS
brew install gh

# Ubuntu/Debian
(type -p wget >/dev/null || sudo apt install wget -y) \
  && sudo mkdir -p -m 755 /etc/apt/keyrings \
  && out=$(mktemp) && wget -nv -O$out https://cli.github.com/packages/githubcli-archive-keyring.gpg \
  && cat $out | sudo tee /etc/apt/keyrings/githubcli-archive-keyring.gpg > /dev/null \
  && sudo chmod go+r /etc/apt/keyrings/githubcli-archive-keyring.gpg \
  && echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null \
  && sudo apt update \
  && sudo apt install gh -y

# After installation, authenticate:
gh auth login

# Verify
gh auth status  # Should show "Logged in to github.com"

---

AI CLI Dependencies (At Least One Required)

You need at least one AI CLI installed to use Codev. Install more for multi-agent consultation.

Claude Code (Recommended)

Requirement	Value
Purpose	Primary AI agent for development
Required For	codev import command (spawns interactive Claude session)
Documentation	docs.anthropic.com

Installation:

npm install -g @anthropic-ai/claude-code

# Verify
claude --version

Gemini CLI

Requirement	Value
Purpose	Multi-agent consultation, alternative perspectives
Documentation	github.com/google-gemini/gemini-cli

Installation:

npm install -g @google/gemini-cli

# Verify
gemini --version

Codex CLI

Requirement	Value
Purpose	Multi-agent consultation, code-focused analysis
Documentation	github.com/openai/codex

Installation:

npm install -g @openai/codex

# Verify
codex --version

---

Version Requirements Summary

Dependency	Minimum Version	Required?
Node.js	18.0.0	Yes
git	2.5.0	Yes
gh	latest	Yes
Claude Code	latest	At least one AI CLI
Gemini CLI	latest	At least one AI CLI
Codex CLI	latest	At least one AI CLI

---

Platform-Specific Notes

macOS

All dependencies are available via Homebrew:

# Install all core dependencies at once
brew install node gh

# Git is included with Xcode command line tools
xcode-select --install

Ubuntu/Debian

Most dependencies are available via apt:

# Core dependencies
sudo apt install nodejs npm git

# gh requires adding GitHub's apt repository (see above)

Windows

Codev is designed for Unix-like systems. On Windows, use WSL2:

# Install WSL2 with Ubuntu
wsl --install -d Ubuntu

# Then follow Ubuntu installation instructions inside WSL

---

Troubleshooting

"command not found" errors

Ensure the installed binaries are in your PATH:

# Check PATH
echo $PATH

# Common fix: add npm global bin to PATH
export PATH="$PATH:$(npm config get prefix)/bin"

Terminal connection issues

Ensure no firewall is blocking the ports (default: 4200-4299):

# Check if port is in use
lsof -i :4200

# Clean up stale port allocations
af ports cleanup

gh authentication issues

# Re-authenticate
gh auth logout
gh auth login

# Verify
gh auth status

---

See Also

• INSTALL.md - Installation guide
• MIGRATION-1.0.md - Migration guide for existing projects
• codev doctor - Automated dependency checker