mk

MeowKit

AI agent toolkit for Claude Code
113 skills · 39 agents · 25 commands · 7 modes · 24 rules · 4 conditional rules · 17 hook scripts · 4-layer+ security

---

What is MeowKit

MeowKit installs a .claude/ directory that Claude Code reads at session start. It enforces a structured 7-phase workflow with hard gates, TDD, security scanning, and scoped topic-file memory (fixes.md, review-patterns.md, architecture-decisions.md). Zero external dependencies for core workflow.

Homepage: meowkit.dev  ·  Docs: docs.meowkit.dev

Quick Start

MeowKit installs two ways. Pick one per project — running both resolves the same skills and agents twice (mewkit doctor warns when it detects both).

Flat-copy (default, supported)

npx mewkit init

The CLI fetches the latest release from GitHub, prompts for config, and scaffolds .claude/ into your project. Skills resolve as /mk:*, agents as mk:*.

Native plugin (recommended — Claude Code & Codex)

Installs the mk plugin from the MeowKit marketplace. Skills (/mk:*), agents (mk:*), and hooks all resolve under the plugin; nothing is copied into your project.

# Claude Code
claude plugin marketplace add ngocsangyem/MeowKit
claude plugin install mk@meowkit

# Codex
codex plugin marketplace add ngocsangyem/MeowKit
codex plugin add mk@meowkit

The plugin distribution is generated by mewkit build-plugin (the plugin/ payload + marketplace.json for both runtimes) and staged into each release.

Setup (required for Python skills)

After installing MeowKit, run:

npx mewkit setup

This creates the Python venv at .claude/skills/.venv, installs pip packages (google-genai, pillow, python-dotenv), and interactively prompts for optional system deps (ImageMagick, FFmpeg, Playwright browsers).

Run once per project. Idempotent — safe to re-run after upgrades.

To verify your environment after setup:

npx mewkit doctor     # Verify environment

Packages

Package	npm	Description
mewkit	npx mewkit <cmd>	CLI — init, upgrade, doctor, validate, budget, memory

Requirements

• Node.js 20+
• Python 3.9+ (stdlib only, for validation scripts)
• Git

Project Structure

meowkit/
├── .claude/                  Source of truth — agents, skills, rules, hooks
│   ├── agents/               39 specialist agents
│   ├── skills/               113 skills (mk: namespace)
│   ├── rules/                24 enforcement rules
│   ├── hooks/                17 hook scripts — lifecycle hooks + handlers + libraries
│   ├── commands/             25 slash commands
│   ├── modes/                7 behavioral modes
│   ├── memory/               Machine-local topic files (gitignored; scaffolded by `mewkit setup`)
│   ├── scripts/              Python validators + shell utilities
│   └── settings.json
├── tasks/                    Task templates
├── packages/
│   ├── mewkit/               CLI (npm as mewkit)
│   └── landing/              Landing page (meowkit.dev, Nuxt + Tailwind v4)
├── scripts/                  Release automation
├── website/                  VitePress documentation
├── CLAUDE.md                 Entry point for Claude Code
├── .releaserc.cjs            Semantic release config
└── .github/workflows/        CI/CD (release, beta, PR validation)

Releasing

See RELEASING.md for the complete release guide — manual steps, CI/CD automation, troubleshooting.

Development

npm install              # Install dependencies
npm run build            # Build both packages
npm test                 # Run tests
npm run lint             # Lint
npm run typecheck        # Type check

License

MIT

Inspiration