Rename, close, and mark agents

You manage agents right from their cards in the Console. Touch and hold a card for its actions, swipe it to close it, or tap Select to act on several agents, across Hosts, at once.

What’s in the card’s menu?

Touch and hold an agent card to see:

• Select: start picking several agents. See below.
• Pin or Unpin: keep it at the top of the list.
• Mark as Unread or Mark as Read: see below.
• Move to Workspace…: move its tab into another Workspace on the same Host. See Workspaces.
• Rename Tab…: rename its herdr tab.
• Open in New Window: on iPad, open it in its own window.
• Close: close its tab.

Close an agent

Swipe the card and tap the trash icon, or choose Close from its menu. The tab doesn’t close right away: the icon turns into an undo arrow and a red circle drains for 5 seconds. Tap it, or the card, to undo. When the tab is the last one in its Workspace, the Workspace closes too.

A closed agent goes to Closed Sessions, so you can resume it later.

Close from the agent’s screen

In an open agent, open the More menu and tap Close Agent. Waycar asks “Close ?” and explains that this closes the pane on the Host and removes the agent everywhere. Tap Close Agent to confirm or Cancel to keep it.

This one has no undo countdown: the pane closes on the Host right away, unlike a swipe or the card’s Close. If it fails, Waycar shows Couldn’t Close Agent with the reason.

Rename an agent, shell, tab, or Workspace

Item	Where	What it changes
Rename Tab…	Touch and hold a card in the Console	The herdr tab’s name.
Rename Agent	More menu on an agent’s screen	The agent’s name, the agent field on its card. Leave it empty to fall back to the detected kind, such as claude.
Rename Agent on a shell (the sheet reads Rename Shell)	More menu on a shell’s screen	The shell’s tab name.
Rename Workspace	More menu on any agent’s screen	The name of the Workspace it’s in.

Tap Save to apply or Cancel to leave it.

Agent name rules

Agent names are 1 to 32 characters: lowercase letters, digits, - or _, starting with a lowercase letter. The sheet shows this rule when a name doesn’t fit.

Mark an agent as unread

Touch and hold an Idle agent and tap Mark as Unread. Waycar lists it as Done again: green badge, the Done and Needs Attention pills, and Done’s place in the sort. It stays that way until you open it, tap Mark as Read, or the agent starts doing something new.

The mark stays on this device. It never changes what herdr, notifications, or Live Activities report.

Act on several agents at once

1. Touch and hold a card and tap Select.
2. Check the agents you want, or tap Select All. A selection can span Hosts.
3. Use the bottom bar: Pin, Mark Read or Mark Unread, Move…, or Close.
4. Tap Done to leave selection.

Each closed card gets its own undo countdown. Move… only works when every checked agent is on one Host; otherwise Waycar says “Move works within one Host.”

herdr and tmux

Rename Tab… appears for herdr agents. On tmux, Rename Agent renames the tmux window and Rename Workspace renames the tmux session. A shell is renamed by its tmux window.

Troubleshooting

• If a close fails, Waycar shows Could Not Close Tab with the reason. When the Host is briefly reconnecting as the countdown ends, the close waits for it to come back and then goes out.
• If Move to Workspace… or Move… fails, Waycar shows Could Not Move Agent with the reason.
• A rename that fails says “The Host is not connected.” or “herdr rejected the rename:” with herdr’s reason. Reconnect or fix the name, then try again.