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: about 21 hours 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 (3 months ago)
- Default Branch: main
- Last Pushed: 2026-06-27T16:17:40.000Z (1 day ago)
- Last Synced: 2026-06-27T18:07:36.902Z (about 22 hours 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: TypeScript
- Homepage: https://docs.meowkit.dev/
- Size: 34.4 MB
- Stars: 15
- Watchers: 0
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Governance: docs/governance/meowkit-agent-rules.md
Awesome Lists containing this project
README
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](https://meowkit.dev) · **Docs:** [docs.meowkit.dev](https://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)
```bash
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.
```bash
# 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:
```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/ 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](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