FAQ
Questions, answered plainly.
The beta, the agents, your data, Halterio Cloud and installing. If yours isn’t here, the plain-language summary covers the rest.
About Halterio
What it is, who it’s for, and what the beta means.
Halterio is in beta. What does that mean?
It’s ready for daily work, but it’s pre-1.0: builds aren’t code-signed yet, things still change between versions, and some rough edges are left. The app updates itself, so fixes reach you without a reinstall. See what’s on the way.
What is Halterio, in one sentence?
A desktop app where you run and supervise all your coding agents, the way an inbox is where you handle all your email. It starts several agents at once, keeps each on its own branch, and shows you which one needs you and what each one changed.
Who is it for?
Developers who already use a coding agent such as Claude Code or Codex and want to run more than one at a time without losing track, or want their agents to keep moving while they’re away from the desk.
How is this different from running the CLIs in a terminal?
It runs the same CLIs, so you can keep doing that. What Halterio adds is everything around them: a separate checkout per session, an inbox that tells you which agent is waiting, diffs and pull requests beside the chat, your phone as a remote, and agents that can lead other agents.
Is Halterio an editor?
No. It shows the diff, the files and terminals beside each session, and opens any session in Cursor, VS Code, Zed or Terminal when you want to edit by hand.
Agents and accounts
The nine it runs, and whose plan pays for them. More on the agents page.
Which coding agents does it support?
Claude Code, Codex, Cursor, Devin, Grok, Hermes, Pi, opencode and Antigravity. Halterio runs each through its own command-line tool, so you need at least one installed and signed in. Each one, in detail.
Do I pay for the agents twice?
No. Halterio uses the agent CLIs you already have, signed in to your own plans. It shows how much of each plan is left, and can switch between your accounts.
Can Halterio install an agent for me?
Yes. Settings → Agents lists all nine. One that isn’t installed has an Install button, which runs the vendor’s own installer. Sign in to it once and every session can use it.
Can one agent run other agents?
Yes. Every session gets Halterio’s MCP server, so a lead agent can start helpers on any harness, each in its own git worktree, wait for any or all of them, and collect their results, branches and pull requests. You set how deep helpers go and how many run at once, and Stop all ends them.
Your data
Where it lives, what leaves your machine, and what an agent may touch.
Do I need an account?
No. There’s no sign-up and no required online service. Sessions stay on your machine. A free account adds syncing between your devices, and it’s the account Halterio Cloud uses if you want that.
Where does my data live?
In
~/.halterio on macOS and Linux, or %LOCALAPPDATA%\Halterio on Windows. The engine only listens on your own machine, and every connection needs a token it creates at start.Does anything leave my computer?
Your agents talk to their own providers, as they do in a terminal. Halterio itself sends nothing unless you turn something on: syncing with an account, a Cloud computer, or a paired device over Direct Link, which is end-to-end encrypted. Agent logins stay with the agent; Halterio doesn’t copy or store them.
Can an agent control my computer?
Only if you switch Computer Use on. It’s off by default, and even then it never types into terminals, password managers or system prompts. Remote devices get only the permissions you give them.
Cloud and pricing
The app is free. Only Cloud costs money. The details are on the pricing page.
What does Halterio cost?
The app is free, on your own computer and on your other machines, and so is syncing between your devices. You only pay for Halterio Cloud: Cloud computers that run your agents while your own computer sleeps, from $20 a month. Your agents still use your own plans.
What is a Cloud computer?
A Linux machine that Halterio runs for you. You sign in to your agents on it once, then use it from the app like any other computer. It keeps working while your laptop sleeps, stops after a few idle minutes, and a stopped computer uses no hours. How hours work.
Can I cancel Halterio Cloud?
Yes, any time, from Manage billing on your account page. You keep the month you paid for, and extra hours you bought never expire.
Download and install
Platforms, the first launch and updates. Step by step on the download page.
Where do I download it?
Right here: version 0.4.0 is out for macOS on Apple silicon, Windows x64, and Linux on x86_64 and arm64. Intel Macs aren’t supported yet.
Why does my system warn me the first time?
Early builds aren’t code-signed yet. On macOS, Control-click Halterio in Applications and choose Open, or allow it under System Settings → Privacy & Security. On Windows, choose More info, then Run anyway. The steps, and signed installers are on the way.
How do updates work?
Halterio checks for new versions on its own and installs them in the background. Choose Restart to update, or it switches over the next time you quit.
Can I use it from my phone?
Yes. Pair a phone or another computer once by QR code. The connection is end-to-end encrypted, needs no account, and each device gets only the permissions you give it. The iPhone and Android apps are in testing now.
Can it run on a server?
Yes. The same engine runs headless on a build machine or a VPS with
halterio headless, and the desktop app or your phone controls it. Mesh lets a session on one computer start and follow agents on another.