claude9

Spawn run9 dev boxes preloaded for Claude. Fork a base box, clone your project's repos into it, and run claude -p tasks with session persistence — resume by box id.

Install → For agents → View on GitHub

// concept

A CLI for forked dev boxes.

claude9 is a small Rust CLI that forks a preconfigured run9 base box, clones a project group's repos into /home/guy/workspace/repos/ inside it, and runs claude -p tasks on the box with session persistence so follow-ups continue the same conversation.

Config and per-box state live under <project>/.claude9/, discovered by walking up from CWD like git finds .git/. Multiple project groups on one machine stay isolated by default.

// install

One line.

install.sh

$ curl -fsSL https://raw.githubusercontent.com/634750802/claude9/main/install.sh | sh

Prebuilt binaries for darwin-arm64, linux-amd64, and linux-arm64 are published on GitHub Releases. Pin a version with sh -s v0.1.0, or override the install path with CLAUDE9_INSTALL_DIR=~/.local/bin.

// quick tour

Four commands, one session.

~/projects/my-group

# create .claude9/config.toml, edit repo list
$ claude9 config

# create a box, clone configured repos into it
$ claude9 spawn --name my-box

# stream a claude -p turn on the box
$ claude9 task my-box "audit db9-server for N+1 queries"

# follow up on the same session
$ claude9 resume my-box "draft a fix for the worst three"

// agent skill

Let your agent drive it.

claude9 ships with a SKILL.md — a self-contained brief that teaches Claude Code (or any other agent) the four verbs, the base-box contract, discovery rules, and the gotchas. Drop it into your agent's skills directory:

install SKILL.md

$ curl -fsSL https://raw.githubusercontent.com/634750802/claude9/main/SKILL.md -o ~/.claude/skills/claude9.md

Or inline it into your project's CLAUDE.md — anything that reads markdown will do. View the source on GitHub.

// commands

What each verb does.

claude9 config

Create / open .claude9/config.toml in $EDITOR.

claude9 spawn

Fork the base box, clone configured repos, optionally run an inline task.

claude9 task

Stream one claude -p turn on an existing box. Saves the session id for resume.

claude9 resume

Continue the last session on a box with a follow-up prompt.

// base box contract

Prepare the base box once.

claude9 doesn't provision anything automatically. Before you run spawn, prepare a run9 box with:

A remote user guy owning /home/guy/workspace.
A claude CLI authenticated as guy, supporting -p --output-format stream-json --verbose and --resume <sid>.
A gh CLI authenticated as guy (for private-repo cloning).
A git global identity set for guy.

Everything else — language toolchains, build tools, shell helpers — is up to you. See SKILL.md for the full contract and the list of non-goals.