agent-race

Reviewed at commit bc8d48d

Puts several sessions on one track for the same task and scores tools, edits, tests and cost per lane.

Made by
OneWave AI
What we checked

Adds a /race command that opens a race-track scoreboard and compares Claude Code sessions on the same machine by tool calls, edits, passing tests and cost. Each session writes a small progress file under ~/.claude/agent-race/ that the other sessions read. It reads no prompts or file contents and makes no network calls.

Review details

Static review of the source at the pinned commit; not run. Registers session.start (registers the /race command), command.run (start/join, done, demo, leave), tool.call (counts tools, edits and parsed test results; Bash stdout and stderr are only scanned for pass/fail counts when the command looks like a test run and are not stored), turn.complete (updates cost from $.session.usage and finishes the lane when tests were last green) and ui.render for a pane. Reads HOME via $.env.get and writes one JSON file per session at ~/.claude/agent-race/<race>/<sessionId>.json containing the lane name, counters, cost and timestamps; it lists and reads the other lane files in the same race folder every second. Race names are sanitized to a-z, 0-9 and dash. Uses $.ui.status, $.ui.toast and $.audio.speak (spoken winner announcement). Lane files are not deleted on leave, but lanes idle for ten minutes are hidden.

What it uses
  • Reads your prompts: no
  • Sees tool calls: yes
  • Blocks or changes tool calls: no
  • Reads or writes files: yes
  • Runs programs on your machine: no
  • Calls the model (uses tokens): no
  • Sends data over the network: no
  • Stores data: yes
  • Shows something on screen: yes
Hooked events
Screenshot of agent-race

Race Claude Code sessions on a task: live split-screen race track scoreboard

Made this mod? Add a badge to your README

modsforClaude badge for agent-race

Paste this into your README. The badge says reviewed once the current version has been reviewed, and links readers to this page.

[![Listed on modsforClaude](https://modsforclaude.com/badge/agent-race.svg)](https://modsforclaude.com/mods/agent-race/)

← All mods