Answer Gemini CLI from your iPhone

When Gemini CLI stops to ask you something, Hwip sends the question to your iPhone and types your answer back into the same tmux session.

What reaches your phone

• Questions. A rule in ~/.gemini/GEMINI.md has Gemini CLI ask through the hwip_ask tool: up to four buttons and a text field.
• Approval prompts. When Gemini CLI waits on a tool approval, the phone shows the tool, the command or diff, and the answers. If you answer at the keyboard first, the phone's answer is refused.
• A finished turn. A "Task done" push with the project and branch.
• The live timeline. Prompts, tool calls and replies, read from Gemini CLI's own chat log.
• Your prompts. Type a prompt on the phone, and it lands in the session as if you typed it at the keyboard.

Set it up

1. Install Hwip on your iPhone and sign in.
2. On your Mac: npm install -g @hwip/cli && hwip install. For Gemini CLI this adds the Hwip MCP server and two hooks to your user settings.
3. Start Gemini CLI through Hwip: hwip gemini. It runs in a normal tmux session named hwip-<project>.

What a question carries

The session's git diff against HEAD and its last 60 terminal lines. Secret-looking text is masked first, best effort. Everything is sealed on your Mac with AES-256-GCM before it is sent.

What the server sees →

What it doesn't do

• One Gemini CLI session per folder. Two sessions in the same folder share one timeline.
• tmux is required. On Windows, that means WSL.