● muda
↑ subaud · one binary · MIT

Docs

Install muda, then ask your agent to start.

muda is one binary and five skills. Install both, open a session in a GitHub repository, and the muda skill routes to the next step. For what the loop does, see the loop.

what you need

Requirements.

a repoA GitHub repository whose CI runs on GitHub Actions, with some run history. A 30-day window is the usual start.
a tokenmuda reads GitHub with GH_TOKEN, then GITHUB_TOKEN, then your gh login. gh is not required when a token is set. Settings it cannot read are reported as unavailable.
an agentClaude Code, pi or Codex. The skills drive the agent; the agent runs muda.

setup

Three steps.

1 · Install muda

$ curl -fsSL https://muda.tools/install.sh | sh

It downloads muda for your platform and verifies its checksum. muda update moves it to the latest release; muda version shows what you have.

2 · Install the skills

$ muda skills install --agent claude --scope user

--agent is claude, pi or codex (default claude). --scope is user (default) or project. User scope writes to ~/.claude/skills, ~/.pi/agent/skills or ~/.codex/skills. Project scope writes to .claude/skills, .pi/skills or .agents/skills at the Git root. It refuses to overwrite skill files muda does not own.

3 · Start

In the repository, ask your agent to start delivery-waste work with muda. The muda skill checks the binary, checks it can read the repository, and asks before it creates the record. Then it routes to the next phase: measure, diagnose, fix or verify. Each phase stops at a checkpoint for your answer.

› use muda to find the delivery waste in this repo

commands

What the agent runs.

The skills run these. You can also run them yourself. muda help <command> prints the flags, and muda commands --json lists them all.

measureWhere the delivery time goes over a window, with evidence.
gatesCandidate merge and deploy gates and security settings.
scanStatic workflow signals: floating refs, uncached installs, emulation and more.
noticesWarning and notice annotations, grouped, with their sources.
logsA run's jobs, or one job's log filtered by step or pattern.
compareBefore and after timings, and fail-closed gate proof.
recipesList the fix recipes; recipe reads one.
standardRead the delivery-waste standard, or one W-class.
recordThe reviewed local record under .muda/.
skillsInstall the bundled agent skills.
updateUpdate muda to the latest release.

what it writes

It writes only .muda/.

The read commands change nothing. muda record writes only .muda/, and needs no GitHub access. muda skills install is the one other write, and only when you ask for it. The agent commits record changes on a branch and opens a pull request for you to merge. Never edit .muda/ by hand.