Agent Kit

🚀 The Ultimate AI Agent System for Modern Development

20 Agents • 104 Skills • 21 Workflows • Multi-Platform Support

⚡ Quick Install

# Prerequisite: Ensure Python 3.10+ is installed
python3 --version

# Step 1: Initialize Agent Kit
npx @musashishao/agent-kit init

Or install globally:

npm install -g @musashishao/agent-kit
agent-kit init

This installs the .agent folder containing all templates into your project.

📦 What's Included

| Component | Count | Description | |-----------|-------|-------------| | Agents | 20 | Specialist AI personas (frontend, backend, security, etc.) | | Skills | 104 | Domain-specific knowledge modules | | Intelligence | 4 | RAG, Knowledge Graph, Memory, and Verification Gate | | Workflows | 21 | Slash command procedures | | Templates | 4 | Project templates (web, mobile, backend) |

🔗 Multi-Platform Support

Agent Kit works seamlessly with multiple AI coding assistants:

| Platform | Status | Config File | |----------|--------|-------------| | Codex CLI | ✅ Full Support | AGENTS.md | | Gemini CLI | ✅ Full Support | GEMINI.md | | Cursor | ✅ Compatible | .cursor/rules | | Claude Code | ✅ Compatible | CLAUDE.md | | Aider | ✅ Compatible | AGENTS.md |

🎯 Codex CLI Integration

Quick Setup

# Step 1: Install Agent Kit
npx @musashishao/agent-kit init

# Step 2: Generate AGENTS.md for your project
npx @musashishao/agent-kit codex --template web

# Step 3: Sync workflows as slash commands
npx @musashishao/agent-kit setup-codex

# Step 4: Verify installation
npx @musashishao/agent-kit doctor

Available Templates

| Template | Command | Use Case | |----------|---------|----------| | Web | codex --template web | Next.js, React, Tailwind | | Mobile | codex --template mobile | React Native, Flutter | | Backend | codex --template backend | Node.js, Express, APIs | | Default | codex | Generic projects |

Using Workflows in Codex CLI

After running setup-codex, use Agent Kit workflows as slash commands:

# Create new features
/kit-create blog with authentication

# Debug issues
/kit-debug why login returns 401

# Design premium UI
/kit-ui-ux-pro-max dashboard with glassmorphism

# Quality optimization
/kit-quality create production-ready checkout

🛠 CLI Commands

| Command | Description | |---------|-------------| | init | Install .agent folder into your project | | codex | Generate AGENTS.md for Codex CLI | | setup-codex | Sync workflows with Codex CLI slash commands | | mcp | MCP server management | | agents | List all available agents | | skills | List all skills by category | | workflows | List all workflows | | doctor | Health check and diagnostics | | update | Update to the latest version | | status | Check installation status | | sync | Advanced Sync (Graph + RAG + Memory) | | memory | Manage JSON Memory & Session state | | set-lang | Set Agent & Workflow language (vi/en) |

Options

# Codex template options
agent-kit codex --template web      # Web application
agent-kit codex --template mobile   # Mobile app
agent-kit codex --template backend  # Backend API
agent-kit codex --force             # Overwrite existing

# Init options
agent-kit init --force              # Overwrite existing .agent folder
agent-kit init --path ./myapp       # Install in specific directory

# Setup-codex options
agent-kit setup-codex --prefix my-  # Custom prefix for slash commands

# Memory management
agent-kit memory get --type session # View current session state
agent-kit memory update-task --task "X" --status "completed"

# Language management
agent-kit set-lang vi               # Switch to Vietnamese
agent-kit set-lang en               # Switch to English (default)

🌐 Localization & Multi-language

Agent Kit now supports full localization for the AI experience.

Supported Languages

• 🇺🇸 English (en) - Default
• 🇻🇳 Vietnamese (vi) - Professional translation

How it works

Running ak set-lang vi performs three actions:

