Install
noomoo is a command-line tool and a Claude Code plugin that check what happened in your repository instead of trusting what an agent says it did. This page takes you from nothing to a repository that noomoo watches, and back.
Requirements
- Node.js 20 or newer.
- git, and a repository for your project.
- Optionally Claude Code, if you want the plugin.
Install the package
npm install -D noomoo
noomoo has no runtime dependencies. Nothing is installed globally and nothing runs until you run a command.
Set up a repository
npx noomoo setup prints a plan and changes nothing: the files it would create, the scripts and git settings it would touch, and what it would do with a core.hooksPath you already have. When the plan looks right, apply it:
npx noomoo setup
npx noomoo setup --yes
The second command writes everything the plan listed and records it in .noomoo/setup-manifest.json. An existing core.hooksPath of yours stays as it is; add --hooks=replace if you want noomoo's hooks instead. Your agreement to run noomoo in this repository is stored in your user settings, not in the repository.
Claude Code plugin
The noomoo Claude Code plugin adds eleven skills, called as /noomoo:<skill>: /noomoo:start, /noomoo:status, /noomoo:doctor, /noomoo:validate, /noomoo:setup, /noomoo:rollback, /noomoo:spec, /noomoo:architect, /noomoo:report, /noomoo:intake and /noomoo:task.
Install the plugin in Claude Code from the marketplace in the noomoo repository on GitHub:
/plugin install noomoo --marketplace TaskForceNow/noomoo
On Claude Code older than 2.1.275, add the marketplace first:
/plugin marketplace add TaskForceNow/noomoo
/plugin install noomoo@noomoo
The Claude plugin directory listing will be the second channel once it is available. As a fallback, load the release archive for one session: download noomoo-plugin-<version>.zip and SHA256SUMS from the same release, check the zip with shasum -a 256 -c SHA256SUMS --ignore-missing, and start Claude Code with claude --plugin-dir noomoo-plugin-<version>.zip. Use the plugin archive of the same release as the core package installed in your project.
The plugin calls the package installed in your project and downloads nothing. Reading skills work in any repository before setup. A hook checks documents after an edit, but it stays silent until you have run setup in that repository and agreed to it. See the plugin page for what each skill does.
Roll back
npx noomoo rollback prints what would be removed and restored. npx noomoo rollback --yes applies it. Files you changed after setup stay in place, and everything noomoo added is taken out using the manifest.
Something unclear or broken? See Support.