Skip to content

About

Let a team of agents plan, build, review and ship your code change. You approve the plan and the merge.

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Mutagent

unsupervised

Turn your GitHub board into a software factory.

idea → spec → board → agents build in parallel → independent review → CI → merged PR

You sign off on the plan and the merge. The agents do the rest.

License: MIT Agent Skills Claude Code plugin Codex skill

unsupervised is an Agent Skill. Install it in Claude Code, Codex or any agent that can run shell commands, say "set up the software factory here", and your agent gets Architech installed, linked to your board and taking work.

What you get

  • A plan before any code. Requirements, design, tasks and an acceptance spec. In the Full-Loop, nothing gets built until you approve it.
  • Your board as the queue. The plan becomes a parent issue with one sub-issue per task, on your GitHub Project board.
  • Agents that build the tasks in parallel and open the pull requests.
  • Review by an agent that didn't write the code. It sends work back to the builder; after two rounds, it comes to you.
  • CI that bounces back. On the cloud factory, failed CI on its branch sends the work back to the builder, not to you.
  • A pull request waiting for one decision: yours.

Small fix? Skip the ceremony: /execute "fix the off-by-one in pagination" plans, builds, gets the pull request reviewed and merges it as your merge rules allow. In Fast Mode, the merge is what you approve.

How it runs, in 60 seconds

Same pipeline, two places to run it:

Local factory Cloud factory
Runs in Your own Architech session Mutagent Cloud sandboxes
Work starts when You type /dispatch 42 Someone adds the pickup label to an issue
You approve by Answering the session Adding a label on the issue or PR
Best for Trying it on one repository A board that keeps moving with your laptop shut

On the cloud factory, label an issue before you log off and the plan is waiting for you in the morning.

  1. Install the skill (below) and say: "Set up the software factory here, local mode."
  2. Your agent installs Architech. It asks first and shows you the installer. You sign in with /login, then /onboard links your GitHub Project board, writes project memory and rules, and commits two files: factory.yaml and a one-line pointer in CLAUDE.md.
  3. Hand it work: /spec, then /publish and /dispatch. Or /execute for a quick fix, which goes on to merge.
  4. Ready for Cloud? Your agent walks you through architech factory push and enable. Then the board runs itself, up to your approvals.

Install the skill

Claude Code (plugin):

/plugin marketplace add mutagent-io/unsupervised
/plugin install unsupervised@unsupervised

It loads when you ask about Architech or the software factory, or run it as /unsupervised:unsupervised.

Any agent, with the skills CLI:

npx skills add mutagent-io/unsupervised

Claude Code, by hand (runs as /unsupervised):

git clone https://github.com/mutagent-io/unsupervised ~/.claude/skills/unsupervised

Codex, by hand:

git clone https://github.com/mutagent-io/unsupervised ~/.agents/skills/unsupervised

Or clone it into a repository's .agents/skills/ to use it there only. Any other harness: clone it anywhere it can read, and see For agents. Pinned versions: every release attaches unsupervised-v<version>.tar.gz.

Then say

  • "Set up the software factory here, local mode."
  • "Plan this feature with Architech."
  • "Why didn't the factory pick up my issue?"
  • "Hand this bug to Architech and tell me when the PR is up."

It never merges without you

  • Approvals are labels only a person can add. The factory ignores labels from bots and apps. Your agent never adds one, never approves a gate for you, and never merges.
  • Every change lands as a pull request. The merge waits for your approval at every autonomy level.
  • It asks before it installs or writes anything, and shows you the installer before it runs.
  • No keys in chat. You sign in inside Architech with /login.

For agents

Running a harness that doesn't load skills natively? Read SKILL.md and follow its three phases: start (install), setup (sign in, model, onboard) and operate (hand work over, relay questions, read results). Its first section says what your harness needs and what to do without tmux or without a shell. For the Software Factory, read references/factory.md. AGENTS.md points harnesses that load AGENTS.md to the same place. A user can start you with: "Read github.com/mutagent-io/unsupervised and set up Architech in this repo."

Learn more

Contributing and licence

See CONTRIBUTING.md. Licensed under the MIT License.

About

Let a team of agents plan, build, review and ship your code change. You approve the plan and the merge.

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages