Gemini CLI

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.

How it is wired

hwip install adds the Hwip MCP server and two hooks to ~/.gemini/settings.json, and writes the rule to ~/.gemini/GEMINI.md. Your own entries in the settings file are kept. 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 machine with AES-256-GCM before it is sent. What the server sees.

Limits

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

See also Remote control and the MCP tools.