Servonaut Documentation
A modern Python TUI for managing AWS, OVH Cloud, Hetzner Cloud, and any custom SSH host — with full server lifecycle, AI log analysis, and an MCP surface your agent can call.
Start with the Quick Start guide — get from zero to managing your first server in under 5 minutes.
Choose your interface
Servonaut has three interfaces, each for a different audience. Pick the one that matches how you work — they share the same configuration, the same sign-in, and the same servers.
- The TUI — the product. Run
servonautand operate your fleet interactively. The default and recommended way to use Servonaut day-to-day. Start with the Quick Start. - CLI subcommands — for automation and headless environments (CI, cron, boxes with no interactive session). Secondary; everything they do, the TUI does too. See Automating with the CLI below.
- The MCP server — for AI agents like Claude Code and Cursor. See the MCP Server docs, including the agent-only install.
Your first five minutes in the TUI
Launch the app with a single command:
servonaut
You land on a unified instance list: AWS EC2 (all regions), OVH Cloud, Hetzner Cloud, and your custom SSH servers
merged into one searchable table. Press / to search, R to force-refresh, or
S to SSH straight into the selected server. Click any row (or press Enter) to open that server's
Server Actions dashboard — browse files, run commands with streaming output, tail logs,
transfer files over SCP, analyse logs with AI, or ban an IP, all from one action rail. Press L in the
dashboard to toggle a live resource monitor (CPU, RAM, load, disk, uptime — polled over SSH only while the pane is open).
A few global keys worth knowing from day one: ? opens the help screen anywhere,
F2 toggles the built-in AI chat panel alongside any screen, Escape goes back,
and Q quits. Need to record a demo or take screenshots? servonaut --demo
(or Ctrl+Shift+D at runtime) deterministically replaces IPs, account IDs, hostnames, paths, and
secrets with safe fakes on every screen, with a [DEMO] badge in the status bar.
Automating with the CLI
Every major feature also has a scriptable, non-interactive command for CI runners, cron jobs, and headless boxes.
Sign in once per machine with servonaut login — it works fully headless, printing a URL and a short
code you approve from a browser on any device — and the session is shared by every CLI subcommand, the MCP server,
and the TUI. The main command trees:
servonaut ai— talk to the hosted AI gateway headlessly:ai chat, quota and top-up balance, conversation list/show/export. Documented on the Servonaut AI page.servonaut memory— build, refresh, inspect, pin, and export the per-server fact cache. Documented on the Server Memory page.servonaut hetzner— list, create, and destroy Hetzner Cloud servers and manage project SSH keys, with--jsonoutput and--yesfor scripts. Documented on the Hetzner Cloud page.servonaut secrets— set up and inspect the secrets backends. Documented on the Secrets & Integrations page.servonaut connect— run the relay listener that lets hosted AI agents and team-mates dispatch tool calls to this machine;--bgto detach,--statusto check local and backend connection health. Documented on the MCP Server page.
Commands are built for scripting: Ctrl+C always exits cleanly with code 130 (never a traceback), the
ai tree uses documented exit codes for unauthenticated / entitlement / quota / budget outcomes,
and --json flags give machine-readable output where it matters.
For a complete, single-page reference of every subcommand, flag, and exit code see the
CLI Reference.
For AI agents
servonaut --mcp runs the MCP server over stdio, fully headless — it never loads the TUI, so you can
install it on a CI box purely as an agent toolbox. One command wires it into your coding agent:
servonaut --mcp-install claude|cursor|windsurf|opencode|vscode|all. It is also listed in the official
MCP Registry as dev.servonaut/servonaut, so registry-aware clients can discover and install it
directly. Nearly 90 tools cover instance ops, AWS EC2 lifecycle, log analysis and IP banning, S3, full Hetzner
and OVH lifecycle, and server-memory queries — gated by a three-tier guard system (readonly /
standard / dangerous) with every call audit-logged locally. With the relay listener
running (servonaut connect, or auto-started by the TUI after login), hosted agents can execute tool
calls on your machine even with no TUI open, under a per-tier auto-approval policy you control. Full details,
tool list, and the agent-only install live in the MCP Server docs.
Overview
Servonaut is an open-source terminal app (TUI) written in Python, with full mouse and keyboard support. It unifies AWS EC2, OVH Cloud (Public Cloud / VPS / dedicated), Hetzner Cloud, and arbitrary SSH hosts in one searchable list — with lifecycle controls for supported OVH and Hetzner resources, AWS EC2 discovery and observability in the TUI, and AWS EC2 lifecycle available to agents through MCP tools. Paid tiers add cloud config sync, a hosted MCP server for AI agents like Claude Code, Server Memory — a zero-knowledge inventory + drift timeline — and Servonaut AI, a hosted AI gateway with its own dollar budget so you don't need to wire up your own provider keys.
Documentation sections
Quick links
- GitHub Repository — source code, issues, and contributions
- Pricing — free OSS tier and paid plans
- Contact — get support or report an issue. You can also file bug reports directly from the TUI under Account → Bug Reports.