Bashroom is a filesystem for agents — save notes, share files, and hand off work between running sessions.

you
claude
codex
sdan/quickquack
  • notes/
    • 2026-05-20.md claude
    • 2026-05-21.md codex
  • index.md you
  • log.md claude
  • README.md you
One folder. Every agent writes to it; you can open it from anywhere.
npm install -g bashroom
copy
bashroom login
sign in with GitHub
claude mcp add bashroom -- bashroom mcp
wire it into Claude Code
codex mcp add bashroom -- bashroom mcp
wire it into Codex
npx skills add sdan/bashroom
install the skill into any agent
a handoff, end to end
claude
tuesday, end of session
bashroom_write({
  path: "/rooms/quickquack/notes/2026-06-09.md",
  content: "## state\nOAuth refresh works, tests green.\n## next\nWire the callback into /settings."
})
codex
wednesday, fresh session
$ cat /rooms/quickquack/notes/2026-06-09.md
## state
OAuth refresh works, tests green.
## next
Wire the callback into /settings.
That's the whole trick. The second agent reads the first one's file and starts where it stopped — different model, different machine, no scrollback paste.
How does it work?
Bashroom is organized around rooms: a room is a durable project workspace, like /rooms/my-app, where agents keep the files they need for handoff. When an agent runs a command, Bashroom starts a fresh cloud shell for that account and mounts its rooms into it, so normal bash — cat, rg, git — works on the same files another session will see later. The shell resets after each call; the room files do not. Six tools cover the whole surface: bashroom is the shell, bashroom_write writes a file byte-for-byte past bash quoting, and tree/read/search/stat read those same R2 objects directly when you only need file context — bounded, so a big file can't flood the model's context window.
How is it secure?
Each account gets its own ephemeral sandbox and its own slice of R2. When an agent runs bash, Bashroom mounts only that account's allowed rooms at /rooms, using s3fs to make those R2 objects look like normal files. Another user's rooms are not mounted in the sandbox, and structured tools still go through the Worker's account and room checks before touching R2. The account token stays in the local bashroom mcp process, so the model can use Bashroom without seeing the credential.
How do you use it?
For anything you'd otherwise re-explain to a new chat. Example: "read /rooms/<project>/index.md and pick up where the last session left off" — the agent catches up in seconds, no copy-paste from chat scrollback. Different agents on different machines see the same files, so context survives switching from Claude to Codex, or from your laptop to a long-running worker.
How long will it stick around?
Bashroom runs in R2 and CF Sandboxes — even if you used it 200 times a day storing 50MB of notes, it'd be under $1/month. So far the cost is bearable for me to foot; that may change at some point and charge a small fee.
all systems normal · served from iad
viewed from New York City, San Francisco, Kent, The Dalles, +8 more · from @sdan