Your first five minutes.

This guide walks through installing SysNav, connecting to your first host, and running an Ask query across your stack.

1. Install

SysNav ships for macOS (Universal — Apple Silicon + Intel), Linux (x64), and Windows (x64). Grab it from the download page — no account needed to install. On macOS the build is notarized and stapled, so it just opens:

# Open SysNav-macOS-Universal.dmg, then drag
# SysNav into your Applications folder.

2. Launch & import

On first run, SysNav reads your ~/.ssh/config to discover the hosts you already connect to, so they show up ready to select. Your keys and config never leave your machine — the desktop app holds them and does the connecting.

3. Your first Ask

Pick a host, stay in Ask mode (the read-only default), and ask in plain English:

❯ why is disk usage climbing on this box?

SysNav proposes read-only commands (df, du, log reads), runs them, and explains what it found in plain English. In Ask mode it can't mutate anything — destructive commands are blocked outright. When you want it to actually fix something, switch to Agent mode, where every command waits for your approval before it runs.