Orbit Reference
Essential documentation for running Orbit, integrating with Antigravity, and organizing project workflows.
Getting Started
Quick start guide and architecture overview.
Orbit is a local-first desktop workspace that brings together AI-assisted development, agents, creative generation, and visual workflows.
Unlike conventional chat interfaces that discard context or concatenate noisy terminal logs, Orbit persists native provider session IDs, captures discovered project artifacts, and maintains clean project isolation.
Prerequisites & Antigravity Setup
Requirements for running Orbit with your Antigravity environment.
Orbit communicates directly with the installed Google Antigravity CLI (agy). You do not need to provide API keys, Python runtimes, or copied session tokens to Orbit.
- CLI Discovery: Orbit searches your system
PATHfor theagybinary, with an automatic fallback to~/.local/bin/agyon Unix platforms. - Path Override: Set the
ORBIT_AGY_PATHenvironment variable if your Antigravity binary is installed in a non-standard location. - Authentication: Orbit requires that you sign in to Antigravity beforehand using its official Google CLI or web sign-in command. Orbit never touches your credentials.
Projects & Conversations
Managing project contexts, conversations, and asset files.
Orbit organizes work hierarchically into Projects. Each project contains:
- Conversations: Dedicated multi-turn sessions. Each conversation persists its native Antigravity session ID for accurate turn continuity.
- Project Assets: Files and attachments explicitly imported into the project scope.
- Discovered Artifacts: Files created or edited by agents during runs, cataloged in local SQLite storage.
Artifacts & Inspection
How Orbit tracks and previews generated files and code diffs.
When an agent writes or modifies a file within your workspace, Orbit registers the output as a project artifact. The artifact panel provides immediate previews:
Rendered directly in the preview pane with zoom and pan.
Rendered inside sandboxed iframes for safe local interaction.
Formatted syntax preview with granular file mutation history.
Reference an artifact as context in another conversation with one click.
AgentDock Pro Subscription
Licensing and subscriber entitlement details.
Orbit is included as part of AgentDock Pro. There is no separate license fee or subscription needed for Orbit.
Subscriber accounts managed at agdc.dev receive access to Orbit desktop preview builds, multi-agent AIgency workflows, and priority support.
Troubleshooting
Common issues and runtime verification.
"Antigravity runtime unavailable" status
Verify that the agy CLI is installed and executable in your terminal (which agy). If installed in a non-standard directory, launch Orbit with ORBIT_AGY_PATH=/path/to/agy orbit.
Antigravity session authentication expired
Run agy auth login or re-authenticate through official Antigravity tooling. Orbit will automatically detect the renewed session credentials on the next turn.
Run cancellation
Clicking "Cancel" during an active run immediately terminates the child process for that specific turn. Your conversation history and previously saved artifacts remain completely intact.