Display sync status, automation configuration, and recent activity for the current project.
Usage
Description
The status command shows:
- Repo ID and configured agent providers
- Sync automation status (post-commit, agent-complete hooks)
- Local push state (last backfill, events imported)
- Remote pull state (last sync, events received)
- Pending sync triggers
Flags
Working directory (defaults to current directory)
Output JSON instead of human-readable summary
Examples
Basic Status
Output:
Repo: owner/my-project
Agents: Codex, Claude Code
Auto-sync: enabled (post-commit:on, agent-complete:on)
Agent hooks: Codex, Claude Code
Auto pull on sync:on | TUI warm:on | cooldown=300s
Local push: last=2024-01-15T10:30:00Z (2h ago) | files=45/120 | events=1523 | sessions=12
Remote pull: last=2024-01-15T12:15:00Z (5m ago) | received=150 | imported=12 | dedup=138
Snapshot: fp=abc123... | same-count=0 | capped=no | pending=no
JSON Output
{
"cwd": "/home/alice/my-project",
"repoId": "owner/my-project",
"agentProviders": ["codex", "claude-code"],
"automation": {
"enabled": true,
"gitPostCommit": true,
"agentComplete": true,
"agentCompleteProviders": ["codex", "claude-code"],
"autoPullOnSync": true,
"autoWarmTuiOnOpen": true,
"remotePullCooldownSec": 300
},
"localPush": {
"lastRunAt": "2024-01-15T10:30:00Z",
"lastSuccessAt": "2024-01-15T10:30:00Z",
"lastScannedFiles": 120,
"lastMatchedFiles": 45,
"lastImportedEvents": 1523,
"lastImportedSessions": 12,
"mubitRequested": true,
"mubitEnabled": true,
"lastError": null,
"providers": {
"codex": {
"scannedFiles": 80,
"matchedFiles": 30,
"importedEvents": 1200,
"importedSessions": 8,
"lastRunAt": "2024-01-15T10:30:00Z",
"lastSuccessAt": "2024-01-15T10:30:00Z",
"lastError": null
}
}
},
"remote": {
"lastRunAt": "2024-01-15T12:15:00Z",
"lastSuccessAt": "2024-01-15T12:15:00Z",
"receivedTimelineCount": 150,
"lastImported": 12,
"lastDeduplicated": 138,
"lastSnapshotFingerprint": "abc123...",
"consecutiveSameSnapshotCount": 0,
"suspectedServerCap": false,
"pendingTrigger": {
"pending": false
},
"lastError": null
}
}
Output Details
Repo: owner/my-project
Agents: Codex, Claude Code
- Repo - Resolved repo ID (from Mubit project ID or local path hash)
- Agents - Configured agent providers
Automation Status
Auto-sync: enabled (post-commit:on, agent-complete:on)
Agent hooks: Codex, Claude Code
Auto pull on sync:on | TUI warm:on | cooldown=300s
- Auto-sync - Master automation toggle
- post-commit - Git post-commit hook installed
- agent-complete - Agent completion hooks installed
- Agent hooks - Providers with agent-complete hooks
- Auto pull on sync - Pull after sync operations
- TUI warm - Pull on TUI startup
- cooldown - Minimum seconds between auto-pulls
Local Push State
Local push: last=2024-01-15T10:30:00Z (2h ago) | files=45/120 | events=1523 | sessions=12
- last - Last push timestamp (absolute + relative)
- files - Matched files / scanned files
- events - Total events imported
- sessions - Total sessions imported
If no push yet:
Local push state: none
Backfill: run `codaph push` if you want historical agent sessions in Mubit.
Remote Pull State
Remote pull: last=2024-01-15T12:15:00Z (5m ago) | received=150 | imported=12 | dedup=138
Snapshot: fp=abc123... | same-count=0 | capped=no | pending=no
- last - Last pull timestamp
- received - Events fetched from Mubit
- imported - New events added
- dedup - Events deduplicated (already present)
- fp - Snapshot fingerprint (hash of received events)
- same-count - Consecutive identical snapshots (staleness indicator)
- capped - Whether Mubit hit the requested limit (suggests more data available)
- pending - Pending sync trigger waiting to run
If no pull yet:
Remote sync state: none
Fast sync note: `codaph pull` skips local agent history replay; use `codaph push` for backfill.
Status Indicators
Healthy Status
Auto-sync: enabled (post-commit:on, agent-complete:on)
Local push: last=2h ago | files=45/120 | events=1523 | sessions=12
Remote pull: last=5m ago | received=150 | imported=12 | dedup=138
Needs Backfill
Local push state: none
Backfill: run `codaph push` if you want historical agent sessions in Mubit.
Automation Not Enabled
Auto-sync: off (post-commit:off, agent-complete:off)
Onboarding: run `codaph sync setup` to install auto-sync hooks for this repo.
codaph sync setup
# OR during init
codaph init
Server Cap Warning
Snapshot: fp=abc123... | same-count=0 | capped=yes | pending=no
codaph pull --timeline-limit 2400
Stale Snapshot
Snapshot: fp=abc123... | same-count=15 | capped=no | pending=no
Workflow Integration
Check Status After Init
codaph init
codaph status
# Verify automation enabled
Daily Status Check
codaph status
codaph pull # If remote pull is stale
Debug Sync Issues
codaph status --json > status.json
# Inspect status.json for errors
Troubleshooting
Automation Partially Installed
Auto-sync: enabled (post-commit:on, agent-complete:off)
! Warning: Claude Code agent-complete hook auto-install was not possible.
Last Error Present
Local push last error: Network timeout
Last error: Mubit authentication failed
codaph setup --mubit-api-key mb_live_...