Grenade starts Codex with its own hooks, so your phone knows when Codex is working, when it needs an approval and when it has finished. Read what it said or the whole terminal, and answer by typing or by voice.
Codex tells the daemon on your Mac when it starts a turn, when it asks for an approval, when it has finished and when you stopped it with Esc. Once you have trusted them, nothing is guessed from the screen.
What it said
What you asked and what Codex answered, as cards in its own words, read from its transcript on the Mac. The terminal is one tap away.
Trust on a card
Codex's “Hooks need review” and “Trust this folder?” dialogs show on the phone as cards. Tap an option and it is typed into Codex for you.
The keys Codex needs
Enter, Esc, Ctrl-C, Tab and the arrows sit on a key row above the keyboard, so you can answer an approval or stop a run.
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.
Told when it needs you
A notification arrives when Codex asks for an approval or has finished a turn, sealed so that only your phone can read it.
Status
How the phone knows
Grenade starts Codex with a few hooks, passed for that session only, so the phone hears it start a turn, finish and stop on Esc, and shows what you asked and what Codex said as cards, read from its own transcript. The first Codex session asks once to trust them, on a card on your phone: tap Trust. Codex's approvals are answered in its terminal, with the key row or by typing; the cards for permissions, questions and plans are for Claude Code.
Start one
On the Mac
Mac
grenade setup
grenade new api --cwd ~/code/api --agent codex
Yes. Grenade starts the Codex CLI that is on your Mac, with the login it already has. There is no Grenade account and no key to set.
Does Grenade change my Codex configuration?
No. Its hooks are passed to Codex for that session only. The first Codex session asks once whether to trust them, on a card on your phone.
Can I approve a Codex command from my phone?
Yes, in Codex's own terminal, which the phone shows in full. Enter, Esc, Tab and the arrows sit on a key row above the keyboard. The cards you answer with a tap are for Codex's trust dialogs and for Claude Code.
How is this different from Codex Remote in the ChatGPT app?
Codex Remote reaches Codex in the ChatGPT desktop app. Grenade reaches the Codex CLI in your terminal, with no account. The two side by side.
Can I run Codex beside Claude Code?
Yes. Sessions in the same folder form a group, whatever runs in them, and each one shows a color for working, finished or waiting on you.
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.