# ox status (/docs/cli/commands/status)



ox status [#ox-status]

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

Usage [#usage]

```bash
ox status [flags]
```

What status shows [#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 [#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 [#flags]

| Flag     | Description                  |
| -------- | ---------------------------- |
| `--json` | Output as JSON for scripting |

JSON output [#json-output]

```bash
ox status --json
```

Returns structured data including:

```json
{
  "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 [#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 [#troubleshooting-with-status]

**Not logged in?**

```bash
ox login
```

**Project not initialized?**

```bash
ox init
```

**Ledger not cloned?**

```bash
ox doctor --fix
```

**Daemon not running?**

```bash
ox daemon start
```

Related commands [#related-commands]

* [ox doctor](/docs/cli/doctor) — Diagnose and fix common issues
* [ox daemon](/docs/cli/daemon) — Manage the background sync daemon
* [ox agent list](/docs/cli/agent) — List active AI coworkers