Skip to main content
The CLI is designed to keep working when the app is temporarily unreachable.

​
Local Files

Onyx stores local state under .git/onyx/.
FilePurpose
outbox.jsonlPending branch and experiment records.
history.jsonlOffline-searchable experiment history cache.
events.jsonlBest-effort activity feed for onyx listen.
last-run.jsonLatest measured but not yet logged run.

​
Idempotency

Each experiment has a client-generated runRef. Sync can retry safely because the server deduplicates by that key.

​
Commands

onyx status
onyx sync
onyx push
onyx exp list --limit 20
  • status shows pending local records and project resolution.
  • sync flushes the outbox, refreshes history, and requests repository sync.
  • push pushes the current git branch before syncing.
  • exp list searches local history and works offline.