https://github.com/ngocsangyem/meowkit
Production ready. AI Agent Workflow System for Claude Code
https://github.com/ngocsangyem/meowkit
ai ai-agents automation claude claude-code claude-skills codex context-engineering meowkit opus plugins prompt-engineering prompt-toolkit shipping skills spec-driven-development tools workflow
Last synced: 3 days ago
JSON representation
Production ready. AI Agent Workflow System for Claude Code
- Host: GitHub
- URL: https://github.com/ngocsangyem/meowkit
- Owner: ngocsangyem
- License: mit
- Created: 2026-03-25T17:15:54.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-04-29T10:50:55.000Z (about 1 month ago)
- Last Synced: 2026-04-29T12:27:33.449Z (about 1 month ago)
- Topics: ai, ai-agents, automation, claude, claude-code, claude-skills, codex, context-engineering, meowkit, opus, plugins, prompt-engineering, prompt-toolkit, shipping, skills, spec-driven-development, tools, workflow
- Language: Python
- Homepage: https://docs.meowkit.dev/
- Size: 28.6 MB
- Stars: 13
- Watchers: 0
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
MeowKit
AI agent toolkit for Claude Code
77 skills · 17 agents · 21 commands · 7 modes · 19 rules · 27 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](https://meowkit.dev) · **Docs:** [docs.meowkit.dev](https://docs.meowkit.dev/)
## Quick Start
```bash
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:
```bash
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:
```bash
npx mewkit doctor # Verify environment
```
## Packages
| Package | npm | Description |
| ------------------------------------------------ | ------------------ | ----------------------------------------------------- |
| [`mewkit`](https://www.npmjs.com/package/mewkit) | `npx mewkit ` | 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/ 17 specialist agents
│ ├── skills/ 77 skills (mk: namespace)
│ ├── rules/ 19 enforcement rules
│ ├── hooks/ 27 hook scripts — lifecycle hooks + handlers + libraries
│ ├── commands/ 21 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](RELEASING.md)** for the complete release guide — manual steps, CI/CD automation, troubleshooting.
## Development
```bash
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](https://github.com/garrytan/gstack) — Skills, review patterns, ship workflow
- [antigravity-kit](https://github.com/vudovn/antigravity-kit) — Clean code standards, vulnerability scanning
- [aura-frog](https://github.com/nguyenthienthanh/aura-frog) — Agent detection, workflow orchestration
- [claudekit-engineer](https://claudekit.cc) — Cook/fix pipelines, release model