{
  "markdown": "[English](README.md) | [Tiếng Việt](README-vi.md)\n\n# CodyMaster\n\n> *\"I can't write code. But in 6 months, I shipped 12 real products using AI. CodyMaster is everything I learned — so you don't have to repeat my mistakes.\"* — **Tody Le**, Head of Product, Creator of CodyMaster\n\n**50+ skills. One install. Your AI coding agent becomes a full team.**\n\n**v7.0.2 — Browse Hybrid Bridge:** AI-native browser automation with a11y snapshots, error collection, video recording.\n\n```\n    ( . \\ --- / . )\n     /   ^   ^   \\\n    (      u      )\n     |  \\ ___ /  |\n      '--w---w--'\n       Meet Cody 🐹\n```\n\n[![npm version](https://img.shields.io/npm/v/codymaster.svg)](https://www.npmjs.com/package/codymaster)\n[![npm downloads](https://img.shields.io/npm/dm/codymaster.svg)](https://www.npmjs.com/package/codymaster)\n[![license](https://img.shields.io/npm/l/codymaster.svg)](https://github.com/tody-agent/codymaster/blob/main/LICENSE)\n\n---\n\n## The Problem\n\nYou installed an AI coding agent. It writes code fast. But then:\n\n- **It designs differently every time** — your brand looks like 3 different companies\n- **It fixes one thing, breaks five others** — you redo the same work over and over\n- **It forgets everything** between sessions — you re-explain your project every morning\n- **It writes zero tests, zero docs** — your codebase becomes a ticking time bomb\n- **You install 15 skills** — none of them talk to each other\n\n> *\"AI gave me 100 hands. Without discipline, those hands created chaos.\"*\n\n---\n\n## The Solution: A Full Senior Team in One Install\n\nCodyMaster isn't a collection of random skills. It's an **operating system** for your AI agent — 50+ skills that work together like a real team.\n\n**When you install CodyMaster, you hire:**\n\n| Role | What They Do | Key Skills |\n|------|-------------|------------|\n| **Senior Developer** | Write tests first, debug systematically, review code | `cm-tdd` `cm-debugging` `cm-code-review` |\n| **UX Designer** | Extract design systems, preview UI before coding | `cm-design-system` `cm-ux-master` `cm-open-design` |\n| **Product Manager** | Plan features, brainstorm ideas, understand users | `cm-planning` `cm-brainstorm-idea` |\n| **DevOps Engineer** | Safe deploys, secret scanning, right-account checks | `cm-safe-deploy` `cm-identity-guard` |\n| **Tech Writer** | Auto-generate docs, API refs, knowledge base from code | `cm-dockit` `cm-codeintell` |\n| **Automation Lead** | Sprint pipelines, autopilot workflows, status tracking | `cm-sprint-bus` `cm-autopilot` |\n\n---\n\n## Quick Start — 30 Seconds\n\n**Step 1: Install**\n\n```bash\nnpm install -g codymaster && cm\n```\n\nA wizard detects your AI tools (Claude Code, Cursor, Gemini, etc.) and installs skills to all of them.\n\n**Step 2: Start coding**\n\nOpen your AI agent and say what you want:\n\n```\nBuild a landing page for my coffee shop\n```\n\n**Step 3: Watch it work**\n\nCodyMaster automatically chains the right skills:\n`cm-brainstorm-idea` → `cm-design-system` → `cm-execution` → `cm-safe-deploy`\n\nThat's it. No config files. No setup ritual. Just describe what you want.\n\n---\n\n## Disciplined Delivery by Default\n\nCodyMaster now carries one execution contract from planning through verification:\n\n- Rich plans name exact task files and keep every step inside that task scope; TDD work must record RED before GREEN.\n- One approved plan grants scoped execution authorization, so in-scope work continues without repeated confirmation loops.\n- Mode B uses three distinct sessions per task: a fresh implementer, a spec reviewer, and then a quality reviewer.\n- The shared autonomy policy is validated and synchronized across all 14 supported platform distributions.\n- `cm bench --suite workflow-integration --runs 1` runs from any project directory, including an installed npm package, and writes results locally.\n\n---\n\n## See It Work\n\nHere's a real conversation — a non-technical founder building a booking site:\n\n```\nYou:    I want to build a booking website for my spa business.\n        I have an old website at myspa.com but it looks terrible.\n\nAI:     [cm-brainstorm-idea] Let me analyze your current site first...\n        I found 3 key issues: no mobile booking, unclear pricing,\n        slow load time. Here are 2 approaches:\n        A) Redesign from scratch (recommended — your brand needs it)\n        B) Fix the existing site\n        \nYou:    Let's go with A.\n\nAI:     [cm-design-system] I'm extracting your brand colors from\n        myspa.com... Found: gold + navy. Building a design system.\n        [cm-planning] Here's the plan: booking page, services page,\n        about page, contact. Estimated: 30 minutes of AI work.\n        \nYou:    Sounds good, do it.\n\nAI:     [cm-tdd] Writing tests first...\n        [cm-execution] Building 4 pages...\n        [cm-dockit] Generating service descriptions and FAQ docs...\n        [cm-quality-gate] All tests pass. Performance: 98/100.\n        [cm-safe-deploy] Deploying to staging...\n        \n        ✅ Done. Preview: https://staging-myspa.pages.dev\n        \nYou:    The booking button is too small on mobile.\n\nAI:     [cm-debugging] Found it — padding was 8px, should be 16px.\n        [cm-code-review] Fix looks good. No side effects.\n        [cm-safe-deploy] Deployed fix.\n        \n        ✅ Fixed. Try now.\n```\n\n**No code written by the human. No bugs introduced by the AI.** The system caught the mobile issue before it reached production.\n\n---\n\n## What Makes This Different\n\n| | 😵 Random Skills | 🧠 CodyMaster |\n|---|---|---|\n| **Integration** | Each skill is standalone | 50+ skills that chain and share memory |\n| **Memory** | Forgets everything between sessions | Remembers your project, your style, your mistakes |\n| **Safety** | Deploy and pray | Multi-layer protection: tests → security → staging → production |\n| **Design** | Random UI every time | Extracts your brand, enforces consistency |\n| **Documentation** | \"Maybe later\" | Auto-generates docs from your code |\n| **Self-improvement** | Static — what you install is what you get | Learns from feedback, gets better over time |\n\n---\n\n## Built For Builders, Not Coders\n\nCodyMaster was built for people who **have ideas, not CS degrees**.\n\n**You're a good fit if you:**\n- Want to type a message and get a working product back\n- Want your AI to learn from its mistakes\n- Don't want to manually review every line of AI output\n- Want to deploy with confidence, not prayer\n\n**You're NOT a good fit if you:**\n- Enjoy doing the same setup for every project\n- Prefer slow, manual deploys with no safety net\n- Like re-explaining your codebase every morning\n\n---\n\n## The 10-Second Tour\n\nInstead of listing 50+ skills, here's what CodyMaster does in plain language:\n\n### 💡 Before You Build\n- **Thinks before coding** — asks questions, challenges your assumptions, saves you from building the wrong thing\n- **Plans the architecture** — diagrams, data flow, edge cases — all before writing code\n\n### 🎨 While Building\n- **Enforces your design system** — consistent colors, fonts, spacing across every page\n- **Writes tests first** — catches bugs before they exist\n- **Debugs systematically** — traces the root cause, doesn't guess\n\n### 🚀 Before Shipping\n- **Scans for secrets** — no API keys leaking to GitHub\n- **Checks the right account** — no accidental deploys to the wrong Cloudflare\n- **Runs quality gates** — no deploy without passing tests + performance checks\n\n### 📈 After Shipping\n- **Generates documentation** — reads your code, writes the docs\n- **Learns from feedback** — gets smarter with every project\n- **Runs retrospectives** — captures what worked, what didn't, improves the process\n\n📖 [Full skill reference →](skills/)\n\n---\n\n## The Design Pipeline\n\nCodyMaster treats design as a **first-class discipline** — not an afterthought. Your AI doesn't just write code; it enforces visual consistency across every page.\n\n**Three ways to get a design system:**\n\n| Method | When to Use | How |\n|--------|-------------|-----|\n| **Extract from URL** | You have an existing brand/site | `cm-open-design` analyzes your site, extracts colors, fonts, spacing |\n| **Pick from 129 systems** | You want a proven aesthetic | Choose from Linear, Stripe, Vercel, Notion, Apple, Tesla, and 123 more |\n| **Choose a direction** | You have no brand yet | Pick from 5 curated styles: Editorial, Modern Minimal, Warm Soft, Tech Utility, Brutalist |\n\n```\nExtract → Tokens → Validate → Build → QA\n   │          │         │          │       │\n   │          │         │          │       └─ cm-quality-gate\n   │          │         │          └─ cm-execution\n   │          │         └─ cm-ux-master (48 UX laws)\n   │          └─ cm-design-system (STITCH_TOKENS)\n   └─ cm-open-design (129 systems + extraction)\n```\n\n📖 [Full design pipeline guide →](docs/design-pipeline.md)\n\n---\n\n## Real-World Scenarios\n\n| You Say | What Happens |\n|---------|-------------|\n| *\"Fix this bug\"* | `cm-debugging` finds root cause → `cm-tdd` writes test → `cm-quality-gate` verifies |\n| *\"Build a landing page\"* | `cm-brainstorm-idea` → `cm-design-system` → `cm-execution` → `cm-safe-deploy` |\n| *\"Make it look like Stripe\"* | `cm-open-design` extracts Stripe tokens → `cm-design-system` applies → `cm-execution` builds |\n| *\"Deploy to production\"* | `cm-secret-shield` → `cm-security-gate` → `cm-identity-guard` → `cm-safe-deploy` |\n| *\"What does this code do?\"* | `cm-codeintell` reads the codebase → `cm-dockit` generates docs |\n| *\"Add Vietnamese support\"* | `cm-safe-i18n` extracts strings → translates → validates → ships |\n| *\"Start a new project\"* | `cm-project-bootstrap` scaffolds → `cm-planning` plans → `cm-execution` builds |\n\n---\n\n## Install\n\n### One command\n\n```bash\nnpm install -g codymaster && cm\n```\n\n### What the wizard does\n\n1. **Detects** every AI tool you have (Claude Code, Cursor, Gemini CLI, Codex, OpenCode, Windsurf, Cline, Aider, Continue, Kiro, Amazon Q, Amp, Copilot, Claude Desktop)\n2. **Asks** which ones you want skills for (pre-checked for detected tools)\n3. **Installs** to each platform's native location\n4. **Done** — open your AI agent and start building\n\n### After install\n\n```bash\ncm doctor          # Check what's installed\ncm status          # See your tasks and progress\ncm dashboard       # Open the visual dashboard\n```\n\n### For OpenCode users\n\nOpenCode supports both skills and plugins:\n\n```bash\ngit clone https://github.com/tody-agent/codymaster.git ~/.cody-master\n\n# Skills (auto-load)\nln -s ~/.cody-master/.opencode/skills ~/.opencode/skills\n\n# Plugins (optional — adds custom tools)\nmkdir -p ~/.opencode/plugins\nln -s ~/.cody-master/.opencode/plugins/cm-brainstorm-idea.ts ~/.opencode/plugins/\n```\n\nRestart OpenCode to activate. The `cm-brainstorm-idea` plugin adds a strategic analysis tool with auto-detection for brainstorm keywords.\n\n📖 [Full OpenCode installation guide →](.opencode/INSTALL.md)\n\n### For Codex users\n\nFastest path:\n\n```bash\ngit clone https://github.com/tody-agent/codymaster.git ~/.cody-master\ncd ~/.cody-master\nnpm ci\nnpm run build:platforms\n```\n\nThen tell Codex:\n\n```text\nFetch and follow instructions from https://raw.githubusercontent.com/tody-agent/codymaster/main/.codex/INSTALL.md\n```\n\nOr use the local Codex skill tree directly at `.codex/skills/`.\n\n### No Node.js?\n\n```bash\nbash <(curl -fsSL https://raw.githubusercontent.com/tody-agent/codymaster/main/install.sh) --all --profile core\n```\n\n### What's in the package\n\n- **50+ skills** — ready-to-use SKILL.md files for every major AI coding agent\n- **CLI (`cm`)** — install wizard, doctor, dashboard, MCP server, browse daemon\n- **Skill profiles** — curated bundles: `core`, `growth`, `full`, `knowledge`\n- **Multi-platform** — installs to Claude Code, Cursor, Gemini, Codex, OpenCode, Windsurf, Cline, Aider, Continue, Kiro, Amazon Q, Amp, Copilot, Claude Desktop\n- **Zero config** — detects your tools, installs skills, you're done\n\n---\n\n## The Dashboard\n\nVisual mission control for your projects:\n\n```\n┌─────────────────────────────────────────────┐\n│           📊 CodyMaster Dashboard           │\n│  Tasks │ Progress │ Tokens │ Logs           │\n└─────────────────────────────────────────────┘\n```\n\n```bash\ncm dashboard start   # Start the dashboard\ncm dashboard open    # Open in browser\n```\n\nTrack tasks, monitor progress, see what your AI team is doing — all in one screen.\n\n---\n\n## How It Works Under the Hood\n\nFor the curious (skip this if you just want to build):\n\n- **Memory System** — Your AI remembers your project across sessions. No more re-explaining.\n- **Skill Chaining** — Skills talk to each other. Planning feeds into design, design feeds into code, code feeds into tests.\n- **Behavioral Discipline** — Inspired by [Andrej Karpathy's AI coding rules](https://x.com/karpathy/status/2015883857489522876). Your AI thinks before coding, keeps things simple, makes surgical changes.\n- **Multi-Layer Safety** — Tests → security scan → staging → production. Each layer catches what the previous missed.\n- **Self-Healing** — Skills learn from failures and improve over time.\n\n📖 [Architecture deep dive →](docs/architecture/codymaster-brain.md)\n\n---\n\n## For Teams & Advanced Users\n\n### Multiple AI Agents\n\nWorks with 14+ platforms out of the box:\n\n```bash\ncm install claude-code --profile core\ncm install cursor --profile growth\ncm install gemini --profile full\n```\n\n### MCP Server\n\nUse CodyMaster as an MCP server for Claude Desktop:\n\n```bash\nnpx codymaster mcp-serve --install-claude\n```\n\n### Goose Integration\n\n```bash\ncm mcp-serve --print-config  # Paste into Goose config\n```\n\n📖 [All integrations →](docs/integrations/)\n\n---\n\n## CLI Commands\n\n| Command | Description |\n|---------|-------------|\n| `cm` | Launch interactive wizard (auto-detect AI tools) |\n| `cm doctor` | Check installation health across all platforms |\n| `cm status` | View current tasks and progress |\n| `cm dashboard` | Open visual mission control |\n| `cm install <platform> --profile <name>` | Install skills to a specific platform |\n| `cm update --full` | Update all skills to latest |\n| `cm upgrade` | Upgrade CodyMaster itself |\n| `cm mcp-serve` | Run as MCP server for Claude Desktop |\n| `cm browse` | Open a URL in the browse daemon |\n| `cm browse screenshot <url>` | Capture a screenshot |\n| `cm browse snapshot <url>` | Get accessibility tree snapshot |\n\n### Skill Profiles\n\n| Profile | Skills | Best For |\n|---------|--------|----------|\n| `core` | 15 | Daily coding — planning, TDD, debug, review, deploy |\n| `growth` | 25 | + design system, i18n, content factory |\n| `full` | 50+ | Everything — full senior team |\n| `knowledge` | 10 | Docs, code intelligence, retros |\n\n```bash\ncm install claude-code --profile core\ncm install cursor --profile growth\ncm install gemini --profile full\n```\n\n---\n\n## Troubleshooting\n\n### `cm: command not found`\n\n```bash\n# Make sure global npm bin is in PATH\nnpm config get prefix\n# Add the output bin/ folder to your PATH\n```\n\n### Skills not showing in AI agent\n\n```bash\ncm doctor          # Check what's installed where\ncm install --all   # Re-install to all detected platforms\n```\n\n### Build fails\n\n```bash\nnpm run build      # Rebuild TypeScript\nnpm run test:gate:kit  # Run full quality gate\n```\n\n### Permission errors (macOS/Linux)\n\n```bash\nsudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share}\n```\n\n---\n\n## Contributing\n\n1. ⭐ **Star the repo** — helps more builders find this\n2. Fork → Create `skills/cm-your-skill/SKILL.md`\n3. Submit a Pull Request\n\nCI runs `npm run test:gate:kit` on every push and PR.\n\n---\n\n## Resources\n\n| Resource | Link |\n|----------|------|\n| 🌍 Website | [cody.todyle.com](https://cody.todyle.com) |\n| 📖 Docs | [cody.todyle.com/docs](https://cody.todyle.com/docs) |\n| 📘 Repo Docs | [docs/index.md](docs/index.md) |\n| 🎨 Design Pipeline | [docs/design-pipeline.md](docs/design-pipeline.md) |\n| 🛠️ Skills | [skills/](skills/) |\n| 📖 Our Story | [cody.todyle.com/story](https://cody.todyle.com/story) |\n| 📋 Changelog | [CHANGELOG.md](CHANGELOG.md) |\n| 🐛 Issues | [GitHub Issues](https://github.com/tody-agent/codymaster/issues) |\n\n---\n\n## Who Built This\n\n**Tody Le** — Head of Product with 10+ years of experience. Can't write code. Used AI to build real products for 6 months straight. Every skill in this kit was born from a real failure that cost real time and real tears.\n\n> *\"50+ skills. Each skill is a lesson. Each lesson is a sleepless night. And now, you don't have to go through those nights.\"*\n\n---\n\n*ISC License — Free to use, modify, and distribute.*\n\n**Built with ❤️ for the vibe coding community.**\n\n*\"CodyMaster\" = \"Code Đi\" (Vietnamese: \"Go code!\") — just start building.*\n",
  "bytes": 16565,
  "sha": "edf1d555e3a19ee05b22b42995476ac7701509cd06ead965aa95949a84ba1e7d",
  "repo_slug": "tody-agent/codymaster",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_tody_agent_codymaster_b6225384/readme"
}