servonaut 2.1.0__tar.gz

servonaut-2.1.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,31 @@
+Thank you for contributing to Servonaut!
+
+Please provide a clear description of your changes and link to any relevant issues.
+
+**Before submitting, please ensure you have:**
+- [ ] Read the [CONTRIBUTING.md](https://github.com/zb-ss/ec2-ssh/blob/master/CONTRIBUTING.md) guide.
+- [ ] Based your changes on the `main` branch (or the relevant development branch).
+- [ ] Ensured your code follows the project's coding style.
+- [ ] Added tests for your changes (if applicable).
+- [ ] Updated documentation (e.g., `README.md`) if your changes require it.
+- [ ] Added a clear and descriptive title for your pull request.
+- [ ] Written a clear summary of the changes in the "Description" section below.
+
+---
+
+**Description of Changes:**
+
+*(Please provide a detailed description of the changes you've made.)*
+
+**Related Issues:**
+
+*(Link to any relevant issues using `#issue_number`)*
+
+---
+
+**Checklist for Reviewers (Optional - for maintainer use):**
+- [ ] Code is well-formatted and easy to understand.
+- [ ] Changes achieve the intended purpose.
+- [ ] Tests pass (if applicable).
+- [ ] Documentation is updated (if applicable).
+- [ ] No new major issues are introduced.

servonaut-2.1.0/.github/workflows/ci.yml

@@ -0,0 +1,38 @@
+name: CI
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+    branches: [master]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.8", "3.10", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: pip install -e ".[test]"
+
+      - name: Run tests
+        run: pytest --tb=short -q
+
+      - name: Run tests with coverage
+        if: matrix.python-version == '3.12'
+        run: pytest --cov=servonaut --cov-report=term-missing --cov-report=xml
+
+      - name: Upload coverage
+        if: matrix.python-version == '3.12'
+        uses: actions/upload-artifact@v4
+        with:
+          name: coverage-report
+          path: coverage.xml

servonaut-2.1.0/.github/workflows/publish.yml

@@ -0,0 +1,46 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  id-token: write
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install dependencies
+        run: pip install -e ".[test]"
+
+      - name: Run tests
+        run: pytest --tb=short -q
+
+  publish:
+    needs: test
+    runs-on: ubuntu-latest
+    environment: pypi
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build tools
+        run: pip install build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

servonaut-2.1.0/.gitignore

@@ -0,0 +1,51 @@
+.aider*
+# Python
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+*.so
+
+# Build artifacts
+build/
+dist/
+*.egg-info/
+*.egg
+*.whl
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+env/
+
+# IDE / Editor specific
+.vscode/
+.idea/
+*.project
+*.pydevproject
+*.sublime-workspace
+*.sublime-project
+
+# OS specific
+.DS_Store
+Thumbs.db
+
+# Configuration files (if any local, non-committed ones are used)
+# .env
+
+# Test artifacts
+.pytest_cache/
+.coverage
+htmlcov/
+nosetests.xml
+coverage.xml
+*.cover
+*.log
+
+# Hatchling specific (build backend)
+.hatch/
+
+# Projectile marker file
+.projectile
+/local/

servonaut-2.1.0/CLAUDE.md

@@ -0,0 +1,113 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+Servonaut is a Terminal User Interface (TUI) for managing servers. Built with Python and Textual, it provides SSH connections, SCP file transfer, remote file browsing, command execution, and keyword-based server scanning across all AWS regions.
+
+## Development Commands
+
+```bash
+# Run directly without installing (primary dev workflow)
+PYTHONPATH=src python3 -m servonaut.main
+
+# Or run the script directly
+python src/servonaut/main.py
+
+# Run with debug logging (prints to stderr + log file)
+PYTHONPATH=src python3 -m servonaut.main --debug
+
+# Install via pipx (production)
+pipx install .
+
+# Update existing pipx installation after changes
+pipx install . --force
+
+# Install editable for development
+pip install -e .
+```
+
+Tests use pytest. Run with `pip install -e ".[test]" && pytest`. CI runs on push/PR to master via GitHub Actions.
+
+## Architecture
+
+Modular TUI built on Textual, organized into five packages under `src/servonaut/`:
+
+- **`config/`** — Configuration management: `AppConfig` dataclass hierarchy (`schema.py`), JSON load/save/validate (`manager.py`), v1→v2 migration (`migration.py`)
+- **`services/`** — Business logic with abstract interfaces (`interfaces.py`). Each service implements its interface. Key services: `AWSService` (boto3 EC2 API), `CacheService` (stale-while-revalidate), `SSHService` (key management, command building), `ConnectionService` (bastion/ProxyJump resolution), `ScanService` + `KeywordStore` (keyword scanning), `TerminalService` (terminal detection/launch), `SCPService` (file transfer)
+- **`screens/`** — Textual `Screen` subclasses for each view (main menu, instance list, server actions, file browser, command overlay, SCP transfer, scan results, settings, key management, search, help)
+- **`widgets/`** — Reusable Textual widgets: `InstanceTable` (DataTable), `RemoteTree` (Tree for remote fs), `StatusBar`, `ProgressIndicator`, `CommandOutput` (RichLog)
+- **`utils/`** — Helpers: `formatting.py`, `platform_utils.py`, `ssh_utils.py`, `match_utils.py` (instance matching with conditions like `name_contains`, `region`, `name_regex`)
+
+### Service Initialization and Access
+
+All services are created in `ServonautApp._init_services()` (in `app.py`) during `on_mount`. Services are stored as attributes on the app instance. Screens access them via `self.app.<service>` (e.g., `self.app.ssh_service`, `self.app.connection_service`).
+
+Service dependency chain:
+```
+ConfigManager → config
+  ├── CacheService(ttl_seconds=config.cache_ttl_seconds)
+  │     └── AWSService(cache_service)
+  ├── SSHService(config_manager)
+  ├── ConnectionService(config_manager)
+  ├── ScanService(config_manager)
+  ├── KeywordStore(config.keyword_store_path)
+  ├── TerminalService(preferred=config.terminal_emulator)
+  ├── SCPService()
+  └── CommandHistoryService(config.command_history_path)
+```
+
+### Screen Navigation
+
+Screens use `self.app.push_screen()` / `self.app.pop_screen()`. Shared instance data lives in `self.app.instances` (list of dicts with keys: `id`, `name`, `type`, `state`, `public_ip`, `private_ip`, `region`, `key_name`).
+
+### Async Pattern
+
+Long-running operations (AWS API, SSH) are async and run via `self.run_worker()` to avoid blocking the TUI. Workers notify the UI via `self.notify()`.
+
+### Styling
+
+All CSS is in a single `app.css` file using Textual's CSS-like syntax with design tokens (`$surface`, `$primary`, `$accent`, etc.). Screen-specific styles are organized into labeled sections within this file.
+
+## Key Design Decisions
+
+**SSH Connection Strategy:**
+- ProxyJump (`-J`) when no separate bastion key; ProxyCommand when `bastion_key` is set (allows different key for bastion vs target)
+- `IdentitiesOnly=yes` only added when `-i` flag is present
+- Key auto-discovery searches `~/.ssh/` with multiple patterns (exact match, `.pem`, fuzzy)
+- External SSH sessions launch in new terminal window via wrapper script that keeps terminal open on failure
+
+**Instance Caching (stale-while-revalidate):**
+- Cache at `~/.servonaut/cache.json` with configurable TTL (default 3600s)
+- Startup: show stale data immediately, refresh in background if expired
+- `CacheService.load()` respects TTL; `load_any()` ignores TTL; `is_fresh()` checks TTL
+- Force refresh via `R` key in instance list
+
+**Configuration:**
+- JSON at `~/.servonaut/config.json`, dataclass-based schema (`AppConfig`, `ScanRule`, `ConnectionProfile`, `ConnectionRule`)
+- Schema versioning (`CONFIG_VERSION = 2`) with automatic v1→v2 migration
+- Connection rules evaluated in order — first match wins
+
+**Instance Matching (`match_utils.py`):**
+- Used by both scan rules and connection rules
+- Supports: `name_contains`, `name_regex`, `region`, `id`, `type_contains`, `has_public_ip`
+- All conditions are AND-ed together
+
+## Runtime Files
+
+All runtime files are under `~/.servonaut/`:
+
+- `~/.servonaut/config.json` — Main configuration
+- `~/.servonaut/cache.json` — Cached instance list
+- `~/.servonaut/keywords.json` — Scan results store
+- `~/.servonaut/command_history.json` — Saved commands and command history
+- `~/.servonaut/logs/servonaut.log` — Application log
+- `~/.servonaut/logs/servonaut_*.sh` — Temporary SSH wrapper scripts
+
+## Dependencies
+
+- `boto3` — AWS EC2 API
+- `tabulate` — Table formatting (legacy)
+- `textual>=0.40.0` — TUI framework
+- Python 3.8+ required

servonaut-2.1.0/CONTRIBUTING.md

@@ -0,0 +1,45 @@
+# Contributing to Servonaut
+
+First off, thank you for considering contributing to Servonaut! Your help is appreciated.
+
+This document provides guidelines for contributing to this project.
+
+## How Can I Contribute?
+
+### Reporting Bugs
+*   Ensure the bug was not already reported by searching on GitHub under [Issues](https://github.com/zb-ss/ec2-ssh/issues).
+*   If you're unable to find an open issue addressing the problem, [open a new one](https://github.com/zb-ss/ec2-ssh/issues/new). Be sure to include a **title and clear description**, as much relevant information as possible, and a **code sample or an executable test case** demonstrating the expected behavior that is not occurring.
+
+### Suggesting Enhancements
+*   Open a new issue to discuss your enhancement. Clearly describe the proposed enhancement and its potential benefits.
+*   Provide a step-by-step description of the suggested enhancement in as many details as possible.
+
+### Pull Requests
+1.  **Fork the repository**: Click the "Fork" button at the top right of the repository page.
+2.  **Clone your fork**: `git clone https://github.com/zb-ss/ec2-ssh.git`.
+3.  **Create a new branch**: `git checkout -b name-of-your-new-feature-or-fix`
+4.  **Make your changes**: Make your changes in your local repository.
+5.  **Follow coding style**:
+    *   Ensure your code adheres to the existing style.
+    *   If you are adding new features, try to include tests if applicable.
+    *   Update documentation (e.g., `README.md`) if your changes affect usage or add new features.
+6.  **Commit your changes**: Use clear and descriptive commit messages.
+    ```bash
+    git add .
+    git commit -m "feat: Add new feature X"
+    # or "fix: Resolve bug Y"
+    # or "docs: Update README for feature Z"
+    ```
+7.  **Push to your fork**: `git push origin name-of-your-new-feature-or-fix`
+8.  **Open a Pull Request**: Go to the original repository on GitHub and click the "New pull request" button. Fill out the pull request template.
+
+## Development Setup
+Please refer to the `README.md` for instructions on setting up your development environment and installing dependencies.
+
+## Code of Conduct
+Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms. For now, please be respectful and constructive in all interactions.
+
+## License
+By contributing to Servonaut, you agree that your contributions will be licensed under its MIT License.
+
+Thank you for your contribution!

servonaut-2.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 zb-ss
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

servonaut-2.1.0/PKG-INFO

@@ -0,0 +1,175 @@
+Metadata-Version: 2.4
+Name: servonaut
+Version: 2.1.0
+Summary: Interactive TUI for managing servers — SSH, SCP, scanning & more
+Project-URL: Homepage, https://github.com/zb-ss/ec2-ssh
+Project-URL: Repository, https://github.com/zb-ss/ec2-ssh
+Project-URL: Issues, https://github.com/zb-ss/ec2-ssh/issues
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: System :: Systems Administration
+Requires-Python: >=3.8
+Requires-Dist: boto3
+Requires-Dist: tabulate
+Requires-Dist: textual>=0.40.0
+Provides-Extra: test
+Requires-Dist: pytest-cov>=4.0; extra == 'test'
+Requires-Dist: pytest>=7.0; extra == 'test'
+Description-Content-Type: text/markdown
+
+# Servonaut
+
+A modern Terminal User Interface (TUI) for managing servers — SSH, SCP, scanning & more.
+
+## Quick Install
+
+**Linux / macOS:**
+
+```bash
+curl -sSL https://raw.githubusercontent.com/zb-ss/ec2-ssh/master/install.sh | bash
+```
+
+**Windows (PowerShell):**
+
+```powershell
+irm https://raw.githubusercontent.com/zb-ss/ec2-ssh/master/install.ps1 | iex
+```
+
+**Or install directly via pipx / pip:**
+
+```bash
+pipx install servonaut
+```
+
+**Manual install from source:**
+
+```bash
+git clone https://github.com/zb-ss/ec2-ssh.git
+cd ec2-ssh
+pipx install .
+```
+
+## Features
+
+- **Interactive TUI** with mouse and keyboard support powered by [Textual](https://textual.textualize.io/)
+- **List and search** EC2 instances across all AWS regions
+- **SSH into instances** — launches in new terminal window with auto-detected emulator
+- **Run remote commands** via overlay panel with real-time streaming output, persistent history, and saved command favorites
+- **Browse remote file systems** — interactive file tree navigation
+- **SCP file transfer** — upload/download files and directories
+- **Keyword-based server scanning** — search file contents across instances
+- **Bastion host / jump server support** via ProxyJump or ProxyCommand
+- **SSH key management** with auto-discovery and per-instance configuration
+- **Instance caching** with stale-while-revalidate for fast startup
+- **Fully configurable** — all settings in `~/.servonaut/config.json`
+
+## Prerequisites
+
+- Python 3.8+
+- AWS CLI configured (`~/.aws/credentials` and `~/.aws/config`)
+- SSH client (standard on Linux/macOS, OpenSSH on Windows)
+- `pipx` for isolated installation (recommended)
+
+Your AWS credentials need `ec2:DescribeInstances` and `ec2:DescribeRegions` permissions.
+
+## Usage
+
+```bash
+servonaut           # Launch the TUI
+servonaut --debug   # Launch with debug logging to stderr
+```
+
+### Keyboard Shortcuts
+
+| Context | Key | Action |
+|---------|-----|--------|
+| Global | `Q` | Quit |
+| Global | `?` | Help screen |
+| Global | `Escape` | Go back / close |
+| Instance List | `/` | Focus search |
+| Instance List | `R` | Force-refresh from AWS |
+| Instance List | `S` | SSH to selected instance |
+| Instance List | `B` | Browse remote files |
+| Instance List | `C` | Run command overlay |
+| Instance List | `T` | SCP transfer |
+| Command Overlay | `Ctrl+C` | Stop running command |
+| Command Overlay | `Ctrl+R` | Command picker (saved + recent) |
+| Command Overlay | `Ctrl+S` | Save command to favorites |
+| Command Overlay | `Up/Down` | Command history |
+
+### What You Can Do
+
+1. **List Instances** — View all EC2 instances with search/filter
+2. **Search** — Filter instances by name, type, region, or state; search scan results
+3. **Manage SSH Keys** — Configure default and per-instance SSH keys
+4. **Scan Servers** — Run keyword scans across running instances
+5. **Settings** — Configure connection profiles, scan rules, preferences
+
+When you select a server: browse files, run commands, SSH connect, SCP transfer, or view scan results. Command history persists across sessions — use `Ctrl+R` to search history and saved commands, `Ctrl+S` to save favorites.
+
+### Instance Caching
+
+| Scenario | Behavior |
+|----------|----------|
+| First launch (no cache) | Fetches from AWS with progress indicator |
+| Restart within TTL (default 1h) | Instant load from cache |
+| Restart after TTL | Shows stale data immediately, refreshes in background |
+| Press `R` | Force-refresh from AWS |
+
+### Configuration
+
+All configuration lives in `~/.servonaut/config.json`, created automatically on first run.
+
+See [Configuration Guide](docs/configuration.md) for the full reference including connection profiles, scan rules, and match conditions.
+
+## Development
+
+```bash
+# Run directly (primary dev workflow)
+PYTHONPATH=src python3 -m servonaut.main
+
+# Run with debug logging
+PYTHONPATH=src python3 -m servonaut.main --debug
+
+# Install editable
+pip install -e .
+
+# Update pipx installation after changes
+pipx install . --force
+```
+
+```bash
+# Run tests
+pip install -e ".[test]"
+pytest
+```
+
+See [Architecture](docs/architecture.md) for codebase structure and design patterns.
+
+## Troubleshooting
+
+See [Troubleshooting Guide](docs/troubleshooting.md) for help with SSH connections, bastion hosts, key management, and AWS credentials.
+
+## Logging
+
+Logs are always written to `~/.servonaut/logs/servonaut.log`. Use `--debug` for verbose stderr output.
+
+When SSH fails, the terminal window stays open showing the error and exit code.
+
+## License
+
+This project is licensed under the MIT License — see the [LICENSE](LICENSE) file for details.

servonaut-2.1.0/README.md

@@ -0,0 +1,142 @@
+# Servonaut
+
+A modern Terminal User Interface (TUI) for managing servers — SSH, SCP, scanning & more.
+
+## Quick Install
+
+**Linux / macOS:**
+
+```bash
+curl -sSL https://raw.githubusercontent.com/zb-ss/ec2-ssh/master/install.sh | bash
+```
+
+**Windows (PowerShell):**
+
+```powershell
+irm https://raw.githubusercontent.com/zb-ss/ec2-ssh/master/install.ps1 | iex
+```
+
+**Or install directly via pipx / pip:**
+
+```bash
+pipx install servonaut
+```
+
+**Manual install from source:**
+
+```bash
+git clone https://github.com/zb-ss/ec2-ssh.git
+cd ec2-ssh
+pipx install .
+```
+
+## Features
+
+- **Interactive TUI** with mouse and keyboard support powered by [Textual](https://textual.textualize.io/)
+- **List and search** EC2 instances across all AWS regions
+- **SSH into instances** — launches in new terminal window with auto-detected emulator
+- **Run remote commands** via overlay panel with real-time streaming output, persistent history, and saved command favorites
+- **Browse remote file systems** — interactive file tree navigation
+- **SCP file transfer** — upload/download files and directories
+- **Keyword-based server scanning** — search file contents across instances
+- **Bastion host / jump server support** via ProxyJump or ProxyCommand
+- **SSH key management** with auto-discovery and per-instance configuration
+- **Instance caching** with stale-while-revalidate for fast startup
+- **Fully configurable** — all settings in `~/.servonaut/config.json`
+
+## Prerequisites
+
+- Python 3.8+
+- AWS CLI configured (`~/.aws/credentials` and `~/.aws/config`)
+- SSH client (standard on Linux/macOS, OpenSSH on Windows)
+- `pipx` for isolated installation (recommended)
+
+Your AWS credentials need `ec2:DescribeInstances` and `ec2:DescribeRegions` permissions.
+
+## Usage
+
+```bash
+servonaut           # Launch the TUI
+servonaut --debug   # Launch with debug logging to stderr
+```
+
+### Keyboard Shortcuts
+
+| Context | Key | Action |
+|---------|-----|--------|
+| Global | `Q` | Quit |
+| Global | `?` | Help screen |
+| Global | `Escape` | Go back / close |
+| Instance List | `/` | Focus search |
+| Instance List | `R` | Force-refresh from AWS |
+| Instance List | `S` | SSH to selected instance |
+| Instance List | `B` | Browse remote files |
+| Instance List | `C` | Run command overlay |
+| Instance List | `T` | SCP transfer |
+| Command Overlay | `Ctrl+C` | Stop running command |
+| Command Overlay | `Ctrl+R` | Command picker (saved + recent) |
+| Command Overlay | `Ctrl+S` | Save command to favorites |
+| Command Overlay | `Up/Down` | Command history |
+
+### What You Can Do
+
+1. **List Instances** — View all EC2 instances with search/filter
+2. **Search** — Filter instances by name, type, region, or state; search scan results
+3. **Manage SSH Keys** — Configure default and per-instance SSH keys
+4. **Scan Servers** — Run keyword scans across running instances
+5. **Settings** — Configure connection profiles, scan rules, preferences
+
+When you select a server: browse files, run commands, SSH connect, SCP transfer, or view scan results. Command history persists across sessions — use `Ctrl+R` to search history and saved commands, `Ctrl+S` to save favorites.
+
+### Instance Caching
+
+| Scenario | Behavior |
+|----------|----------|
+| First launch (no cache) | Fetches from AWS with progress indicator |
+| Restart within TTL (default 1h) | Instant load from cache |
+| Restart after TTL | Shows stale data immediately, refreshes in background |
+| Press `R` | Force-refresh from AWS |
+
+### Configuration
+
+All configuration lives in `~/.servonaut/config.json`, created automatically on first run.
+
+See [Configuration Guide](docs/configuration.md) for the full reference including connection profiles, scan rules, and match conditions.
+
+## Development
+
+```bash
+# Run directly (primary dev workflow)
+PYTHONPATH=src python3 -m servonaut.main
+
+# Run with debug logging
+PYTHONPATH=src python3 -m servonaut.main --debug
+
+# Install editable
+pip install -e .
+
+# Update pipx installation after changes
+pipx install . --force
+```
+
+```bash
+# Run tests
+pip install -e ".[test]"
+pytest
+```
+
+See [Architecture](docs/architecture.md) for codebase structure and design patterns.
+
+## Troubleshooting
+
+See [Troubleshooting Guide](docs/troubleshooting.md) for help with SSH connections, bastion hosts, key management, and AWS credentials.
+
+## Logging
+
+Logs are always written to `~/.servonaut/logs/servonaut.log`. Use `--debug` for verbose stderr output.
+
+When SSH fails, the terminal window stays open showing the error and exit code.
+
+## License
+
+This project is licensed under the MIT License — see the [LICENSE](LICENSE) file for details.