Screen map
Every screen of the operator app, where it opens, and the page that explains it. The app's title is guilds.run. The orchestrator serves it at the site root, and the same app works on a laptop or a phone.
How the app is built, how a page loads its user and organisation, and every route with its search parameters are in Web app.
Back button
A link in a page's content that leads to another tab or page, such as a tool call's memory chip in an agent's chat or a link in guild settings, leaves a round back arrow floating over the top left of the page's body, just under the agent's or guild's tab row. It returns to the exact place the link was followed from, the open run and call included. Its tooltip names that place: its tab within the same agent or guild ("Back to Chat"), its full name from elsewhere ("Back to agent chat", "Back to guild settings").
Moving within the new place keeps the button. Going back, or moving to another place by the tabs, the sidebar, or the browser, clears it. Links in tab rows and headers are the app's own navigation and leave no button.
Markdown
Messages, notes, Tasks, and instructions render as GitHub Markdown that keeps single line breaks. ![[…]] embeds and tagged handles show as chips. Code blocks show their language and a copy button.
Screens
| Screen | Route | Explained in |
|---|---|---|
| Welcome dialog | over every page | Model keys |
| Home: opens the last guild visited, or the first; with none, Create a guild or Use Builder | / | Guilds, Guild builder |
| Not-found page: Nothing lives at this address, with Back to your guilds | any unknown path | this page |
| Sidebar: Inbox, Builder, Recipes, Tables | every page | Inbox and issues, Guild builder, Recipes, Collections |
| Sidebar: guild rows, each with its unread message count | every page | Guilds, Inbox and issues |
| Sidebar: agent rows and Add agent | every page | Agents |
| Collapsed rail (⌘B / Ctrl+B): the same entries, guild unread badges, and Settings | every page | Guilds |
| Account menu: Organisation switch, Theme, Desktop notifications (when the browser supports them), Settings, Admin, Sign out | every page | Organisations, Users, Inbox and issues |
| Create guild dialog | from the sidebar | Guilds |
| Create an agent: choice of agent or coding agent | from Add agent or the guild's New agent | Agents |
| Create an agent (Identity, Model, Machine) | from Add agent | Agents, Machines, Agent home for Disk |
| Create a coding agent (Identity, Machine, Harness, Lead model, Repositories) | from Add agent | Coding agents, Harnesses, Repositories |
| Guild header and Guild options menu: Open in Studio, New agent, Save as recipe, Guild settings, Clear group chat | /guilds/<id> | Guilds, Group chat |
| Guild message-budget button | /guilds/<id> | Group chat |
| Open recipe apply strip | /guilds/<id> | Applying recipes |
| Guild Group chat tab, with the queue of messages waiting for busy agents | /guilds/<id> | Group chat |
| Guild Settings tab | /guilds/<id>/settings | Guilds |
| Guild Settings: Operators | /guilds/<id>/settings | Operators |
| Guild Settings: Commit author email, Repositories | /guilds/<id>/settings | Repositories |
| Guild State › Files | /guilds/<id>/state/files | Notes |
Note Access button and the Access to <path> dialog | the header of an open note in the notes browser: Guild State › Files, Agent State › Notes, Studio | Access, Notes |
| Guild State › Access | /guilds/<id>/state/access | Access, Notes, Collections |
| Guild Routines tab | /guilds/<id>/routines | Routines |
| Guild Issues tab | /guilds/<id>/issues | Inbox and issues |
| Guild Tools tab | /guilds/<id>/tools | Access |
| Guild Secrets tab | /guilds/<id>/secrets | Secrets |
| Guild Usage tab | /guilds/<id>/usage | Usage |
| Agent inspector header and menu | /guilds/<id>/agents/<id> | Agents |
| Coding readiness warning | agent inspector | Coding agents |
| Browser login needed strip | agent inspector | Browser |
| Agent Chat tab: transcript, run flow, attachments, Resume | /guilds/<id>/agents/<id> (?run=…) | Run transcript, Runs |
| Chat History drawer | /guilds/<id>/agents/<id>/history (?history=true) | Run transcript |
| Chat coding strip | agent Chat tab | Coding agents |
Chat code_task row and Changes panel | agent Chat tab | Code tasks, Reviewing changes |
| Chat secret request card | agent Chat tab | Run transcript, Secrets |
| Agent Prompt tab | /guilds/<id>/agents/<id>/prompt | Task |
| Agent State › Memory | /guilds/<id>/agents/<id>/state/memory | Memory |
| Agent State › Notes | /guilds/<id>/agents/<id>/state/notes | Notes |
| Agent State › Access | /guilds/<id>/agents/<id>/state/access | Access, Notes, Collections |
| Agent State › Scripts | /guilds/<id>/agents/<id>/state/scripts | Scripts |
| Agent Routine tab | /guilds/<id>/agents/<id>/routine | Routines |
| Agent Browser tab | /guilds/<id>/agents/<id>/browser | Browser |
| Agent CLI tab | /guilds/<id>/agents/<id>/cli | Agent home |
| Agent Tools tab | /guilds/<id>/agents/<id>/tools | Access |
| Agent Secrets tab | /guilds/<id>/agents/<id>/secrets | Secrets |
| Agent Usage tab | /guilds/<id>/agents/<id>/usage | Usage, Agent home for disk |
| Agent Settings: Identity, Model / Lead model | /guilds/<id>/agents/<id>/settings (?section=identity, model) | Agents |
| Agent Settings: Machine | ?section=machine | Machines |
| Agent Settings: Harness | ?section=harness | Harnesses |
| Agent Settings: Repositories | ?section=repositories | Repositories |
| Access view (Tools and Secrets, at organisation, guild, and agent) | Settings, guild, and agent tabs | Access, Secrets |
| Inbox | /inbox | Inbox and issues |
| Tables: records, Columns, Access | /tables, /tables/<collection id> (?tab=columns, access) | Collections, Access |
| Settings › General | /settings | Organisations |
| Settings › Members | /settings?tab=members | Organisations |
| Settings › Machines | /settings?tab=machines | Machines |
| Settings › Model keys | /settings?tab=keys | Model keys |
| Settings › Secrets | /settings?tab=secrets | Secrets |
| Settings › Tools | /settings?tab=tools | Access |
| Settings › Usage | /settings?tab=usage | Usage |
| Admin › Connector catalog | /admin | Instance admin, Connector registry |
| Admin › Platform keys | /admin?tab=instance | Instance admin, Platform keys |
| Admin › Users | /admin?tab=users | Instance admin, Users |
| Studio landing and workspace: Guild, Agents, State, Tools | /studio, /studio/<session id> | Prompt Studio |
| Studio Agents › Topology | /studio/<session id>?section=agents | Studio activity |
| Studio State › References | /studio/<session id>?section=state&tab=references | Prompt Studio |
| Studio coach proposal cards | /studio/<session id> | Studio proposals |
| Builder landing and workspace | /builder, /builder/<session id> | Guild builder |
| Recipes library and recipe page | /recipes, /recipes/<id> | Recipes |
| Apply preview and apply checklist | /recipes/<id>/apply, /applies/<apply id> | Applying recipes |