freshcrate
Home > Frameworks > MeowKit

Description

Production ready. AI Agent Workflow System for Claude Code

README

MeowKit Banner

MeowKit

AI agent toolkit for Claude Code
75 skills Β· 18 agents Β· 20 commands Β· 7 modes Β· 17 rules Β· 35 hook scripts Β· 4-layer+ security

npm version GitHub release License


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

Release History

VersionChangesUrgencyDate
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 ```High4/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 ```High4/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 ```High4/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 ```High4/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 ```High4/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 ```High4/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 ```High4/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 ```High4/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 ```High4/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 ```High4/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 ```High4/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 ```Medium4/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 ```Medium4/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 ```Medium4/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 ```Medium4/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 ```Medium4/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 ```Medium4/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 ```Medium4/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 ```Medium4/11/2026
v2.3.3Release v2.3.3Medium4/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 upgradeMedium4/11/2026
v2.3.1Release v2.3.1Medium4/11/2026
v2.3.0Node.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 ```Medium4/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 ```Medium4/9/2026
v2.2.1Release v2.2.1Medium4/9/2026
v2.2.0Release v2.2.0Medium4/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 ```Medium4/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 -Medium4/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 workfMedium4/3/2026
v1.3.4Release v1.3.4Medium4/2/2026
v1.3.3Release v1.3.3Medium4/1/2026
v1.3.2Release v1.3.2Medium4/1/2026
v1.3.1Release v1.3.1Medium4/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** β€” `workMedium3/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 ``` Medium3/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 (Medium3/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 Medium3/30/2026
v1.0.013 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-loadeMedium3/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 docsMedium3/29/2026
v0.1.1Fix: 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 assetsMedium3/29/2026
v0.1.0Initial 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 systemMedium3/29/2026

Dependencies & License Audit

Loading dependencies...

Similar Packages

taktTAKT: TAKT Agent Koordination Topology - AI Agent Workflow Orchestration0.37.0
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-04-21
kelosKelos - The Kubernetes-native framework for orchestrating autonomous AI coding agents.v0.30.0
sessioncraftThroughline for long-running AI projects.main@2026-04-13
conductor-ossMarkdown-native AI agent orchestrator. Write tasks in a kanban board, agents do the work.0.60.8