moshterm

~ codex

Codex from your phone

Run the Codex CLI in tmux on your computer, install the moshterm companion, and connect with moshterm on iPhone, iPad or Android. Codex's approval prompts reach your phone with the command attached, Chat View shows the session as a conversation, and the Inbox shows whether Codex is working, waiting or done. Free, with no account.

App Store coming soon Get it on Google Play

Free, no account. moshterm Pro adds live previews.

Set it up

On the computer where Codex runs (macOS, Linux or WSL):

# installs moshterm-hook and starts itcurl -fsSL https://mickmosh-relay.mick-fb5.workers.dev/install.sh | sh
# writes Codex's hooks.json and turns its hooks onmoshterm-hook install

The hooks go in Codex's own folder, $CODEX_HOME (~/.codex unless you changed it). Codex asks once whether to trust the new hooks. Then start Codex inside tmux:

# a session for the agenttmux new -s web
# inside that sessioncodex

Connect from the phone and the app pairs with the companion on that first connection.

Approvals

When Codex asks before running a command, the request reaches your phone. Approve or deny it, and the companion types y or Esc into Codex's own prompt, after checking the prompt in the tmux pane is still the one you saw. If it changed, nothing is typed and the phone says so.

Chat View and the Inbox

Chat View reads Codex's session files under $CODEX_HOME/sessions and shows them as a conversation, with tool calls folded to one line. Prompts you send from it go to the same pane.

The Inbox keeps one row per Codex session on every paired computer. By default a finished turn only notifies you when the reply needs you, and everything else waits in the Inbox.

Other agents

The same companion manages hooks for Claude Code, OpenCode, Cursor, Grok Build, Kimi Code, Hermes, Pi and OMP. See Claude Code from your phone.

Questions

Can I answer Codex approval prompts from my phone?

Yes, when Codex runs in a tmux pane on a computer with the moshterm companion. Approve or deny from the notification or the Inbox; the companion types the answer into Codex after checking the prompt is unchanged.

Does moshterm run Codex for me?

No. Codex runs on your own computer with your own login. moshterm is the terminal, the notifications and the Inbox.

Is it free?

Yes. Approvals, Chat View, the Inbox and notifications are free, with no account. moshterm Pro only adds live previews.