CLI Reference

The omnipotent binary is the Sovereign Command Interface. Built in Rust with Clap, it wraps Docker Compose and exposes the full runtime lifecycle.

Install: cd tools/omnipotent-cli && cargo install --path .

Commands

omnipotent init

Initialize a new Sector. Creates the .realm/ directory with federation config, security manifests, and state directories.

# Sovereign mode (default — solo, no sync)
omnipotent init

# Alliance mode with federation URL
omnipotent init --federation https://github.com/your-org/commons.git --mode alliance

Flag	Default	Description
`--federation <URL>`	None	Remote Commons repo URL
`--mode <MODE>`	`sovereign`	`sovereign` or `alliance`

omnipotent up

Bootstrap the Sovereign Swarm. Starts all Docker containers via Compose.

# Standard boot
omnipotent up

# Force rebuild containers
omnipotent up --build

Flag	Description
`-b, --build`	Force rebuild of all containers before starting

omnipotent plan

Enter the Infinite Planning Loop. Shadow Route orchestrates task dispatch, agent execution, and checkpoint validation.

# Default speed (balanced)
omnipotent plan

# Verbose mode for learning
omnipotent plan --speed turtle

# Fast execution
omnipotent plan --speed rabbit

Flag	Default	Description
`--speed <MODE>`	`half`	`turtle` (verbose), `half` (balanced), `rabbit` (fast)

omnipotent status

Show the current Swarm status. Agent health, memory tier states, active tasks, and blockers.

omnipotent status

omnipotent audit

Run the Sovereign Audit Protocol. Verifies file integrity against SHA-256 manifests, checks agent configurations, and reports anomalies.

omnipotent audit

omnipotent diplomat

Sync Alliance plans to the Commons repository. Runs the Diplomat agent's git-based federation protocol.

# One-shot sync
omnipotent diplomat

# Continuous background sync (every 30s)
omnipotent diplomat --watch

# Custom interval
omnipotent diplomat --watch --interval 60

# Force overwrite (dangerous)
omnipotent diplomat --force

Flag	Default	Description
`--watch`	off	Run continuously on interval
`--interval <SECS>`	`30`	Seconds between sync cycles
`--force`	off	Overwrite existing alliance directory

omnipotent tutorial

Launch the interactive Haunted House tutorial. A guided walkthrough of the core concepts in a story-driven format.

omnipotent tutorial

omnipotent tools

List all discovered tools and capabilities in the current Sector.

omnipotent tools

omnipotent purge

Clean up legacy files and temporary artifacts from the Sector.

omnipotent purge

omnipotent update

Self-update the binary via the Ouroboros Protocol. Downloads the latest release from GitHub.

omnipotent update

Note: Self-update is currently a stub. Build from source or download from the Releases page.

omnipotent uninstall

Uninstall Omnipotent. Stops containers, optionally removes data volumes and Docker images.

# Full uninstall
omnipotent uninstall

# Keep data volumes
omnipotent uninstall --keep-data

# Also prune Docker images
omnipotent uninstall --prune

Flag	Description
`--keep-data`	Preserve data volumes and `.realm/` directory
`--prune`	Remove associated Docker images