Run My Agents
Run many Claude Code sessions on one repo, and stop them overwriting each other.
When one session is about to edit a file that another session on your computer edited in the last 10 minutes, the edit is stopped once with a note:
Run My Agents: another Claude session (9d5f2846 on branch fix-login, in ~/code/app) edited api.ts 2 min ago. Your edit could overwrite its work. Read the file again first, or work on a different file. If you are sure, make the edit again and it will go through.
The agent re-reads the file and carries on. It is a warning, not a lock: a second try always goes through.
No server, no account, no keys. Everything stays in ~/.run-my-agents/claims.json on your computer.
Install
In Claude Code:
/plugin marketplace add flisk-sh/run-my-agents
/plugin install run-my-agents@run-my-agents
Then open two or more sessions on the same repo, or on worktrees of it, and work as usual.
How it works
session A edits api.ts ──► claims.json { api.ts: A, 1 min ago }
session B edits api.ts ──► sees A's claim ──► edit stopped once, with a note
session B edits again ──► goes through, B now holds the claim
A PreToolUse hook runs before Edit, Write, MultiEdit and NotebookEdit. Claims expire after 10 minutes.
Settings
| Variable | Default | What it does |
|---|
RUN_MY_AGENTS_TTL_MINUTES | 10 | How long an edit counts as "recent" |
RUN_MY_AGENTS_DIR | ~/.run-my-agents | Where claims are kept |
RUN_MY_AGENTS_MODE | warn | off turns the warning off without uninstalling |
RUN_MY_AGENTS_IGNORE | (none) | Extra comma-separated globs that never warn, like *.snap,docs/gen/**. Lockfiles, *.generated.*, dist/ and node_modules/ are always skipped |
RUN_MY_AGENTS_DEBUG | (off) | 1 logs every decision and error to debug.log in the claims folder |
When a session ends, its claims are dropped, so a finished session never stops anyone.
Limits
- One computer only. Sessions on other machines are not seen.
- Edits made through Bash (
sed, echo > file) are not seen; only Claude's edit tools are.
- It matches whole files, not functions or lines.
- It warns, it never locks: a retry after a warning goes through. If the other session edits the file again after you were warned, you are warned again before your next edit, with its session, branch, age and when its claim drops.
- It needs
node on your PATH.
Test
bun run check
Runs every layer: web (typecheck, lint, tests), board (typecheck, tests), the kitchen agent (typecheck, tests), the evals grader and the
hooks suite (bash test/test.sh, which needs Node 22). CI and the Kitchen's merge gate run the same command.
License
MIT. Made by Flisk.
The board: see all your agents
A local web page with every Claude Code session on your computer as a card: a face, what it is doing, the files it
touched, and a warning when two sessions edited the same file. It reads ~/.claude/projects, so there is nothing to
sign in to, and it never leaves your computer.
cd services/app/board && bun install && bun start
Then open http://localhost:4100. It refreshes every 5 seconds. With Flisk, flisk up starts it as a local process.
Token limits
Set a token limit per session on the board. When a Claude Code session passes it, the plugin stops it once and
tells it to move to the next cheaper model: Opus, then Sonnet, then Haiku. It never moves a model up. With
"move new sessions to a cheaper model" on, it also writes that model to the project's
.claude/settings.local.json, so new sessions there start on it. Limits live in ~/.run-my-agents/limits.json.
Other agents and skills
The board reads Codex sessions from ~/.codex/sessions as well as Claude Code's. Each agent's Skills drawer suggests
skills for its job from the DevEx Roadmap catalog (bun scripts/skills.ts <roadmap checkout>
refreshes services/app/board/src/skills.json).
Mac app
Open Terminal and paste this (Apple Silicon and Intel, macOS 13 or later):
curl -fsSL https://run-my-agents.flisk.si/install.sh | sh
It downloads the latest release, puts the app in
/Applications and opens it. The board is built in, so it needs no Bun, Docker, Tilt or Flisk. Every v* tag, and
every merge to main that changes the board, hooks or app, builds and attaches a new release
(.github/workflows/release-mac.yml). The app updates itself: on launch it installs a newer release before the board
starts, and while it runs it downloads one every 6 hours and installs it when you quit (or now, from Check for
Updates… in the menu bar item). RUN_MY_AGENTS_NO_UPDATE=1 turns that off.
The app is not notarized by Apple (that needs a paid developer account), so macOS blocks it when you download the
zip in a browser, with "damaged" or "could not verify". The command above avoids that, because a file curl saves is
not blocked. If you did download the zip, move the app to Applications and run
xattr -cr "/Applications/Run My Agents.app" once. docs/MAC_NOTARIZATION.md has the
optional way to notarize it later.
Develop
cd services/app/board && bun run dev
bun run dev restarts the board when its code changes, and an open board page reloads itself and keeps what you were typing (drafts are saved per agent in the browser).
bun run live does that and also follows main: a merged pull request is live within a minute, and the board comes back if it crashes. It leaves a checkout that is on another branch or has unsaved edits alone.
여기까지가 README 앞부분입니다. 나머지는 원문에서 읽을 수 있습니다. README 전문 보기 ↗
