Skip to content
Docs
Download

Managed Codex and Claude Code sessions

Start Codex or Claude Code through the Whisperstream CLI so sessions remain available for HUD and voice replies.

Applies to
Whisperstream 1.5.0
Last reviewed

Install the Whisperstream CLI

Start Codex or Claude Code through the optional Whisperstream CLI when you want its session to remain available in the HUD after a turn ends. This lets you return to a coding session and dictate a reply later, instead of relying on Agent Speak's temporary reply window.

First, connect the coding agent you plan to use. See Agent Speak for connection, trust, and speech setup. Then:

  1. Open Experimental in Whisperstream.
  2. Beside Agent Speak, select Configure.
  3. Find Whisperstream CLI and select Install.
  4. If the status asks you to, open a new terminal before using the command.

Use Uninstall in the same place to remove the Whisperstream command from your PATH. This does not uninstall Codex, Claude Code, or Whisperstream.

Start a coding agent session

Open Windows Terminal and run the command for your coding agent:

whisperstream codex
whisperstream claude

Arguments after the agent name pass to that coding agent unchanged. For example:

whisperstream codex resume --last
whisperstream claude --model opus

Voice replies are tested in Windows Terminal only. They may work in another terminal, but Codex or Claude Code continues normally if Whisperstream cannot connect the session.

Remote Codex sessions are not available for HUD replies. Running whisperstream codex --remote still starts Codex normally, with voice replies off.

Return to a session in the HUD

Use your View full response shortcut to open the HUD. Each active CLI-started session appears under Coding agent sessions, identified by its coding agent and session name.

When several sessions are open, select a tab or use these shortcuts:

  • Ctrl+1 through Ctrl+9 selects a session by position.
  • Ctrl+Tab moves to the next session.
  • Ctrl+Shift+Tab moves to the previous session.

The selected session shows its latest response and whether it can accept a reply. If it is read-only, continue in its terminal and wait until the agent finishes before trying again.

To reply, select a session that can accept input and start dictation with your usual Push to Talk or Toggle shortcut. Review the draft in the HUD, then press Enter to send it. Press Escape to cancel the draft and close the HUD without ending the coding agent session. Agent Speak's automatic-send and speech settings still apply; configure them in Agent Speak.

Closing the terminal ends that coding agent session and removes it from the HUD. Closing or restarting Whisperstream does not stop the coding agent. The session reconnects when Whisperstream is available again. If the provider is disconnected, the app version is incompatible, or a connection cannot be established, the coding agent continues normally and HUD replies remain off.