File & Directory Layout

The Orbit data directory

All of Orbit’s system state lives under ~/.orbit/:

~/.orbit/
├── config.json          # Projects, settings, server config
├── vault.json           # AES-256-GCM encrypted secrets
├── queue.db             # SQLite prompt queue
├── server.pid           # Orbit Server process PID
├── wake-requested.flag  # Written by the Wake Receiver if Electron isn't running
├── wake.log             # Wake attempt log
├── orbit.log            # General server log
├── renderer-crash.log   # Replayed in a startup banner
├── qa-results.db        # QA harness results
├── global/              # Global context (all projects)
├── locks/               # Per-project spawn locks ({slug}.pid)
├── logs/                # Server and dev-server logs; logs/prompts/ raw transcripts
├── memory/              # Universal persistent memory (global.md, {project}.md)
├── plugins/             # Installed plugins
└── captures/            # Screenshot/photo captures

A parallel ~/.orbit-sandbox/ backs the sandbox server sidecar on port 4856.

Path constants live in a single src/paths.js — there are no hardcoded path strings elsewhere in the codebase.

Per-project files

In each registered project:

{project}/
├── COMPLETION_LOG.md         # Append-only audit trail of shipped prompts
├── COMPLETION_LOG.archive.md # Full entries (compact rows stay in COMPLETION_LOG.md)
└── context/                  # Project context files
    ├── handoffs/             # Category-organized session handoffs
    ├── audits/               # Read-only audit reports
    └── ...                   # specs, tech stack, conventions, design references