MeowKit

Production ready. AI Agent Workflow System for Claude Code

ai ai-agents automation claude claude-code claude-skills codex context-engineering prompt-engineering python

Why this rank:Recent releaseStrong adoptionHealthy release cadence

Description

Production ready. AI Agent Workflow System for Claude Code

README

MeowKit

AI agent toolkit for Claude Code
75 skills · 18 agents · 20 commands · 7 modes · 17 rules · 35 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.

Documentation: docs.meowkit.dev (VitePress)

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/               18 specialist agents
│   ├── skills/               79 skills (meow: namespace)
│   ├── rules/                17 enforcement rules
│   ├── hooks/                35 hook scripts — lifecycle hooks + handlers + libraries
│   ├── commands/             20 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)
├── 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

Release History

Version	Changes	Urgency	Date
v2.10.2	## PR Review + Response Skills See [changelog](https://docs.meowkit.dev/changelog) for full details. ### Install ```bash npx mewkit init # or upgrade: npx mewkit upgrade ```	High	6/2/2026
v2.9.13	## Fix Gate Parity & Workflow Evidence Index See [changelog](https://docs.meowkit.dev/changelog) for full details. ### Install ```bash npx mewkit init # or upgrade: npx mewkit upgrade ```	High	5/30/2026
v2.9.9	## Plan-creator determinism + handoff See [changelog](https://docs.meowkit.dev/changelog) for full details. ### Install ```bash npx mewkit init # or upgrade: npx mewkit upgrade ```	High	5/23/2026
v2.9.7	## Docs reference contract + validator See [changelog](https://docs.meowkit.dev/changelog) for full details. ### Install ```bash npx mewkit init # or upgrade: npx mewkit upgrade ```	High	5/16/2026
v2.9.5	## mk:worktree script backing and new commands See [changelog](https://docs.meowkit.dev/changelog) for full details. ### Install ```bash npx mewkit init # or upgrade: npx mewkit upgrade ```	High	5/14/2026
v2.7.6	## Improve harness See [changelog](https://docs.meowkit.dev/changelog) for full details. ### Install ```bash npx mewkit init # or upgrade: npx mewkit upgrade ```	High	5/9/2026
v2.7.4	## Browser skill consolidation See [changelog](https://docs.meowkit.dev/changelog) for full details. ### Install ```bash npx mewkit init # or upgrade: npx mewkit upgrade ```	High	5/3/2026
v2.7.0	## Update syntax See [changelog](https://docs.meowkit.dev/changelog) for full details. ### Install ```bash npx mewkit init # or upgrade: npx mewkit upgrade ```	High	4/30/2026
v2.6.1	## New agent: project manager See [changelog](https://docs.meowkit.dev/changelog) for full details. ### Install ```bash npx mewkit init # or upgrade: npx mewkit upgrade ```	High	4/22/2026
v2.6.0	## The Skills Compliance Release See [changelog](https://docs.meowkit.dev/changelog) for full details. ### Install ```bash npx mewkit init # or upgrade: npx mewkit upgrade ```	High	4/21/2026
v2.5.1	## New skill: meow:henshin See [changelog](https://docs.meowkit.dev/changelog) for full details. ### Install ```bash npx mewkit init # or upgrade: npx mewkit upgrade ```	High	4/19/2026
v2.5.0	## The Native Fit Release See [changelog](https://docs.meowkit.dev/changelog) for full details. ### Install ```bash npx mewkit init # or upgrade: npx mewkit upgrade ```	High	4/19/2026
v2.4.6	## Improve meow:ship See [changelog](https://docs.meowkit.dev/changelog) for full details. ### Install ```bash npx mewkit init # or upgrade: npx mewkit upgrade ```	High	4/19/2026
v2.4.5	## New skills: problem-solving and sequential-thinking See [changelog](https://docs.meowkit.dev/changelog) for full details. ### Install ```bash npx mewkit init # or upgrade: npx mewkit upgrade ```	High	4/18/2026
v2.4.4	## Improve docs See [changelog](https://docs.meowkit.dev/changelog) for full details. ### Install ```bash npx mewkit init # or upgrade: npx mewkit upgrade ```	High	4/18/2026
v2.4.3	## Improve skill brainstorm See [changelog](https://docs.meowkit.dev/changelog) for full details. ### Install ```bash npx mewkit init # or upgrade: npx mewkit upgrade ```	High	4/18/2026
v2.4.2	## Memory fix See [changelog](https://docs.meowkit.dev/changelog) for full details. ### Install ```bash npx mewkit init # or upgrade: npx mewkit upgrade ```	High	4/18/2026
v2.4.1	## Memory Simplification See [changelog](https://docs.meowkit.dev/changelog) for full details. ### Install ```bash npx mewkit init # or upgrade: npx mewkit upgrade ```	High	4/18/2026
v2.4.0	## The Agent Constitution See [changelog](https://docs.meowkit.dev/changelog) for full details. ### Install ```bash npx mewkit init # or upgrade: npx mewkit upgrade ```	High	4/18/2026
v2.3.12	## New skills See [changelog](https://docs.meowkit.dev/changelog) for full details. ### Install ```bash npx mewkit init # or upgrade: npx mewkit upgrade ```	High	4/17/2026
v2.3.11	## Fix env loading See [changelog](https://docs.meowkit.dev/changelog) for full details. ### Install ```bash npx mewkit init # or upgrade: npx mewkit upgrade ```	Medium	4/14/2026
v2.3.10	## Improve jira skill See [changelog](https://docs.meowkit.dev/changelog) for full details. ### Install ```bash npx mewkit init # or upgrade: npx mewkit upgrade ```	Medium	4/13/2026
v2.3.9	## Improve memory See [changelog](https://docs.meowkit.dev/changelog) for full details. ### Install ```bash npx mewkit init # or upgrade: npx mewkit upgrade ```	Medium	4/12/2026
v2.3.8	## Improve multimodal See [changelog](https://docs.meowkit.dev/changelog) for full details. ### Install ```bash npx mewkit init # or upgrade: npx mewkit upgrade ```	Medium	4/12/2026
v2.3.7	## New skill meow:chom See [changelog](https://docs.meowkit.dev/changelog) for full details. ### Install ```bash npx mewkit init # or upgrade: npx mewkit upgrade ```	Medium	4/11/2026
v2.3.6	## Remove unused files See [changelog](https://docs.meowkit.dev/changelog) for full details. ### Install ```bash npx mewkit init # or upgrade: npx mewkit upgrade ```	Medium	4/11/2026
v2.3.5	## Improve CEO review See [changelog](https://docs.meowkit.dev/changelog) for full details. ### Install ```bash npx mewkit init # or upgrade: npx mewkit upgrade ```	Medium	4/11/2026
v2.3.4	## Centralized Dotenv Loading See [changelog](https://docs.meowkit.dev/changelog) for full details. ### Install ```bash npx mewkit init # or upgrade: npx mewkit upgrade ```	Medium	4/11/2026
v2.3.3	Release v2.3.3	Medium	4/11/2026
v2.3.2	## Agent-Skills Integration Integrates correctness patterns from Anthropic's agent-skills system. ### Features - core-behaviors.md — 6 mandatory behaviors + 10 failure modes - Failure catalogs — per-skill rationalizations + red flags for cook, plan-creator, review - Phase composition contracts — expects/produces/breaks-if-missing per phase - Lifecycle routing — task signal → phase → skill mapping ### Install ```bash npx mewkit init # or upgrade	Medium	4/11/2026
v2.3.1	Release v2.3.1	Medium	4/11/2026
v2.3.0	Node.js hook dispatch system with 8 handler modules, cook verification flags, review skeptic anchoring, structured memory filtering, and tool output limits. ### Install ```bash npx mewkit init # or upgrade: npx mewkit upgrade ```	Medium	4/11/2026
v2.2.2	## Changed - meow:web-to-markdown — `injection_detect.py` homoglyph detection now flags only mixed-script tokens (e.g., Latin + Cyrillic within a single word) instead of consecutive foreign characters. Reduces false positives on legitimate multilingual content while still catching homoglyph spoofing attempts. ### Install ```bash npx mewkit init # or upgrade: npx mewkit upgrade ```	Medium	4/9/2026
v2.2.1	Release v2.2.1	Medium	4/9/2026
v2.2.0	Release v2.2.0	Medium	4/9/2026
v2.1.0	## What's New ### Custom Statusline - 5-line ANSI status bar: model+tier, context usage, plan tracking, rate limits, tokens ### Dependency Management - Install Python skill deps during init, per-skill requirements.txt, doctor pip check ### mewkit CLI - Version picker with manual entry, cross-platform Python detection ### SEO - Sitemap, robots.txt, OG/Twitter meta tags ### Install ```bash npx mewkit init # or upgrade: npx mewkit upgrade ```	Medium	4/4/2026
v2.0.0	## The Leverage Release The biggest MeowKit update. 8 new skills, 17 reference merges, hook profiling, external integrations. ### New Skills - meow:decision-framework — operational decision architecture - meow:verify — unified build→lint→test→type→coverage - meow:api-design — REST/GraphQL patterns - meow:build-fix — build error triage - meow:database — schema, migrations, query optimization - meow:intake — tool-agnostic ticket/PRD analysis -	Medium	4/4/2026
v1.4.0	## The Plan Intelligence Release ### Features - Plan red-team extraction — dedicated step-05 with 7-field findings, agent adjudication, 3-option user review - Plan-specific personas — Assumption Destroyer + Scope Critic adapted for plan review - Dynamic persona scaling — phase-count thresholds (2/3/4 personas) - --parallel mode — file ownership matrix + parallel group hydration - --two mode — 2 competing approaches + trade-off matrix - **Fast-mode workf	Medium	4/3/2026
v1.3.4	Release v1.3.4	Medium	4/2/2026
v1.3.3	Release v1.3.3	Medium	4/1/2026
v1.3.2	Release v1.3.2	Medium	4/1/2026
v1.3.1	Release v1.3.1	Medium	4/1/2026
v1.3.0	## The Integration Integrity Release Full adversarial audit of every MeowKit component — 15 agents, 60 skills, 9 hooks, 14 rules. Found and fixed 42 critical issues. ### Critical Fixes - Hooks enforcement restored — `gate-enforcement.sh` and `privacy-block.sh` were completely non-functional since v1.0.0 (argument mismatch). All 9 hooks now registered and working. - Agent naming — 5 phantom `subagent_type` values in Task() calls mapped to real agents - 7-phase model — `work	Medium	3/31/2026
v1.2.1	### Bug Fix - Memory capture at Phase 6 now enforced — `meow:cook` Phase 6 (Reflect) now spawns a dedicated subagent for `meow:memory` session-capture, matching the same MUST-spawn enforcement as project-manager and docs-manager. Previously memory write was an inline bullet point that could be skipped if session was interrupted. ### Install ```bash npm create meowkit@latest # or upgrade: npx mewkit upgrade ```	Medium	3/30/2026
v1.2.0	## The Memory Activation Release Fixed the dormant memory system and enriched it with cross-framework insights from 6 agent frameworks. ### Features - Session capture pipeline fixed — Stop hook writes structured NEEDS_CAPTURE markers; Phase 0 retroactive capture processes them (max 3, 2-min budget) - Live capture — Phase 5 preserves WHY decisions were made (retroactive can only recover WHAT) - 3-category extraction — learnings captured as patterns, decisions, or failures (	Medium	3/30/2026
v1.1.0	MeowKit v1.1.0 — The Reasoning Depth Release New skills: meow:elicit, meow:validate-plan, meow:nyquist Enhanced review pipeline with scout + elicitation Beads pattern for resumable COMPLEX builds Subagent Status Protocol SKILLS_INDEX + AGENTS_INDEX updates VitePress docs with Mermaid diagrams	Medium	3/30/2026
v1.0.0	13 new capabilities inspired by BMAD-METHOD and ClaudeKit-Engineer: - Scale-adaptive intelligence (domain-based complexity routing) - 3-layer adversarial code review (Blind Hunter + Edge Case + Criteria Auditor) - Party Mode (multi-agent deliberation for architecture decisions) - Parallel execution with git worktree isolation - Project context system (agent constitution) - Navigation help (/meow:help) - Hook-based enforcement (privacy-block, gate-enforcement, context-loade	Medium	3/30/2026
v0.1.2	## Features - Interactive version selection in `npm create meowkit@latest` - `git-manager` agent for commit/push with conventional commits - README for both npm packages - CHANGELOG and VitePress changelog page - Resources dropdown in docs nav ## Documentation - Rewrite root README — project description + release guide - Update CLI docs for GitHub-download architecture - Add `--list` flag and beta channel docs	Medium	3/29/2026
v0.1.1	Fix: exclude runtime dirs (session-state, memory, logs) from release zip. ## Changes - Added .claude/session-state/ to .gitignore - Release zip now excludes runtime artifacts (memory, logs, session-state, .env, metadata.json) - Clean release package with only distributable assets	Medium	3/29/2026
v0.1.0	Initial release of MeowKit - AI agent toolkit for Claude Code. ## What's included - 49 skills with meow: namespace - 14 specialist agents - 18 slash commands - 7 behavioral modes - 14 rule files - 6 hooks - 4-layer security system - Cross-session memory system	Medium	3/29/2026

Dependencies & License Audit

Loading dependencies...

Similar Packages

agent-search-cliEnable AI agents to search, crawl, and extract web data with IP rotation, CAPTCHA handling, and rate limit management via CLI and Python.main@2026-06-04

taktTAKT: TAKT Agent Koordination Topology - AI Agent Workflow Orchestrationmain@2026-06-03

kelosKelos - The Kubernetes-native framework for orchestrating autonomous AI coding agents.v0.37.0

sessioncraftThroughline for long-running AI projects.main@2026-04-13

hermes-agentThe agent that grows with youv2026.6.5

More from ngocsangyem

mewkitMeowKit CLI — scaffold, upgrade, and manage your AI agent toolkit

More in Frameworks

langchainThe agent engineering platform

deer-flowAn open-source long-horizon SuperAgent harness that researches, codes, and creates. With the help of sandboxes, memories, tools, skill, subagents and message gateway, it handles different levels of ta

tqdmFast, Extensible Progress Meter

simBuild, deploy, and orchestrate AI agents. Sim is the central intelligence layer for your AI workforce.