omnihost688 1.0.0

A feature-rich SSH server management CLI tool

🚀 OmniHost

High-Performance SSH Management CLI for DevOps Engineers

Manage hundreds of servers with lightning-fast parallel execution, beautiful CLI output, and DevOps-focused shortcuts.

Features • Installation • Quick Start • Documentation • Contributing

---

⚡ Highlights

# Quick start
omnihost --version              # Check version
omnihost examples               # See usage examples

# Server Groups - organize your infrastructure
omnihost group add web web01 web02 web03
omnihost exec-group web "systemctl restart nginx"
omnihost exec-group web "uptime" --dry-run  # Preview first!

# Command Aliases - reduce repetitive typing
omnihost alias add restart-nginx "sudo systemctl restart nginx"
omnihost exec-group web restart-nginx

# File Transfer - push/pull files easily
omnihost push web01 ./app.tar /opt/app/
omnihost pull db01 /var/log/mysql.log ./logs/
omnihost push web01 ./dist /var/www/ --recursive

# Execute on all servers in parallel - 10x faster, with retry & dry-run
omnihost exec-all "systemctl status nginx" --parallel 10 --retries 2 --dry-run
omnihost exec-all "uptime" --json | jq '.succeeded'  # CI/CD integration

# Quick DevOps shortcuts - no need to type full exec commands
omnihost uptime  # Uses default server
omnihost disk web01
omnihost memory db01

# Beautiful, formatted output with Rich library
omnihost list  # Stunning table view of all servers

# Enhanced logging for troubleshooting
omnihost --verbose exec web01 "ls -la"
omnihost --debug exec-all "uptime"

# Audit logging - all commands tracked automatically
cat ~/.omnihost/audit.log  # JSON audit trail

🎯 Why OmniHost?

Problem	Traditional Approach	OmniHost
Check 20 servers	20 × 3s = 60 seconds	12 seconds (parallel)
Type repetitive commands	ssh user@host 'uptime'	omnihost uptime
Manage server configs	Edit ~/.ssh/config manually	Interactive omnihost add
View command output	Plain text	Beautiful formatted panels
Execute on multiple servers	Write bash loops	omnihost exec-all

✨ Features

🖥️ Server Management

• Add/Edit/Remove servers with interactive prompts
• List all configured servers with beautiful table view
• Info command with connection testing
• Integrates with SSH config (~/.ssh/config)

⚡ Performance Features

• Parallel execution on multiple servers (5-20x faster)
• Bulk operations (exec-all, exec-multi)
• Quick commands for common DevOps tasks
• Default server configuration (no need to specify every time)
• Connection pooling and caching

🎨 Beautiful CLI

• Rich formatted output with colors and panels
• Progress bars for bulk operations
• Interactive prompts with validation
• Clean, organized command structure

🔐 Security

• SSH key authentication support
• No password storage
• Respects SSH config security settings
• Connection timeout management

📦 Installation

From Source

# Clone the repository
git clone https://github.com/sagar.memane/omnihost.git
cd omnihost

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

# Install
pip install -e .

Requirements

• Python 3.8 or higher
• SSH access to remote servers
• SSH keys configured (recommended)

🚀 Quick Start

1. Add Your First Server

omnihost add
# Follow interactive prompts

Or use command-line options:

omnihost add -a web01 -h 192.168.1.100 -u ubuntu --key ~/.ssh/id_rsa

2. List Servers

omnihost list           # Basic view
omnihost list -v        # Verbose with SSH keys

3. Set Default Server (Optional)

omnihost config set-default web01
# Now you can use: omnihost uptime (without specifying server)

4. Execute Commands

# Single server
omnihost exec web01 "df -h"

# All servers (parallel)
omnihost exec-all "uptime"

# Specific servers
omnihost exec-multi "web01,web02,db01" "systemctl status nginx"

5. Quick DevOps Commands

omnihost uptime web01          # Quick uptime
omnihost disk web01            # Disk usage
omnihost memory web01          # Memory usage
omnihost processes web01       # Top processes
omnihost status web01 nginx    # Service status
omnihost logs web01 nginx      # View logs

