ox status

Display current authentication status, project initialization, ledger and team context sync status, daemon health, and AI coworker activity. Status also shows a tree view of all SageOx directory locations.

Usage

terminal

What status shows

Status provides a comprehensive view of your SageOx setup:

Authentication: Login state, user identity, token expiration, git PAT validity
Configuration: User config directory location
Project: Whether the current repo is initialized, code index status
Ledger: Sync status, visibility, access level
Team Context: Connected teams, sync state, staleness warnings
Daemon: Running state, uptime, sync statistics, summarizer agent
AI Coworkers: Active coworker count and status

Example output

Authentication Status
─────────────────────
Endpoint            sageox.ai (✓ logged in)
User                Person A <person@test.sageox.ai>
Session             ✓ auto-refresh enabled (~/.config/sageox/auth.json)
Git PAT             ✓ valid

Configuration
─────────────
User config dir     ✓ ~/.config/sageox

Project Status
──────────────
Repo directory      /Users/person/src/acme-app
  SageOx state      ├── .sageox/ dir ✓
  Code indexed      └── 2m ago  (git history, symbols)

Ledger              repo_abc123
  Visibility        private (✓ member)
  Path              .sageox/ledger
  Status            ✓ synced (2m ago)

Team                acme-eng
  Visibility        private (✓ member)
  Path              .sageox/teams/primary
  Status            ✓ synced (5m ago)

Daemon Sync
───────────
Status              ✓ running 2h (pid 12345)
Summarizer          claude (auto)
Total syncs         142 (12 last hour)
Activity (4h)       ▁▂▃▅▇▅▃▂▁▁▂▃▄▅▆▇▅▃▂
                    -4h        -2h        now

AI Coworkers        2 active  (ox agent list)

Flags

Flag	Description
`--json`	Output as JSON for scripting
`-v, --verbose`	Show opaque IDs and full on-disk paths

JSON output

terminal

Returns structured data including:

{
  "auth": {
    "authenticated": true,
    "endpoint": "sageox.ai",
    "user": "Person A",
    "email": "person@test.sageox.ai"
  },
  "project": {
    "initialized": true,
    "directory": "/Users/person/src/acme-app",
    "code_index": {
      "indexed": true,
      "commits": 1234,
      "symbols": 5678
    }
  },
  "ledger": {
    "configured": true,
    "status": "synced",
    "visibility": "private"
  },
  "daemon": {
    "running": true,
    "pid": 12345,
    "total_syncs": 142
  },
  "version": {
    "current": "0.25.0",
    "update_available": false
  }
}

Common status indicators

Indicator	Meaning
`✓ synced`	Up to date with remote
`⚠ stale`	Last sync was too long ago
`✗ not cloned`	Repo exists remotely but not locally
`⟳ setting up...`	Initial clone in progress
`not accessible`	Logged in but no access to this resource

Troubleshooting with status

Not logged in?

terminal

Project not initialized?

terminal

Ledger not cloned?

terminal

Daemon not running?

terminal

What's next

ox doctor: Diagnose and fix common issues
ox daemon: Manage the background sync daemon
ox agent list: List active AI coworkers

On this page