1. AI Instruction Update: Updates GEMINI.md logic to ensure the AI responds in your chosen language.
2. Workflow Swapping: Physically updates the description field in all .agent/workflows/*.md files so that CLI tools (Codex, Antigravity) display localized help text.
3. Internal Config: Saves preference to .agent/memory/user.json.

Note: If ak command is outdated, use npx @musashishao/agent-kit@latest set-lang vi

🔌 MCP Integration

Agent Kit includes built-in MCP (Model Context Protocol) servers to extend your AI assistant's capabilities.

Quick Setup

# Build MCP servers
npx @musashishao/agent-kit mcp build

# Configure for Claude Desktop
npx @musashishao/agent-kit mcp setup --client claude

# Restart Claude Desktop

Built-in Servers

| Server | Tools | Description | |--------|-------|-------------| | agent-kit-core | 7 | Project analysis, agents/skills listing | | agent-kit-git | 5 | Git operations (status, diff, log) | | agent-kit-fs | 5 | File system operations |

MCP Commands

# Server management
mcp setup --client claude  # Configure for Claude/Cursor
mcp build                  # Build all servers
mcp list                   # List available servers
mcp status                 # Check status

# Templates
mcp create my-api --type api      # Create API server
mcp create my-db --type database  # Create DB server
mcp templates                     # List templates

# Registry
mcp search github                 # Search npm registry
mcp install @anthropic/mcp-server-github  # Install from npm
mcp featured                      # Show featured servers

Available Templates

| Template | Description | |----------|-------------| | api | REST API integration | | database | SQLite/PostgreSQL connector | | web-scraper | Web page scraper | | custom | Minimal starter template |

📁 Project Structure

.agent/
├── agents/          # 16 Specialist Agents
├── skills/          # 42 Skills
├── memory/          # 🧠 AI Session & State
├── workflows/       # 17 Slash Commands
├── rules/           # Platform-specific rules
│   ├── CODEX.md    # Codex CLI rules
│   └── GEMINI.md   # Gemini CLI rules
├── templates/       # Project templates
└── ARCHITECTURE.md  # Full documentation

🎯 Usage

Using Agents

Mention an agent by name to invoke specialized expertise:

Use the @security-auditor to review authentication
Use the @frontend-specialist to analyze React components
Use the @debugger to fix the login issue

Using Skills

Skills are loaded automatically based on task context. The AI reads skill descriptions and applies relevant knowledge.

Using Workflows

Invoke localized workflows with slash commands:

| Command | Description | |---------|-------------| | /autofix | Autonomous self-healing loop for failed commands | | /brainstorm | Structured brainstorming for projects and features | | /context | Auto-generate optimal context for complex tasks | | /create | Create new applications with AI-Ready infra | | /dashboard | Create and view visual project dashboards | | /debug | Systematic problem investigation and root cause analysis | | /deploy | Production deployment with pre-flight checks | | /enhance | Add or update features in an existing app | | /next | Suggest the next logical steps for development | | /orchestrate | Coordinate 3+ specialized agents for complex tasks | | /plan | Create detailed project plans and task breakdowns | | /preview | Manage local development and preview servers | | /quality | Optimize context and output for high-quality results | | /spec | Create specification documents before planning | | /status | Display project and agent health status | | /test | Generate and execute comprehensive test suites | | /ui-ux-pro-max | Professional UI/UX planning with 50+ styles |

💡 Tip: Use ak set-lang vi to see these descriptions in Vietnamese!

Example:

/kit-create landing page with hero section
/kit-debug why login fails
/kit-ui-ux-pro-max dashboard with glassmorphism

🌐 Platform Setup Guides

Gemini CLI

# Install Agent Kit
npx @musashishao/agent-kit init

# Configure Gemini settings
echo '{ "contextFileName": ".agent/rules/GEMINI.md" }' > .gemini/settings.json

Cursor IDE

# Install Agent Kit
npx @musashishao/agent-kit init

# Copy rules to Cursor
mkdir -p .cursor/rules
cp .agent/rules/GEMINI.md .cursor/rules/agent-kit.md

Claude Code

# Install Agent Kit
npx @musashishao/agent-kit init

# Copy rules for Claude
cp .agent/rules/GEMINI.md CLAUDE.md

📊 Quality Validation

Ensure your setup is optimal:

# Run health check
npx @musashishao/agent-kit doctor

# Run quality validator
python3 .agent/skills/context-engineering/scripts/quality_validator.py .

Expected output:

📊 Summary
  Passed: 32/32 (100%)
  ✓ Excellent! Agent Kit is fully configured for Codex CLI.

📚 Documentation

• Website: agent-kit.musashi.works
• AGENTS.md: Project root
• ARCHITECTURE.md: .agent/ARCHITECTURE.md
• Platform Guides: /docs/platforms/

🤝 Contributing

We welcome contributions! Please see .agent/ARCHITECTURE.md for guidelines.

License

MIT © Musa (musashishao)