6. Interactive Shell

omnihost connect web01
# Full PTY support - run vim, htop, top, etc.

📖 Documentation

• Quick Reference - Command cheat sheet
• Performance Guide - DevOps patterns and optimization
• Architecture - Code structure and design
• Contributing - Development guide
• Security - Security policy
• Changelog - Version history

🎯 Common Use Cases

Daily Operations

# Morning health check
omnihost exec-all "uptime && free -h" --parallel 10

# Check disk space across infrastructure
omnihost exec-all "df -h /" --no-output | grep "9[0-9]%"

Deployments

# Deploy to web servers
omnihost exec-multi "web01,web02,web03" \
  "cd /app && git pull && systemctl restart app" --parallel 3

# Verify deployment
omnihost exec-multi "web01,web02,web03" "curl -s localhost/health"

Troubleshooting

# Quick diagnostics
omnihost memory prod01
omnihost processes prod01
omnihost logs prod01 nginx -n 100

# Check all servers for issues
omnihost exec-all "systemctl is-failed --quiet || echo 'Services OK'"

🏗️ Project Structure

omnihost/
├── __init__.py              # Package metadata  
├── cli.py                   # CLI entry point
├── config.py                # Configuration management
├── ssh_config.py            # SSH config operations
├── ssh_client.py            # Connection management
├── performance.py           # Caching & optimization
└── commands/                # Command modules
    ├── server_management.py # list, add, edit, remove, info
    ├── exec_command.py      # Remote execution
    ├── connect_command.py   # Interactive shell
    ├── bulk_operations.py   # exec-all, exec-multi
    ├── quick_commands.py    # Quick DevOps shortcuts
    └── config_command.py    # Configuration management

🤝 Contributing

• 📋 Beautiful table formatting for server lists
• ℹ️ Server information - View details and test connections
• 🔧 SSH config integration - Works with ~/.ssh/config
• 🎨 Rich formatting - Color-coded output and panels
• 💾 Persistent storage - All config saved to SSH config file
• 🔐 SSH key support - Use identity files for authentication

📚 Commands Reference

Command	Description	Example
list	Show all configured servers	omnihost list -v
add	Add a new server	omnihost add -a web01 -h 1.2.3.4 -u ubuntu
info	Show server details	omnihost info myserver
edit	Edit server configuration	omnihost edit myserver
remove	Remove a server	omnihost remove myserver
exec	Execute command on server	omnihost exec myserver "ls -la"
connect	Open interactive shell	omnihost connect myserver

📂 Project Structure

ServerManager/
├── omnihost/                      # Main package
│   ├── __init__.py               # Package metadata
│   ├── cli.py                     # CLI entry point
│   ├── ssh_config.py              # SSH config operations
│   ├── ssh_client.py              # Connection management
│   ├── utils.py                   # Shared utilities
│   └── commands/                  # Command modules
│       ├── __init__.py
│       ├── server_management.py   # list, add, edit, remove, info
│       ├── exec_command.py        # Remote command execution
│       └── connect_command.py     # Interactive shell
├── pyproject.toml                 # Package configuration
├── requirements.txt               # Dependencies
├── main.py                        # Legacy wrapper
├── README.md                      # This file
├── ARCHITECTURE.md                # Developer guide
└── QUICK_REFERENCE.md             # Quick reference

🔧 Development

Install in Development Mode

pip install -e .

Changes to the code are immediately reflected without reinstalling.

Run Tests

# Syntax check
python -m py_compile omnihost/*.py omnihost/commands/*.py

# Test commands
omnihost --help
omnihost list

Add New Commands

1. Create omnihost/commands/my_command.py
2. Import in omnihost/cli.py
3. Register with register_my_command(app)

See ARCHITECTURE.md for details.

🛠️ Requirements

• Python 3.8 or higher
• Unix-like system (Linux, macOS, WSL on Windows)
• SSH config file at ~/.ssh/config

📝 SSH Config

OmniHost works with standard SSH config format:

Host myserver
    HostName 192.168.1.100
    User ubuntu
    Port 22
    IdentityFile ~/.ssh/id_rsa

Host production
    HostName prod.example.com
    User admin
    IdentityFile ~/.ssh/prod_key

OmniHost can create and manage this file for you!

🎨 Example Sessions

Adding a Server

$ omnihost add
╭─────────────────╮
│ Add New Server  │
╰─────────────────╯
Server alias: web01
Hostname or IP address: 192.168.1.100
SSH username: ubuntu
SSH port [22]: 
Use SSH key file? [Y/n]: y
Path to private key [~/.ssh/id_rsa]: 

Configuration Summary:
  Alias: web01
  Hostname: 192.168.1.100
  User: ubuntu
  Port: 22
  Identity File: ~/.ssh/id_rsa

Add this server? [Y/n]: y
✓ Successfully added server 'web01'

Listing Servers

$ omnihost list

            Configured Servers             
╭────────┬─────────────┬───────────┬──────╮
│ Alias  │ Hostname    │ User      │ Port │
├────────┼─────────────┼───────────┼──────┤
│ web01  │ 192.168.1.100│ ubuntu   │  22  │
│ db01   │ 10.0.0.5    │ postgres  │  22  │
╰────────┴─────────────┴───────────┴──────╯

Total servers: 2

Executing Commands

$ omnihost exec web01 "df -h | head -5"

╭────────────────────── 🔌 Connecting ───────────────────────╮
│ Host: web01                                                 │
│ Server: ubuntu@192.168.1.100:22                            │
│ Command: df -h | head -5                                    │
╰─────────────────────────────────────────────────────────────╯

╭───────────────────── ✓ Output ─────────────────────────╮
│ Filesystem      Size  Used Avail Use% Mounted on       │
│ /dev/sda1        50G   20G   28G  42% /                │
│ tmpfs            16G     0   16G   0% /dev/shm          │
│ /dev/sdb1       100G   45G   51G  47% /data            │
╰─────────────────────────────────────────────────────────╯

🤝 Contributing

We love contributions! Here's how you can help:

1. Star this repo ⭐
2. Report bugs via GitHub Issues
3. Suggest features or improvements
4. Submit Pull Requests - see CONTRIBUTING.md

Development Setup

git clone https://github.com/sagar.memane/omnihost.git
cd omnihost
python3 -m venv venv
source venv/bin/activate
pip install -e .

See CONTRIBUTING.md for detailed guidelines.

📄 License

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

🙏 Acknowledgments

• Built with Typer - Modern CLI framework
• Styled with Rich - Beautiful terminal formatting
• SSH via Paramiko - Pure Python SSH implementation

📮 Support

• Issues: GitHub Issues
• Discussions: GitHub Discussions
• Security: See SECURITY.md for reporting vulnerabilities

🗺️ Roadmap

• Server management (add, edit, remove, list)
• Remote command execution
• Interactive shell sessions
• Bulk parallel operations
• Quick DevOps shortcuts
• Server grouping and tagging
• Command history and replay
• Custom command templates
• SSH tunnel management
• File transfer operations (SCP/SFTP)
• Integration with cloud providers (AWS, Azure, GCP)
• Web UI for server management
• Ansible integration

📈 Performance Benchmarks

Operation	Sequential	Parallel (--parallel 5)	Speedup
10 servers uptime	30s	6s	5x
20 servers status	60s	12s	5x
50 servers check	150s	30s	5x

Tests conducted on servers with ~300ms average latency

🆘 Troubleshooting

Command not found after installation

source venv/bin/activate  # Activate virtual environment
pip install -e .  # Reinstall if needed
which omnihost  # Should show path in venv

Connection issues

# Test SSH manually first
ssh -F ~/.ssh/config myserver

# Check server configuration
omnihost info myserver

Permission errors with SSH keys

chmod 600 ~/.ssh/id_rsa
chmod 700 ~/.ssh

Slow bulk operations

# Increase parallelism (default is 5)
omnihost exec-all "uptime" --parallel 10

# Reduce timeout for faster failure detection
omnihost exec-all "ping -c 1 google.com" --timeout 5

---

⬆ back to top

Made with ❤️ for DevOps Engineers

If you find OmniHost useful, please ⭐ star this repository!