ox CLI
The ox CLI connects your repositories to the SageOx platform, giving your AI coworkers access to Team Context: your team's decisions, conventions, and current work.
Installation
terminal
$
After installation, verify it works:
terminal
$
Quick setup
terminal
# Authenticate with SageOx
$
# Initialize your repository
$
# Verify everything works
$
Command reference
Authentication
| Command | Description |
|---|---|
ox login | Authenticate with SageOx using device flow |
ox logout | Remove stored credentials |
ox status | Show authentication and repository status |
Setup
| Command | Description |
|---|---|
ox init | Initialize a repository with SageOx |
ox doctor | Run diagnostics on your setup |
ox upgrade | Update ox to the latest version |
ox uninstall | Remove ox from your system |
Team Knowledge
| Command | Description |
|---|---|
ox query | Ask questions about your codebase and team context |
ox teams | List and manage team memberships |
ox import | Import recordings or transcripts |
ox coworker | Manage AI coworker configurations |
Code
| Command | Description |
|---|---|
ox code search | Semantic search across your codebase |
ox code index | Build or update the code index |
ox index | Manage repository indexes |
Memory
| Command | Description |
|---|---|
ox distill | Distill key decisions from discussions into Team Context |
Agent integration
| Command | Description |
|---|---|
ox agent prime | Inject Team Context into an AI coworker session |
ox agent session | Manage active AI coworker sessions |
Background services
| Command | Description |
|---|---|
ox daemon | Run the background sync daemon |
ox sync | Manually sync repository state |
Utilities
| Command | Description |
|---|---|
ox view | Open SageOx dashboard in browser |
ox version | Display ox version |
ox release-notes | Show release notes for current version |
Global flags
These flags work with any command:
| Flag | Description |
|---|---|
--verbose | Show detailed output |
--quiet | Suppress non-essential output |
--json | Output in JSON format (for scripting) |
--config <path> | Use a specific config file |
--no-interactive | Disable spinners and TUI elements (auto-enabled in CI) |
--profile | Generate CPU profile and execution trace for performance analysis |
Configuration
ox stores configuration in two locations:
| Location | Purpose |
|---|---|
~/.config/sageox/ | Global config and credentials |
.sageox/ | Repository-specific settings |
What's next
- CLI Quickstart - Get started in minutes
- ox init - Initialize your first repository
- ox login - Authentication details
- ox doctor - Troubleshoot setup issues
- ox agent prime - How AI coworkers get Team Context