> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sesameterminal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Command palette

# Command palette

The fastest way to anything: markets, teams, tags, your positions and commands. Budget:
open any market with `Mod+K`, typing and `Enter`. Search must answer in under 300 ms
(Phase 1 exit gate).

## Content and ranking

* **Result kinds:** market or event, team (`@`), tag (`#`), your positions, commands
  (`>`).
* **Prefixes:** `@` restricts to teams and events, `#` to tags, `>` to commands. With no
  prefix, markets, teams, positions and commands are mixed.
* **Ranking**, applied within two text-match tiers:

  1. Strong match: every query word matches the start of a word in the title, team or
     alias (`lak cel` → Lakers v Celtics).
  2. Weak match: substring or typo-tolerant.

  Inside each tier: pinned, then held, then live, then volume (PLAN §4). A pinned weak
  match never beats an unpinned strong match. (Open question 12 in README.md: PLAN lists only
  the pinned/held/live/volume order.)
* **Empty query:** Recent (last 5 opened), then Pinned, then Held, then Live now. Five rows
  per group at most.
* Results update on every keystroke. The previous list stays until the new one arrives
  (no blank list, no skeleton). A `Searching…` hint shows in the footer if a query takes
  over 150 ms.

## Keys

| Key | Action |
| - | - |
| `Mod+K`, `/` | Open (from anywhere; `/` not while typing in an input) |
| typing | Filters |
| `↑` / `↓` | Move the selection (wraps) |
| `Enter` | Open: market → market view; team → its live or next game's market view; position → market view on that outcome; tag → becomes a filter chip in the input (`#NBA ×`) and the list narrows; command → run it |
| `Shift+Enter` | Pin or unpin the selected market. The palette stays open and the row's pin icon updates |
| `Alt+Enter` | Open in a new panel: dock the selected outcome's ladder. On Live and Watchlist it docks in place; on other routes it goes to Live and docks |
| `Tab` | Complete the selected team or tag into the input |
| `Backspace` on an empty input | Remove the last filter chip |
| `Esc` | Clear the query; if already empty, close |

## Commands (`>`)

| Command | Notes |
| - | - |
| `Cancel all orders` | Same as the top-bar Cancel all. Hint `Ctrl+Shift+X` |
| `Cancel orders in <market>` | Offered for the market of the focused ladder or selected row |
| `Exit <outcome>` | One per held outcome: the portfolio's Exit (sell the whole position at the walk price). Armed only; disabled row with reason otherwise |
| `Arm trading` / `Switch to Safe` | Deliberate (type + Enter), so allowed. Arming has no hotkey |
| `Go to Live / Watchlist / Portfolio / Orders / Alerts / Settings` | Hints show `g l`, `g w`, … |
| `Theme: dark / light / system` | Saves `theme_mode` |
| `Show hotkeys` | `?` |
| `Toggle bottom dock` | `` ` `` |
| `Log out` | |

## Desktop

```
                      ┌───────────────────────────────────────────────────────────────────┐ y 96
                      │ [search] lak cel|                                          Esc    │ 52 input
                      ├───────────────────────────────────────────────────────────────────┤
                      │ Held                                                              │ 24 group label
                      │ [trending-up] Lakers v Celtics        120 sh (dot) Q3 4:12  41/43¢│ 40 (selected: --accent)
                      │               NBA · Moneyline                                     │
                      │ Markets                                                           │
                      │ [trending-up] Lakers v Celtics – Spread −4.5 (dot) Q3 4:12  47/49¢│ 40
                      │ [trending-up] Lakers v Celtics – Total 221.5 (dot) Q3 4:12  52/54¢│ 40
                      │ Teams                                                             │
                      │ [users] Los Angeles Lakers                 NBA · next: live now   │ 40
                      │ [users] Boston Celtics                     NBA · next: live now   │ 40
                      ├───────────────────────────────────────────────────────────────────┤
                      │ ↵ open   ⇧↵ pin   ⌥↵ dock   @ teams   # tags   > commands         │ 32 footer
                      └───────────────────────────────────────────────────────────────────┘
                       640 wide, centred; max 8 result rows visible, then the list scrolls
```

* Panel: 640 px wide, top at 96 px, `--popover`, `--radius-lg`, `--shadow-lg`, over a
  backdrop of `--background` at 60% opacity.
* Input: 52 px, body text 16 px, no border, `--muted-foreground` placeholder
  `Search markets, teams, #tags, > commands`.
* Rows: command palette row component (components.md), 40 px. Right side shows the score
  or clock for games and `bid/ask` for markets (not clickable: the palette navigates, it
  does not trade).
* Mouse: hover selects, click opens, Shift+click pins.
* The palette is cmdk. Filtering is server-side (FTS5) for markets, teams and tags;
  commands and recent items filter locally.

## Mobile (Search tab)

```
 ┌──────────────────────────────────────┐
 │ app header                           │ 52 app header stays
 ├──────────────────────────────────────┤
 │ [search] lak cel|             Close  │ 52 input (16 px text)
 │ [@ Teams] [# Tags] [> Commands]      │ 44 prefix chips
 ├──────────────────────────────────────┤
 │ Held                                 │ 24
 │ Lakers v Celtics              [star] │ 52 row + 44×44 pin button
 │ NBA · Moneyline · 120 sh · Q3 4:12   │
 │ Markets                              │
 │ Lakers v Celtics – Spread…    [star] │ 52 (title truncates before the pin)
 │ …                                    │
 ├──────────────────────────────────────┤
 │ (keyboard)                           │
 └──────────────────────────────────────┘
```

* Opens with the input focused and the keyboard up. The app header stays, so Safe/Armed
  and Cancel all remain reachable.
* Prefix chips insert `@`, `#` or `>` (typing symbols is slow on phone keyboards).
* Tap a row: open. Tap the `[star]` pin button: pin or unpin. Long-press a row: action
  sheet with Open ladder, Pin, Set alert….
* `Close` clears and returns to the previous tab. (Cancel is reserved for orders.)
* Budget on mobile: tap Search, type, tap the result (2 taps + typing).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.