Use Agent Approve

Agents, names, and images

Give agent sessions distinct names and images on iPhone and Apple Watch.

Agent Approve creates a separate agent entry for each observed agent instance. A profile or workspace name sent by an integration can help distinguish concurrent sessions.

Active and inactive agents

The Agents tab lists agents under Active Agents and Inactive Agents. An agent is listed as active while it holds an active-session slot, which is the same count shown in Settings > Plan & Usage and on the Agents tab badge. An inactive agent shows Ready when it is idle and was seen within the last 30 minutes. After 30 minutes without activity, or when its last-seen time is missing, the list shows Offline. Offline is based on when Agent Approve last heard from the agent; it does not confirm that the agent process has closed.

Rename an agent

  1. Open Agents.
  2. Select the agent.
  3. Open the more menu.
  4. Tap Rename Agent.
  5. Enter a name and tap Save.

Use names that describe the role or machine, such as builder, reviewer, or my-mac. Names can be up to 100 characters. The custom name changes how the agent appears in your account. It does not rename the underlying coding-agent profile.

Change the image

  1. Open the agent and its more menu.
  2. Tap Change Image.
  3. Choose Photos, From URL, or an image already in Your Images.

Photo uploads support PNG, JPEG, GIF, and WebP data up to 5 MB. A URL must be a direct HTTPS image URL in one of those formats. Use Reset Image to return to the integration's default icon.

Removing an image from Your Images resets the avatar for every agent that uses it. The confirmation shows how many agents are affected.

Reset or remove an agent

Open an agent's more menu for these actions:

ActionWhat it does
Rename AgentChanges the display name in your account.
Change ImageSelects an upload, direct image URL, or saved image.
Reset ImageRestores the integration's default icon when a custom image is set.
Reset StatusClears a status that no longer reflects the running agent.
Clear All EventsPermanently removes the agent's event history after confirmation.
Delete AgentPermanently removes the agent entry and all of its events after confirmation.

Deleting an agent removes its entry from your account and frees its active-session slot. It does not stop the coding agent on your computer. The delete is refused, and the agent stays in the list, while an approval for it is waiting on your phone or if it sends new activity during the delete. Answer the approval or wait for the activity to settle, then try again. A coding agent that keeps running can appear again after deletion when it sends new activity, and that activity counts toward your plan's limits again.

Tap the information button on an agent to see its current status, integration identity, installed hook information, and capabilities. A capability shown there describes what that integration can report or control; it does not imply that every action in the coding agent is intercepted.

Do not use screenshots containing private commands, customer information, or account secrets as agent images.

Go out and grab a coffee

We'll ping you if your agents need you. Try Agent Approve free for 7 days.