Developers
Build on your own Mac.
For anyone who can call an HTTP API or write a little JSON: RoachNet's model server, its local API, its themes and its packs all run on the Mac in front of you, and the docs cover each one.
:36434Model serverOllama, OpenAI and Anthropic APIs, no token:ephemeralLoopback APIThe app's own API, a fresh token every launch:38111Companion bridgeWhat your phone talks to, behind a token:setupSetup serviceOnly while RoachNet Setup is open
Nothing else listens unless you turn on Cluster, which opens one port on your network for your other Macs.
What you can build on
-
Model server
Three APIs, one address
RoachInference answers the Ollama, OpenAI and Anthropic APIs on
127.0.0.1:36434, with no token, like Ollama. Change one address in a tool you already use and it runs on your Mac's models.
Point a client at itcurl -s http://127.0.0.1:36434/v1/models -
Local API
161 routes, all documented
Every route the runtime's four servers answer, and the two functions roachnet.org runs, each with its request, response and source line. A script you keep gets a RoachClaw API token, with the scope you choose.
Browse every routecurl -s "$ROACHNET/api/health" -
Packs, themes and agents
Grow it from a small core
Add panes, models and maps as packs, make a theme in the editor, and bring Claude Code, Codex and other coding agents into the Org as employees.
Extend RoachNetOrg › Agents › Hire agent…
Make and share
Make a theme, then hand it on
Start from one of the 37 built-in themes or 13 snippets in Settings › Appearance and change any color, font, radius or background. A theme is a JSON file, so you can export it and send it, and whoever gets it drops it into ~/RoachNet/storage/themes.
Packs come from RoachNet Apps: send someone the catalog and they install the same pack in one click, with no account.
Guides and reference
Task-first guides for getting something done, and reference pages for when you need the exact field.
Guides
- Install RoachNet on a Mac
The app goes in
~/RoachNet/appand your data in~/RoachNet/storage, and nothing else gets installed. - Use Ollama, OpenAI and Anthropic clients
Change one address and a tool you already use runs on your Mac's models.
- Extend RoachNet
Packs, themes, your own agents and the local API.
- Themes
37 built-in themes, 13 snippets and an editor. Themes are JSON files.
- RoachNet Apps and feature packs
A small core, and anything you add you can take out again.
- The Org
Agents with roles and budgets, and decisions that wait for you.
- Claude and ChatGPT plans as models
Your own plan, through your own signed-in CLI. Off until you turn it on.
- RoachTrace
Every run traced on your Mac, with secrets scrubbed before anything is written.
Reference
- The local API
Four servers on
127.0.0.1, and how to find the port and the token. - Model server reference
Every Ollama, OpenAI and Anthropic route, streamed or not.
- Companion bridge reference
What your phone talks to, behind a token, and nothing else.
- Setup service reference
The installer's backend, which runs only while Setup is open.
- Command line
The helper that runs RoachNet's servers has flags of its own.
- Environment variables
What
roachnet-runtimereads when it starts. - Folders and files
Two places in your home folder, and your data is in one of them.
- Security
What protects the local API, your devices and your files, and where the limits are.
- Network and privacy
No analytics, local servers on
127.0.0.1, and the short list of reasons RoachNet goes online. - RoachNet 1.1.4 release notes
What's new, the fixes and how to upgrade.