Skip to content

Releases: RyanJThompson/simbroker

Release list

v0.1.0

v0.1.0 Latest
Latest

Choose a tag to compare

View all tags
@RyanJThompson RyanJThompson released this 12 Aug 23:16
v0.1.0
de6074f

First tagged release.

A machine-global broker for a capacity-capped pool of iOS simulators and Android emulators — so parallel worktrees, terminals, CI steps and AI agents stop colliding on the same device or booting more than the Mac can hold.

Install

go install github.com/RyanJThompson/simbroker/cmd/simbroker@v0.1.0

Or download a tarball below, extract, and put simbroker on your PATH. macOS only. Run simbroker doctor to check the machine.

Setting it up for AI agents

The README has a copy-paste prompt you can hand to Claude Code (or any coding agent) from inside your project — it installs the binary, registers the MCP server, writes ~/.simbroker/config.json, adds the claim/teardown rules to your CLAUDE.md, and sets the permissions allowlist.

What's in it

  • claim / renew / release / list / devices / gc / doctor CLI
  • MCP server (simbroker mcp) with claim_simulator, release_simulator, renew_simulator, list_simulators — claims auto-renew for the session and release when it ends
  • Per-class capacity (iOS and Android budgeted separately; an emulator is a full VM)
  • Liveness on two axes: TTL expiry, plus PID liveness so a dead holder's device frees immediately
  • No daemon — coordination is an flock'd, atomically-replaced state file in ~/.simbroker/
Assets 4
Loading