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.25.0. Run ox version to check yours and ox upgrade to update. See ox release-notes for what changed.
Installation
terminal
$
Or install with Homebrew:
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, symbols, history, PRs, and comments in this repo |
ox decision | Work with Decision Records (ADRs, DDRs), enriched with Team Context |
ox index | Index code and project data for search |
ox init | Initialize SageOx for this repository |
ox plan | Work with plans (enrich, render, review) |
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 brief | Show what SageOx gave this session |
ox conversation | Read recorded team conversations from the local Team Context |
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 |
ox skills | Inspect the skills your AI coworkers have |
Teams
| Command | Description |
|---|---|
ox bulletin | Post to the team bulletin board (team Feature Preview) |
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 (not for human use) |
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 feedback | Send private product feedback to SageOx Support |
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 or a specific version |
ox version | Print version information |
Additional commands
| Command | Description |
|---|---|
ox addons | Install skills, rules, and the context each skill carries |
ox config | Manage ox configuration |
ox pet | Show Oxy, SageOx's mascot, in Claude Code and Codex |
ox uninstall | Remove SageOx from this repository |
ox view | Open the SageOx dashboard in your browser |
ox walkthrough | Show what was on screen, clicked, and pointed at in a walkthrough |
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> | User config file (overrides OX_USER_CONFIG) |
--no-input | Disable prompts and terminal UI; provide required input with arguments or flags |
--no-interactive | Disable spinners and TUI elements (auto-enabled when CI=true) |
--yes | Answer yes to confirmation prompts without reading stdin (overrides a piped answer) |
--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.json | 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