omnihost688 1.0.1

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

# Production-ready output modes for DevOps automation
omnihost exec-all "hostname" --json       # Pure JSON (pipe to jq)
omnihost exec-all "uptime" --csv          # CSV for spreadsheets
omnihost exec-all "df -h" --quiet         # Minimal scriptable output
omnihost exec-all "ps aux" --compact      # Condensed single-line
omnihost exec-all "systemctl status nginx" --plain  # No colors/formatting

# 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

# Command History - track and replay commands
omnihost history                    # List recent commands
omnihost history show 42            # Show command details
omnihost history replay 42          # Replay a command

# SSH Tunnels - port forwarding made easy
omnihost tunnel create web01 8080 --remote-port 80
omnihost tunnel list                 # List active tunnels
omnihost tunnel stop web01 8080     # Stop a tunnel

# Jump Hosts - access private servers through bastions
omnihost add private-server -h 10.0.0.5 --jump-host bastion

# Performance Profiling - optimize your operations
omnihost profile list                # List profile files
omnihost profile show profile.prof   # Analyze performance

🎯 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, exec-group)
• Quick commands for common DevOps tasks
• Default server configuration (no need to specify every time)
• Connection pooling and caching
• Production-ready output modes (JSON, CSV, quiet, plain, compact)
• Scriptable output for CI/CD pipelines and automation

🎨 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
• Audit logging - All commands tracked automatically

⚙️ Configuration Management

• Environment variables - Configure via OMNIHOST_* env vars
• Config validation - omnihost config validate
• Config export/import - Backup and restore configurations
• Default server - Set once, use everywhere
• Server groups - Organize servers logically
• Command aliases - Reusable command shortcuts

📦 Installation

From PyPI (Recommended)

pip install omnihost

Note: After installation, you may want to install man pages:

# Linux/Mac (requires sudo for system-wide)
sudo python -m omnihost.install_man_pages

# Or user-specific (no sudo needed)
python -m omnihost.install_man_pages

Then you can use: man omnihost

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)

# Or use environment variable:
export OMNIHOST_DEFAULT_SERVER=web01

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"

# Production-ready output modes
omnihost exec-all "hostname" --json        # Pure JSON for parsing
omnihost exec-all "uptime" --csv           # CSV for reports
omnihost exec-all "df -h" --quiet          # Minimal for scripts
omnihost exec-all "ps aux" --plain         # No ANSI colors
omnihost exec-all "ls -la" --compact       # One line per server
omnihost exec-all "uptime" --show-output   # Show detailed output (opt-in)

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.

⚙️ Configuration

Output Modes for DevOps Automation

OmniHost provides multiple output formats optimized for different use cases:

Mode	Flag	Use Case	Example
JSON	--json	CI/CD pipelines, parsing with jq	omnihost exec-all 'cmd' --json | jq
CSV	--csv	Spreadsheets, reports, analytics	omnihost exec-all 'cmd' --csv > report.csv
Quiet	--quiet, -q	Shell scripts, log files	omnihost exec-all 'cmd' --quiet
Plain	--plain	Legacy systems, plain text logs	omnihost exec-all 'cmd' --plain
Compact	--compact	Quick checks, condensed output	omnihost exec-all 'cmd' --compact
Default	(none)	Interactive use, rich formatting	omnihost exec-all 'cmd'

Key Features:

• --json outputs pure JSON (no decorative panels) - perfect for piping to jq
• --csv exports to CSV format - import into Excel or databases
• --quiet provides minimal one-line output per server - ideal for scripts
• --plain removes all ANSI formatting - for legacy terminals or log files
• --compact shows condensed single-line format - quick status checks
• --show-output displays detailed command output (opt-in, default is summary only)

Examples:

# Parse JSON in CI/CD pipeline
omnihost exec-all 'hostname' --json | jq -r '.results[].output'

# Export to spreadsheet
omnihost exec-all 'uptime' --csv > server_uptime.csv

# Shell script integration
for server in $(omnihost exec-all 'hostname' --quiet | grep '✓' | cut -d: -f1); do
  echo "Processing $server"
done

# Clean logs without colors
omnihost exec-all 'systemctl status nginx' --plain >> audit.log

# Quick status check
omnihost exec-all 'df -h /' --compact

Environment Variables

OmniHost supports configuration via environment variables (takes precedence over config file):

export OMNIHOST_DEFAULT_SERVER=web01
export OMNIHOST_OUTPUT_MODE=compact
export OMNIHOST_PARALLEL=10
export OMNIHOST_TIMEOUT=60
export OMNIHOST_AUDIT_ENABLED=true

Config Management

# Show current configuration
omnihost config show

# Validate configuration
omnihost config validate

# Export configuration (backup)
omnihost config export
omnihost config export --output my-config.json

# Import configuration (restore)
omnihost config import my-config.json
omnihost config import my-config.json --merge  # Merge with existing

📖 Documentation

• Quick Reference - Command cheat sheet
• Performance Guide - Optimization tips
• Architecture - Code structure
• CLI Best Practices - Best practices
• Feature Roadmap - Planned features
• 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 /" --compact | grep "9[0-9]%"

# Export server inventory to CSV
omnihost exec-all "hostname && cat /etc/os-release | grep PRETTY_NAME" --csv > inventory.csv

# Quick status check in shell script
if omnihost exec-all 'systemctl is-active nginx' --quiet | grep -q '✗'; then
  echo "Alert: Some servers have nginx down!"
fi

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

📚 Commands Reference

Server Management

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

Execution

Command	Description	Example
exec	Execute command on server	omnihost exec myserver "ls -la"
connect	Open interactive shell	omnihost connect myserver
exec-all	Execute on all servers	omnihost exec-all "uptime" --parallel 10
exec-multi	Execute on specific servers	omnihost exec-multi "web01,web02" "df -h"
exec-group	Execute on server group	omnihost exec-group web "systemctl restart nginx"

Output Mode Flags (available for all bulk commands):

• --json - Pure JSON output for parsing
• --csv - CSV format for spreadsheets
• --quiet / -q - Minimal scriptable output
• --plain - No ANSI colors/formatting
• --compact - Condensed single-line format
• --show-output - Display detailed command output

Configuration

Command	Description	Example
config show	Show configuration	omnihost config show
config set-default	Set default server	omnihost config set-default web01
config validate	Validate configuration	omnihost config validate
config export	Export configuration	omnihost config export
config import	Import configuration	omnihost config import backup.json

Groups & Aliases

Command	Description	Example
group add	Create server group	omnihost group add web web01 web02
alias add	Create command alias	omnihost alias add restart-nginx "sudo systemctl restart nginx"

📝 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!

🤝 Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

Quick start:

git clone https://github.com/sagarmemane135/omnihost.git
cd omnihost
python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip install -e .

📄 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

✅ Implemented

• Server management (add, edit, remove, list)
• Remote command execution
• Interactive shell sessions
• Bulk parallel operations
• Quick DevOps shortcuts
• Server grouping
• Command aliases
• File transfer (push/pull)
• Configuration management
• Audit logging
• Dry-run mode
• JSON output
• Command history and replay ✨ NEW
• SSH tunnel management ✨ NEW
• Jump host / bastion support ✨ NEW
• Performance profiling tools ✨ NEW
• Man page generation ✨ NEW
• Test suite structure ✨ NEW

🚧 Planned

• Custom command templates
• Real-time log streaming
• Output comparison across servers
• Cloud provider integration (AWS, Azure, GCP)
• Ansible playbook integration

See Feature Roadmap for detailed information.

🆘 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!