Skip to content

tody-agent/codymaster

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

128 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

English | Tiแบฟng Viแป‡t | ไธญๆ–‡ | ะ ัƒััะบะธะน | ํ•œ๊ตญ์–ด | เคนเคฟเคจเฅเคฆเฅ€

๐Ÿง  CodyMaster

Your AI Agent is smart. CodyMaster makes it wise.

60+ Skills ยท 20+ Commands ยท 1 Plugin ยท 8+ Platforms ยท 6 Languages ยท v6.0.0

    ( . \ --- / . )
     /   ^   ^   \
    (      u      )
     |  \ ___ /  |
      '--w---w--'
       Meet CodyMaster ๐Ÿน
  Your smart coding companion.

CodyMaster Kanban Dashboard

Discord

๐ŸŒŸ If CodyMaster saves you time, give it a Star! ๐ŸŒŸ


๐Ÿ›‘ The Problem Nobody Talks About

You installed an AI coding agent. It's brilliant. It writes code faster than any human.

But then reality hits:

๐Ÿ˜ค What Actually Happens ๐Ÿ’€ The Real Cost
AI designsdifferently every single time โ€” same brand, 3 different styles Clients think you're 3 different companies
AI fixes one bug,silently breaks 5 other things You redo the same work 3-4 times
AIforgets everything between sessions You re-explain the same codebase every morning
AI writes zero tests, zero docs Your codebase becomes a house of cards
You install 15 different skills โ€”none of them talk to each other Frankenstein toolkit with zero synergy
Deploy to production =deploy and pray ๐Ÿ™ Broken deploys at 2 AM, no rollback

"AI gave me 100 hands. But without discipline, those hands created chaos." โ€” Tody Le, Head of Product ยท 10+ years ยท Creator of CodyMaster


๐ŸŸข The Solution: An Entire Senior Team in One Kit

CodyMaster isn't just "another AI skills pack." It's 10+ years of product management experience + 6 months of battle-tested vibe coding, distilled into 68+ interconnected skills that work as a single integrated system.

When you install CodyMaster, you're not adding skills. You're hiring an entire senior team:

graph TD
    A["๐Ÿง  CodyMaster Kit"] --> B["๐Ÿ‘จโ€๐Ÿ’ป Senior Developer<br/><i>cm-tdd ยท cm-debugging ยท cm-code-review ยท cm-clean-code</i>"]
    A --> C["๐ŸŽจ UX Lead<br/><i>cm-design-system ยท cm-ux-master ยท cm-ui-preview</i>"]
    A --> D["๐Ÿ“‹ Product Manager<br/><i>cm-planning ยท cm-brainstorm-idea ยท cm-jtbd</i>"]
    A --> E["๐Ÿ”’ DevOps Engineer<br/><i>cm-safe-deploy ยท cm-secret-shield ยท cm-security-gate ยท cm-identity-guard</i>"]
    A --> F["๐Ÿ“ Technical Writer<br/><i>cm-dockit ยท cm-content-factory ยท cm-auto-publisher</i>"]
    A --> G["๐Ÿ“ˆ Growth Marketer<br/><i>cm-ads-tracker ยท cm-cro-methodology ยท cm-growth-hacking</i>"]
    A --> H["๐Ÿญ Enterprise Dev<br/><i>cm-booking-calendar ยท cm-google-form</i>"]
    style A fill:#fbc531,stroke:#e1b12c,color:#2f3640,stroke-width:3px
    classDef team fill:#2f3640,stroke:#dcdde1,stroke-width:1px,color:#fff;
    class B,C,D,E,F,G,H team;
Loading

โšก What Makes CodyMaster Different

Other skill packs give you loose tools. CodyMaster gives you an interconnected operating system for your AI โ€” 68+ skills that chain, share memory, and communicate like a real team.

๐Ÿ”„ Full Lifecycle Coverage (Idea โ†’ Production)

No gaps. No manual handoffs. Every phase is covered:

graph LR
    A["๐Ÿ’ก Idea"] --> B["๐Ÿ“‹ Plan"]
    B --> C["๐ŸŽจ Design"]
    C --> D["๐Ÿงช Test First"]
    D --> E["๐Ÿ’ป Code"]
    E --> F["๐Ÿ” Debug"]
    F --> G["โœ… Quality Gate"]
    G --> H["๐Ÿ”’ Security Scan"]
    H --> I["๐Ÿš€ Deploy"]
    I --> J["๐Ÿ“Š Monitor"]
    J --> K["๐Ÿ“ Document"]
    K --> L["๐Ÿง  Learn & Improve"]
    L -.-> A
    classDef phase fill:#353b48,stroke:#fbc531,stroke-width:2px,color:#fff;
    class A,B,C,D,E,F,G,H,I,J,K,L phase;
Loading

๐Ÿง  The Unified Brain: 5-Tier Memory + Smart Spine

Your AI doesn't just execute โ€” it understands and remembers using a multi-scale, 5-Tier + Smart Spine architecture that persists across sessions and machines:

  1. Sensory Memory (Session) โ€” Immediate context of active files and terminals.
  2. Working Memory (cm-continuity) โ€” Cross-session scratchpad. AI never repeats the same mistake.
  3. Long-Term Memory (learnings.json) โ€” Reinforced lessons with smart Ebbinghaus TTL decay.
  4. Semantic Memory (cm-deep-search) โ€” Local vector search across docs using qmd.
  5. Structural Memory (cm-codeintell) โ€” AST-based CodeGraph. Up to 95% token compression for full codebase context.

๐Ÿฆด Smart Spine (v4.6+) โ€” The nervous system connecting all 5 tiers:

  • SQLite + FTS5 โ€” BM25-ranked keyword search replaces flat JSON scans.
  • Progressive Loading (L0/L1/L2) & Smart Brain Router โ€” Context loaded at cheapest sufficient depth via a robust task classifier. Up to 80% token savings on standard workflows.
  • Skill Execution Cache โ€” Warm FTS5 cache tracks successful agent skill chains. Matches bypass token-heavy LLM decision loops for instant task resolution.
  • cm:// URI Scheme โ€” Skills request context by URI, not file paths.
  • Token Budget โ€” 200k window pre-allocated by category. No more silent overflow.
  • Context Bus โ€” Skills share outputs in real-time within a chain.
  • MCP Server โ€” 18 tools exposed to Claude Desktop, Goose, and any MCP client (src/mcp-context-server.ts). Includes memory tools (cm_memory_write, cm_natural) plus advisory JSON surfaces (cm_advisory_report, cm_advisory_metrics, cm_advisory_handoff).
  • Intelligent Skill Selection โ€” selectTopSkills() dynamically picks the 2-3 most task-relevant skills per chain execution. Backed by SkillsBench research: 2-3 focused skills = +18.6pp vs 4+ loaded statically.
  • SQLite-first memory stack โ€” CodyMaster ships a supported default path built on SQLite + FTS5, token-budgeted context loading, and optional qmd / code intelligence layers. The older OpenViking path has been removed from the runtime.

โ˜๏ธ The Cloud Brain (cm-notebooklm) High-value knowledge and design patterns are synced to NotebookLM, providing a universal, cross-machine "Soul" for your project. Auto-generate podcasts and flashcards to onboard human developers alongside the AI.

๐Ÿ“– CodyMaster Brain & memory model โ†’

