# Maintenance (https://sageox.ai/docs/cli/maintenance)

# Maintenance

Keep your ox CLI up to date, check version info, and cleanly remove SageOx when needed.

## Check your version

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

Shows the installed version, build date, and commit hash.

For machine-readable output:

<Terminal>
  <TerminalCommand>ox version --json</TerminalCommand>
</Terminal>

## Upgrade ox

<Terminal>
  <TerminalCommand>ox upgrade</TerminalCommand>
</Terminal>

The CLI detects how it was installed and uses the appropriate upgrade method:

| Install method | Upgrade command |
|----------------|-----------------|
| Homebrew | `brew upgrade ox` |
| `go install` | `go install github.com/sageox/ox@latest` |
| Manual download | Downloads latest binary from GitHub |

The `--json` flag outputs upgrade status in JSON format for scripting.

## View release notes

<Terminal>
  <TerminalCommand>ox release-notes</TerminalCommand>
</Terminal>

Displays release notes for the currently installed version.

| Flag | Description |
|------|-------------|
| `--latest` | Show notes for the latest available version |
| `--raw` | Output raw markdown without formatting |

## Uninstall ox from a repository

<Terminal>
  <TerminalCommand>ox uninstall</TerminalCommand>
</Terminal>

Removes SageOx from the current repository. The command prompts for confirmation before making changes.

### What gets removed

| Artifact | Description |
|----------|-------------|
| `.sageox/` | Configuration, cache, and daemon files |
| Git hooks | SageOx-installed `prepare-commit-msg` and `post-commit` hooks |
| `.claude/settings.local.json` | Agent integration settings (SageOx keys only) |
| `CLAUDE.md` / `AGENTS.md` | Removes `ox agent prime` references |

<Callout type="info">
Non-SageOx git hooks and user configurations are preserved. The CLI identifies SageOx-specific content and removes only that.
</Callout>

### Flags

| Flag | Description |
|------|-------------|
| `--dry-run` | Show what would be removed without making changes |
| `--force` | Skip confirmation prompt |
| `--local-only` | Remove local artifacts only (skip server deregistration) |
| `--user-integrations` | Also remove user-level integration hooks |
| `--all` | Remove from all repositories in the current directory tree |

### Preview changes first

<Terminal>
  <TerminalCommand>ox uninstall --dry-run</TerminalCommand>
</Terminal>

This shows exactly what will be removed without making any changes.

## Clean reinstall

To start fresh with a clean SageOx setup:

<Terminal>
  <TerminalComment>Remove existing installation</TerminalComment>
  <TerminalCommand>ox uninstall --force</TerminalCommand>
  <TerminalComment>Re-initialize</TerminalComment>
  <TerminalCommand>ox init</TerminalCommand>
  <TerminalComment>Verify setup</TerminalComment>
  <TerminalCommand>ox doctor</TerminalCommand>
</Terminal>

## Uninstall the CLI binary

`ox uninstall` removes SageOx from repositories. To remove the ox CLI itself:

| Install method | Removal command |
|----------------|-----------------|
| Homebrew | `brew uninstall ox` |
| `go install` | `rm $(go env GOPATH)/bin/ox` |
| Manual | Delete the binary from your PATH |

Global credentials are stored in `~/.config/sageox/`. Remove this directory to clear all authentication data.

## What's next

- [ox doctor](/docs/cli/doctor) - Diagnose setup issues after reinstalling
- [ox init](/docs/cli/init) - Re-initialize a repository
- [ox login](/docs/cli/auth) - Re-authenticate if needed