Meet Fennec · Get started · The fen CLI · Feedback
Fennec runs the agent loop on a cloud computer while connecting it to approved files and tools on your Mac. Choose where each agent runs, keep using your terminal, and manage its sessions from the menu bar or fen.
Brain in the cloud. Hands on your Mac. The agent reasons and runs in its cloud session. When it needs your local project, files, or commands, it reaches your Mac through the access you approve.
Cloud sessions can keep working around the clock while their cloud computer is running. Closing your laptop ends its availability as a local tool, not the cloud session. Work that needs your Mac waits until it is reachable again.
|
Keep your editor, repository, and tools on your Mac. Choose Cloud computer for the agent loop, and approve the local files and commands it needs. |
Once a task has what it needs in the cloud, detach and close your Mac—even shut it down. The cloud process keeps running without an open terminal. |
|
Come back, run |
See Idle, Working, Needs input, and Errored sessions in the menu bar. Copy their attach commands or explicitly stop work you no longer need. |
- Open Fennec from your menu bar and sign in with your Runta account.
- Choose an agent. Select Cloud computer to enable cloud execution.
- Open your terminal and launch that agent as usual—for example,
codex. - Press Ctrl+C to detach. Fennec prints the command for that specific session. Run it to return, or run
fento choose from your live sessions.
Cloud execution needs a Runta account and model access configured for the agent. Cloud compute and model-provider charges are separate.
Cloud controls are currently available for Claude Code, Codex, and Pi. Other discovered agents are shown as Coming soon. Fennec synchronizes supported local model settings and credentials; it doesn't require matching local and cloud CLI versions.
Magpie is optional and off by default. Sign in to your agent locally; Fennec copies its supported native credentials into an isolated configuration directory in your cloud sandbox. Enable Settings → Magpie only if you want to select cloud models through Magpie. The same setting is available with fen settings magpie on|off.
A short command for sessions that stay with you. Start with fen to open the live-session picker; you don't need to remember a session ID.
When you detach, the terminal tells you exactly how to return. For a session named cone-leaf, the actual message is:
Session detached.
Run fen attach cone-leaf to reattach, or fen to manage sessions.
cone-leaf is the name assigned to that session, not something you need to invent. Use the name in your own detach message, or copy the attach command from Fennec's Sessions page.
fen # Pick a live session
fen attach cone-leaf # Reattach to a specific session
fen sessions # List sessions
fen stop cone-leaf # Explicitly stop a session| In the session picker | Action |
|---|---|
↑ / ↓ or j / k |
Select a session |
Enter |
Attach |
x |
Stop the selected session, with confirmation |
r |
Refresh |
Esc or q |
Leave the picker |
More terminal commands
fen status # Check Fennec's state
fen agents # List discovered agents
fen launch codex # Start a cloud Codex session
fen account # Inspect account state
fen billing # Inspect account usage
fen --help # See available commandsControl commands return structured JSON, making them useful in scripts as well as your terminal.
Ctrl+C detaches your terminal. The cloud agent keeps running. Closing the Fennec popup also leaves sessions running.
To end a session, use the agent's own exit command—such as /exit or Pi's /quit—or choose Stop session in Fennec.
Cloud execution doesn't move every dependency off your Mac. If a task needs local files, commands, or services through the connector, your Mac must remain reachable for that access. Approve local access only for the work you intend to allow.
Attach vs. resume
fen attach connects to an existing live process. For a finished Codex session, fen resume <session-id> can restore its saved conversation when Fennec can identify it unambiguously. It starts a new process; it is not a live attachment.
Found a rough edge? Open an issue with what you expected and what happened. Keep credentials and private terminal output out of public reports.
Want to contribute? See DEVELOP.md for architecture, builds, signing, and checks. Third-party assets and licenses are documented in THIRD_PARTY_NOTICES.md.
If Fennec makes your terminal feel a little more free, give it a star. ⭐
Built by Runta · Share feedback