ox integrate
Install or manage SageOx integrations with AI coding agents. The integration ensures that ox agent prime runs when an AI coding session starts, giving AI coworkers access to team context.
Usage
Supported agents
Claude Code is the default. Install any other agent with its flag.
| Agent | Integration method | Level |
|---|---|---|
| Claude Code | JSON hooks in .claude/settings.json | Project or User |
| Gemini CLI | Hooks (--gemini) | Project or User |
| Codex CLI | Hooks (--codex; add --user for every repository) | Project or User |
| Amp CLI | AGENTS.md marker (--amp) | Project |
| OpenCode | Plugin (--opencode) | Project or User |
| Pi | AGENTS.md marker (--pi) | Project |
| OMP | .omp/AGENTS.md marker (--omp) | Project |
| Factory Droid | Hooks (--droid) | Project or User |
| Cursor Agents Window | Hooks (--cursor) | Project |
Subcommands
| Command | Description |
|---|---|
ox integrate install | Install SageOx integration for AI coworkers |
ox integrate list | List integration status for all AI agents |
ox integrate uninstall | Uninstall SageOx integration from AI coworkers |
ox integrate install
Install SageOx hooks for AI coworkers.
What gets installed (project-level):
- Lifecycle hooks in
.claude/settings.json:SessionStart, Prime context on session startPreCompact, Re-prime before context compactionPostToolUse, Track tool usageStop, Clean up on stopSessionEnd, Finalize sessionUserPromptSubmit, Track prompts
- Git commit hooks (
prepare-commit-msg) for attribution trailers
ox integrate uninstall
Remove SageOx integration from AI coworkers. Use the agent-specific flags to uninstall from other agents.
ox integrate list
Show the status of SageOx integrations for all supported AI agents.
Flags
Flags for ox integrate install and ox integrate uninstall:
| Flag | Description |
|---|---|
--user | Install/uninstall at user level (all projects) |
--gemini | Target Gemini CLI instead of Claude Code |
--codex | Target Codex CLI instead of Claude Code |
--amp | Target Amp CLI instead of Claude Code |
--opencode | Target OpenCode instead of Claude Code |
--pi | Target the Pi coding agent instead of Claude Code |
--omp | Target OMP instead of Claude Code |
--droid | Target Factory Droid instead of Claude Code |
--cursor | Target Cursor Agents Window instead of Claude Code |
How integration works
Default integration
When you run ox integrate install, SageOx adds its hooks to Claude Code's settings.json. Run ox integrate list to see what is installed.
User-level integration
When you run ox integrate install --user, SageOx adds an ox:prime marker to ~/.claude/CLAUDE.md. This enables priming for all projects without per-project setup, including repositories that have not run ox init.
Verify the integration
After installing, start a Claude Code session. The session primes on start and receives an agent ID such as Oxa7b3.
If it doesn't, check:
What's next
- ox init - Initialize a project (includes integration)
- ox agent prime - Manually prime an AI coworker
- ox status - Check integration and sync status