Grenade listens to Claude Code's own hooks, so your phone knows the moment Claude needs a permission, asks a question or finishes. Answer on a card, by typing, or by voice.
Claude Code tells the daemon on your Mac when it starts working, when it needs an answer and when it has finished. Nothing is guessed from the screen.
Permissions as cards
When Claude wants to run a command or edit a file, the phone shows what it wants to do, in full. Allow it once, or deny it and say what to do instead.
Questions and plans
A question shows its choices, and takes a typed answer too. A plan can be approved, or sent back with what should change.
The model in the header
Each session shows the model Claude last answered with, and follows a /model switch.
Type or talk
Send text from the keyboard, or hold the mic and speak. Speech is turned into text on the phone, and lands in the field first so you can fix it.
Hand it a screenshot
Attach an image from the phone. It is saved on the Mac and the agent is given its path, end-to-end encrypted like everything else.
Status
How the phone knows
Grenade starts Claude Code with its own hooks, passed for that session only: nothing in ~/.claude changes. They report to the daemon on your own Mac and nowhere else. The one-line summary on each session is written on the Mac through your Claude Code login, so there is no API key to set.
Start one
On the Mac
Mac
grenade setup
grenade new api --cwd ~/code/api --agent claude
No. Grenade starts the Claude Code that is already on your Mac, with the login it already has. There is no Grenade account: you pair your phone by scanning a QR code on the Mac.
Does Grenade change my Claude Code settings?
No. Its hooks are passed to Claude Code for that session only, so nothing in ~/.claude changes.
Can I approve a permission from my phone?
Yes. When Claude wants to run a command or edit a file, the phone shows the request in full on a card. Allow it once, or deny it and say what to do instead. Questions and plans arrive the same way.
How is this different from Claude Code Remote Control?
Remote Control reaches one Claude Code session through your Anthropic account. Grenade lists every agent on your Mac, Codex and shells included, with no account, and shows which one is waiting. The two side by side.
Can I run several Claude Code sessions at once?
Yes. Sessions in the same folder form a group, and each one shows a color: amber when it needs an answer, green when it has finished, blue while it works.
Does my code leave my Mac?
The agent runs on your Mac as it always does, and Grenade adds no server that can read it. What your phone shows of the terminal travels end-to-end encrypted, directly on your Wi‑Fi or through a relay that sees only encrypted bytes.
What if I close the terminal, or my phone loses its connection?
The session keeps running: it lives in tmux on your Mac, so closing a window ends nothing. The phone reconnects by itself and shows where the session is now.