MeowKit
ngocsangyem/MeowKit
Production ready. AI Agent Workflow System for Claude Code
Instalação
npx convez-ai ngocsangyem/MeowKit1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
README
A tradução para o português deste README ainda está na fila.
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
npx mewkit init
The CLI fetches the latest release from GitHub, prompts for config, and scaffolds .claude/ into your project.
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/ 104 skills (mk: namespace)
│ ├── rules/ 23 enforcement rules
│ ├── hooks/ 17 hook scripts — lifecycle hooks + handlers + libraries
│ ├── commands/ 24 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
- gstack — Skills, review patterns, ship workflow
- antigravity-kit — Clean code standards, vulnerability scanning
- aura-frog — Agent detection, workflow orchestration
- claudekit-engineer — Cook/fix pipelines, release model