HinaCode
Run many agents. Know which one needs you.
A delightful workstation for running Claude Code, Codex, Muse Code, opencode, and magpie in parallel, each in its own worktree, each visible at a glance.
Download · Documentation · Report a bug · Request a feature · Releases
English · 繁體中文
[!WARNING]
HinaCode is in alpha and ships several times a day. Expect bugs, and please report them.
Why HinaCode?
Running one agent in a terminal works. Running five stops working: you lose track of which checkout each agent owns, which one is waiting for approval, and which pull request each one shipped.
HinaCode is a delightful workstation for coding agents. It handles the work around each agent: where it runs, when it needs you, what it changed, and how it ships. That way you can run agents in parallel and stay in control.
- Free and open source under the MIT license. No markup, no proxy.
- Uses the agents you already pay for. HinaCode runs the
claude, codex, muse, and opencode CLIs you are signed in to, and runs claude through your magpie gateway for magpie threads. Usage goes to those plans, API keys, or gateway, exactly as it does in a terminal.
- Local by default. Your code only goes where those CLIs already send it. HinaCode keeps its data in a single SQLite file on your machine.
- Built with HinaCode, every day. If the workflow hurts, we feel it first.
Features
- A worktree per thread. Branch from
main, any branch, or an open pull request. Your setup script runs before the agent starts.
- Five agents, one sidebar. Pick Claude Code, Codex, Muse Code, opencode, or magpie per thread, and switch mid-thread.
- Inbox. Every active thread in one list, with approvals and questions marked.
- Inline approvals and questions. Allow, deny with a note, or answer without leaving the thread.
- Steer or queue. Change the agent's course mid-turn, or queue the next task behind it.
- Diffs per turn. Comment on a line and the agent gets the exact spot.
- Browser, terminal, and ports. Open the dev server, a shell, and the ports an agent left open beside the thread. Mention a terminal with
@ or send its selected output to the thread, and the agent reads it.
- Linked pull requests. See checks and review state next to the thread. HinaCode tells the agent when checks fail or a review lands.
- Merge and clean up. Squash and merge from the thread, and HinaCode removes the worktree.
- Routines. Run a prompt on a schedule, from a webhook, or from the CLI, in the project folder or a new worktree.
- Built-in MCP server. Agents can ask you for secrets, hand work to other threads, drive a disposable VM or mobile simulators, and use Linear.
- Remote machines and your phone. Run
npx hinacode serve on another machine, then approve, steer, and merge from the phone app.
- Other apps. Add your machine's URL to a chat app or agent harness that speaks remote MCP, approve it with a one-time code, then start, read, and steer threads from there.
Supported agents
Install each CLI you want to use, sign in, and keep it on your PATH. HinaCode never sits between you and the provider.
| Agent | CLI | Sign in | Protocol |
|---|
| Claude Code | claude | claude (follow the login flow) | Agent SDK |
| Codex | codex | codex (follow the login flow) | App-server protocol |
| Muse Code | muse | muse login | MSP |
| opencode | opencode | opencode auth login | Agent Client Protocol (ACP) |
| magpie | claude | run magpie | Agent SDK through the gateway |
Adding a backend takes one AgentProvider implementation in src/main/agents/ plus registration in the runner. See the agent provider guide.
Download
Download the latest build for your platform from Releases:
| Platform | Format |
|---|
| macOS (Apple silicon) | .dmg |
| Windows | Installer |
| Linux | AppImage |
The headless server runs anywhere Node 24 does (see Remote and headless).
This is the beginning of the README. Read the rest at the original. Read the full README ↗