๐Ÿ›ก๏ธ Multi-Layer Protection (Your Codebase Won't Get Destroyed)

Every line of code passes through multiple safety gates before reaching production:

flowchart LR
    subgraph "Layer 1: Write"
        A["cm-tdd<br/>Tests First"] --> B["cm-code-review"]
    end
    subgraph "Layer 2: Secure"
        B --> C["cm-secret-shield<br/>Leak Scan"] --> S["cm-security-gate<br/>Vuln Scan"] --> D["cm-identity-guard<br/>Right Account"]
    end
    subgraph "Layer 3: Isolate"
        D --> E["cm-git-worktrees<br/>Isolated Branch"]
    end
    subgraph "Layer 4: Deploy"
        E --> F["cm-quality-gate<br/>Evidence Check"] --> G["cm-safe-deploy<br/>Multi-Gate Pipeline"]
    end
    style A fill:#e84118,stroke:#c23616,color:#fff
    style C fill:#e84118,stroke:#c23616,color:#fff
    style F fill:#0097e6,stroke:#00a8ff,color:#fff
    style G fill:#4cd137,stroke:#44bd32,color:#fff
Loading

Result: Zero leaked secrets. Zero wrong-account deploys. Zero "worked on my machine" failures.

๐ŸŽจ Design System Builder โ€” Even From Old Products

Got a legacy product with no design system? cm-design-system scans your website, extracts colors, typography, spacing, and tokens, then rebuilds a proper design system. Preview designs visually with Pencil.dev or Google Stitch before writing a single line of code.

๐Ÿ“ Zero Documentation? No Problem.

Don't know what the old code does? **cm-dockit** reads your entire codebase and generates:

  • ๐Ÿ“š Technical architecture docs
  • ๐Ÿ“– User guides & SOPs
  • ๐Ÿ”Œ API references
  • ๐ŸŽฏ Persona analysis & JTBD mapping
  • ๐ŸŒ Multi-language. SEO-optimized.

One scan = Complete knowledge base.

๐Ÿ’ก Strategic Brainstorming (Design Thinking + 9 Windows)

Before diving into code for complex requests, **cm-brainstorm-idea** evaluates your product using multi-dimensional analysis (Tech, Product, Design, Business). It generates 2-3 qualified options using the 9 Windows (TRIZ) framework and provides a visual UI Preview via Pencil.dev or Google Stitch to validate the direction before detailed planning.

๐Ÿ“– TRIZ-parallel workflow & UI preview handoff โ†’

๐Ÿญ AI Content Factory v2.0 & Visual Dashboard

Need to scale content? **cm-content-factory** is a self-learning, multi-agent content engine. It automatically researches, writes, audits (SEO & Persuasion), and deploys high-converting articles with the Content Mastery framework (StoryBrand + Cialdini) to guarantee conversion.

Track it all on the Visual Dashboard (cm-dashboard): No more guessing. Track every task, every agent, every deployment on a real-time Kanban board. Pipeline progress, token tracker, event log โ€” all on one screen.

๐Ÿงฌ Self-Healing Skills (Recovery, Search, and Evolution)

CodyMaster ships a dedicated self-healing skill family for keeping the skill library usable as the repo evolves.

  • **cm-skill-health** audits a skill's real health from shipped signals: docs drift, broken references, retro notes, validation, and gates.
  • **cm-skill-evolution** (Skill Evolver) completes the autonomy loop with three modes: FIX, DERIVED, and CAPTURED. It modifies, clones, and generates new skills automatically based on analyzer recommendations, paired with anti-loop protection and .md backups.
  • **cm-learning-promoter** searches your database for recurring task struggles and automatically graduates them into permanently coded skills (cm-learned-*) when appropriately reinforced.
  • **cm advisory report / metrics / handoff** turn execution telemetry into a reviewable operator loop before any skill repair begins.
  • Integrated Evolution commands (cm evolve run/status/promote) give immediate insight into all mutations.
  • **cm-skill-chain Auto-Dispatch** โ€” sequence dispatching remains automated with task detection and multi-step handoffs.
  • **cm-skill-search** finds the best skill through cm suggest, skill indexes, and repo search.
  • **cm-skill-share** packages a skill safely across repos and machines without dropping companion files.

Think of it like an immune system for your AI toolkit. First inspect the telemetry, then diagnose the skill, then repair it deliberately, then capture the learning.

๐Ÿš€ Growth Hacking Engine

Need popups, booking flows, or lead capture? **cm-growth-hacking** generates complete conversion systems: Bottom Sheet + Calendar CTA + Tracking. Auto-detects industry, selects the right pattern, wires up **cm-booking-calendar** for appointments and **cm-ads-tracker** for pixel tracking. Zero dependencies.


๐Ÿ†š Scattered Skills vs CodyMaster

๐Ÿ˜ต 15 Random Skills ๐Ÿง  CodyMaster
Integration Each skill is standalone, no shared context 68+ skills that chain, share memory, and communicate
Lifecycle Covers coding only Covers Idea โ†’ Design โ†’ Code โ†’ Test โ†’ Deploy โ†’ Docs โ†’ Learn
Memory Forgets everything between sessions 5-tier Unified Brain: Sensory โ†’ Working โ†’ Long-term โ†’ Semantic โ†’ Structural + Cloud Brain, powered by SQLite + FTS5 by default with optional local semantic layers like qmd.
Safety YOLO deploys 4-layer protection: TDD โ†’ Security โ†’ Isolation โ†’ Multi-gate deploy
Design Random UI every time Extracts & enforces design system + visual preview
Documentation "Maybe write a README later" Auto-generates complete docs, SOPs, API refs from code
Self-improvement Static โ€” what you install is what you get Advisory-driven self-healing: inspect telemetry โ†’ diagnose โ†’ repair with FIX / DERIVED / CAPTURED
Maintenance Update 15 repos separately One npm i -g codymaster updates everything

๐Ÿฆฅ Built For Lazy People (Seriously)

We're going to be honest: CodyMaster was built for lazy people.

If you want to:

  • โœ… Type a chat message and get a working product back
  • โœ… Have your AI learn from its mistakes and get better every day
  • โœ… Never setup the same boilerplate twice
  • โœ… Deploy with confidence instead of praying

โ†’ CodyMaster is for you.

If you prefer:

  • โŒ Manually reviewing every line of AI output
  • โŒ Doing the same setup ritual for every project
  • โŒ Slow, manual deploys with no safety net

โ†’ CodyMaster is NOT for you.


๐Ÿš€ 1-Minute Install

โœจ NEW: Claude Desktop Plugin (Zero Terminal Required)

The easiest way to install CodyMaster โ€” no npm, no terminal, no setup.

Claude Desktop / Claude Cowork:

Run the auto-installer to inject the MCP Servers into your Claude Desktop config automatically:

npx codymaster mcp-serve --install-claude

All 68+ skills will be wired up instantly via MCP stdio. Remember to restart Claude Desktop to load the new config.


2. Install AI Skills (All Other Platforms)

CodyMaster uses Native Plugin Extensions for zero-friction installation. No bash scripts, no manual folder copying. Select your platform below:

Claude Code CLI:

claude plugin marketplace add tody-agent/codymaster
claude plugin install cm@codymaster --scope user

Cursor (in Agent Chat):

/add-plugin cody-master

Gemini CLI / Google Antigravity:

gemini extensions install https://github.com/tody-agent/codymaster

(Progressive disclosure: Add @~/.gemini/antigravity/skills/cm-skill-index/SKILL.md to your GEMINI.md to save tokens)

OpenCode / OpenClaw: Tell your agent:

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

Codex: Tell your agent:

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

3. Install Mission Control Dashboard (Optional but Recommended)

Visualize your progress, manage tasks, and track your 10x coding streak with Cody the Hamster ๐Ÿน.

Both are official: install per project (no -g) or globally.

Per project โ€” keeps the CLI version with the repo (use npx so you do not need cm on your PATH):

npm install codymaster
npx cm

Global โ€” type cm from any directory:

npm install -g codymaster
cm

The CLI will greet you and keep you organized on your long coding sessions!

    ( . \ --- / . )
     /   ^   ^   \        Hi! I'm Cody ๐Ÿน
    (      u      )        Your smart coding companion.
     |  \ ___ /  |
      '--w---w--'

โ”‚
โ—†  Quick menu
โ”‚  โ— ๐Ÿ“Š  Dashboard (Start & open)
โ”‚  โ—‹ ๐Ÿ“‹  My Tasks
โ”‚  โ—‹ ๐Ÿ“ˆ Status
โ”‚  โ—‹ ๐Ÿงฉ  Browse Skills

Use with Goose

CodyMaster works as a Goose MCP extension, giving Goose persistent memory, skill orchestration, and token management.

3-step setup:

# 1. Install CodyMaster
npm install -g codymaster

# 2. Get your Goose config snippet
cm mcp-serve --print-config

# 3. Paste the output into your Goose config (~/.config/goose/config.yaml)

See full Goose integration guide for details.


๐ŸŽฏ Real-World Use Cases

Tip: Start any session with /cm:start <your goal> and CodyMaster will pick the right skills automatically.

Scenario Skills Used What You Say
๐Ÿ› Fix a bug without breaking anything cm-debugging โ†’ cm-tdd โ†’ cm-quality-gate "Debug this crash"
๐Ÿš€ Ship a feature safely cm-planning โ†’ cm-tdd โ†’ cm-code-review โ†’ cm-safe-deploy "Build the login flow"
๐ŸŽจ Build a new UI from scratch cm-ux-master โ†’ cm-design-system โ†’ cm-ui-preview "Design the dashboard page"
๐Ÿ”’ Deploy to production cm-secret-shield โ†’ cm-security-gate โ†’ cm-identity-guard โ†’ cm-safe-deploy "Deploy to prod"
๐Ÿ“ Understand a legacy codebase cm-codeintell โ†’ cm-dockit "What does this code do?"
๐Ÿ“ˆ Launch a landing page cm-brainstorm-idea โ†’ cm-cro-methodology โ†’ cm-content-factory "Build a landing page for my SaaS"
๐ŸŒ Add multi-language support cm-safe-i18n "Add Vietnamese and Japanese"
๐Ÿ”„ Start a new project cm-project-bootstrap โ†’ cm-planning "Bootstrap a Next.js SaaS"
๐Ÿง  Resume after a break cm-continuity โ†’ cm-status "What was I working on?"
๐Ÿญ Scale SEO content cm-content-factory โ†’ cm-auto-publisher โ†’ cm-ads-tracker "Create 20 articles for my blog"

๐Ÿงฐ The 60+ Skill Arsenal

Domain Skills
๐Ÿ”ง Engineering cm-tdd cm-debugging cm-quality-gate cm-test-gate cm-code-review cm-clean-code
โš™๏ธ Operations cm-safe-deploy cm-identity-guard cm-secret-shield cm-security-gate cm-git-worktrees cm-terminal cm-safe-i18n
๐ŸŽจ Product & UX cm-planning cm-design-system cm-ux-master cm-ui-preview cm-project-bootstrap cm-jtbd cm-brainstorm-idea cm-dockit cm-readit
๐Ÿ“ˆ Growth & CRO cm-content-factory cm-auto-publisher cm-ads-tracker cm-cro-methodology cm-growth-hacking cm-booking-calendar cm-google-form
๐Ÿข Enterprise cm-reactor cm-notebooklm
๐Ÿงฌ Self-Healing cm-skill-health cm-skill-evolution cm-skill-search cm-skill-share cm-skill-chain cm-skill-mastery cm-skill-index
๐ŸŽฏ Orchestration cm-execution cm-continuity cm-deep-search cm-codeintell cm-how-it-work
๐Ÿ–ฅ๏ธ Workflow cm-start cm-dashboard cm-status

๐ŸŽฎ Commands

Run cm --help (or node dist/index.js --help from a clone) for the authoritative list. Highlights from src/cli/command-registry.ts:

cm, codymaster              โ†’ CLI entry
cm status                   โ†’ Task & project summary
cm task <cmd> [args...]     โ†’ Task management
cm project <cmd> [args...]  โ†’ Project management
cm deploy <cmd> [args...]   โ†’ Deploy / rollback / history / changelog
cm dashboard [start|stop|status|open|url] โ†’ Mission Control (default :6969)
cm agent [status|memory|brain|learn]      โ†’ Working memory / learnings
cm brain                    โ†’ Continuity + next actions
cm chain <cmd> [args...]    โ†’ Skill chain execution
cm config [key] [value]   โ†’ Config helper
cm open                     โ†’ Open dashboard in browser
cm browse โ€ฆ                 โ†’ Local Playwright browse daemon (QA)
cm guardian โ€ฆ               โ†’ Destructive-command / path checks
cm index skills             โ†’ Zero-Token tech stack and skill local indexer
cm sprint โ€ฆ                 โ†’ Sprint pipeline + .cm/sprint
cm design-studio [init|status]
cm distro validate โ€ฆ        โ†’ Validate skill pack layout

Memory, bus, budgets, cm:// resolution: use the MCP context server โ€” see docs/api/api-reference.md.

Engineering (browse, guardian, sprint): docs/workflows/engineering-pipeline.md ยท docs/browse-daemon.md ยท docs/workflows/guardian-hooks.md ยท docs/architecture/servers-and-mcp.md

Legacy configs that still say storage.backend: viking are automatically routed back to SQLite.

Slash Commands (inside AI agents):

/cm:demo         โ†’ Interactive onboarding tour
/cm:plan         โ†’ Plan a feature with analysis
/cm:build        โ†’ Build with strict TDD
/cm:debug        โ†’ Systematic debugging
/cm:ux           โ†’ Design system extraction & UI preview

๐Ÿ‘ค Who Built This

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.

"68+ skills. Each skill is a lesson. Each lesson is a sleepless night. And now, you don't have to go through those nights."

๐Ÿ“– Read the full story โ†’


๐Ÿ“š Resources


๐Ÿค Contributing

  1. โญ Star the repo โ€” it helps more builders find this
  2. Fork โ†’ Create skills/cm-your-skill/SKILL.md
  3. Submit a Pull Request

CI runs npm ci and npm run test:gate:kit on pushes and pull requests (see .github/workflows/ci.yml).


ISC License โ€” Free to use, modify, and distribute.

Built with โค๏ธ for the vibe coding community.

"CodyMaster" = "Code ฤi" (Vietnamese: "Go code!") โ€” just start building.

About

Vibe Coding Framework - Full SaaS Development Team from A-Z with Brain, Self Improvement, Auto Development

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors