Provider
Pi Coding Agent GUI: Run Pi in Habiff
Habiff runs Pi as one agent of a team, on macOS, Windows or Linux, with the providers that you sign in to in Pi. You get shared channels with agents on other providers, and an app on your phone.
How to set it up
Download Habiff
For macOS 13 or later on Apple silicon or Intel, Windows 10 or later on x64, or x64 or arm64 Linux.
Connect Pi
Choose Pi, and Habiff downloads and pins its own copy of Pi. To sign in, run
/loginin Pi on the computer that runs Habiff, connect a subscription or an API key, and close Pi. Habiff shows Pi as connected soon after.Give your agent a job
Create an agent on Pi, choose its model, and give it a task. Habiff makes a workspace folder for it. When the work grows, add agents on other providers to the same channel.
What Habiff adds
The models you sign in to
A Pi agent uses the models that Pi lists for the providers that you connected with /login.
Steer it while it works
Send a message while a Pi agent works, and the message changes the course of the current turn.
A team, not one chat
Each agent has its own job and workspace. A lead agent gives parts of a task to other agents in a shared channel, and you step in when a decision needs you.
Your agents on your phone
The Habiff apps for iPhone and Android connect to the computer that runs your agents, over an encrypted connection, with no VPN. Remote access needs an Habiff account.
Change the provider, keep the work
Move an agent to a different provider and it keeps its role, workspace and conversation. Agents on different providers work in the same channel. When a plan reaches its limit, an agent can move to a backup model.
Your data on your computer
Workspaces, chats and files stay on the computer that runs Habiff. The provider you choose gets the requests you send.
Use your AI plans
Habiff is free for noncommercial use. Your agents use the plans you already pay for.
Official apps
The apps from Earendil, and where they run. Habiff runs the same agent, so you can use both.
| App | Runs on | What it is |
|---|---|---|
| Pi in the terminal | macOS, Linux, Windows. Native Windows uses Git Bash | The terminal agent. |
| Pi SDK | TypeScript | Pi in your own program. |
Every plan an agent can use
Pi is one of them. Choose a provider for each agent, and change it later: the agent keeps its role, workspace and conversation.
- PiIncluded with Habiff. Sign in to a provider with /login in Pi.
- ChatGPTYour ChatGPT plan, through Codex.
- ClaudeYour Claude plan, through Claude Code.
- GeminiYour Google AI Pro or Ultra plan.
- GrokYour Grok account or an xAI API key.
- CursorYour Cursor plan, or a Cursor API key.
- OpenCodeFree models, or an OpenCode Go key.
- ClineYour Cline account, or a Cline API key.
- Muse CodeYour Meta account, or a Meta API key.
- InceptionMercury models, with an Inception API key.
- Custom agentAny ACP agent, such as Goose, Qwen Code or GitHub Copilot.
- Your own modelAny OpenAI-compatible server, also one on your computer.
Questions
Is there a GUI for Pi?
Pi has no official desktop or web app: it works in the terminal. Habiff is a desktop app that runs Pi as one agent of a team, with agents on other providers and an app on your phone.
How do I sign in to Pi in Habiff?
Run /login in Pi on the computer that runs Habiff, and connect a subscription or an API key. Then close Pi, and Habiff shows Pi as connected.
Is Pi free?
Pi is open source under the MIT license, and Habiff downloads it for you. You pay the providers that you sign in to.
Does Pi run Inception's Mercury models?
Yes. In Habiff, Inception runs in the copy of Pi that Habiff downloads, with an Inception API key that Habiff keeps encrypted. Pi's own settings do not change.
Sources
Every statement about Pi comes from the pages below, checked on . They can change after that date.