Console (SSH)

The Console is a native SSH terminal built into Gray. It’s there when you need to drop into your server directly — read a log, restart a service, poke at the filesystem.

When to use it

• Voice and chat handle 95% of ops. Console is the other 5%.
• Anything you’d rather see exactly the raw output for.
• Debugging the box when the brain itself is misbehaving.

Setting it up

The Console is only available when you’re connected to a host you can reach over SSH — i.e., your self-hosted Gray over Tailscale, or any server you’ve added to Settings → SSH hosts.

1. Open Settings → SSH hosts → Add host.
2. Enter hostname, user, port, and your SSH key (uses Apple’s Secure Enclave — see Key storage).
3. Save.

The Console tab on Talk now shows that host. Tap it to drop into a real shell.

Plus / Pro only

The Console is gated to Plus and Pro tiers, and is always available on self-hosted Gray.

What’s safe

• The brain’s own guardrail (guard.py) blocks the brain from touching secrets, running rm -rf, modifying /etc/ssh, etc. The Console you control directly — if you type rm -rf, that’s on you.
• All Console sessions are logged to your History.
• Keys never leave the Secure Enclave.

Tips

• External keyboards work — Bluetooth, Smart Keyboard, Magic Keyboard.
• Long-press the screen to copy/paste from the system clipboard.
• Swipe down from the top to switch between Console, Talk, and Files without losing your session.