# ox status (https://sageox.ai/docs/cli/status)

# ox status

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

## Usage

```bash
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

```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

| 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?**
```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

- [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