Skip to content

mateussiqueira/omni-cli

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

9 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Omni CLI

Omni CLI โ€” The CLI of CLIs โ€” A unified hub to orchestrate development tools.

Python License PyPI CI Docs

  โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆ  โ–ˆโ–ˆโ–ˆ    โ–ˆโ–ˆโ–ˆ โ–ˆโ–ˆ โ–ˆโ–ˆโ–ˆ    โ–ˆโ–ˆ
 โ–ˆโ–ˆ    โ–ˆโ–ˆ โ–ˆโ–ˆโ–ˆโ–ˆ  โ–ˆโ–ˆโ–ˆโ–ˆ โ–ˆโ–ˆ โ–ˆโ–ˆโ–ˆโ–ˆ   โ–ˆโ–ˆ
 โ–ˆโ–ˆ    โ–ˆโ–ˆ โ–ˆโ–ˆ โ–ˆโ–ˆโ–ˆโ–ˆ โ–ˆโ–ˆ โ–ˆโ–ˆ โ–ˆโ–ˆ โ–ˆโ–ˆ  โ–ˆโ–ˆ
 โ–ˆโ–ˆ    โ–ˆโ–ˆ โ–ˆโ–ˆ  โ–ˆโ–ˆ  โ–ˆโ–ˆ โ–ˆโ–ˆ โ–ˆโ–ˆ  โ–ˆโ–ˆ โ–ˆโ–ˆ
  โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆ  โ–ˆโ–ˆ      โ–ˆโ–ˆ โ–ˆโ–ˆ โ–ˆโ–ˆ   โ–ˆโ–ˆโ–ˆโ–ˆ

๐Ÿš€ Overview

Omni CLI is a unified command-line hub that connects and orchestrates multiple development tools in a single interface:

  • ๐Ÿง  Memory: macOS memory optimization using Thunderbolt 4 SSD
  • ๐Ÿ”Œ MCP: Model Context Protocol server management
  • ๐ŸŒ Hostinger: Domain, DNS, and VPS management
  • โ˜๏ธ Cloudflare: DNS and cache management
  • ๐ŸŒฉ๏ธ AWS: S3, EC2, Route53 via AWS CLI
  • โ–ฒ Vercel: Projects and deployments
  • ๐Ÿ™ GitHub: Repository management, trending, and cloning
  • ๐Ÿšฆ Unleash: Feature flag management
  • ๐Ÿ”Œ Plugins: Install and manage Omni CLI plugins
  • ๐ŸŽญ Profiles: Switch between dev/staging/prod configurations
  • ๐Ÿš€ Self-update: Update Omni CLI from PyPI
  • โš™๏ธ Config: Centralized configuration

๐Ÿ“ฆ Installation

From PyPI (recommended)

pip install omni-cli

From source

# Clone the repository
git clone https://github.com/mateussiqueira/omni-cli.git
cd omni-cli

# Create virtual environment
python3 -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install in development mode
pip install -e ".[dev]"

# Or install directly
pip install .

โšก Quick Start

# Show overall status
omni status

# Show version
omni version

# Interactive initial setup
omni config init

๐Ÿ› ๏ธ Development with Makefile

Omni CLI includes a Makefile with common development tasks:

make install-dev    # Install with dev dependencies
make test           # Run tests
make lint           # Run linters
make format         # Format code
make type-check     # Run type checker
make build          # Build package
make clean          # Remove build artifacts

๐Ÿš Shell Completion

Enable tab completion for Omni CLI:

# Bash
omni completion install bash
source ~/.bashrc

# Zsh
omni completion install zsh
source ~/.zshrc

# Or view manual instructions
omni completion bash
omni completion zsh

๐Ÿ“š Documentation

Full documentation site: mateussiqueira.github.io/omni-cli โ€” with search, multi-language (EN/PT), and mobile-friendly layout.

๐Ÿง  Memory Commands

Optimize your Mac using a Thunderbolt 4 SSD as memory extension:

# Check memory status
omni memory status

# Setup Thunderbolt SSD
omni memory setup --disk /Volumes/ThunderboltSSD

# Start monitoring
omni memory monitor

# Move heavy app caches
omni memory cache-move docker

๐Ÿ”Œ MCP Commands

Manage MCP servers:

# List servers
omni mcp list

# Add a server
omni mcp add my-server npx -y @modelcontextprotocol/server-filesystem /path

# Remove a server
omni mcp remove my-server

# Test a server
omni mcp test my-server

๐ŸŒ Hostinger Commands

Manage your Hostinger infrastructure:

# List domains
omni hostinger domains

# List VPS instances
omni hostinger vps

# Show DNS records
omni hostinger dns conecthu.com

Set the token:

export OMNI_HOSTINGER_API_TOKEN=your_token_here

๐Ÿ™ GitHub Commands

# List repositories
omni github repos --user mateussiqueira

# Trending repositories
omni github trending --lang python

# Clone a repository
omni github clone mateussiqueira/omni-cli

Set credentials:

export OMNI_GITHUB_TOKEN=your_token_here
export OMNI_GITHUB_USERNAME=mateussiqueira

๐Ÿšฆ Unleash Commands

# List feature flags
omni unleash flags --project default

# Create a feature flag
omni unleash create my-flag --desc "Flag description"

# Enable/disable
omni unleash toggle my-flag true
omni unleash toggle my-flag false

Set credentials:

