# Bayesian SSH - Fast and Easy SSH Session Manager [](https://rustup.rs/) [](LICENSE) [](https://github.com/abdoufermat5/bayesian-ssh/actions/workflows/ci.yml) > **An ultra-fast and intelligent SSH session manager with Bayesian-ranked search, fuzzy matching, Kerberos support, bastion hosts, and advanced history management.** ## What is Bayesian SSH? **Bayesian SSH** transforms your SSH experience with intelligent automation: - **Bayesian-ranked search** - connections ranked by frequency, recency, and match quality - **Intelligent fuzzy search** across all commands - find connections by partial names, tags, or patterns - **One-click connections** to your servers - **Automatic Kerberos** ticket management - **Smart bastion host** routing - **Tag-based organization** for easy management - **Complete connection history** with statistics - **SQLite database** for persistence ## Quick Start ### Installation #### Option 1: One-liner Install (Recommended) ```bash # Install latest CLI release automatically (non-interactive) curl -fsSL https://raw.githubusercontent.com/abdoufermat5/bayesian-ssh/main/install.sh | bash # Install latest Desktop GUI release automatically (non-interactive) curl -fsSL https://raw.githubusercontent.com/abdoufermat5/bayesian-ssh/main/install.sh | bash -s -- --desktop # Interactive installation (choose CLI or Desktop) curl -fsSL https://raw.githubusercontent.com/abdoufermat5/bayesian-ssh/main/install.sh | bash -s -- --interactive ``` #### Option 2: Manual Build ```bash # Clone and build git clone https://github.com/abdoufermat5/bayesian-ssh.git cd bayesian-ssh # Build and install CLI version using Makefile make release make install # Build and install Desktop GUI version using Makefile make install-desktop ``` ### First Connection ```bash # Add a server bayesian-ssh add "My Server" server.company.com # Connect instantly bayesian-ssh connect "My Server" ``` ## 📖 Basic Usage ### Core Commands ```bash # Connect to a server (with fuzzy search) bayesian-ssh connect "Server Name" # Exact match bayesian-ssh connect "webprod" # Finds "web-prod-server" bayesian-ssh connect "prod" # Shows all production servers # Manage connections (all with fuzzy search) bayesian-ssh edit "webprod" # Edit connection settings bayesian-ssh show "dbprod" # Show connection details bayesian-ssh remove "apigateway" # Remove connection # Add new connection bayesian-ssh add "Server Name" hostname.com # List connections bayesian-ssh list # Import from SSH config bayesian-ssh import # Interactive TUI mode bayesian-ssh tui # Full-screen connection browser # Interactive Desktop GUI mode bayesian-ssh-desktop # Launches the desktop GUI client ``` ### Session Management ```bash # View session history with stats bayesian-ssh history # Recent sessions bayesian-ssh history -c "prod" # Filter by connection bayesian-ssh history --days 7 --failed # Last week's failures # Manage active sessions bayesian-ssh close # List active sessions bayesian-ssh close "Server" # Close specific session bayesian-ssh close --cleanup # Clean stale sessions bayesian-ssh close --all # Close all sessions ``` ### Connection Aliases ```bash # Create shortcuts for connections bayesian-ssh alias add db prod-database # 'db' → 'prod-database' bayesian-ssh alias add p1 Portail01 # Quick alias bayesian-ssh connect db # Uses alias bayesian-ssh alias list # Show all aliases bayesian-ssh alias remove db # Remove alias ``` ### Bastion Management ```bash # Use default bastion bayesian-ssh add "Server" host.com # Force direct connection bayesian-ssh add "Server" host.com --no-bastion # Custom bastion bayesian-ssh add "Server" host.com --bastion custom-bastion.com ``` ### Configuration The app automatically creates configuration in `~/.config/bayesian-ssh/`: ```bash # View current config bayesian-ssh config # Set defaults (Kerberos is disabled by default, current user is used) bayesian-ssh config --use-kerberos --default-user customuser ``` ## Documentation Full documentation is built with [mdBook](https://rust-lang.github.io/mdBook/). To build and view locally: ```bash make docs # Build to docs/book/ make docs-serve # Serve locally with live reload ``` Documentation covers: - **[Getting Started](docs/src/getting-started/installation.md)** - Installation, quick start, configuration - **[User Guide](docs/src/user-guide/connection-management.md)** - Connections, sessions, aliases, TUI, bastion hosts - **[Advanced Usage](docs/src/advanced-usage/enterprise.md)** - Enterprise, cloud, CI/CD, security & compliance - **[Reference](docs/src/reference/architecture.md)** - Architecture, troubleshooting, changelog ## Changelog See [CHANGELOG.md](CHANGELOG.md) for detailed release notes. ## Contributing 1. **Fork** the project 2. **Create** a feature branch (`git checkout -b feature/AmazingFeature`) 3. **Commit** your changes (`git commit -m 'Add AmazingFeature'`) 4. **Push** to the branch (`git push origin feature/AmazingFeature`) 5. **Open** a Pull Request ## License This project is licensed under **MIT**. See the [LICENSE](LICENSE) file for details. ---