CLI
ox CLI
The ox CLI connects your repositories to the SageOx platform, giving your AI coworkers access to Team Context: your team's recorded discussions, decisions, and current work.
This reference tracks ox 0.14.0. Run ox version to check yours and ox upgrade to update. See ox release-notes for what changed.
Installation
terminal
$
After installation, verify it works:
terminal
$
Quick setup
terminal
# Authenticate with SageOx
$
# Initialize your repository
$
# Verify everything works
$
Command reference
Grouped as they appear in ox --help.
Software development
| Command | Description |
|---|---|
ox code | Search code in this repo |
ox decision | Work with Decision Records (ADRs, DDRs) |
ox index | Index code and project data for search |
ox init | Initialize SageOx for this repository |
ox plan | Work with plans |
ox pr | Author SageOx content for pull requests |
ox session | Manage AI coworker sessions |
ox viz | Choose, author, render, and lint visual explanations |
Knowledge
| Command | Description |
|---|---|
ox conversation | Read recorded team conversations from the local Team Context |
ox distill | Distill team observations into memory summaries |
ox import | Import a document, media file, or video URL into Team Context |
ox kb | Work with Knowledge Bubbles |
ox query | Search team knowledge |
ox recap | Show the concrete value SageOx has delivered to your work |
Teams
| Command | Description |
|---|---|
ox export | Show where your data lives and how to take it with you |
ox glance | See what your team's AI coworkers are working on |
ox murmur | Publish a coordination signal to other AI coworkers |
ox team | Work with your teams and coworkers |
Authentication
| Command | Description |
|---|---|
ox login | Authenticate with sageox.ai |
ox logout | Log out of SageOx |
ox status | Display SageOx status and directory locations |
ox sync | Manually sync ledger/team contexts (rarely needed) |
Agent integration
| Command | Description |
|---|---|
ox agent | UX exposed to AI coding agents |
ox agent prime | Inject Team Context into an AI coworker session |
ox coworker | Manage expert agents and subagents for your team |
ox hooks | Manage event hooks for daemon notifications |
ox integrate | Set up SageOx integration with Claude Code |
Diagnostics
| Command | Description |
|---|---|
ox adapter | Manage external adapter binaries |
ox daemon | Manage the background sync daemon |
ox doctor | Run diagnostics on ox installation and configuration |
ox gc | Reclone eligible managed repositories safely |
ox guide | Show a bundled topical guide |
ox release-notes | Display release notes for the current version |
ox upgrade | Upgrade ox to the latest version |
ox version | Print version information |
Configuration and utilities
| Command | Description |
|---|---|
ox config | Manage ox configuration |
ox uninstall | Remove SageOx from this repository |
ox view | Open the SageOx dashboard in your browser |
Global flags
These flags work with any command:
| Flag | Description |
|---|---|
-v, --verbose | Show detailed output |
-q, --quiet | Suppress non-error output |
--json | Output in JSON format (for scripting) |
-c, --config <path> | Config file path (default: .sageox/config.yaml) |
--no-interactive | Disable spinners and TUI elements (auto-enabled when CI=true) |
--profile | Generate a CPU profile and execution trace for performance analysis |
Configuration
ox stores configuration in two locations:
| Location | Purpose |
|---|---|
~/.config/sageox/ | Global config and credentials |
.sageox/config.yaml | 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