Skip to content
Browse documentation

Reference

Customize the workspace and use keyboard controls

Arrange the room, choose appearance, use quick actions, and navigate without guessing shortcuts.

Choose appearance and arrange the room

  1. Open Settings → Appearance. Light is the default. Choose dark, light, system, Dark Balanced (dark interface with a light canvas), or Light Balanced (light interface with a dark canvas). The preference persists across restarts.
  2. Under Studio background in the same tab, choose the floor of the studio canvas: Classic (the original dotted floor, the default), Office, Garden, Atelier or Library. It is saved automatically for this project and applies in light and dark modes.
  3. Pan and zoom the room using its workspace controls: Zoom out, Zoom in and Fit all agents, which frames the whole room layout again. Drag a workstation to organize the team visually; this changes placement, not mission, routing, or capabilities.
  4. Open Furniture to browse 20 pieces in Work, Lounge and Life: tables, boards, a library, test station, server rack, printer, seating, plants and more. A project holds up to 256 pieces. Selected furniture opens real notes, tickets, reports or team requests: the Printer exports a request report or the activity logs, the Locker opens an agent’s appearance, and the Jukebox can play an optional ambient sound that stops when you close its panel. Ambient animations alone do not execute work.
  5. Use the operating system’s reduced-motion preference to reduce motion in components that honor it. Whistle (shown as At your desks while active) calls agents back to their workstations; it is a visual interaction rather than a pause, stop, or approval action.
  6. Verify a layout change by reopening the app and checking the saved room. Reset room at the bottom of the furniture library replaces this room’s furniture and notes with the default layout after confirmation; choose Keep my room to cancel. It does not move the view: use Fit all agents for that.

Organize rooms and personalize agent desks

  1. Use Rooms beside Furniture and Whistle to add a named room, up to 32 per project. Choose its purpose (Kitchen, Restroom, Meeting room, Lounge, Focus room or Custom room), then customize its floor and shape.
  2. Select a room to rename it and adjust width, height and corner rounding, from square shapes to rounded rooms. Keep proportions linked or resize the dimensions separately; handles on the selected room allow direct resizing. Drag its label to move the room with its furniture and workstations. Removing the room leaves its contents in place.
  3. Choose an Office, Garden, Atelier or Library floor. A custom color overrides the floor and motif colors. Show or hide the raised walls to adjust the view.
  4. Position the entrance along the room perimeter while editing. Rooms cannot overlap; adjacent rooms share a repositionable door, which disappears when they separate. Agents use doorways to cross walls. Door handles appear during room editing.
  5. Place furniture within rooms. Agents can visit accessible furniture beyond their workstation’s surroundings. They approach available left or right access points, or the front of compatible furniture when a side is occupied. Blocked access, occupied slots, At your desks, pause and reduced motion can prevent a visit.
  6. Edit an agent’s appearance in Edit agent: choose a Shape (Circle, Capsule, Drop, Rounded, Triangle, Organic, Star, Scribble, Light bulb, Flower or Diamond), a color, Accessories (Glasses, Headphones, both or none) and a Desk. None is the original default; Administrative desk, Computer workstation and Research desk add visible furniture at that workstation, which you can drag or move with the arrow keys. A workstation without a desk keeps its round floor marker. Cranks can wear the same accessories, set in the Crank editor.
  7. Use the four canvas tabs above the scene, Studio, Cranks, Board and Meetings, to switch between the team floor, automation tools, the planning board and meetings. Each view retains its zoom and framing while you switch. The right-panel Agents and Cranks tabs follow the Studio and Cranks selection; each Crank has its own On / Off switch. Layout choices do not grant application access or alter workflow routing. See Plan work on the Board and Hold meetings with your agents.

Keyboard reference

WhereKeysAction
AppCtrl+K or Command+KToggle Quick actions.
Quick actionsType; Arrow Up / Arrow Down; EnterFilter, select, and execute an action.
Quick actions or settingsEscapeClose the open surface.
Request composerEnterSend the request, except during IME composition.
Request composerShift+EnterInsert a line break.
Request edit boxCtrl+Enter or Command+Enter; EscapeSave or run the edited request; cancel the edit.
Conversation large viewEscapeReturn to the workbench.
Source control commit messageCtrl+Enter or Command+EnterCommit.
Meeting message @mention suggestionsArrow Up / Arrow Down; Tab or Enter; EscapeChoose a suggestion, insert it, or dismiss the list.
Canvas tabs, Agents / Cranks tabs, request detail tabs, speed mode switchArrow Left / Arrow Right; Home; EndMove to the previous, next, first or last option.
Focused workstation, desk or room labelArrow keysMove it in 15-unit steps; a room moves with its contents.
Focused room resize handleArrow keysResize the room by 10 px per press.
Focused door during room editingArrow keysMove the door along the wall by 1% per press.
Room or furniture inspectorEscapeClose the inspector.
DocsTab / Shift+Tab; EnterMove among links and controls and activate them.
Docs mobile navigationEscapeClose and return focus to Browse documentation.
Docs code/table regionArrow keys when focusedScroll overflowing content.

Use Quick actions

  • With an empty search, Quick actions shows This request (actions for the selected request), the first Actions, Go to the other canvases, and recent requests.
  • Actions include New request, Pause agents or Resume agents, Stop all requests (only while a request is live), Turn board auto-run on or off, Show changes, Add agent, New Crank, Open project, Open settings and Account. Go to opens Studio, Board, Meetings or Cranks. Speed: Ultra-fast, Balanced and Big brain switch the speed mode.
  • This request offers, depending on its state: Stop this request; Resume this request or Fix the open points; Restart this request or Run this request again; Edit this request or Edit and run this request again; and Export this request.
  • Typing searches actions, requests, board cards, agents (including Enable or Disable for each agent), meetings and Cranks. Accents and capitals are ignored, and every typed word must match.
  • Text of three characters or more can also be sent: Ask the team: … submits it as a new request, and Add to … creates a card in the board’s ready column (or its backlog when there is none). These appear first for a sentence of five words or more, or when no action or item label matches.

Read the action before pressing Enter; Stop all requests affects every active request. There is no separate documented global keyboard shortcut for approving permissions or deploying.

All documentation