outrigger ← back
❯ cat setup.txt

Five minutes of setup, then it stays out of your way.

Everything below names the actual buttons. Nothing here is required — the app works on defaults — but these five are worth the minutes.

1 · First connect

Tap +, give the host a nickname, its address, and your username, then Save and tap the host. Type your password once — that first password session is the bootstrap. Toggle Save — unlock with Face ID if you want reconnects to be a glance instead of typing; the saved password is encrypted by the Secure Enclave and never enters a backup.

2 · Never type that password again

While connected, tap the host's name in the title bar to open its detail card. In the key section, generate a key — the default is born inside the Secure Enclave and can never leave the chip — then tap Install on server. That appends your public key to the server's authorized_keys over the session you already have open. From then on the host is key-only: connecting is Face ID, nothing typed.

Server pinned to ed25519? Generate the ed25519 key instead — it's a software key (the Enclave only speaks P-256; we're honest about this), sealed at rest by the Enclave and Face ID-gated the same. Copy public key is there for pasting into config management if you'd rather not touch the server from the phone.

3 · The tmux ritual

The one line that makes sessions effectively immortal. Edit the host, open Advanced, and put this in Startup:

tmux new -A -s main

Every connect now attaches to the same server-side session — creating it the first time, rejoining it every time after. Phone dies, elevator eats your signal, week passes: reconnect and the session is exactly where you left it, because it never stopped. The ✦ assist's "catch me up" reads what happened in the gap.

4 · The ✦ assist

On supported iPhones (15 Pro and later) the assist works out of the box, entirely on device. For a bigger brain, bring your own key: Settings › Assist › Brain, pick a provider, tap Get a key ↗ (opens the provider's console right in the app), paste, Save. Then hit Test connection — a green check means the round trip works — and use the button beside the model field to pick from the provider's live model list.

Running your own models? Point Base URL at any OpenAI-compatible endpoint — Ollama or LM Studio on your own machine work, and need no key at all:

http://your-mac.local:11434/v1

5 · Snippets

The on the key rail. Save the commands you run on every connect — reattach rituals, log tails, deploys. Tap one to place it at the prompt (you press return); enable Allow long-press to run immediately per snippet for the ones you trust. Snippets can be global or scoped to one host.

The rail, briefly

ctrl taps arm it for the next key; the armed state is shown on the cap. The bottom toggle names the drag mode you're in: hist walks your command history, scrl (always that green) scrolls the buffer — flipping back snaps you to the live line. Every key on the rail is customizable in Settings › Key rail.

Questions

[email protected] — a real person reads it. The privacy page covers where your data goes (short version: your servers, not us).