robot-army

A single-user daemon that turns labelled GitHub issues into real, interactive Claude Code sessions in the terminal I already have open.

⚠️☠️☢️🚨 DANGER: Entering Vibe Land! This is entirely vibe coded by Claude and reviewed by Claude. I’ve barely looked at a single line of the code. You probably don’t want to ever run this if you’re not me. 🚨☢️☠️⚠️

This is written for my future self. It is public so it can be read, not so it can be adopted — there is no support, no stable API, and no packaging beyond a local pyproject.toml.

The guide

Start at the guide, which follows one issue through the system in the order the system touches it.

• Setup — install, the token, the config file, onboarding, effect levels
• ① Where work comes from — the label, the Trello board, cards
• ② What runs next — concurrency, serial working, board order, holds
• ③ What a session is told — the prompt, Spec Kit, previewing
• ④ What happens after — issue comments, notifications, cleanup
• Operating it — the web interface, logs, health, recovery
• Configuration — every section and key

Two deeper references:

• The audit log — record shape, every action, reconstructing history
• State — every path and table, and what survives a reboot

The source

github.com/jantman/robot-army. MIT licensed.

This site is open source. Improve this page.