Skip to main content
Version: 11.5.0

Having Conversations with Your Agent

HYPR AgentPass™ carries messages both ways between you and a running agent. The agent asks or reports, you answer or instruct, and the gateway records the exchange. The connection that makes this possible is called a channel.

In the console, Conversations carries a Preview tag.

You need Conversations: View and Conversations: Send, which Admin, Operator and Supervisor hold for their own agents. You message the agents you supervise.

How a Channel Works​

A channel client runs beside the agent, and keeps a live connection to the gateway. There is one for Claude Code and one for Codex CLI. Through it, the gateway can hand your message to the agent mid-task, and relay the agent's replies back. The channel uses the agent identity the gateway already knows, so the conversation is attributed to your agent and to you.

Two things must be in place.

RequirementWho does it
The AI provider connector your agent uses has Allow Channel connections turned on. It is on by default for Anthropic and OpenAI connectorsYour administrator, if it has been turned off. See Anthropic
The channel client for your agent is running on the machine where the agent runsOn a Mac with Endpoint Guard, Endpoint Guard. See Channels on a Mac. Elsewhere, you, with the client your HYPR representative provides for your agent type

Channels on a Mac​

On a Mac running Endpoint Guard for macOS, nobody installs or starts a channel by hand. When your administrator turns on Claude Code or Codex CLI under Desktops › Desktop configuration › Configuration, and the tool is signed in, Endpoint Guard takes care of its channel:

  • It fetches the channel from your gateway the first time the tool is routed, and checks its signature before running it.
  • It runs the channel for the signed-in user, and starts it again if it stops.
  • It checks your gateway for a newer channel every hour. If a new version cannot start on the Mac, it goes back to the previous one.

While your agent waits for your approval, its channel waits too. It connects within a minute of your approval. See Approve the First Connection.

To see a Mac's channels, run ap-cli status on it. It lists each installed channel with its version and whether it is running. It also says when a channel check failed, or when a new version could not start or did not pass its signature check. See Check a Workstation with ap-cli.

How an administrator turns the channels on is in Claude and Codex Channels.

Message a Running Agent​

  1. Open Conversations. The list shows every agent you supervise, with unread conversations first. If you supervise no agents yet, the screen reads No agents yet.
  2. Click your agent to open its conversation.
  3. Type your message, and send it. The agent's replies arrive in the same thread as it works.

If the agent's channel is offline, the message waits, and is delivered when the channel reconnects.

On iPhone, a message to an agent that is turned off is not sent, and the app shows This agent is turned off. Turn the agent back on, or ask whoever turned it off. See Turning an Agent Off.

The same conversations reach you in the HYPR mobile app. Open the agent's conversation, and reply there. A request the agent raises for a decision arrives under Needs you, where you approve or deny it. See Approving and Denying Agent Actions.