Maintenance
Keep your ox CLI up to date, check version info, and cleanly remove SageOx when needed.
Check your version
Shows the installed version, build date, and commit hash.
For machine-readable output:
Upgrade ox
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
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
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 |
Non-SageOx git hooks and user configurations are preserved. The CLI identifies SageOx-specific content and removes only that.
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
This shows exactly what will be removed without making any changes.
Clean reinstall
To start fresh with a clean SageOx setup:
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 distill
Distill team knowledge into structured memory from discussions, sessions, and GitHub activity
Cookbooks | SageOx Workflow Recipes and Integration Guides
Step-by-step workflow recipes for SageOx. Integrate with Loom, Figma, Cap, Claude Code, Codex, and OpenClaw. Build team knowledge that compounds over time.