Repository navigation
Context Menus
Almost every action in Browserland has a right-click home. This is the "where do I right-click for X" index: pick the surface you're pointing at, see what its menu offers, and jump to the page that explains each action in depth.
A few rules apply everywhere:
- Greyed-out items don't apply to the current window (for example, Move column left when the window is already in the leftmost column).
- A
✓marks the current setting (the active width preset, the current MCP mode, names-vs-numbers, and so on). - Press
Escape, or click anywhere outside the menu, to dismiss it.
| Surface | How to open | Covered in depth on |
|---|---|---|
| Window title bar | Right-click a window's title bar | Arranging-Windows, Columns-and-Widths, Floating-Window-Controls |
| Tab strip | The ⊟ button on a tile's tab strip |
Arranging-Windows |
| Taskbar item | Right-click a window's taskbar button | Taskbar |
| Pager dot | Right-click a workspace dot in the taskbar | Workspaces |
| Empty desktop / strip | Right-click the background (or empty taskbar) | Floating-Window-Controls, Workspaces |
| Launch (+) button | Right-click the + button |
Taskbar, Window-Types |
Right-click a window's title bar. The menu adapts to whether the window is tiled or floating, and to whether it's a terminal or an app window (note, editor, file manager, task manager, Control Panel, help).
When the window is tiled:
-
Column width — set the column to
⅓,½,⅔, ormax. See Columns-and-Widths. - Stack into left column / Stack into right column — merge this window down into a neighbor column as a row.
- Move to own column — eject a window that shares a column into its own.
- Move to new column — spawn a fresh column to its right.
- Tab into left column / Tab into right column — tab this window into the neighbor column's live tile.
- Tab this window — seed or keep a tab strip in place for a lone window.
- Untab tile (split to rows) — break a tabbed tile back into stacked rows.
- Untab cell (side by side) — drop a nested split-group's tabs out as adjacent side-by-side cells.
- Un-split row (split to rows) — explode a split row into stacked rows.
- Move column left / Move column right — shift the whole column along the strip.
- Send to <workspace> / Send to new workspace — move the window to another virtual desktop. See Workspaces.
- Float this window — detach it from the strip as a floating window. See Snapping-and-Pop-out.
Tabbing, splitting, and stacking are all explained on Arranging-Windows; the column actions live on Columns-and-Widths.
When the window is floating:
- Tile this window — drop it straight into the tiling strip (no drag needed). See Snapping-and-Pop-out.
- Lock to screen (pin) / Unlock (scroll with strip) — pin the window so it doesn't scroll away with the tiling strip (this pins position, not always-on-top).
- On all workspaces / Show on all workspaces — keep a floating window visible on every workspace, or limit it to this one. See Workspaces.
On every window:
- MCP access (terminals only) — set this window's agent access to Off, Read, or Read-write. See MCP-and-AI-Agents.
-
MCP scope (terminals only, on a broker that supports scopes) — tag the window with an MCP scope, so only an MCP client declaring that scope (or one declaring none) can see it: (none) removes the tag, each scope already in use on that broker is listed with a
✓on the current one, and Set scope... takes a new name (1–64 ofA-Z a-z 0-9 . _ -, starting with a letter or digit; empty removes the tag). See MCP-and-AI-Agents. - Open in new window (terminals only) — move the terminal into a browser window of its own; see Window-Types.
- Fit to this screen (terminals only) — give the terminal this screen's size back, for example after another device such as a phone was active and left it phone-sized. A floating window is first reset to the default size. See Hosts-and-Multi-Browser.
- Minimize / Restore — hide the window to the taskbar, or bring it back.
- Close — soft close. A terminal's shell keeps running; a non-empty sticky note reopens from Closed notes in the + menu; a text editor keeps its file on the host (with unsaved changes it asks Save, Don't save or Cancel: Cancel, Esc or a click outside keep the editor and its text, and only Don't save discards the unsaved text); a file manager / task manager just closes.
- Terminate (terminals only) — hard-kill the shell process tree (asks to confirm).
- Delete note / Delete file (sticky notes and the text editor) — asks to confirm. On a sticky note it discards the note's text, which lives in this browser; on the text editor it closes the editor and discards unsaved text; the file on disk is not touched. The Scratchpad has no Delete item: its notes are stored on the broker, closing its window does not delete them, and closing a tab removes that tab from the notes (an earlier History revision can restore it). The last remaining tab cannot be closed, so to empty it clear its text.
In a popped-out terminal window (Open in new window) the title-bar menu is just Return to desktop and Terminate (with confirmation). See Window-Types.
Close, terminate, delete, and pinning are detailed on Floating-Window-Controls.
Color and rename aren't on this right-click menu. Recolor a terminal, sticky note or text editor from the color button in its title bar (palette, custom, and recents; hidden on screens 520 px wide or less), and double-click a sticky note's or text editor's title to rename it — both covered on Floating-Window-Controls.
When windows are stacked as tabs in one tile, the tile shows a tab strip. The strip's ⊟ button untabs it:
- On a top-level tabbed tile,
⊟does Split into rows (the same as the title-bar's Untab tile (split to rows)). - On a nested split group,
⊟does Drop tabs side by side (the same as Untab cell (side by side)).
Click any tab to switch to that window. Tabs and untabbing are explained on Arranging-Windows.
Each open window has a taskbar button. Left-click focuses and raises it (or restores it if minimized). Right-click for per-window actions:
- Focus — bring the window into view and raise it, restoring it if minimized: a tiled window takes you to its workspace, a floating one is brought to the workspace you are on (a closed window reopens on its own workspace). This works even for a closed or parked window (it reopens it).
- Restore / Minimize — bring a minimized window back, or hide it.
- Close — soft close, same as the title-bar menu.
- Terminate (terminals only) — hard-kill the shell, even on a parked session (asks to confirm).
To send a window to another workspace, use its title-bar menu (above). The taskbar is covered on Taskbar.
Right-click a workspace dot at the bottom of the taskbar. The menu opens with a greyed header naming the workspace (Workspace N, plus its name if it has one), then:
- Rename… — give the workspace a name.
- Remove workspace — delete it (disabled when only one workspace remains).
- Colour… — pick the workspace's colour from the palette, or None.
- Stack with… / Remove from stack — put the workspace in a stack with another pager entry, or take it out.
- Move left / Move right — move it one place along the pager (Move up / Move down inside a stack's list).
- Show names / Show numbers — choose whether the dots display workspace names or numbers.
- New workspace — append a fresh, empty workspace.
A stack's dot has its own menu, headed Stack N (plus its name, if it has one) and its member count: Rename stack…, Colour… and Move left / Move right for the whole stack. Right-click a row in a stack's list for that workspace's menu above.
Workspaces and the pager are covered on Workspaces. This whole menu comes from the Workspaces mod — with it disabled there are no pager dots to right-click. Hiding the pager (Control Panel → Windows → Workspaces) removes the dots too, but rename and remove are on the empty desktop / taskbar menu below as well, so they survive that. Disabling the mod takes both menus away together.
Right-click the desktop background (or an empty part of the taskbar). The menu depends on the window mode.
In floating mode — one-shot arrangements plus a size lock:
- Cascade
- Tile Horizontally
- Tile Vertically
- Tile H + V
- Lock Size / Unlock Size — snap every floating window to the default size and hide the resize handles, or restore free resizing.
- Minimize All Windows
Both modes then show the workspace block:
- A row per workspace, showing its name and a count of what it holds — columns in tiling mode, floating windows in floating mode (the
✓marks the active one); click to jump to it. - New workspace — append a fresh, empty workspace.
- Rename <workspace>… — rename the workspace you are on.
- Remove <workspace> — delete the workspace you are on (disabled when only one remains).
Both modes then offer Fit all to this screen, which does Fit to this screen for every terminal, and 🎛 Control panel — this menu does still use the emoji. Undo <action> comes after it, as the last item in the menu, appearing in floating mode once there is an arrange to reverse (single-level). The arrange and lock-size actions are covered on Floating-Window-Controls; the workspace block on Workspaces — it comes from the Workspaces mod, so with that disabled the tiling menu is just Fit all to this screen and 🎛 Control panel.
Because this menu also opens from an empty part of the taskbar, it is the one workspace surface that is always reachable — no window can cover it — which is what makes hiding the pager safe.
Left-click the + to launch the default host's default terminal — the local broker unless you've picked another default in Control Panel → Browser → Hosts (see Hosts-and-Multi-Browser). Right-click it for the full launch menu:
- Broker status rows — one per attached broker: a state dot and label doing what the taskbar chip does (log in, take over the lease, or hide/show that broker's windows — the hide toggle keeps the menu open). See Hosts-and-Multi-Browser.
-
Terminal profiles — each launchable profile for the host (the default is marked
(default)), listed under its broker's status row. - Open in folder… — a directory picker (per host) that starts the host's default profile rooted at the folder you choose.
- App windows — in registration order: Control panel, Help, Task manager, File manager, Text editor, Sticky note, Scratchpad, Session recorder. Each carries a small SVG icon, not an emoji. Mods that ship off by default add their own rows once enabled, Clipboard and AI status among them. See Window-Types.
- Closed notes — at the bottom, any non-empty sticky note you've closed; click one to reopen it.
The launch button and start-button label are covered on Taskbar.
Browserland — a web-based terminal desktop. This wiki is the end-user guide; for the wire protocol, auth model, and HTTP/MCP contract see Technical Reference. Released under the MIT License.
Start here
Building layouts
The desktop
Windows & content
Multi-host & AI
For developers