export OMNI_UNLEASH_URL=https://your-unleash.com
export OMNI_UNLEASH_API_TOKEN=your_token

โ˜๏ธ Cloudflare Commands

# List zones
omni cloudflare zones

# List DNS records
omni cloudflare dns example.com

# Purge cache
omni cloudflare purge example.com

Set credentials:

export OMNI_CLOUDFLARE_API_TOKEN=your_token

๐ŸŒฉ๏ธ AWS Commands

# Check AWS CLI status
omni aws status

# List S3 buckets
omni aws s3

# List EC2 instances
omni aws ec2 --region us-east-1

# List Route53 zones
omni aws route53

Requires AWS CLI to be installed and configured.

โ–ฒ Vercel Commands

# List projects
omni vercel projects

# List deployments
omni vercel deployments --project my-app

# List environment variables
omni vercel env my-app

Set credentials:

export OMNI_VERCEL_TOKEN=your_token

๐Ÿ”Œ Plugin Commands

# List installed plugins
omni plugins list

# Create plugin template
omni plugins create myplugin

# Install plugin
omni plugins install omni-cli-example

# Uninstall plugin
omni plugins uninstall omni-cli-example

๐ŸŽญ Configuration Profiles

# Create profiles
omni config profile create dev
omni config profile create prod

# Switch profile
omni config profile use dev

# List profiles
omni config profile list

๐Ÿš€ Self-Update

# Check for updates
omni update --check

# Update to latest version
omni update

# Force reinstall
omni update --force

โš™๏ธ Configuration

Omni CLI stores settings in ~/.config/omni/config.toml.

# Interactive setup
omni config init

# Show configuration
omni config show

# Set a value
omni config set thunderbolt_disk /Volumes/MySSD

# Show environment variables
omni config env

๐Ÿงช Testing

pytest

๐Ÿ—๏ธ Architecture

omni-cli/
โ”œโ”€โ”€ src/omni/
โ”‚   โ”œโ”€โ”€ cli.py              # Main entrypoint
โ”‚   โ”œโ”€โ”€ commands/           # Domain-specific commands
โ”‚   โ”‚   โ”œโ”€โ”€ memory.py
โ”‚   โ”‚   โ”œโ”€โ”€ mcp.py
โ”‚   โ”‚   โ”œโ”€โ”€ hostinger.py
โ”‚   โ”‚   โ”œโ”€โ”€ cloudflare.py
โ”‚   โ”‚   โ”œโ”€โ”€ aws.py
โ”‚   โ”‚   โ”œโ”€โ”€ vercel.py
โ”‚   โ”‚   โ”œโ”€โ”€ github.py
โ”‚   โ”‚   โ”œโ”€โ”€ unleash.py
โ”‚   โ”‚   โ”œโ”€โ”€ config.py
โ”‚   โ”‚   โ”œโ”€โ”€ completion.py
โ”‚   โ”‚   โ”œโ”€โ”€ plugins.py
โ”‚   โ”‚   โ””โ”€โ”€ update.py
โ”‚   โ””โ”€โ”€ core/               # Core utilities
โ”‚       โ”œโ”€โ”€ config.py
โ”‚       โ”œโ”€โ”€ executor.py
โ”‚       โ”œโ”€โ”€ logger.py
โ”‚       โ”œโ”€โ”€ plugins.py
โ”‚       โ””โ”€โ”€ profiles.py
โ”œโ”€โ”€ tests/                  # Tests
โ”œโ”€โ”€ docs/                   # Documentation (EN & PT)
โ”œโ”€โ”€ assets/                 # Logo and banner assets
โ”œโ”€โ”€ scripts/                # Utility scripts
โ”œโ”€โ”€ .github/workflows/      # CI/CD workflows
โ”œโ”€โ”€ Makefile                # Development tasks
โ”œโ”€โ”€ pyproject.toml          # Project configuration
โ””โ”€โ”€ README.md               # Main documentation

๐ŸŒ Leading Open Source Countries

Rank Country Highlight
1 ๐Ÿ‡บ๐Ÿ‡ธ USA Largest number of projects and contributors
2 ๐Ÿ‡จ๐Ÿ‡ณ China Large developer base (GitHub, Gitee)
3 ๐Ÿ‡ฉ๐Ÿ‡ช Germany Technical quality, Linux, KDE
4 ๐Ÿ‡ฌ๐Ÿ‡ง UK Innovation in web and infrastructure
5 ๐Ÿ‡ฎ๐Ÿ‡ณ India Fast-growing community
6 ๐Ÿ‡ซ๐Ÿ‡ท France Important European projects
7 ๐Ÿ‡จ๐Ÿ‡ฆ Canada Strong presence in AI and open data
8 ๐Ÿ‡ง๐Ÿ‡ท Brazil Active community, Python, PHP, JS
9 ๐Ÿ‡ฏ๐Ÿ‡ต Japan Ruby, infrastructure
10 ๐Ÿ‡ท๐Ÿ‡บ Russia Systems and security projects

๐Ÿค Contributing

  1. Fork the project
  2. Create your branch (git checkout -b feature/new-feature)
  3. Commit your changes (git commit -m 'Add new feature')
  4. Push to the branch (git push origin feature/new-feature)
  5. Open a Pull Request

๐Ÿ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.


Made with ๐Ÿ’™ by Mateus Siqueira

About

A CLI das CLIs - Unified hub to orchestrate development tools

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors