Installation & Setup

Quick Reference

• Time: ~5 minutes
• Prerequisites: Node.js 18+, npm
• Difficulty: Beginner

Prerequisites

Tool	Version	Check
Node.js	18+	node --version
npm	9+	npm --version
Git	Any	git --version

Step 1: Install Cody Master

npm (recommended)

npm install -g cody-master

From source

git clone https://github.com/omisocial/cody-master.git
cd cody-master
npm install
npm run build
npm link  # Makes 'cm' command available globally

Verify installation:

cm --version
# Expected: 3.2.0 or later

Step 2: Initialize a Project

Navigate to your project directory and initialize:

cd /path/to/your/project
cm init

This creates the working memory directory:

.cm/
├── CONTINUITY.md      # Session state
├── config.yaml        # RARV settings
└── memory/
    ├── learnings.json  # Error patterns
    └── decisions.json  # Architecture decisions

Step 3: Start the Dashboard

cm dashboard start
# or simply
cm open

The Kanban dashboard opens at http://codymaster.localhost:48120

Step 4: Install Skills for Your AI Platform

# For Google Antigravity (Gemini)
cm install cm-tdd --platform gemini

# For Claude Code
cm install cm-tdd --platform claude

# For Cursor
cm install cm-tdd --platform cursor

Step 5: Create Your First Task

CLI

cm task add "Set up authentication" --priority high

Dashboard

# Open http://codymaster.localhost:48120
# Click "+ Add Task" in the Backlog column

Step 6: Dispatch to an AI Agent

# Assign agent and skill first
cm task add "Fix login bug" --agent antigravity --skill cm-debugging --priority high

# Then dispatch
cm task dispatch <task-id>

Verification

After setup, verify everything works:

# Check status
cm status

# Expected output:
# 📊 Status Overview
# Projects: 1
# Tasks: 1
# Dashboard: RUNNING at http://codymaster.localhost:48120

Troubleshooting

❌ "cm: command not found"

Ensure the npm global bin is in your PATH:

export PATH="$(npm config get prefix)/bin:$PATH"

Add this to your ~/.zshrc or ~/.bashrc.

❌ Dashboard port already in use

# Use a different port
cm dashboard start --port 3001

❌ "No projects found"

# Create a project first
cm project add "My Project" --path /my/project

Next Steps

• Using Skills → — Learn how to invoke and customize skills
• Dashboard Guide → — Master the Kanban board
• Skills Library → — Browse all 30+ available skills