Guide
Orb documentation
What Orb is and how the guide is laid out, from your first session to pairing your phone.
Orb is a native macOS menu-bar app that keeps your agent sessions one keystroke away. Press a global hot key and a Liquid Glass dock slides in: a column of session bubbles on the right, the active session on the left. Each bubble is one running agent, and switching between them is instant because nothing restarts.
This guide is task first. Start with the basics, then dip into a concept when you need it.
Start here
- Getting started: install Orb, meet the requirements, and launch your first session.
- Keyboard shortcuts: the keys that drive the dock.
Concepts
- Bubbles and panes: what a session is, the agent and Terminal panes, and how sessions survive a restart.
- Profiles: choose an agent and where a session runs.
- Snapshots: freeze a set-up filesystem and boot new sessions from it in seconds.
- Spaces and displays: keep the same sessions on every screen, or pin them per Space.
- Containers: run a session inside Apple's native container runtime.
Reach and remove
- Mobile pairing: watch and answer sessions from your iPhone.
- Troubleshooting: fixes for the failures you are most likely to hit.
- Uninstall: where Orb stores its data and how to remove it cleanly.
For a short list of common questions, see the FAQ. For how Orb handles your data, see the security page.