Guides
Drive Muse Code on a remote machine
Run the Helicon daemon and the muse CLI on the machine that holds your code, then open the web build in a browser and point it at that daemon. You get the same sidebar, diffs, approvals and cost view as the desktop app, with the agent running next to the repository instead of on your laptop.
Last updated · Markdown version
When this is the right shape
- The repository is large and the machine that holds it is not your laptop.
- Builds and test suites want more CPU than a laptop has.
- Code must not leave a particular machine.
- You want long runs to continue while the laptop sleeps.
What you need on the remote machine
- Node 22 or newer, because you are running the daemon from source rather than using the bundled runtime.
- The muse CLI, signed in with its own
muse loginon that machine. - A way to reach it: your own tunnel, VPN or reverse proxy.
Security posture
The daemon can start processes and edit files, because that is what a coding agent does. Treat it as you would any service with shell access: do not expose it to the open internet, put it behind a tunnel or a VPN, and keep the approval modes strict rather than turning on allow all.
Set up Helicon against a remote daemon
Install the muse CLI on the remote machine. Sign in there with its own login.
muse loginRun the daemon there. Node 22 or newer is required when running from source.
npm install && npm run devReach it privately. Use your own tunnel, VPN or reverse proxy rather than exposing the port.
Open the web UI. Point the browser build at the daemon and add the projects on that machine.
Frequently asked questions
Is there a hosted version?
No. The daemon is yours, on a machine you control.
Does the web UI have fewer features?
No. It is the same React UI as the desktop app. The difference is which machine the daemon runs on.
Can several people use one daemon?
Multi user deployment is out of scope today. Helicon targets an individual developer's own machines.
Keep reading
- Remote daemon and web UIThe same Helicon UI ships as a web app pointed at a daemon on another machine, so a laptop can supervise Muse Code running on a workstation or a server.
- LinuxAn x86_64 AppImage that runs on most distributions and updates itself. Make it executable, run it, and point it at a muse CLI that is signed in.
- Remote developmentRun the daemon and the muse CLI on the machine that holds the repository, then supervise from a browser on a laptop. Same UI, same sidebar, same approvals.
Same Muse Code. Same subscription. Better interface.
Free and MIT licensed. Signed Windows installer, universal macOS DMG, and a web build against a daemon you run.