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 as a macOS app (Apple Silicon + Intel). After you request beta access, download the .zip and install:

$ unzip SysNav-macOS-ARM64.zip
$ xattr -cr SysNav.app      # clear quarantine (unsigned beta build)
$ mv SysNav.app /Applications

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.