Getting Started

From zero to monitoring your first AI agent session in under five minutes.

1. Install the CLI

Requires Node.js 20 or later.

npm install -g styrby-cli

Verify the install:

styrby --version

2. Create an account

Sign up at styrbyapp.com. Pro and Growth both include one machine and full session monitoring; cancel anytime.

3. Run the setup wizard

Run the onboard command. It handles GitHub authentication, machine registration, and mobile pairing in one flow.

styrby onboard

The wizard opens your browser for GitHub OAuth, registers your machine, then displays a QR code. Open Styrby on your phone and tap Add Machine to scan it.

Pairing generates a TweetNaCl keypair on your machine. The public key is sent to Styrby; the private key never leaves your device. All session data is end-to-end encrypted from this point.

To re-pair later (new phone, lost device), run styrby pair.

4. Start an AI agent

Launch any supported agent. The CLI auto-detects the agent process and begins streaming session data.

# Use agent shorthand to start a session.
# All 11 agents are accepted: claude, codex, gemini, opencode, aider,
# goose, amp, crush, kilo, kiro, droid.
styrby claude

# Or let Styrby use your default agent (set via ~/.styrby/config.json):
styrby

Tier note: Free includes Claude Code, Codex, and Gemini CLI. Pro adds OpenCode, Aider, Goose, Amp, Crush, and Kilo. Power adds Kiro and Droid. See Agent Setup for the full matrix.

Within seconds, the session appears in your dashboard and mobile app. You can see token usage, approve permission requests, and review the conversation in real time.

5. Verify everything works

styrby status
# Output:
# Machine: paired (abc123)
# Agents:  1 active (claude)
# Session: ses_8f3k2... (running, 142 tokens)