Set up ShellSpeak

The free Mac gateway — one‑time, ~2 minutes

ShellSpeak on your iPhone controls Claude Code running on your own Mac. A small free helper — the ShellSpeak Gateway — runs on that Mac and bridges the two over your local Wi‑Fi. Your phone talks only to your Mac; nothing goes to any NYRAI or cloud server, and it uses your Claude — we never see your commands.

Get ShellSpeak Gateway (macOS) →

On nyrai.ai · universal (Apple Silicon & Intel) · signed & notarized by Apple · free.

What you need first

A Mac and an iPhone with the ShellSpeak app.

Claude Code installed on that Mac and signed in. Get it here: Claude Code setup — then confirm claude --version works in Terminal. The gateway can’t do anything without it.

Both devices on the same Wi‑Fi (not cellular).

Set it up

1 · Install the gateway

Open the downloaded .dmg and drag ShellSpeak Gateway into Applications. The first time you open it, right‑click the app → Open (this confirms you trust an app downloaded outside the App Store — you only do it once).

2 · Start it

The window checks that Claude Code is installed (green dot = good). Click Start Gateway. A QR code appears. Leave this app running while you use ShellSpeak.

3 · Connect your phone

On your iPhone: open ShellSpeak → Connect → Scan QR Code → point it at the code on your Mac. That’s it — start speaking.

If iOS asks for Local Network permission, allow it — the phone needs it to reach your Mac. (You can also turn it on later in iOS Settings → ShellSpeak → Local Network.)

Is this safe?

Yes. The connection is encrypted and the gateway pins your Mac’s own certificate, so only your phone (with the key from that QR) can connect. Every spoken command is screened against a safety denylist — destructive operations like rm -rf, disk formatting, or “delete everything” are blocked before they ever reach Claude Code, and deletions are sent to the Trash rather than permanently removed.

Trouble?

“Claude Code was not found”

Install it (setup guide) and confirm claude --version works in Terminal, then click Start again. Apps opened from the Finder don’t inherit your Terminal’s PATH; the gateway re‑reads your login shell to find claude, but a very custom setup (nvm/asdf) may still hide it — put claude on a standard path like /usr/local/bin.

“That network port is already in use”

Another program holds the port. Edit ~/.shellspeak/config.json, change "port" (e.g. to 3100), and click Start again.

My phone won’t connect

Make sure both devices are on the same Wi‑Fi, and on the phone that iOS Settings → ShellSpeak → Local Network is ON. Then re‑scan the QR code.

It stopped by itself

The gateway times out after a long idle period (a safety feature). Just click Start Gateway again.

Home · Privacy · Terms · Support