Skip to content

Codebase Analysis โ€‹

Quick Reference

  • Project: Cody Master v3.2.0
  • Type: CLI Tool + Express Dashboard + Skills Framework
  • Languages: TypeScript, HTML, CSS, JavaScript
  • Frameworks: Commander.js (CLI), Express.js (Dashboard)
  • Lines of Code: ~4,500+ (core TypeScript)

Architecture Overview โ€‹

Three-layer architecture: Presentation (landing page + dashboard), Business Logic (CLI + REST API + Judge), Data (JSON file store + skills library).

Directory Structure โ€‹

cody-master/
โ”œโ”€โ”€ src/                    # Core TypeScript source
โ”‚   โ”œโ”€โ”€ index.ts            # CLI entry point (1536 lines)
โ”‚   โ”œโ”€โ”€ dashboard.ts        # Express REST server (710 lines)
โ”‚   โ”œโ”€โ”€ continuity.ts       # Working memory system
โ”‚   โ”œโ”€โ”€ judge.ts            # Judge Agent evaluation
โ”‚   โ”œโ”€โ”€ skill-chain.ts      # Multi-skill pipeline engine
โ”‚   โ”œโ”€โ”€ agent-dispatch.ts   # Task โ†’ AI Agent dispatch
โ”‚   โ”œโ”€โ”€ data.ts             # JSON data store
โ”‚   โ””โ”€โ”€ chains/             # Chain definitions
โ”œโ”€โ”€ public/                 # Landing page website
โ”‚   โ”œโ”€โ”€ index.html          # Main landing page
โ”‚   โ”œโ”€โ”€ skills.html         # Skills catalog
โ”‚   โ”œโ”€โ”€ story.html          # Origin story
โ”‚   โ”œโ”€โ”€ demo.html           # Demo page
โ”‚   โ”œโ”€โ”€ start.html          # Getting started
โ”‚   โ”œโ”€โ”€ persona.html        # Persona detail pages
โ”‚   โ”œโ”€โ”€ dashboard/          # Dashboard SPA
โ”‚   โ”œโ”€โ”€ css/                # Stylesheets
โ”‚   โ”œโ”€โ”€ js/                 # Client-side JavaScript
โ”‚   โ”œโ”€โ”€ i18n/               # Translation files (6 languages)
โ”‚   โ””โ”€โ”€ img/                # Assets
โ”œโ”€โ”€ skills/                 # 30+ AI Agent Skills
โ”‚   โ”œโ”€โ”€ cm-tdd/             # Test-Driven Development
โ”‚   โ”œโ”€โ”€ cm-debugging/       # Root cause investigation
โ”‚   โ”œโ”€โ”€ cm-planning/        # Implementation planning
โ”‚   โ”œโ”€โ”€ cm-execution/       # Autonomous execution
โ”‚   โ””โ”€โ”€ ...                 # 25+ more skills
โ”œโ”€โ”€ adapters/               # Platform-specific configs
โ”‚   โ”œโ”€โ”€ antigravity.js      # Google Antigravity adapter
โ”‚   โ”œโ”€โ”€ claude-code.js      # Claude Code adapter
โ”‚   โ””โ”€โ”€ cursor.js           # Cursor adapter
โ”œโ”€โ”€ docs/                   # This documentation
โ”œโ”€โ”€ test/                   # Test suite
โ”œโ”€โ”€ dist/                   # Compiled output
โ”œโ”€โ”€ package.json            # Project manifest v3.2.0
โ”œโ”€โ”€ tsconfig.json           # TypeScript config
โ”œโ”€โ”€ vitest.config.ts        # Test framework config
โ””โ”€โ”€ wrangler.toml           # Cloudflare Pages config

Dependencies โ€‹

CategoryPackageVersionPurpose
Corecommander^14.0.3CLI framework
Coreexpress^5.2.1HTTP server for dashboard
Corechalk^5.6.2Terminal coloring
Coreprompts^2.4.2Interactive CLI prompts
Buildtypescript^5.9.3TypeScript compiler
Buildts-node^10.9.2TypeScript runtime
Testvitest^4.1.0Test framework
Testjsdom^29.0.1DOM testing
Testacorn^8.16.0JS parser for testing

Key Files โ€‹

FileRoleLines
src/index.tsCLI entry โ€” all commands~1,536
src/dashboard.tsExpress REST API server~710
src/continuity.tsWorking memory (CONTINUITY.md)~500+
src/judge.tsTask health evaluation~400+
src/skill-chain.tsMulti-skill pipeline engine~350+
src/agent-dispatch.tsTask dispatch to AI agents~250+
src/data.tsJSON data store + types~200+

Route Map (Dashboard REST API) โ€‹

MethodPathHandlerDescription
GET/api/projectsDashboardList all projects
POST/api/projectsDashboardCreate project
GET/api/tasksDashboardList tasks
POST/api/tasksDashboardCreate task
PUT/api/tasks/:id/moveDashboardMove task (kanban)
POST/api/tasks/:id/transitionDashboardTransition task state
POST/api/tasks/:id/dispatchDashboardDispatch task to AI agent
GET/api/judgeJudgeEvaluate all tasks
GET/api/judge/:taskIdJudgeEvaluate single task
GET/api/agents/suggestJudgeSuggest best agent
GET/api/continuityContinuityAll projects' memory
POST/api/continuity/:projectIdContinuityUpdate working memory
GET/api/deploymentsDashboardDeploy history
POST/api/deploymentsDashboardRecord deployment
POST/api/deployments/:id/rollbackDashboardRollback a deploy
GET/api/changelogDashboardChangelog entries
GET/api/chainsChainList skill chains
POST/api/chain-executionsChainStart chain execution

Test Coverage โ€‹

FrameworkTest FilesDescription
Vitesttest/frontend-safety.test.tsFrontend safety HTML checks

WARNING

Current test coverage is low โ€” only 1 test file exists. Recommended: add unit tests for judge.ts, continuity.ts, and skill-chain.ts.

Open Source AI Agent Skills Framework