A comprehensive SSH toolkit for managing connections, tunnels, and remote sessions with a modern CLI interface.
LazySSH simplifies SSH connection management with an elegant CLI interface. It helps you manage multiple connections, create tunnels, transfer files, and automate common SSH tasks.
- Dual Interface Modes: Interactive menu mode or command mode with smart tab completion
- Connection Management: Handle multiple SSH connections with control sockets
- Tunneling: Create forward and reverse tunnels with simple commands
- Dynamic Proxy: Set up SOCKS proxy for secure browsing
- SCP Mode: Transfer files securely between local and remote systems with rich visualization
- Terminal Integration: Open terminal sessions directly from LazySSH
- Human-Readable Output: Sizes and formatting optimized for readability
- Rich Visual Elements: Color coding, progress bars, and tree visualizations
# Install globally
pip install lazyssh
pipx install lazyssh
# Or install for the current user only
pip install --user lazyssh# Start LazySSH in command mode (default)
lazyssh
# Create a new connection
lazyssh> lazyssh -ip 192.168.1.100 -port 22 -user admin -socket myserver
# Create a connection with dynamic SOCKS proxy
lazyssh> lazyssh -ip 192.168.1.100 -port 22 -user admin -socket myserver -proxy 8080
# Create a tunnel
lazyssh> tunc myserver l 8080 localhost 80
# Open a terminal
lazyssh> term myserver
# Transfer files (SCP mode)
lazyssh> scp myserver
# In SCP mode: visualize remote directory tree
scp myserver:/home/user> tree
# Download files
scp myserver:/home/user> get config.jsonFor detailed documentation, please see the docs directory:
- User Guide: Comprehensive guide to using LazySSH
- Command Reference: Details on all available commands
- SCP Mode Guide: How to use the file transfer capabilities
- Tunneling Guide: Creating and managing SSH tunnels
- Troubleshooting: Common issues and solutions
- Development Guide: Information for contributors
- Publishing Guide: How to publish the package
- Python 3.11+
- OpenSSH client
- Terminator terminal emulator
MIT License
This repository uses GitHub Projects for issue and PR tracking. To use the automated project board features:
For detailed setup instructions, see .github/setup-project-board.md.
Quick setup:
- Create a new project at: https://github.com/users/YOUR_USERNAME/projects
- Name it "LazySSH Development"
- Configure the Status field with the predefined options
- Link your repository to the project
The repository includes automated workflows that will:
- Add new issues and PRs to the project board
- Update status based on labels and PR state
- Sync existing items when manually triggered
To manually trigger a sync of all open issues and PRs:
- Go to Actions → Project Board Automation
- Click "Run workflow"
- Check "Sync all open issues and PRs"
- Click "Run workflow"
Contributions are welcome! Please feel free to submit a Pull Request.