Omni CLI¶

The CLI of CLIs — A unified hub to orchestrate development tools.

What is Omni CLI?¶

Omni CLI is a unified command-line interface that connects and orchestrates multiple development tools in a single, consistent interface. Instead of remembering different CLI syntax for each tool, you use one CLI to rule them all.

  ██████  ███    ███ ██ ███    ██
 ██    ██ ████  ████ ██ ████   ██
 ██    ██ ██ ████ ██ ██ ██ ██  ██
 ██    ██ ██  ██  ██ ██ ██  ██ ██
  ██████  ██      ██ ██ ██   ████

Features¶

🤖 AI & MCP¶

Manage MCP (Model Context Protocol) servers for AI tool integration — add, remove, test, and monitor your AI agent infrastructure.

🧠 Memory Optimization¶

Optimize macOS memory using Thunderbolt 4 SSD as swap and cache extension. Monitor memory pressure, move app caches, and configure automatic optimization.

🌐 Cloud Management¶

Hostinger — Domains, DNS zones, and VPS management
Cloudflare — DNS records and cache purging
AWS — S3, EC2, and Route53 operations
Vercel — Project and deployment management

🐙 GitHub¶

Repository management, trending repositories, and batch cloning — all from the command line.

🚦 Feature Flags¶

Manage Unleash feature flags: toggle, create, archive, and check flag status across environments.

🔌 Plugin System¶

Extend Omni CLI with external plugins discovered via Python entry points. Install, list, and remove plugins dynamically.

🎭 Profiles¶

Switch between development, staging, and production configurations with a single command. Isolated credentials per profile.

⚙️ Smart Configuration¶

Centralized config via TOML files and environment variables. Single source of truth for all tools.

Quick Start¶

Install¶

pip install omni-cli

Or from source:

git clone https://github.com/mateussiqueira/omni-cli.git
cd omni-cli
pip install -e ".[dev]"

Verify¶

omni version
# Omni CLI version 0.1.0

Explore¶

omni status            # System status
omni --help            # All commands
omni memory status     # Memory status
omni github trending   # GitHub trending repos

Command Groups¶

Command	Description
`omni memory`	🧠 Mac memory optimization
`omni mcp`	🔌 MCP server management
`omni hostinger`	🌐 Hostinger domain/VPS management
`omni cloudflare`	☁️ Cloudflare management
`omni aws`	🌩️ AWS management
`omni vercel`	▲ Vercel management
`omni github`	🐙 GitHub repository management
`omni unleash`	🚦 Unleash feature flags
`omni plugins`	🔌 Plugin management
`omni config`	⚙️ Configuration management
`omni completion`	🐚 Shell completion
`omni update`	🚀 Self-update

Documentation¶

Getting Started — First steps with Omni CLI
Installation — Detailed installation guide
Command Reference — Complete command reference
Examples — Practical usage examples
Architecture — Project architecture
Use Cases — Real-world scenarios
FAQ — Frequently asked questions
Troubleshooting — Common issues

Advanced Topics¶

Memory Deep Dive — macOS memory internals
MCP Integration — AI tool integration
Plugin Development — Create plugins
Enterprise Setup — Team/org deployment
Performance — Optimization tips
Migration — Migrating from other tools

Project Structure¶

omni-cli/
├── src/omni/
│   ├── cli.py              # Main entrypoint
│   ├── commands/           # 12 command modules
│   │   ├── memory.py       # Memory optimization
│   │   ├── mcp.py          # MCP servers
│   │   ├── hostinger.py    # Hostinger API
│   │   ├── cloudflare.py   # Cloudflare API
│   │   ├── aws.py         # AWS operations
│   │   ├── vercel.py       # Vercel management
│   │   ├── github.py       # GitHub API
│   │   ├── unleash.py      # Feature flags
│   │   ├── plugins.py      # Plugin system
│   │   ├── config.py       # Configuration
│   │   ├── completion.py   # Shell completion
│   │   └── update.py       # Self-update
│   └── core/               # Core framework
│       ├── config.py       # Pydantic config
│       ├── executor.py     # Shell executor
│       ├── logger.py       # Logging + audit
│       ├── plugins.py      # Plugin discovery
│       └── profiles.py     # Profile management
├── tests/                  # Test suite
├── docs/                   # Documentation
├── assets/                 # Logos and images
└── pyproject.toml          # Project config