Installation

Prerequisites

Before installing CAMI, ensure you have:

• Go 1.21+ installed (go version to check)
• Git installed (git --version)
• sudo access (for installing binary to /usr/local/bin)
• Claude Code (claude.ai/code)

Installation Steps

1. Clone CAMI Repository

# Clone the repository
git clone https://github.com/lando-labs/cami.git
cd cami

2. Build and Install

# Build Go binary and install CAMI
make install

This command:

1. Builds the CAMI Go binary
2. Creates ~/cami-workspace/ with templates and configuration
3. Installs cami binary to /usr/local/bin/ (requires sudo)

What gets created:

~/cami-workspace/           # Your CAMI workspace
├── CLAUDE.md               # CAMI documentation
├── README.md               # Quick start guide
├── .mcp.json               # MCP server config (local)
├── .gitignore              # Git ignore rules
├── .claude/
│   └── agents/             # CAMI's own agents
│       └── agent-architect.md
├── sources/
│   └── my-agents/          # Your custom agents directory
│       └── .camiignore     # Exclude non-agent files
/usr/local/bin/cami         # Binary on your PATH

3. Verify Installation

# Check CAMI is installed
cami --version
# Output: CAMI v0.3.0 - Claude Agent Management Interface
# Check CAMI help
cami --help

If you see the version and help output, CAMI is successfully installed!

Platform Notes

macOS (Intel and Apple Silicon)

Works on both Intel and Apple Silicon (arm64). The make install command will:

• Build for your current architecture
• Ask for sudo password to install to /usr/local/bin

Linux

Requires:

• Go 1.21+ installed
• sudo access for installation

Then follow standard installation instructions above.

WSL (Windows Subsystem for Linux)

CAMI works on WSL2. Requirements:

• Go 1.21+ installed in WSL (not Windows)
• sudo access configured in WSL
• Git configured in WSL

Then follow standard installation instructions above.

What Gets Installed

1. CAMI Binary (/usr/local/bin/cami)

Single Go binary with dual modes:

MCP Server Mode (primary):

cami --mcp
# Runs as MCP server for Claude Code integration

CLI Mode (secondary):

cami list                    # List available agents
cami deploy frontend backend ~/projects/my-app
cami scan ~/projects/my-app  # Check deployed agents
cami source list             # List agent sources

2. CAMI Workspace (~/cami-workspace/)

Your agent management headquarters:

• CLAUDE.md: Complete CAMI documentation for Claude context
• README.md: Quick start guide
• .mcp.json: MCP server configuration (local to workspace)
• .gitignore: Pre-configured git ignore rules
• .claude/agents/: CAMI's own agents (agent-architect, etc.)
• sources/my-agents/: Directory for your custom agents

Configuring Claude Code

CAMI's MCP server is pre-configured in ~/cami-workspace/.mcp.json:

{
  "mcpServers": {
    "cami": {
      "command": "cami",
      "args": ["--mcp"]
    }
  }
}

This works automatically when you open Claude Code in ~/cami-workspace/.

Global MCP Setup (Optional)

To use CAMI from any directory:

Add to ~/.claude/settings.json:

{
  "mcpServers": {
    "cami": {
      "command": "cami",
      "args": ["--mcp"]
    }
  }
}

Note: You'll need to restart Claude Code after modifying settings.

Troubleshooting

"Go Not Found"

Problem: make install fails with "go: command not found"

Solution:

# Install Go 1.21+
# macOS:
brew install go
# Linux:
wget https://go.dev/dl/go1.21.0.linux-amd64.tar.gz
sudo tar -C /usr/local -xzf go1.21.0.linux-amd64.tar.gz
export PATH=$PATH:/usr/local/go/bin
# Verify
go version

"Permission Denied" Installing Binary

Problem: Cannot install to /usr/local/bin

Solution:

# Option 1: Use sudo
sudo make install
# Option 2: Install to user directory
mkdir -p ~/bin
cp cami ~/bin/
export PATH=$PATH:~/bin  # Add to ~/.bashrc or ~/.zshrc

"Workspace Directory Already Exists"

Problem: ~/cami-workspace/ already exists

Solution:

# Option 1: Remove existing workspace
rm -rf ~/cami-workspace
make install
# Option 2: Keep existing workspace
# Just build and install binary
make build
sudo cp cami /usr/local/bin/

CAMI Tools Not Available in Claude Code

Problem: Claude doesn't see CAMI MCP tools

Solutions:

1. Verify CAMI is on PATH: which cami
2. Check .mcp.json exists in ~/cami-workspace/
3. Open Claude Code in ~/cami-workspace/ directory
4. For global access, verify ~/.claude/settings.json is configured
5. Restart Claude Code completely

Build Errors

Problem: make build fails

Solutions:

# Ensure Go modules are downloaded
go mod download
# Clean and rebuild
make clean
make build
# Check Go version (must be 1.21+)
go version

Manual Installation (Advanced)

If you prefer manual setup:

# 1. Build CAMI binary
cd cami
go build -o cami ./cmd/cami
# 2. Install binary
sudo cp cami /usr/local/bin/
# 3. Create workspace
mkdir -p ~/cami-workspace/sources/my-agents
mkdir -p ~/cami-workspace/.claude/agents
# 4. Copy templates
cp install/templates/CLAUDE.md ~/cami-workspace/
cp install/templates/README.md ~/cami-workspace/
cp install/templates/.mcp.json ~/cami-workspace/
cp install/templates/.gitignore ~/cami-workspace/
cp install/templates/.camiignore ~/cami-workspace/sources/my-agents/
# 5. Copy CAMI's agents
cp install/templates/agent-architect.md ~/cami-workspace/.claude/agents/
# 6. Verify
cami --version

Uninstalling CAMI

To remove CAMI:

# Remove binary
sudo rm /usr/local/bin/cami
# Remove workspace (optional - contains your custom agents!)
rm -rf ~/cami-workspace
# Remove global config (if configured)
# Edit ~/.claude/settings.json and remove "cami" entry

Warning: Removing ~/cami-workspace/ deletes your custom agents! Back up sources/my-agents/ first if needed.

Next Steps

CAMI is installed! Now:

1. Complete first-time setup - Add agent sources
2. Deploy your first agent - See CAMI in action
3. Explore CLI commands - Learn scripting workflows

Build from Source (Development)

Contributing to CAMI? See development setup:

# Clone repository
git clone https://github.com/lando-labs/cami.git
cd cami
# Open in Claude Code (uses go run for dev)
claude
# Build for current platform
make build
# Run tests
make test
# Build for all platforms
make release-all

The CAMI repository includes .mcp.json configured with go run for zero-setup development.