MEOW
Tell MEOW what you want. Get the finished branch.
MEOW is a workflow harness for Claude that plans, implements, tests, reviews, and delivers software changes in isolated worktrees.
Running a built-in workflow starts a loop: MEOW implements, reviews, and fixes the work until review passes, or the configured round limit is reached. It does not stop after a single attempt. Once review passes, MEOW runs the final checks before delivery. Custom workflows control their own loop stages.
Install
PowerShell
irm https://raw.githubusercontent.com/maya8237/MEOW/main/scripts/install.ps1 | iex
Bash
curl -fsSL https://raw.githubusercontent.com/maya8237/MEOW/main/scripts/install.sh | sh
The installer needs Python 3.12 or newer (it uses the newest it finds; set
MEOW_PYTHON to choose one). It puts MEOW in ~/.meow, adds the meow command to your PATH,
and sets up its skills in Claude Code. Open a new terminal or restart Claude Code
to get started.
Run
Claude Code:
/meow:run Add CSV export
Terminal or CI:
meow run "Add CSV export" --name csv-export
By default, meow run handles the request as one sprint: plan, implement,
check, and review.
Add -o/--orchestrate to split an objective into tasks, run
each as a full sprint in its own worktree, and merge passing tasks. MEOW
reviews the combined result before pushing one branch and opening one PR/MR.
Projects are set up automatically on first use. Use /meow:onboard to configure
integrations and optional features.
Common commands
| Need | Command |
|---|---|
| Build a feature | /meow:run ... or meow run ... |
| Plan only | /meow:plan ... or meow plan ... |
| Schedule a run | /meow:schedule ... or meow schedule add --at "09:00" -- run "Add CSV export" --name csv-export |
| Review | /meow:review ... or meow review ... |
| Integrate CI review | /meow:integrate-ci-review |
| Fix lint | /meow:lint |
| Queue work | meow queue "..." |
| Check or continue | meow status or meow resume RUN_ID |
Common flags
| Flag | Purpose |
|---|---|
--orchestrate / -o |
Coordinate multiple sprints and deliver one reviewed branch and PR/MR |
--max-parallel N |
Limit concurrent sprints with --orchestrate (default: 3) |
-n / --no-worktree |
Work in the current checkout without committing or pushing |
-nc / --no-worktree-commit |
Work in the current checkout and commit without pushing |
-np / --no-worktree-push |
Work in the current checkout, commit, and push |
-m / --manually-approve-plan |
Approve the plan before implementation |
--name NAME |
Name the feature branch and worktree |
--from BRANCH / -b BRANCH |
Choose the starting branch |
--update / -u |
Update MEOW with meow --update |
--help / -h |
Show help for a command |
See the CLI guide for worktrees, background runs, recovery, orchestration, and advanced options. Normal feature runs create a worktree and commit/push after verification.
Configuration and integrations
.meow/config.toml— shareable project settings..meow/config.local.toml— ignored machine- or user-specific settings.~/.meow/config.toml— user fallback settings.
MEOW supports Jira, GitLab, GitHub, configured tests and builds, browser tester checks, Claude Code hooks, and scheduled Jira runs. See the integration guide.
Uninstall
PowerShell
irm https://raw.githubusercontent.com/maya8237/MEOW/main/scripts/uninstall.ps1 | iex
Bash
curl -fsSL https://raw.githubusercontent.com/maya8237/MEOW/main/scripts/uninstall.sh | sh
It asks before changing anything. It removes the MEOW release, meow/mw on
PATH, the Claude Code plugin and skill registrations, scheduled MEOW runs, and
(optionally) ~/.meow data, Bun shared-store settings, and each project's
.meow/, hooks, and plugin entries.
Docs
1 maintainer
Metadata
1 maintainer
Release files for meow-harness 0.1.16
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| meow_harness-0.1.16.tar.gz | 1.9 MB | With provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| meow_harness-0.1.16-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 3.3 MB
Release files / meow_harness-0.1.16.tar.gz
| Download URL | meow_harness-0.1.16.tar.gz |
|---|---|
| Size | 1.9 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c45b2567b5ae5f92276e0811d53ba25b112d63fbb01c3392f8537cea37163ed7
|
|
BLAKE2b-256 checksum How to use checksums |
b0d9e216de5cbe1538480076736228663f36f34f0c06003275025d2d89547354
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 21, 2026.
Transparency logRelease files / meow_harness-0.1.16-py3-none-any.whl
| Download URL | meow_harness-0.1.16-py3-none-any.whl |
|---|---|
| Size | 1.3 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ed877ebc7d9d019dfdc11f22c98a3565fee968faf131f76e27407603f44c68e7
|
|
BLAKE2b-256 checksum How to use checksums |
1b58dc050cbaf1d138d748abebeac8439e8ca6bfa7b0bb781f21b60abc610ae4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 21, 2026.
Transparency logSecurity for meow-harness 0.1.16
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for meow_harness-0.1.16.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 21, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
