浪人 · a masterless samurai
Your agents. Your machine. No master but you.
Features · Gallery · Run it · Docs
One desktop app for every coding agent you pay for.
Codex, Claude Code, Cursor, Grok Build, OpenCode, Antigravity, Droid, Kilo, Pi — nine CLIs, one dark-first Electron workspace on Linux, Windows, and macOS. Chat, terminal, preview, git, pull requests, stats, themes. Bring your own subscriptions. Ronin sells you nothing and phones home to no one.
If the CLI works in a terminal, Ronin can drive it.
Start with Codex, hit a wall, hand the thread to Claude. Same history, same checkpoints, same working directory.
An agent that's been here before resumes its own session. A newcomer gets a brief built from the thread. Switch back later and it picks up where it left off — no copy-paste, ever. (docs)
Same prompt, two (or more) models, each in its own worktree. Press Compare, pick who should answer, and read them as ordinary threads with chips to jump between. Keep the one you like; delete the rest. (docs)
Claude leads, Codex implements, Grok reviews — or any roster you name. You define the roles; the lead hands work around in one shared worktree until the task is done. Gate a role if you want to see it coming. Not the default; you build the team. (docs)
Select the passage you're stuck on. A chip appears — Ask on the side opens a fresh thread on exactly that text, same project, same checkout. The main thread never learns you asked. (docs)
Agents leave work behind in the transcript — "this helper could go," "these two want merging." Select it and press Capture. Ronin files a draft thread, ready on every device, and you stay where you were reading. (docs)
Six lanes — Draft, Up Next, Working, Needs You, Snoozed, Done. Drag to settle, snooze, or pick the next thing. The sidebar and the board never disagree. (docs)
Come back to a twenty-minute turn and press replay. The prompt, each tool call, and the reply play back in order, pauses compressed so you see the rhythm without sitting through the dead air. (docs)
Reads each provider's own session transcripts — every token, including turns you ran in a bare terminal, on every connected machine. Real costs (Grok's exact figure, not an estimate), cache savings, per-model breakdowns, an hourly chart, and a sidebar meter that shows when your window resets, to the minute. (docs)
A spent five-hour window isn't a failure you can act on. Ronin parks the message, counts down above the composer, and sends it the moment the window resets. Cancel it, fire it early, or walk away. (docs)
When an agent writes HTML — a coverage report, a chart, a mockup — Ronin renders it in the transcript. Sandboxed. Relative assets load. No "open this link." (docs)
- Checkpoints after every turn — diff or restore anything an agent did
- Commit, branch, discard, worktrees in the topbar
- Pull requests across every connected server — review, react, edit in place
Tsukimi, Aizome, Urushi, the pure-black OLED Void family — plus Open VSX theme search. Pull almost any VS Code theme straight in. Import your own. Light and dark stay intact.
Drop a SKILL.md in ~/.ronin/skills and every provider can use it. Slash commands — /clear, /compact, /model, /review, /fork — work the same way, next to each CLI's native ones. (skills · commands)
Save a prompt, pick a schedule, walk away. Each run is a real thread you can read afterwards, defaulting to its own worktree so unattended edits never land in your checkout. (docs)
npx t3 pair --tailscaleScan the QR. Your phone is driving the same threads, over your tailnet, on hardware you own. LAN and SSH work too. (docs)
- Since you last looked — what finished, what's still running, what's waiting on you (docs)
- Needs you — a sidebar queue, and a dock badge, for anything that stopped until you answer
- Agent notifications — a system ping when a turn finishes, fails, or waits for approval
- Native on Windows — no WSL; the same CLIs you run in PowerShell
- Live browser preview — tabs, navigation, screenshots, recordings
- Permission modes — decide how much rope each agent gets
- Transcript export — Markdown or JSON
- Editor hand-off — opens any file in the editor you actually use
Workspace — centered composer, resizable sidebar, project-aware threads, source control in the title bar.
Stats — spend and tokens by provider and model, theme-aware charts, cache savings, hourly resolution.
Appearance — system / light / dark, first-party themes, OLED blacks, Open VSX theme search.
Important
Install and authenticate at least one provider first:
| Provider | Install | Auth |
|---|---|---|
| Codex | Codex CLI | codex login |
| Claude | Claude Code | claude auth login |
| Cursor | Cursor CLI | agent login |
| Grok Build | Grok Build CLI | grok login |
| OpenCode | OpenCode | opencode auth login |
| Antigravity | Antigravity CLI (agy) |
sign in via agy |
| Droid | Factory Droid | droid / FACTORY_API_KEY |
| Kilo | Kilo CLI | kilo auth |
| Pi | Pi | pi |
Download the latest build from Releases. The app updates itself.
Or build from source:
# Node 22.16+ / 23.11+ / 24.10+
curl -fsSL https://vite.plus | bash # install vp (macOS/Linux)
vp i
vp run dev # server + web
# or
vp run dev:desktop # Electron shellvp run build:desktop
vp run dist:desktop:linux # Linux AppImage
vp run dist:desktop:win # Windows installer (NSIS)
vp run dist:desktop:dmg:arm64 # macOSArtifacts ship as Ronin-${version}-${arch}.${ext}. On Windows, Ronin runs native CLIs — no WSL. (install docs)
| Audience | Start here |
|---|---|
| Using Ronin | docs/user/install.md |
| Keybindings | docs/user/keybindings.md |
| Switching provider | docs/user/switching-providers.md |
| Second opinion | docs/user/second-opinion.md |
| Side chats | docs/user/side-chats.md |
| Board | docs/user/board.md |
| Automations | docs/user/automations.md |
| Build systems | docs/user/build-systems.md |
| Stats & usage | docs/user/usage.md |
| Remote / Tailscale | docs/user/remote-access.md |
Full tree: docs/.
Built on T3 Code.
Early. Expect bugs. Prefer small fixes over grand PRs unless we ask. Read CONTRIBUTING.md first.
浪人 — cut free. Keep the blade sharp.