# ox CLI (/docs/cli)



ox CLI [#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 [#installation]

<Terminal>
  <TerminalCommand>
    curl -sSL 

    [https://raw.githubusercontent.com/sageox/ox/main/scripts/install.sh](https://raw.githubusercontent.com/sageox/ox/main/scripts/install.sh)

     \| bash
  </TerminalCommand>
</Terminal>

After installation, verify it works:

<Terminal>
  <TerminalCommand>
    ox version
  </TerminalCommand>
</Terminal>

Quick setup [#quick-setup]

<Terminal>
  <TerminalComment>
    Authenticate with SageOx
  </TerminalComment>

  <TerminalCommand>
    ox login
  </TerminalCommand>

  <TerminalComment>
    Initialize your repository
  </TerminalComment>

  <TerminalCommand>
    ox init
  </TerminalCommand>

  <TerminalComment>
    Verify everything works
  </TerminalComment>

  <TerminalCommand>
    ox doctor
  </TerminalCommand>
</Terminal>

Command reference [#command-reference]

Authentication [#authentication]

| Command     | Description                                |
| ----------- | ------------------------------------------ |
| `ox login`  | Authenticate with SageOx using device flow |
| `ox logout` | Remove stored credentials                  |
| `ox status` | Show authentication and repository status  |

Setup [#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 [#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 [#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 [#memory]

| Command      | Description                                              |
| ------------ | -------------------------------------------------------- |
| `ox distill` | Distill key decisions from discussions into Team Context |

Agent integration [#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 [#background-services]

| Command     | Description                    |
| ----------- | ------------------------------ |
| `ox daemon` | Run the background sync daemon |
| `ox sync`   | Manually sync repository state |

Utilities [#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 [#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 [#configuration]

ox stores configuration in two locations:

| Location            | Purpose                       |
| ------------------- | ----------------------------- |
| `~/.config/sageox/` | Global config and credentials |
| `.sageox/`          | Repository-specific settings  |

What's next [#whats-next]

* [CLI Quickstart](/docs/cli/quickstart) - Get started in minutes
* [ox init](/docs/cli/init) - Initialize your first repository
* [ox login](/docs/cli/auth) - Authentication details
* [ox doctor](/docs/cli/doctor) - Troubleshoot setup issues
* [ox agent prime](/docs/cli/prime) - How AI coworkers get Team Context