07Projects & File Scoping
SECTION 07•RUNTIME
Projects & File Scoping
Local directory binding, workspace isolation, and SQLite data schema.
Local Directory Binding
When you create or open a project in Orbit, the path is stored as an absolute directory binding. All file system checks, git status queries, and tool executions are dispatched with this directory as the root working directory.
Database Schema
Orbit uses a local SQLite database (orbit.db) located in your operating system's application data directory.
| Table | Primary Key | Key Fields |
|---|---|---|
| projects | id (TEXT) | name, root_path, created_at, last_opened_at |
| conversations | id (TEXT) | project_id, provider_conversation_id, title, status |
| turns | id (TEXT) | conversation_id, prompt, response, exit_code, duration_ms |
| artifacts | id (TEXT) | project_id, file_path, mime_type, file_size, last_modified |
Workspace Boundary Enforcement
Orbit validates relative and absolute target paths requested by agent tool calls. If a tool proposes writing to /tmp, ~/.ssh, or any directory outside the active project root, Orbit elevates the request to a high-priority warning modal requiring explicit override.