Skip to content

The desktop app edits an agent's file as text, leaving every line its form did not change, asks once before a save that lets a tool run without asking that the replaced file did not, and switches a window among the agents its session could run

Decision 842 · accepted · 2026-10-10 · issue #503

Issue #503 in the desktop app (the daemon's side is Decision 841). Three choices the issue and 841 leave to the client.

  • The file's text is what is edited, and the daemon is its only judge. The form reads the frontmatter keys it knows (description, mode, model, tools, permissions, max_turns, budget_share, skills) out of the text and writes a change back where the key was (withFields), every other line as the file had it: a key it does not know (onboarding's imported_from, override), a comment, the order. A key written in a way the form does not read (a folded scalar) turns the form off and leaves the text to the file tab, rather than rewrite what it could not read. Not chosen: building the text from agents.get's parsed fields, which drops what the form does not know at the first save. Nothing is checked in the client: Check and Save ask the daemon (agents.validate, agents.put), and each finding is shown at the field it names, on the tab that has it.
  • Asked once, against the file being replaced. Before a save the editor shows what the agent may do, every auto named, and the save is asked about once when it lets a tool run without asking that did not before: an auto added, or an ask or deny made auto (widenedAutos). The comparison is with the file the save replaces, the definition the editor was opened from when it has the same name and layer; anything else is a new file and every auto in it counts, so copying an agent with an auto into your own layer is asked about, since there it applies in every workspace and no trust is asked (Decision 825 gates only a repository's). A save that keeps the autos it had is not asked about again. A repository's save is asked about too, worded for the trust it waits on. Not chosen: asking on every save (a question that is always there is not read), or only for the user layer (a repository's auto applies to everyone once trusted).
  • The switch offers agents. A window's head shows its agent and a switch among the primary agents its session could run: agents.list for a session on this computer, with each one's layer, and the agents section of the session's own commands.list for a session on the platform, its bundle's. The plane's profiles were offered there before, and a plane profile is not an agent: profile.switch names the agent, and since 841 an unknown name is refused. A refusal is said beside the switch; a switch that took is the transcript's to say, from profile_switched with its layer and the tools gained and lost. The agent shown is the transcript's (session_created, whose profile a pod writes as the agent it runs, Troupe.Session taking the plane's agent or the default, then each profile_switched), and until that arrives a daemon row's profile, never a plane row's, which names the plane's profile.

Governs: clients/gui/packages/client/src/agents.ts, clients/gui/apps/desktop/src/views/Agents.tsx, clients/gui/apps/desktop/src/views/AgentEditor.tsx, clients/gui/apps/desktop/src/views/AgentSwitch.tsx