helmrig
v0.7.5
Published
Headless development server for remote project management, terminals, and AI agents — open-source alternative to code-server for agent-first workflows.
Maintainers
Readme
Helmrig Server
Headless development server for remote project management, terminals, and AI agents.
An alternative to code-server, designed for the agent-first workflow — you manage projects and drive AI agents from ios client while the real work happens on a real machine.
Website: helmrig.app
Install
Requires Node.js ≥ 20.
npx helmrig@latestQuick start
helmrig opens a TUI cockpit in your terminal. From the home menu you can:
- Auth device — show a QR + one-time code to pair a new device.
- Manage devices — list paired devices, see details, revoke.
- Install daemon — run helmrig in the background on login (systemd user on Linux, launchd LaunchAgent on macOS).
- Check for updates — current vs latest on npm, install latest with hot-swap (no dropped connections).
[q] quits. Ctrl+C also quits.
If a daemon is already running, helmrig attaches to it as a read-only cockpit — no extra server is spawned, the existing one keeps the lock.
Run helmrig --help for the full list of CLI flags.
Auto-update
helmrig polls npm hourly for new versions and hot-swaps the server in place — no dropped connections, no manual npm update. The cockpit's Update menu lets you trigger an install on demand without waiting for the next poll.
License
Proprietary and closed-source. Copyright © Helmrig. All rights reserved.
The source code is not publicly available. Only the bundled npm package is distributed. Unauthorized copying, modification, redistribution, or reverse engineering is prohibited.
