Servonaut Documentation

A modern Python TUI for managing servers — SSH, SCP, AWS EC2, CloudTrail, WAF, and AI-powered log analysis, all from your terminal.

New to Servonaut?

Start with the Quick Start guide — get from zero to managing your first server in under 5 minutes.

Overview

Servonaut is an open-source CLI tool built with Python and Textual. It provides a keyboard-driven, mouse-friendly TUI for everything you need when managing Linux servers and AWS infrastructure. The paid tiers add cloud config sync and a hosted MCP server for AI agents like Claude Code. A hosted AI proxy is on the roadmap.

Documentation sections

Quick Start

Install Servonaut and be up and running in minutes. Covers install, first run, and core operations.

Installation

System requirements, all install methods, upgrading, uninstalling, and optional dependencies.

Configuration

Full reference for ~/.servonaut/config.json — AWS, SSH, AI providers, MCP, secrets handling.

Features

SSH & SCP, AWS EC2, CloudTrail, CloudWatch, WAF management, keyboard shortcuts reference.

MCP Server

Connect AI agents like Claude Code to your infrastructure. Auto-install, tools, and guard levels.

API Reference Premium

REST API for config sync and team management. OAuth2 device flow authentication.

Quick links

GitHub Repository — source code, issues, and contributions
Pricing — free OSS tier and paid plans
Contact — get support or report an issue

Next Quick Start