Ctrl-N in command mode and Tab in a window open one agent picker over the session's own agents.list, whose rows say where each agent comes from in four words; from it b starts a branch (then w or c), s switches the window it was opened over (a pod's own), e opens the agent's file in /agents' editor, Enter does what it was opened for, and what the session cannot do is refused there with why¶
TUI decision 164 · accepted · 2026-10-18 · issue #594
Issue #594's terminal slice, on root Decision 920's list. Amends TUI Decision 155 (Ctrl-N's chooser is no longer command mode's own page) and 156 (Tab's chooser is the same picker, and does more than switch).
- One picker.
Troupe.UI.TUI.AgentChooseris the popup both keys open, over what they were opened from: command mode for Ctrl-N, the window for Tab. Its rows are the daemon'sagents.listnamed by the session (root Decision 920), so on a pod they are the bundle's (the remote client sendssession_id, which the pod's guard admits). Each row is the name, the agent in use marked●, its origin in the four words (Shipped,Your organisation's,Yours,This repository's; a daemon before them is read bylayer) and the badges the palette shows; beside it the description, where it comes from with a bundle's profile, what it stands in for, what it may do, why it cannot run here when it cannot, and its instruction, read throughagents.getas the cursor reaches it. - Three actions, the same keys wherever it was opened.
bstarts a branch on the agent; where it works is the next step,wa worktree of its own,cthe checkout, Enter the one marked, as Ctrl-N's second step was; what was typed before Ctrl-N is the task and starts at once, and without one the choice waits on the command line, as before.sswitches the window it was opened over (profile.switch, the conversation kept); on a pod Ctrl-N'ssswitches the session's own agent, its one window.eopens/agentson the agent and its editor at once (TUI Decision 156's edit: the person's editor on a temporary copy, checked when it comes back, a built-in saved as a copy where the person says). Enter does what it was opened for: a start from Ctrl-N, a switch from Tab, so neither key's habit changed. Not chosen: Enter always starting, as the issue sketched, which would have turned every Tab-then-Enter switch into a new branch. - Refused there, with why, before the daemon is asked, on the picker's own line: an
agent the daemon says cannot run here, for a start and a switch; a start on a pod ("a
remote session runs one profile; create another session from HQ");
sin command mode on this computer, which has no window to switch; andeon a bundle's agent (editable_reason) or on anything on a pod (the listing'sread_only, the sentence the worker refuses a write with). - Not here:
/agentsand/newopening the picker, the manager density, copy and new from a template in the picker, and save → start (the issue's other slices).
Governs: clients/tui/lib/troupe/ui/tui/agent_chooser.ex, clients/tui/lib/troupe/ui/tui/server.ex, clients/tui/lib/troupe/ui/tui/view.ex, clients/tui/lib/troupe/client/daemon.ex, clients/tui/lib/troupe/client/remote.ex