Installation & Setup

Quick Reference

• Time: ~2 minutes
• Prerequisites: Node.js 18+
• Difficulty: Beginner

Method 0: Bash Script (Universal — RECOMMENDED)

The most reliable way to install CodyMaster on any platform (Claude Code, Gemini, Cursor, etc.). This script auto-detects your environment and installs all 35 skills.

bash <(curl -fsSL https://raw.githubusercontent.com/tody-agent/codymaster/main/install.sh) --all

What this installs:

• All 35 AI Agent Skills (placed in your platform's skills directory).
• Professional workflows (TDD, Debugging, Deployment).
• Working memory and context management.

---

Method 1: Dashboard & CLI (Local Mission Control)

If you want the visual Kanban dashboard and the terminal-first productivity tool, install the global npm package:

npm install -g codymaster

Commands available:

• cm — primary CLI command
• codymaster — full alias.

NOTE

The npm package installs the Dashboard tool. To install the AI Skills for your agent, use Method 0 (Bash Script) above.

All 35 skills ship as a single plugin:

Domain	Skills
🔧 Engineering	cm-tdd, cm-debugging, cm-quality-gate, cm-test-gate, cm-code-review
⚙️ Operations	cm-safe-deploy, cm-identity-guard, cm-git-worktrees, cm-terminal, cm-secret-shield, cm-safe-i18n
🎨 Product	cm-planning, cm-brainstorm-idea, cm-ux-master, cm-ui-preview, cm-dockit, cm-readit, cm-project-bootstrap, cm-jtbd
📈 Growth	cm-content-factory, cm-ads-tracker, cm-cro-methodology
🎯 Orchestration	cm-execution, cm-continuity, cm-skill-chain, cm-skill-index, cm-skill-mastery, cm-deep-search, cm-how-it-work
🖥️ Workflow	cm-start, cm-dashboard, cm-status

Step 3: Verify

claude plugin list

You should see cm listed as installed.

One-Liner Alternative

If you prefer to see all commands at once without navigating menus:

bash <(curl -fsSL https://raw.githubusercontent.com/tody-agent/codymaster/main/install.sh) --claude

---

Method 2: Gemini CLI / Google Antigravity

Option A: Auto-installer (Recommended)

bash <(curl -fsSL https://raw.githubusercontent.com/tody-agent/codymaster/main/install.sh) --antigravity

This automatically clones the repo and copies all 35 skills to ~/.gemini/antigravity/skills/.

Option B: Manual clone + copy

# Clone once
git clone --depth 1 https://github.com/tody-agent/codymaster.git ~/.cody-master

# Copy skills to Antigravity
cp -r ~/.cody-master/skills/* ~/.gemini/antigravity/skills/

TIP

GEMINI.md: Add skill references to your project's GEMINI.md:

@~/.gemini/antigravity/skills/cm-skill-index/SKILL.md
@~/.gemini/antigravity/skills/cm-continuity/SKILL.md
@~/.gemini/antigravity/skills/cm-start/SKILL.md

---

Method 3: Cursor

In Cursor Agent chat, run:

/add-plugin cm

Or search for codymaster in the Cursor plugin marketplace.

---

Method 4: Codex

Tell Codex:

Fetch and follow instructions from https://raw.githubusercontent.com/tody-agent/codymaster/main/.codex/INSTALL.md

---

Method 6: Aider

bash <(curl -fsSL https://raw.githubusercontent.com/tody-agent/codymaster/main/install.sh) --aider

Skills will be copied to ~/.aider/skills/.

---

Method 7: Continue.dev

bash <(curl -fsSL https://raw.githubusercontent.com/tody-agent/codymaster/main/install.sh) --continue

Skills will be copied to ~/.continue/rules/.

---

Method 8: Amazon Q CLI

bash <(curl -fsSL https://raw.githubusercontent.com/tody-agent/codymaster/main/install.sh) --amazon-q

Skills will be copied to ~/.aws/amazonq/skills/.

---

Method 9: Amp

bash <(curl -fsSL https://raw.githubusercontent.com/tody-agent/codymaster/main/install.sh) --amp

Skills will be copied to ~/.amp/skills/.

---

Method 10: Manual / Any Platform

Clone the repo and copy skills directly:

# Clone once
git clone https://github.com/tody-agent/codymaster.git ~/.cody-master

# Copy to your platform's skills directory
cp -r ~/.cody-master/skills/* ~/.gemini/antigravity/skills/    # Gemini
cp -r ~/.cody-master/skills/* .gemini/skills/                  # Project-local
cp -r ~/.cody-master/skills/* .cursor/skills/                  # Cursor
cp -r ~/.cody-master/skills/* .codex/skills/                   # Codex
cp -r ~/.cody-master/skills/* .opencode/skills/                # OpenCode

---

First Steps After Installation

Run the interactive onboarding tour — it takes ~2 minutes and shows every skill:

/cm:demo

Then use any command by name:

Command	What it does
/cm:plan	Brainstorm + architecture + task plan
/cm:build	TDD implementation (red → green → refactor)
/cm:debug	4-phase root cause analysis
/cm:review	Code review + quality gate
/cm:deploy	Safe multi-gate deployment
/cm:ux	UX design + prototyping
/cm:content	AI content factory
/cm:bootstrap	New project setup

Skills also activate automatically when relevant — just describe what you want and the right skill engages.

Updating

# NPM (Universal)
npm update -g codymaster

# Claude Code
claude plugin update cm@codymaster

# Gemini CLI / Antigravity — re-run the installer
bash <(curl -fsSL https://raw.githubusercontent.com/tody-agent/codymaster/main/install.sh) --antigravity

# Or update the clone and re-copy
cd ~/.cody-master && git pull && cp -r skills/* ~/.gemini/antigravity/skills/

Troubleshooting

❌ "Plugin not found" or marketplace error

Make sure your Claude Code CLI is up to date:

claude --version
# Should be 1.0 or later

Then retry:

claude plugin marketplace add tody-agent/codymaster

❌ Skill not activating

Try invoking explicitly:

Use the cm-planning skill for this task

Check that the plugin is installed:

claude plugin list

❌ curl installer not working

Download and inspect the script manually:

curl -fsSL https://raw.githubusercontent.com/tody-agent/codymaster/main/install.sh -o install.sh
bash install.sh --claude

Next Steps

• Using Skills → — Learn how to invoke and customize skills
• Skills Library → — Browse all 34+ available skills
• Dashboard Guide → — Task tracking with the Kanban board