outlaw

A Claude Code mod: a one colour Atari Outlaw duel at the right end of the line above the prompt. Your gunslinger fires at the moments worth celebrating, the bug fires back when a tool fails. Part of the Claude Code Arcade in claude-plugins.

What it does

• Medium moments are one shot for your gunslinger, big moments three. A failed tool is a shot for the bug.
• A hit is aimed at eye level and clears the cactus; a miss is from the hip and takes a chunk out of the cactus, which grows back between duels.
• Between duels the two pace, shift their weight and tip their hats, a tumbleweed rolls by and a vulture circles; while Claude thinks they stand with a hand on the gun.
• Under the duel: YOU 7 : 3 BUGS ▲ 4 ★ 6 (score, your run of hits, your best run). Kept between sessions.
• /outlaw shows the score and rules; /outlaw draw is a practice duel; /outlaw hide puts it away and /outlaw show brings it back.

Moments

Every Arcade game spots the moments worth celebrating on its own, so each one installs alone with no dependency. Coding or not, a session has them.

| Size | Moments | |---|---| | Small | A finished turn, a file saved, every 10th tool call in a turn | | Medium | A commit, a push, a pull request opened, tests passing, any skill run, a subagent finished, a plan approved, an MCP tool that sends, creates, posts or publishes, a long document written, praise in your message | | Big | A merge, a release (gh release create, npm publish), a production deploy (vercel --prod, netlify deploy --prod, fly deploy and others), tests back to green after failing, a deliverable made (PDF, DOCX, XLSX, PPTX, images), a published page, a finished task list of three or more, a marathon turn (10 minutes, 30 tools, no errors), three subagents done in one turn, a 3, 7, 30 or 100 day streak, the 100th, 1,000th or 10,000th tool call |

A commit that says "nothing to commit" or a push that says "Everything up-to-date" counts for nothing. Tool calls inside subagents do not count; their finishing does.

Settings

All optional; every one is empty by default. Set them in /plugin (the plugin's settings) or in settings.json under pluginConfigs.

| Setting | What it is for | Example | |---|---|---| | big_skills | Skills whose run is a big moment (every other skill is medium) | release-notes, publish-report | | quiet_skills | Skills that celebrate nothing | commit | | big_commands | A regular expression of shell commands whose success is big | make ship | | medium_commands | A regular expression of shell commands whose success is medium | terraform apply | | praise_words | Extra words that count as praise, on top of the built-in list (thanks, great, perfect and a few in other languages) | nice one, cheers |

What it reads and does

• Reads: the name of each tool Claude runs and whether it failed; for shell commands, the command line and whether its output says nothing changed; for file writes, the file name and its line count; skill names; the words of your message (only to spot praise); subagent start and finish.
• Keeps: its own score and state in Claude Code's plugin store on your machine.
• Draws: one block at the right end of the line above the prompt, and an occasional notice.
• Hooks: skill.prompt only notes which skill ran, so a finished skill can count as a moment; it passes the skill's prompt on unchanged. command.run answers its own /outlaw command and no other.
• Privacy: see PRIVACY.md.
• Never: changes, blocks or delays a tool call or a message; sends anything anywhere (no network calls, no telemetry); reads file contents beyond counting lines of a file Claude writes.

Install

Needs Claude Code 2.1.287 or later (mods). Tested on 2.1.289.

/plugin marketplace add mutlumehmet/claude-plugins
/plugin install outlaw@mehmetmutlu

A mod runs inside Claude Code with your permissions. Read the code before you install any mod.

It draws in a terminal (including an editor's integrated terminal) and in the Code tab of the Desktop app; in the VS Code chat panel and claude -p it runs but draws nothing. Several Arcade games can be open at once, but the line above the prompt fills up: /<command> hide puts one away, /<command> show brings it back.

Known gaps

• The duel is drawn with block characters; a terminal with tall line spacing shows thin gaps between rows.

About

Made by Mehmet Mutlu, part of claude-plugins. More of his work at mehmetmutlu.dev.

License

MIT