• 🎨 Beautiful TUI Interface - Modern terminal user interface with colors and smooth animations
• 🔐 Secure Password Storage - Master password with system keyring integration (macOS Keychain, Linux Secret Service, Windows Credential Manager)
• 🔑 Dual Authentication - Support for both password and SSH key authentication
• 📁 Connection Management - Add, edit, delete, and organize your SSH connections
• 🔍 Smart Search - Quick connection search and filtering
• 📤 Export/Import - Full compatibility with OpenSSH config format
• ⚡ Fast & Lightweight - Built with Go for optimal performance
• 🌍 Cross-Platform - Works on macOS, Linux, and Windows
• 🔒 Open Source - MIT licensed, community-driven development

macOS & Linux:

curl -fsSL https://raw.githubusercontent.com/ankogit/ssh_keeper/main/scripts/install.sh | bash

Windows (PowerShell):

iwr -useb https://raw.githubusercontent.com/ankogit/ssh_keeper/main/scripts/install.ps1 | iex

🔄 Автоматическое обновление: Скрипты автоматически определяют и скачивают последнюю версию релиза!

✨ Features of the installer:

• 🔍 Auto-detects your OS and architecture
• 📥 Downloads the correct version automatically
• 🔧 Installs to system directory (/usr/local/bin)
• ✅ Verifies installation success
• 🎨 Beautiful colored output with progress

Download the latest release for your platform:

• macOS Intel: ssh-keeper-0.1.0-darwin-amd64.tar.gz (3.08 MiB)
• macOS Apple Silicon: ssh-keeper-0.1.0-darwin-arm64.tar.gz (2.94 MiB)
• Linux: ssh-keeper-0.1.0-linux-amd64.tar.gz (3.84 MiB)
• Windows: ssh-keeper-0.1.0-windows-amd64.zip (3.33 MiB)

# Extract the archive
tar -xzf ssh-keeper-0.1.0-*.tar.gz  # Linux/macOS
# or unzip ssh-keeper-0.1.0-windows-amd64.zip  # Windows

# Make executable (Linux/macOS)
chmod +x ssh-keeper*

# Run
./ssh-keeper

📖 Подробная инструкция по установке: INSTALL.md | macOS Apple Silicon

macOS & Linux:

curl -fsSL https://raw.githubusercontent.com/ankogit/ssh_keeper/main/scripts/uninstall.sh | bash

Manual uninstall:

# Remove binary
sudo rm /usr/local/bin/ssh-keeper

# Remove configuration (optional)
rm -rf ~/.ssh-keeper

Note: Screenshots will be added here once the application is running

Beautiful main menu with intuitive navigation

View and manage your SSH connections

Easy connection setup with form validation

# Clone the repository
git clone https://github.com/ankogit/ssh_keeper.git
cd ssh_keeper

# Build the application
make build

# Run the application
make run

# Build for current platform
make build

# Build for all platforms
make build-all

# Run in development mode
make run-dev

# Install system-wide
make install

• Go 1.24+ - Download Go
• Make (optional, for using Makefile)

When you first run SSH Keeper, you'll be prompted to set up a master password. This password is used to encrypt your connection data and is stored securely in your system's keyring.

ssh-keeper

The application provides an intuitive main menu with the following options:

• 🔍 View Connections - Browse and search your SSH connections
• ➕ Add Connection - Add a new SSH connection
• ⚙️ Settings - Configure application settings
• 📤 Export - Export connections to OpenSSH config
• 📥 Import - Import connections from OpenSSH config
• ❌ Quit - Exit the application

1. Select "➕ Add Connection" from the main menu
2. Fill in the connection details:
   • Name: A friendly name for your connection
   • Host: Server hostname or IP address
   • Port: SSH port (default: 22)
   • User: Username for SSH connection
   • Authentication: Choose between password or SSH key
3. Save your connection

• Enter your password when adding the connection
• Password is encrypted and stored securely
• No need to enter password each time you connect

• Specify the path to your SSH private key
• Supports standard SSH key formats
• Works with existing SSH key infrastructure

SSH Keeper stores its configuration in ~/.ssh-keeper/:

• config.yaml - Application settings
• connections.yaml - SSH connections (encrypted)
• Passwords are stored securely using system keyring

Create a .env file for development:

cp env.example .env

For production builds, configure GitHub Environment variables:

1. Go to Settings → Environments
2. Create/Edit "Production" environment
3. Add environment variable:
   • Name: APP_SIGNATURE
   • Value: ssh-keeper-prod-signature

See CI/CD Documentation for detailed setup instructions.

SSH Keeper prioritizes security and follows best practices:

• Encrypted Storage: All connection data is encrypted using AES-256
• System Keyring Integration: Master password stored in system keyring (Keychain/Secret Service/Credential Manager)
• Memory Management: Sensitive data cleared from memory after use
• No Plain Text: No passwords stored in plain text files
• Open Source: Full source code available for security audit

ssh_keeper/
├── cmd/ssh-keeper/          # Main application entry point
├── internal/
│   ├── models/              # Data models (Connection, Config)
│   ├── ui/                  # TUI components and screens
│   │   ├── components/      # Reusable UI components
│   │   └── screens/         # Application screens
│   ├── services/            # Business logic services
│   ├── ssh/                 # SSH client integration
│   └── config/              # Configuration management
├── docs/                    # Documentation
├── scripts/                 # Build and utility scripts
├── Formula/                 # Homebrew formulas
└── Makefile                 # Build automation

# Clone the repository
git clone https://github.com/ankogit/ssh_keeper.git
cd ssh_keeper

# Download dependencies
make deps

# Set up development environment
make dev-setup

# Run tests
make test

# Run with coverage
make test-coverage

SSH Keeper uses GitHub Actions for automated CI/CD:

• ✅ Automated Testing - Tests run on every push/PR
• ✅ Multi-platform Builds - Linux, macOS, Windows
• ✅ Automatic Releases - Tag-based releases with artifacts
• ✅ Security Scanning - Code and dependency vulnerability checks
• ✅ Code Quality - Linting and formatting checks

Create a release:

git tag v0.1.0
git push origin v0.1.0

📖 CI/CD Documentation: CI_CD_DOCUMENTATION.md

# Build for current platform
make build

# Build for all platforms
make build-all

# Create release packages
make release

We welcome contributions! SSH Keeper is an open source project under the MIT license.

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

• Follow Go best practices and conventions
• Add tests for new functionality
• Update documentation as needed
• Ensure all tests pass before submitting PR

Found a bug? Have a feature request? Please open an issue!

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

The MIT License is one of the most permissive open source licenses, allowing:

• ✅ Commercial use - Use in commercial projects
• ✅ Modification - Modify and create derivatives
• ✅ Distribution - Distribute copies
• ✅ Private use - Use privately
• ✅ Patent use - Use patented technology

This makes SSH Keeper accessible to everyone while maintaining the freedom to use, modify, and distribute the software.

SSH Keeper is built with amazing open source projects:

• Bubble Tea - A powerful TUI framework for Go
• Bubbles - Beautiful UI components
• Lip Gloss - Styling for terminal applications
• go-keyring - Cross-platform keyring access
• Termenv - Terminal environment detection

• ✅ Core Features - Connection management, secure storage
• ✅ TUI Interface - Beautiful terminal interface
• ✅ Cross-Platform - macOS, Linux, Windows support
• ✅ Security - Encrypted storage, system keyring integration
• 🔄 Documentation - Comprehensive docs and examples
• 🔄 Testing - Unit tests and integration tests
• 🔄 Packaging - Homebrew, Debian packages