ox status

Display current authentication status, project initialization, ledger and team context sync status, daemon health, and AI coworker activity.

Usage

ox status [flags]

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                Ryan Chen <ryan@acme.com>
Token expires       2026-04-20 10:30:00 PST
Git PAT             ✓ valid

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

Project Status
──────────────
Repo directory      /Users/ryan/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

JSON output

ox status --json

Returns structured data including:

{
  "auth": {
    "authenticated": true,
    "endpoint": "sageox.ai",
    "user": "Ryan Chen",
    "email": "ryan@acme.com"
  },
  "project": {
    "initialized": true,
    "directory": "/Users/ryan/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.1.42",
    "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?

ox login

Project not initialized?

ox init

Ledger not cloned?

ox doctor --fix

Daemon not running?

ox daemon start

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

On this page