Documentation
CLICommands

ox uninstall

Completely remove SageOx from the current repository: the .sageox directory, git hooks, and agent integration files.

This is a destructive operation and cannot be undone.

Usage

terminal
$

What it removes

  1. The .sageox/ directory and all its contents
  2. Git hooks (prepare-commit-msg and others)
  3. Agent integration files (.claude/settings.json and similar)
  4. The ox agent prime entry from AGENTS.md / CLAUDE.md
  5. User-level integration hooks, when --user-integrations is set

Files tracked in git are unstaged but left in the working tree unless you explicitly request their removal.

If several endpoints are configured, you can pick which one to uninstall from, or pass --all to remove them all.

Examples

Preview the changes without touching anything:

terminal
$

Remove from every configured endpoint without a prompt:

terminal
$

Flags

FlagDescription
--allUninstall from all configured endpoints
--dry-runPreview what would be removed without making changes
--forceSkip the confirmation prompt for non-interactive use
--local-onlySkip the cloud notification (doesn't require login, but cloud resources won't be cleaned up)
--user-integrationsAlso remove user-level integration hooks

What's next

  • ox init - Set SageOx back up in a repository
  • ox doctor - Verify the repository's SageOx state