gloomberb 0.18.4 → 0.19.0

package/src/docs/snapshot.json

@@ -1,7 +1,7 @@
 {
  "format": 1,
  "site": "https://gloom.sh",
- "updatedAt": "2026-10-17",
+ "updatedAt": "2026-10-28",
  "categories": [
   {
    "id": "research",
@@ -37,16 +37,6 @@
   }
  ],
  "functions": [
-  {
-   "code": "ATTN",
-   "name": "Research attention",
-   "description": "What Gloom users are researching",
-   "detail": "Which tickers opted-in Gloom users are researching, by hour, day and week, with sector and country totals and abnormal attention. Delayed at least an hour. Pro shows the full board; Free shows three rows per section.",
-   "category": "research",
-   "arg": "NVDA",
-   "access": "pro",
-   "lesson": "/academy/compare-screen-follow-money/filings-and-attention/attention"
-  },
   {
    "code": "DES",
    "name": "Security overview",
@@ -295,9 +285,9 @@
   },
   {
    "code": "CSP",
-   "name": "Cash-secured put screen",
-   "description": "Put-selling yield across a list",
-   "detail": "For each ticker, the put nearest a delta (0.30) on the expiry about 30 days out, ranked by annualised yield on cash at the bid, with distance out of the money, delta, IV rank, the bid/ask spread (wide ones flagged, never dropped), and whether earnings fall before expiry. Enter opens the put in OSA.",
+   "name": "Options strategy screen",
+   "description": "Puts, covered calls, spreads, condors, straddles and calendars across a list",
+   "detail": "One tab per strategy: cash-secured put, covered call, vertical, iron condor, straddle, strangle and calendar. For each ticker it picks the legs by delta and expiry, then shows credit or debit, max gain and loss, break-evens, probability of profit, IV rank, wide spreads and earnings before expiry. Income trades rank by yearly return, debit trades by reward to risk.",
    "category": "research",
    "arg": "JPM, GS, KO"
   },
@@ -468,8 +458,7 @@
    "description": "Outstanding settlement fails",
    "detail": "The Short Interest pane on Fails to deliver: SEC outstanding fail shares by settlement date and CUSIP, with reported prices. Each date is a separate snapshot; never add fails across dates. Published twice monthly with a delay. Missing records do not establish zero fails.",
    "category": "research",
-   "arg": "AAPL",
-   "access": "cloud"
+   "arg": "AAPL"
   },
   {
    "code": "ATS",
@@ -477,8 +466,7 @@
    "description": "Weekly off-exchange shares and trades",
    "detail": "The Short Interest pane on Weekly ATS/OTC: FINRA ATS and non-ATS shares and trades, including dark-pool activity. ATS % divides ATS shares by published off-exchange shares, not total market volume or short volume. Missing categories stay blank. Published weekly with a two- or four-week delay depending on the security tier.",
    "category": "research",
-   "arg": "AAPL",
-   "access": "cloud"
+   "arg": "AAPL"
   },
   {
    "code": "DIAG",
@@ -1034,12 +1022,20 @@
    "category": "markets",
    "lesson": "/academy/macro-markets-and-news/markets/movers-highs-halts"
   },
+  {
+   "code": "SCAN",
+   "name": "Live scanner",
+   "description": "Your own intraday stock scan",
+   "detail": "Scan all US stocks, an index, a sector or a watchlist for your own conditions: a move over the last minutes, volume against its usual pace, a new session high or low, a VWAP cross or a gap, above price, market cap and volume floors. Matches refresh through the session and new ones can alert. Real-time on Pro, 15-minute delayed on Free.",
+   "category": "markets"
+  },
   {
    "code": "FLOW",
    "name": "Options flow",
    "description": "Unusual options activity",
-   "detail": "Sweeps, blocks, and large premium prints as they hit the tape, with ticker, strike, expiry, and premium.",
+   "detail": "Sweeps, blocks, and large premium prints, plus the session's net premium tide.",
    "category": "markets",
+   "arg": "NVDA",
    "access": "pro",
    "lesson": "/academy/options-and-volatility/positioning-and-flow/options-flow"
   },
@@ -1725,7 +1721,7 @@
     "desktop",
     "tui"
    ],
-   "updatedAt": "2026-10-15",
+   "updatedAt": "2026-10-25",
    "blocks": [
     {
      "type": "heading",
@@ -1734,7 +1730,7 @@
     },
     {
      "type": "paragraph",
-     "text": "Either command installs the desktop app and the `gloomberb` terminal command."
+     "text": "Either command installs the desktop app and the `gloom` terminal command."
     },
     {
      "type": "code",
@@ -1759,7 +1755,7 @@
     },
     {
      "type": "paragraph",
-     "text": "Terminal UI only; Ghostty, Kitty, or WezTerm render charts best. Installs `gloomberb` into `~/.local/bin`."
+     "text": "Terminal UI only; Ghostty, Kitty, or WezTerm render charts best. Installs `gloom` into `~/.local/bin`."
     },
     {
      "type": "code",
@@ -1772,7 +1768,7 @@
     },
     {
      "type": "paragraph",
-     "text": "The [desktop installer](/download/desktop), about 280 MB, installs the app and the `gloomberb` command for your user, with no admin rights. It is not code-signed yet, so SmartScreen may stop it:"
+     "text": "The [desktop installer](/download/desktop), about 280 MB, installs the app and the `gloom` command for your user, with no admin rights. It is not code-signed yet, so SmartScreen may stop it:"
     },
     {
      "type": "list",
@@ -1790,10 +1786,10 @@
     {
      "type": "list",
      "items": [
-      "**Terminal:** the installer adds `gloomberb` to your PATH, so open a new terminal window. PowerShell works.",
+      "**Terminal:** the installer adds `gloom` to your PATH, so open a new terminal window. PowerShell works.",
       "**Charts:** Windows Terminal has no Kitty graphics, so terminal charts draw as text. The desktop app draws them in full.",
-      "**Data:** `%USERPROFILE%\\.gloomberb`, printed by `gloomberb version`. `GLOOMBERB_HOME` moves it.",
-      "**Git and Bun:** Bun ships with the app. Git is needed only to install plugins.",
+      "**Data:** `%USERPROFILE%\\.gloomberb`, printed by `gloom version`. `GLOOMBERB_HOME` moves it.",
+      "**Git and Bun:** Bun ships with the app; Git does not. Some official plugins (TV, Substack, Interactive Brokers, IBKR Gateway, Public, Robinhood, SimpleFIN, Polls, Prediction Markets, BYOK AI) install from GitHub and need [Git for Windows](https://git-scm.com/download/win). Without it Gloom starts without them, says so, and `gloom doctor` names them.",
       "**Versions:** Windows 11 x64. Windows 10 and ARM PCs (x64 emulation) are untested."
      ]
     },
@@ -1825,11 +1821,11 @@
     },
     {
      "type": "code",
-     "code": "gloomberb\ngloomberb version\ngloomberb doctor"
+     "code": "gloom\ngloom version\ngloom doctor"
     },
     {
      "type": "paragraph",
-     "text": "`gloomberb` opens the terminal UI. `version` prints the data folder, and `doctor` checks that config, the cache database, plugins, and capabilities load."
+     "text": "`gloom` opens the terminal UI. `version` prints the data folder, and `doctor` checks that config, the cache database, plugins, and capabilities load."
     },
     {
      "type": "heading",
@@ -1861,6 +1857,14 @@
       ]
      ]
     },
+    {
+     "type": "paragraph",
+     "text": "Installed before 0.18.4, when the command was `gloomberb`? Updating adds `gloom` beside it and `gloomberb` keeps working, with nothing to reinstall."
+    },
+    {
+     "type": "paragraph",
+     "text": "Had `Gloomberb.app`? Its next update renames it to `Gloom.app`; settings and data stay."
+    },
     {
      "type": "heading",
      "level": 3,
@@ -1868,11 +1872,11 @@
     },
     {
      "type": "paragraph",
-     "text": "The app updates from **stable** releases, the ones on the [changelog](/changelog). **Nightly** is a daily build of main that gets fixes first and can break. To switch, run **Release Channel** from the command bar (on the Mac, also **Gloomberb > Release Channel...**), or in a terminal:"
+     "text": "The app updates from **stable** releases, the ones on the [changelog](/changelog). **Nightly** is a daily build of main that gets fixes first and can break. To switch, run **Release Channel** from the command bar (on the Mac, also **Release Channel...** in the app menu), or in a terminal:"
     },
     {
      "type": "code",
-     "code": "gloomberb config set updates.channel nightly"
+     "code": "gloom config set updates.channel nightly"
     },
     {
      "type": "paragraph",
@@ -1993,7 +1997,7 @@
     },
     {
      "type": "paragraph",
-     "text": "Run `gloomberb` and follow the same five steps. Commands open with `Ctrl+K` or `Ctrl+P`; `GL` arranges the panes. Chart not rendering? See [troubleshooting](/docs/troubleshooting#chart-or-terminal-graphics)."
+     "text": "Run `gloom` and follow the same five steps. Commands open with `Ctrl+K` or `Ctrl+P`; `GL` arranges the panes. Chart not rendering? See [troubleshooting](/docs/troubleshooting#chart-or-terminal-graphics)."
     },
     {
      "type": "heading",
@@ -2447,7 +2451,7 @@
     "reinvest",
     "DVD"
    ],
-   "updatedAt": "2026-10-17",
+   "updatedAt": "2026-10-25",
    "blocks": [
     {
      "type": "heading",
@@ -2460,7 +2464,7 @@
     },
     {
      "type": "code",
-     "code": "gloomberb portfolio create Core\ngloomberb portfolio position set Core VTI 40 280\ngloomberb portfolio position set Core BND 60 72\ngloomberb portfolio cash set Core 2000 USD"
+     "code": "gloom portfolio create Core\ngloom portfolio position set Core VTI 40 280\ngloom portfolio position set Core BND 60 72\ngloom portfolio cash set Core 2000 USD"
     },
     {
      "type": "heading",
@@ -2473,7 +2477,7 @@
     },
     {
      "type": "code",
-     "code": "gloomberb portfolio target set Core VTI 60\ngloomberb portfolio target set Core BND 35\ngloomberb portfolio target set Core CASH 5"
+     "code": "gloom portfolio target set Core VTI 60\ngloom portfolio target set Core BND 35\ngloom portfolio target set Core CASH 5"
     },
     {
      "type": "heading",
@@ -2482,7 +2486,7 @@
     },
     {
      "type": "paragraph",
-     "text": "`PF` and `gloomberb portfolio show Core` add four columns once targets are set:"
+     "text": "`PF` and `gloom portfolio show Core` add four columns once targets are set:"
     },
     {
      "type": "code",
@@ -2522,12 +2526,16 @@
      "type": "paragraph",
      "text": "VTI is 11.1pp over its target, so the table says sell 6 shares. BND is 15.4pp under, so buy 47. Make both trades and every drift lands near 0pp."
     },
+    {
+     "type": "paragraph",
+     "text": "To place them from Gloom, see [Trading](/docs/trading)."
+    },
     {
      "type": "callout",
      "blocks": [
       {
        "type": "paragraph",
-       "text": "`gloomberb portfolio show Core --explain` prints these terms under the table. `gloomberb catalog glossary` lists every term the terminal uses."
+       "text": "`gloom portfolio show Core --explain` prints these terms under the table. `gloom catalog glossary` lists every term the terminal uses."
       }
      ]
     },
@@ -2538,7 +2546,7 @@
     },
     {
      "type": "paragraph",
-     "text": "`gloomberb portfolio show Core` also lists what each share or fund pays a year: its trailing twelve months of dividends per share times the shares you hold, in the portfolio's currency, and that as a yield on the holding's value. The TOTAL row gives the portfolio's income and its yield on the whole portfolio, cash included. A holding whose dividends could not be read shows `—`, and so does the total, never $0."
+     "text": "`gloom portfolio show Core` also lists what each share or fund pays a year: its trailing twelve months of dividends per share times the shares you hold, in the portfolio's currency, and that as a yield on the holding's value. The TOTAL row gives the portfolio's income and its yield on the whole portfolio, cash included. A holding whose dividends could not be read shows `—`, and so does the total, never $0."
     },
     {
      "type": "paragraph",
@@ -2546,7 +2554,7 @@
     },
     {
      "type": "code",
-     "code": "gloomberb portfolio show Core --drip --years 3 --withholding 15"
+     "code": "gloom portfolio show Core --drip --years 3 --withholding 15"
     },
     {
      "type": "paragraph",
@@ -2554,7 +2562,7 @@
     },
     {
      "type": "paragraph",
-     "text": "To compare payers before you buy, rank them by yield with payout and growth: `gloomberb fn DVD KO PEP JNJ`."
+     "text": "To compare payers before you buy, rank them by yield with payout and growth: `gloom fn DVD KO PEP JNJ`."
     },
     {
      "type": "details",
@@ -2578,6 +2586,226 @@
     }
    ]
   },
+  {
+   "slug": "trading",
+   "title": "Trading",
+   "lead": "Place, change and cancel orders at your broker from one ticket beside the chart.",
+   "category": "Start here",
+   "tags": [
+    "trading",
+    "order ticket",
+    "broker",
+    "orders",
+    "ORD",
+    "BUY",
+    "SELL",
+    "Aries",
+    "Interactive Brokers",
+    "simulation",
+    "spreads",
+    "OSA",
+    "bracket",
+    "OCO",
+    "trailing stop"
+   ],
+   "updatedAt": "2026-10-25",
+   "blocks": [
+    {
+     "type": "image",
+     "src": "https://gloom.sh/screenshots/trading-ticket.png",
+     "alt": "Gloom's order ticket beside an AAPL chart, on a simulation account",
+     "caption": "A simulation account: draft limit, working stop and average cost on the chart."
+    },
+    {
+     "type": "heading",
+     "level": 2,
+     "text": "Brokers that trade"
+    },
+    {
+     "type": "table",
+     "headers": [
+      "Broker",
+      "Trades through"
+     ],
+     "rows": [
+      [
+       "[Aries](/plugins/aries)",
+       "This ticket, for stocks, ETFs, options and spreads"
+      ],
+      [
+       "[Interactive Brokers](/plugins/ibkr-gateway)",
+       "The IBKR Gateway plugin's own Trade tab, with Gateway or TWS running"
+      ]
+     ]
+    },
+    {
+     "type": "paragraph",
+     "text": "Both need the desktop app or the terminal. To connect Aries:"
+    },
+    {
+     "type": "list",
+     "items": [
+      "Install **Aries** from Plugins (`PL`).",
+      "Open Brokers (`BR`), add **Aries**, press **Connect** and sign in to Aries in the browser.",
+      "Leave **Include accounts** on **Simulation only** for your first orders."
+     ],
+     "ordered": true
+    },
+    {
+     "type": "heading",
+     "level": 2,
+     "text": "Open the ticket"
+    },
+    {
+     "type": "list",
+     "items": [
+      "**Chart:** in a ticker's research pane, press `t` on the Chart tab, or open the Trade tab.",
+      "**Command bar:** `BUY AAPL 10`, or `SELL AAPL 10 350` with a limit price.",
+      "**Options:** `t` on a contract in `OMON`, or on a spread in `OSA` to trade it as one order."
+     ]
+    },
+    {
+     "type": "heading",
+     "level": 2,
+     "text": "Order types"
+    },
+    {
+     "type": "paragraph",
+     "text": "Aries takes market, limit, stop and stop limit (`1` to `4`), and spreads at a net debit or credit."
+    },
+    {
+     "type": "paragraph",
+     "text": "Take profit / stop loss, OCO pairs and trailing stops show only for a broker that runs them, which Aries does not."
+    },
+    {
+     "type": "heading",
+     "level": 2,
+     "text": "Trade from the chart"
+    },
+    {
+     "type": "list",
+     "items": [
+      "Press **Chart** beside a price (`c`), then click the chart to set it.",
+      "Drag a dashed draft line to move that price.",
+      "Drag a working order's line to load the change into the ticket."
+     ]
+    },
+    {
+     "type": "paragraph",
+     "text": "Nothing reaches the broker from the chart: every change goes through review."
+    },
+    {
+     "type": "heading",
+     "level": 2,
+     "text": "Safety"
+    },
+    {
+     "type": "list",
+     "items": [
+      "A profile trades only with **Enable trading** on, which asks first.",
+      "Every order gets a preview of its cost and fees from the broker first.",
+      "Accounts are marked **SIM** or **LIVE**. A live order waits until you type its symbol.",
+      "Simulation accounts can skip the review: untick **Confirm orders**."
+     ]
+    },
+    {
+     "type": "heading",
+     "level": 2,
+     "text": "Orders and fills"
+    },
+    {
+     "type": "list",
+     "items": [
+      "**Under the ticket:** open orders, updated live, with edit and cancel.",
+      "**On the chart:** working orders and your average cost.",
+      "**`ORD`:** orders and fills for any trading account.",
+      "**Fills:** a notification, even with no ticket open, and positions sync to the portfolio."
+     ]
+    },
+    {
+     "type": "details",
+     "summary": "Keys in the ticket",
+     "blocks": [
+      {
+       "type": "table",
+       "headers": [
+        "Key",
+        "Does"
+       ],
+       "rows": [
+        [
+         "`b` / `s`",
+         "Buy or sell"
+        ],
+        [
+         "`1` to `4`",
+         "Market, limit, stop, stop limit"
+        ],
+        [
+         "`5` `6` `7`",
+         "25%, 50% or the most you can trade"
+        ],
+        [
+         "`8` `9` `0`",
+         "Bid, mid or ask as the price"
+        ],
+        [
+         "`p`",
+         "Last as the price"
+        ],
+        [
+         "`c`",
+         "Pick the price on the chart (`Esc` keeps the old one)"
+        ],
+        [
+         "`t` / `a`",
+         "Time in force, account"
+        ],
+        [
+         "`r` / `o`",
+         "Review, open orders"
+        ],
+        [
+         "`F6`",
+         "Move between chart and ticket"
+        ],
+        [
+         "`<` / `>`",
+         "Widen or narrow the ticket"
+        ],
+        [
+         "`Esc`",
+         "Close the ticket"
+        ]
+       ]
+      },
+      {
+       "type": "paragraph",
+       "text": "In `ORD`, `m` changes the selected order and `c` cancels it."
+      }
+     ]
+    },
+    {
+     "type": "details",
+     "summary": "Fine print",
+     "blocks": [
+      {
+       "type": "list",
+       "items": [
+        "Aries takes Day, Good til cancelled, Immediate or cancel, Fill or kill, At the opening and At the close for stocks, plus extended hours on live accounts. Options and spreads take Day or Good til cancelled.",
+        "Selling more than you hold is refused: Aries takes no short sales.",
+        "One-click simulation orders still get a preview, and a warning brings the review back.",
+        "Cancelling asks first, and the order can still fill before the broker confirms.",
+        "While the broker's stream is down, Gloom polls for quotes and orders instead.",
+        "Spreads take 2 to 4 legs and have no line to drag. A change keeps the legs: quantity or net price only.",
+        "In a pane under about 900 px wide (100 columns in the terminal), the ticket takes the whole pane.",
+        "Brokers turns trading off for a profile at any time."
+       ]
+      }
+     ]
+    }
+   ]
+  },
   {
    "slug": "ai-workflows",
    "title": "AI workflows",
@@ -2631,14 +2859,14 @@
       ],
       [
        "Headless",
-       "`gloomberb ai providers`, `gloomberb ai ask`",
+       "`gloom ai providers`, `gloom ai ask`",
        "Provider checks and one-off prompts. See [CLI](/docs/cli-functions)."
       ]
      ]
     },
     {
      "type": "paragraph",
-     "text": "The AI screener, Ask AI tab, `AGENT` and `gloomberb ai` need the [BYOK AI plugin](/plugins/byok-ai) (`gloomberb install gloom-sh/gloom-byok-ai`), terminal and desktop only."
+     "text": "The AI screener, Ask AI tab, `AGENT` and `gloom ai` need the [BYOK AI plugin](/plugins/byok-ai) (`gloom install gloom-sh/gloom-byok-ai`), terminal and desktop only."
     },
     {
      "type": "paragraph",
@@ -2697,7 +2925,7 @@
     "troubleshooting",
     "diagnostics"
    ],
-   "updatedAt": "2026-10-07",
+   "updatedAt": "2026-10-25",
    "blocks": [
     {
      "type": "heading",
@@ -2713,11 +2941,11 @@
      "rows": [
       [
        "Will not launch",
-       "`gloomberb version`, then `gloomberb doctor`."
+       "`gloom version`, then `gloom doctor`."
       ],
       [
        "Command missing",
-       "`HELP`, then `gloomberb plugin list`."
+       "`HELP`, then `gloom plugin list`."
       ],
       [
        "Pane blank",
@@ -2747,8 +2975,8 @@
     {
      "type": "list",
      "items": [
-      "`Bad CPU type in executable` on macOS: an Intel Mac running the Apple Silicon app. Delete `/Applications/Gloomberb.app` and rerun `curl -fsSL gloom.sh/install | bash` for the Intel terminal build.",
-      "`gloomberb doctor` shows runtime errors.",
+      "`Bad CPU type in executable` on macOS: an Intel Mac running the Apple Silicon app. Delete `/Applications/Gloom.app` (`Gloomberb.app` before the app was renamed) and rerun `curl -fsSL gloom.sh/install | bash` for the Intel terminal build.",
+      "`gloom doctor` shows runtime errors.",
       "Update with the same method you installed with. See [Install and update](/docs/getting-started)."
      ]
     },
@@ -2761,8 +2989,8 @@
      "type": "list",
      "items": [
       "Commands: `Cmd/Ctrl+K` or `Ctrl+P`. Backtick is tickers only.",
-      "Search the command name if you forgot the prefix, or `HELP` in the app and `gloomberb help` in a shell.",
-      "Plugin command: `gloomberb plugin list`. Plugin missing: `gloomberb plugin doctor <name-or-path>`, see [Plugins](/docs/plugins).",
+      "Search the command name if you forgot the prefix, or `HELP` in the app and `gloom help` in a shell.",
+      "Plugin command: `gloom plugin list`. Plugin missing: `gloom plugin doctor <name-or-path>`, see [Plugins](/docs/plugins).",
       "Some commands need a ticker: `GP AAPL`, not `GP`.",
       "Not sure what a pane shows? `F1` opens its help card."
      ]
@@ -2786,7 +3014,7 @@
      "items": [
       "Wait for loading to finish, then `r`.",
       "Read the status: delayed, stale, error, or auth.",
-      "`gloomberb provider status` lists enabled providers.",
+      "`gloom provider status` lists enabled providers.",
       "Check the pane supports the instrument. SEC filings cover supported US securities only.",
       "Hosted panes may need login, verification, or an entitlement."
      ]
@@ -3073,11 +3301,11 @@
     },
     {
      "type": "paragraph",
-     "text": "When signed in, searches you finish in the command bar are saved to improve search, shown to no one, and deleted with your account. [Research attention](/docs/attention) is a separate opt-in, off by default."
+     "text": "When signed in, searches you finish in the command bar are saved to improve search, shown to no one, and deleted with your account. Attention Counts, the research attention contribution, is a separate opt-in, off by default."
     },
     {
      "type": "paragraph",
-     "text": "Turn reports off with `Crash Reports` or `Usage Counts` in the command bar, or `gloomberb config set telemetry.crashReports false` and `telemetry.usage false`. `DO_NOT_TRACK=1` turns both off."
+     "text": "Turn reports off with `Crash Reports` or `Usage Counts` in the command bar, or `gloom config set telemetry.crashReports false` and `telemetry.usage false`. `DO_NOT_TRACK=1` turns both off."
     }
    ]
   },
@@ -3289,7 +3517,7 @@
     },
     {
      "type": "paragraph",
-     "text": "CLI `gloomberb fn KPIS NVDA`. MCP `company.kpis`, `company.guidance`. A paid API serves both in [Gloom Datasets](/docs/datasets). Related: [`GUID`](/docs/functions#guid), [`EM`](/docs/functions#em)."
+     "text": "CLI `gloom fn KPIS NVDA`. MCP `company.kpis`, `company.guidance`. A paid API serves both in [Gloom Datasets](/docs/datasets). Related: [`GUID`](/docs/functions#guid), [`EM`](/docs/functions#em)."
     }
    ]
   },
@@ -3387,7 +3615,7 @@
     },
     {
      "type": "paragraph",
-     "text": "CLI `gloomberb fn CRDOC FICO`. MCP `credit.documents`, `credit.instrument`, `credit.screen`. Related: [`DDIS`](/docs/functions#ddis), [Catalysts](/docs/catalysts)."
+     "text": "CLI `gloom fn CRDOC FICO`. MCP `credit.documents`, `credit.instrument`, `credit.screen`. Related: [`DDIS`](/docs/functions#ddis), [Catalysts](/docs/catalysts)."
     }
    ]
   },
@@ -3482,7 +3710,7 @@
     },
     {
      "type": "paragraph",
-     "text": "CLI `gloomberb fn CATL PFE`. MCP `market.catalysts`, `company.litigation`, `catalysts.event`, `catalysts.changes`. Related: [Company KPIs](/docs/company-kpis)."
+     "text": "CLI `gloom fn CATL PFE`. MCP `market.catalysts`, `company.litigation`, `catalysts.event`, `catalysts.changes`. Related: [Company KPIs](/docs/company-kpis)."
     }
    ]
   },
@@ -3603,7 +3831,7 @@
     },
     {
      "type": "paragraph",
-     "text": "CLI `gloomberb fn AWARDS LMT`. MCP `company.awards`, `company.award_evidence`. Related: [Supply chain and exposure](/docs/exposure), [`SEG`](/docs/functions#seg)."
+     "text": "CLI `gloom fn AWARDS LMT`. MCP `company.awards`, `company.award_evidence`. Related: [Supply chain and exposure](/docs/exposure), [`SEG`](/docs/functions#seg)."
     }
    ]
   },
@@ -3710,7 +3938,7 @@
     },
     {
      "type": "paragraph",
-     "text": "CLI `gloomberb catalog EXPO` lists the options. MCP `portfolio.exposure` (`holdings`, `depth`, `cashWeight`, `scenario`) and `company.supply_chain_graph`, `company.supply_chain_paths`, `company.supply_chain_evidence`. Related: [Government awards](/docs/government-awards)."
+     "text": "CLI `gloom catalog EXPO` lists the options. MCP `portfolio.exposure` (`holdings`, `depth`, `cashWeight`, `scenario`) and `company.supply_chain_graph`, `company.supply_chain_paths`, `company.supply_chain_evidence`. Related: [Government awards](/docs/government-awards)."
     }
    ]
   },
@@ -3815,115 +4043,7 @@
     },
     {
      "type": "paragraph",
-     "text": "CLI `gloomberb fn JOBS NVDA`. MCP `company.hiring`, `market.hiring_movers`, `hiring.momentum`, `apps.attention`, `apps.rank_history`. Related: [Research attention](/docs/attention)."
-    }
-   ]
-  },
-  {
-   "slug": "attention",
-   "title": "Research attention",
-   "lead": "ATTN shows which tickers other Gloom users are researching, and which are getting unusual attention",
-   "category": "Understand the data",
-   "tags": [
-    "ATTN",
-    "attention",
-    "research",
-    "privacy"
-   ],
-   "updatedAt": "2026-10-07",
-   "blocks": [
-    {
-     "type": "heading",
-     "level": 2,
-     "text": "Open it"
-    },
-    {
-     "type": "table",
-     "headers": [
-      "Command",
-      "Opens"
-     ],
-     "rows": [
-      [
-       "`ATTN`",
-       "The board"
-      ],
-      [
-       "`ATTN NVDA`",
-       "One ticker"
-      ],
-      [
-       "`ATTN 6758:JPX`",
-       "An international listing"
-      ]
-     ]
-    },
-    {
-     "type": "heading",
-     "level": 2,
-     "text": "What you see"
-    },
-    {
-     "type": "table",
-     "headers": [
-      "Tab",
-      "Shows"
-     ],
-     "rows": [
-      [
-       "Ranking",
-       "Tickers by research hours, with share, price move and relative volume"
-      ],
-      [
-       "Abnormal",
-       "Tickers well above their own usual level"
-      ],
-      [
-       "Sectors, Countries",
-       "Totals by sector and country"
-      ],
-      [
-       "History",
-       "Hourly research hours for one ticker"
-      ],
-      [
-       "Evidence",
-       "The window and rules behind each figure"
-      ]
-     ]
-    },
-    {
-     "type": "paragraph",
-     "text": "Switch the window between Now, Today and Week. Enter opens a ticker, `e` shows evidence."
-    },
-    {
-     "type": "heading",
-     "level": 2,
-     "text": "Free and Pro"
-    },
-    {
-     "type": "paragraph",
-     "text": "Pro shows the full board and 29 days of hourly history. Free shows three rows per section and the latest point. Data lags by at least an hour."
-    },
-    {
-     "type": "heading",
-     "level": 2,
-     "text": "Keep in mind"
-    },
-    {
-     "type": "list",
-     "items": [
-      "Counts come only from users who opted in, so they are a sample, not the market. A ticker appears only when enough people looked at it, and hidden hours are unavailable, not zero."
-     ]
-    },
-    {
-     "type": "heading",
-     "level": 2,
-     "text": "Your choice"
-    },
-    {
-     "type": "paragraph",
-     "text": "Contributing is a separate opt-in setting, off by default. Toggle **Attention Counts** in Settings or with `gloomberb config set telemetry.attention true`. See the [Privacy Policy](/privacy). MCP `market.attention`."
+     "text": "CLI `gloom fn JOBS NVDA`. MCP `company.hiring`, `market.hiring_movers`, `hiring.momentum`, `apps.attention`, `apps.rank_history`."
     }
    ]
   },
@@ -4027,7 +4147,7 @@
     },
     {
      "type": "paragraph",
-     "text": "Source: U.S. Bureau of Labor Statistics. CLI `gloomberb fn CPI shelter`. Related: [Oil and gas inventories](/docs/energy-inventories), [`ECST`](/docs/functions#ecst)."
+     "text": "Source: U.S. Bureau of Labor Statistics. CLI `gloom fn CPI shelter`. Related: [Oil and gas inventories](/docs/energy-inventories), [`ECST`](/docs/functions#ecst)."
     }
    ]
   },
@@ -4046,7 +4166,7 @@
     "storage",
     "commodities"
    ],
-   "updatedAt": "2026-10-07",
+   "updatedAt": "2026-10-23",
    "blocks": [
     {
      "type": "heading",
@@ -4096,7 +4216,7 @@
       ],
       [
        "Vs 1Y",
-       "Change on the same week a year ago"
+       "Change against a year ago"
       ],
       [
        "Vs 5Y",
@@ -4119,7 +4239,7 @@
     },
     {
      "type": "paragraph",
-     "text": "Free on every plan, signed in or not. Petroleum updates Wednesdays and gas Thursdays at 10:30 a.m. Eastern, and the new week shows within minutes."
+     "text": "Free on every plan, signed in or not. Petroleum updates Wednesdays and gas Thursdays at 10:30 a.m. Eastern, and the new week shows within minutes. Before a gas release, the Gas Storage tab's header gives the economic calendar's consensus and the prior week's change."
     },
     {
      "type": "heading",
@@ -4129,12 +4249,14 @@
     {
      "type": "list",
      "items": [
-      "The five-year range uses the five years before the current one, read on the same calendar day. A series with less history says so."
+      "Gas storage's Vs 1Y and Vs 5Y are the figures the EIA prints in its weekly storage report: its year-ago level and its five-year average (2021-25 in 2026). They match the report to the tenth, and the footer says so. Until the EIA's figures for a new week are in, they are read from the weekly history instead.",
+      "Petroleum's year ago is the published week nearest the same date, and its five-year average uses the five years before the current one, read on the same calendar day.",
+      "The five-year range (low, high and where the level sits) is always read from the weekly history. A series with less history says so."
      ]
     },
     {
      "type": "paragraph",
-     "text": "Source: U.S. Energy Information Administration. CLI `gloomberb fn DOE --tab gas`. Related: [Consumer prices](/docs/consumer-prices), [`CTM`](/docs/functions#ctm)."
+     "text": "Source: U.S. Energy Information Administration. CLI `gloom fn DOE --tab gas`. Related: [Consumer prices](/docs/consumer-prices), [`CTM`](/docs/functions#ctm)."
     }
    ]
   },
@@ -4150,7 +4272,7 @@
     "perpetuals",
     "history"
    ],
-   "updatedAt": "2026-10-09",
+   "updatedAt": "2026-10-26",
    "blocks": [
     {
      "type": "heading",
@@ -4190,6 +4312,18 @@
       "Shows"
      ],
      "rows": [
+      [
+       "Compare",
+       "One asset's contracts across the venues: mark, funding, premium and when each was observed"
+      ],
+      [
+       "Liquidations",
+       "One asset's liquidated longs and shorts across the venues: 24-hour and 7-day totals, the hourly series and the largest prints"
+      ],
+      [
+       "Depth",
+       "One asset's resting bids and asks within 0.5%, 1% and 2% of mid on each venue, from each venue's order book every hour"
+      ],
       [
        "History",
        "Funding, open interest and mark premium, with price candles and settled funding where available"
@@ -4213,6 +4347,37 @@
      "type": "paragraph",
      "text": "Pro shows the stored history. Free shows a limited preview of the latest values. History starts when Gloom first collected a market."
     },
+    {
+     "type": "heading",
+     "level": 2,
+     "text": "Liquidations"
+    },
+    {
+     "type": "paragraph",
+     "text": "Each venue's public liquidation stream, kept event by event with the time it arrived. A long liquidated is a forced sell, a short a forced buy, valued at the price the venue reports: the average fill on Binance and Hyperliquid, the bankruptcy price on Bybit and OKX. What the streams leave out:"
+    },
+    {
+     "type": "list",
+     "items": [
+      "Binance and OKX send at most one liquidation per contract each second, so a burst on one contract is undercounted.",
+      "Bybit sends every liquidation.",
+      "Hyperliquid publishes only the positions its liquidity vault takes over (backstop liquidations). Liquidations closed on the order book are not published venue-wide and are missing.",
+      "Venues publish no liquidation history, so time the collector was not connected is missing, not zero, and history starts at first collection."
+     ]
+    },
+    {
+     "type": "paragraph",
+     "text": "Free shows each contract's 24-hour and 7-day totals and the three largest prints; Pro adds the hourly series and the twenty largest prints."
+    },
+    {
+     "type": "heading",
+     "level": 2,
+     "text": "Order book depth"
+    },
+    {
+     "type": "paragraph",
+     "text": "The quote notional resting within 0.5%, 1% and 2% of mid, read once an hour from each venue's public order book for its 50 largest markets by open interest. Binance and Bybit return the nearest 1,000 price levels a side and OKX 5,000; on the deepest markets the book ends inside a band, which then shows at least (≥) what it holds. Hyperliquid returns 20 levels a side, so wider bands are read from its grouped book and a band's edge falls within one price group. A book not read for 2.5 hours (it left its venue's 50 largest, or the venue is failing) is marked stale and left out of the band totals; after a week it is no longer listed. Free shows the latest reading; Pro the hourly history."
+    },
     {
      "type": "heading",
      "level": 2,
@@ -4230,14 +4395,14 @@
     {
      "type": "list",
      "items": [
-      "Stored readings cover Hyperliquid, Binance, Bybit and OKX.",
+      "Stored readings cover Hyperliquid, Binance, Bybit and OKX. Compare shows each venue's leading contract free; Pro lists every contract.",
       "Positive funding means longs pay shorts. Open interest in contracts and in USD differ, because a price rise adds USD open interest without new contracts.",
       "A stock perpetual's premium is blank while the stock market is closed. The live board and trading are in the Hyperliquid plugin."
      ]
     },
     {
      "type": "paragraph",
-     "text": "CLI `gloomberb fn PERP BTC`. MCP `perps.board`, `perps.history`, `perps.rankings`, `perps.compare`. Related: [`FUT`](/docs/functions#fut), [`CRYP`](/docs/functions#cryp)."
+     "text": "CLI `gloom fn PERP BTC`. MCP `perps.board`, `perps.history`, `perps.rankings`, `perps.compare`. Related: [`FUT`](/docs/functions#fut), [`CRYP`](/docs/functions#cryp)."
     }
    ]
   },
@@ -4374,7 +4539,7 @@
     },
     {
      "type": "paragraph",
-     "text": "CLI `gloomberb fn GPU H100`. MCP `gpu.board`, `gpu.history`, `gpu.changes`. Related: [Power and grid](/docs/power)."
+     "text": "CLI `gloom fn GPU H100`. MCP `gpu.board`, `gpu.history`, `gpu.changes`. Related: [Power and grid](/docs/power)."
     }
    ]
   },
@@ -4501,7 +4666,7 @@
     "call wall",
     "put wall"
    ],
-   "updatedAt": "2026-10-16",
+   "updatedAt": "2026-10-28",
    "blocks": [
     {
      "type": "heading",
@@ -4526,12 +4691,16 @@
       [
        "`OPX SPX`",
        "The S&P 500 index with its SPX and SPXW options"
+      ],
+      [
+       "`OPX BTC-USD`",
+       "Deribit's BTC options (`ETH-USD` for ETH)"
       ]
      ]
     },
     {
      "type": "paragraph",
-     "text": "NDX and RUT options are not covered; QQQ and IWM follow the same indexes."
+     "text": "NDX and RUT options are not covered; QQQ and IWM follow the same indexes. Among coins only BTC and ETH have listed options; bitcoin-linked US funds such as IBIT list their own."
     },
     {
      "type": "heading",
@@ -4616,7 +4785,7 @@
       {
        "type": "list",
        "items": [
-        "Gamma per contract is Black-Scholes gamma with the forward at spot, times the 100-share multiplier. Time runs to 16:00 New York on the expiry date, at least one hour.",
+        "Gamma per contract is Black-Scholes gamma with the forward at spot, times the 100-share multiplier. Time runs to 16:00 New York on the expiry date, at least one hour, from now, or outside the session from the spot's time: before the open, a same-day expiry has the hours from the pre-market print to the close, with the volatility the last session's quotes imply. A cash index (SPX, XSP) outside its session is spot at that session's close.",
         "Each strike's volatility comes from its expiry's out-of-the-money quotes, linear between quoted strikes and flat beyond. An expiry without usable quotes is left out and named.",
         "GEX at a strike is gamma × 100 × spot × 1% of spot × open interest.",
         "The flip reprices net GEX from 15% below to 15% above spot in 0.25% steps, each strike keeping its volatility, and takes the sign change nearest spot.",
@@ -4639,6 +4808,44 @@
       }
      ]
     },
+    {
+     "type": "heading",
+     "level": 2,
+     "text": "BTC and ETH options"
+    },
+    {
+     "type": "paragraph",
+     "text": "`OPX BTC-USD`, `GEX ETH-USD` and `OVDV BTC-USD` read Deribit's options. In the command bar and in panes, a bare `BTC` or `ETH` is the US fund with that ticker, as everywhere else, so type `BTC-USD OPX` for the coin. Only the CLI's `gloomberb fn` and `gloomberb shot` read a bare `BTC` or `ETH` as the coin for OPX, GEX and OVDV, with a note; add `--exchange ARCA` for the fund."
+    },
+    {
+     "type": "table",
+     "headers": [
+      "Figure",
+      "On Deribit"
+     ],
+     "rows": [
+      [
+       "Open interest",
+       "Live, in coins: one contract is 1 BTC or 1 ETH"
+      ],
+      [
+       "Expiry",
+       "08:00 UTC on the date named, against the index averaged over the 30 minutes before"
+      ],
+      [
+       "Max pain and Payout $",
+       "As for US options, with a contract size of one coin; Payout $ is in dollars"
+      ],
+      [
+       "Gamma",
+       "Deribit's mark IVs, Black-76 at each expiry's forward to 08:00 UTC; the flip and walls are read against the index"
+      ],
+      [
+       "DVOL",
+       "Deribit's 30-day implied volatility index, shown in OVDV and charted as `CAP:volatility:dvol-btc`"
+      ]
+     ]
+    },
     {
      "type": "heading",
      "level": 2,
@@ -4676,7 +4883,7 @@
     },
     {
      "type": "paragraph",
-     "text": "`gloomberb fn GEX SPY --csv` opens with a summary: spot and quote times, the open interest session, the unit, net GEX, the dealer range, the flip and both walls. Puts export negative, so call and put GEX add up to net. `--json` has the same under `metadata.gamma`."
+     "text": "`gloom fn GEX SPY --csv` opens with a summary: spot, when gamma is evaluated and when its quotes were taken (`Gamma at ..., vols from ...`), the open interest session, the unit, net GEX, the dealer range, the flip and both walls. Puts export negative, so call and put GEX add up to net. `--json` has the same under `metadata.gamma`."
     },
     {
      "type": "heading",
@@ -4715,7 +4922,7 @@
     },
     {
      "type": "paragraph",
-     "text": "**pro** needs Pro, **cloud** needs a Gloom Cloud account, and **plugin** installs with `PL` or `gloomberb install gloom-sh/<repo>`. [term.gloom.sh](https://term.gloom.sh) already has `POLL` and `PM`."
+     "text": "**pro** needs Pro, **cloud** needs a Gloom Cloud account, and **plugin** installs with `PL` or `gloom install gloom-sh/<repo>`. [term.gloom.sh](https://term.gloom.sh) already has `POLL` and `PM`."
     },
     {
      "type": "table",
@@ -4778,7 +4985,7 @@
    "blocks": [
     {
      "type": "paragraph",
-     "text": "`Cmd/Ctrl` is Cmd on a Mac outside the terminal, Ctrl everywhere else. Rebind keys in Help (`?`) or with `gloomberb config set keybindings.actions.<action> <keys>`."
+     "text": "`Cmd/Ctrl` is Cmd on a Mac outside the terminal, Ctrl everywhere else. Rebind keys in Help (`?`) or with `gloom config set keybindings.actions.<action> <keys>`."
     },
     {
      "type": "heading",
@@ -5021,7 +5228,7 @@
     },
     {
      "type": "paragraph",
-     "text": "`LANG` cycles languages. `LANG ja` (or `auto`, `en`, `es`, `zh-CN`, `zh-TW`, `ko`) sets one and saves it. `GLOOMBERB_LANG=ja gloomberb` sets it for one terminal launch."
+     "text": "`LANG` cycles languages. `LANG ja` (or `auto`, `en`, `es`, `zh-CN`, `zh-TW`, `ko`) sets one and saves it. `GLOOMBERB_LANG=ja gloom` sets it for one terminal launch."
     }
    ]
   },
@@ -5065,11 +5272,11 @@
       ],
       [
        "CLI",
-       "`gloomberb config set theme colorblind`. A name works too: `\"White Phosphor\"`."
+       "`gloom config set theme colorblind`. A name works too: `\"White Phosphor\"`."
       ],
       [
        "List them",
-       "`gloomberb config themes` (`--json` for scripts)"
+       "`gloom config themes` (`--json` for scripts)"
       ]
      ]
     },
@@ -5266,11 +5473,11 @@
    "blocks": [
     {
      "type": "paragraph",
-     "text": "`gloomberb` alone, or `gloomberb launch-ui` from a script, opens the terminal UI. Every other command runs headless and prints a result."
+     "text": "`gloom` alone, or `gloom launch-ui` from a script, opens the terminal UI. Every other command runs headless and prints a result."
     },
     {
      "type": "paragraph",
-     "text": "`gloomberb help <command>` shows usage and examples. Plugins add commands of their own, such as `ai ask` from BYOK AI."
+     "text": "`gloom help <command>` shows usage and examples. Plugins add commands of their own, such as `ai ask` from BYOK AI."
     },
     {
      "type": "paragraph",
@@ -5381,7 +5588,7 @@
       ],
       [
        "`fred <series>`, `yield-curve`",
-       "FRED series (needs a Gloom Cloud sign-in), Treasury yields"
+       "FRED series, no sign-in (`fred --list` shows the set), Treasury yields"
       ],
       [
        "`provider-search <query>`",
@@ -5517,19 +5724,19 @@
     },
     {
      "type": "code",
-     "code": "gloomberb catalog chart\ngloomberb fn GP NVDA\ngloomberb fn 13F AAPL --view=ticker-holdings --json\ngloomberb shot QQ AAPL,MSFT,NVDA --output quotes.png\ngloomberb shot FA ASML --statement income --width 1400 --height 900"
+     "code": "gloom catalog chart\ngloom fn GP NVDA\ngloom fn 13F AAPL --view=ticker-holdings --json\ngloom shot QQ AAPL,MSFT,NVDA --output quotes.png\ngloom shot FA ASML --statement income --width 1400 --height 900"
     },
     {
      "type": "paragraph",
-     "text": "`gloomberb catalog <function>` lists a function's options. `shot` also takes `--tab <id>`. `shot` draws a function's options as its pane does: `gloomberb shot 13F 0001067983 --compare SPY` opens the fund's overlap with SPY. An option only the text report reads, such as `--limit`, fails `shot` with exit 1 and names the `fn` command that reads it, instead of saving the pane without it."
+     "text": "`gloom catalog <function>` lists a function's options. `shot` also takes `--tab <id>`. `shot` draws a function's options as its pane does: `gloom shot 13F 0001067983 --compare SPY` opens the fund's overlap with SPY. An option only the text report reads, such as `--limit`, fails `shot` with exit 1 and names the `fn` command that reads it, instead of saving the pane without it."
     },
     {
      "type": "paragraph",
-     "text": "A command exits 0 when it worked and 1 when it failed (bad input, no data found, a failed check); `gloomberb help` ends with the list. `shot` saves its PNG, prints the Reason line and still exits 0 when the pane drew an error, was empty, was still loading or was behind an access gate, so a script cannot tell that from a good capture. `shot --strict` exits 2 in those cases instead, with the PNG still saved and the Reason still printed."
+     "text": "A command exits 0 when it worked and 1 when it failed (bad input, no data found, a failed check); `gloom help` ends with the list. `shot` saves its PNG, prints the Reason line and still exits 0 when the pane drew an error, was empty, was still loading or was behind an access gate, so a script cannot tell that from a good capture. `shot --strict` exits 2 in those cases instead, with the PNG still saved and the Reason still printed."
     },
     {
      "type": "paragraph",
-     "text": "A function name nothing opens (`fn volsurf SPY`) fails with the functions closest to it by name, keyword and description, at most five, and `Search the catalog: gloomberb catalog volsurf`."
+     "text": "A function name nothing opens (`fn volsurf SPY`) fails with the functions closest to it by name, keyword and description, at most five, and `Search the catalog: gloom catalog volsurf`."
     },
     {
      "type": "paragraph",
@@ -5541,7 +5748,7 @@
     },
     {
      "type": "paragraph",
-     "text": "Times print in UTC. To see your own clock beside them, run `gloomberb config set timezone Asia/Tokyo` (any `Region/City` name; `none` turns it off): `Sat 10 Oct 2026 16:56 UTC (Sun 11 Oct 01:56 Asia/Tokyo)`. A trading day keeps its market's date in every zone, and `--json` and `--csv` keep the raw values."
+     "text": "Times print in UTC. To see your own clock beside them, run `gloom config set timezone Asia/Tokyo` (any `Region/City` name; `none` turns it off): `Sat 10 Oct 2026 16:56 UTC (Sun 11 Oct 01:56 Asia/Tokyo)`. A trading day keeps its market's date in every zone, and `--json` and `--csv` keep the raw values."
     },
     {
      "type": "heading",
@@ -5550,7 +5757,7 @@
     },
     {
      "type": "code",
-     "code": "gloomberb api list --json\ngloomberb api get <capability-id>\ngloomberb api invoke asset-data.gloomberb-cloud.getQuote '{\"ticker\":\"AAPL\",\"exchange\":\"NASDAQ\"}' --json\ngloomberb api subscribe <capability.operation> [json] --limit 10"
+     "code": "gloom api list --json\ngloom api get <capability-id>\ngloom api invoke asset-data.gloomberb-cloud.getQuote '{\"ticker\":\"AAPL\",\"exchange\":\"NASDAQ\"}' --json\ngloom api subscribe <capability.operation> [json] --limit 10"
     }
    ]
   },
@@ -5652,31 +5859,31 @@
      ],
      "rows": [
       [
-       "`gloomberb remote help`",
+       "`gloom remote help`",
        "Agent-focused usage from the running app."
       ],
       [
-       "`gloomberb remote schema`",
+       "`gloom remote schema`",
        "Resource URIs, operations, request and response shapes."
       ],
       [
-       "`gloomberb remote get <resource>`",
+       "`gloom remote get <resource>`",
        "Read one resource."
       ],
       [
-       "`gloomberb remote call <operation> [json] [--dry-run]`",
+       "`gloom remote call <operation> [json] [--dry-run]`",
        "Invoke one operation."
       ],
       [
-       "`gloomberb remote patch <resource> <json-patch> [--expect-rev rev] [--dry-run]`",
+       "`gloom remote patch <resource> <json-patch> [--expect-rev rev] [--dry-run]`",
        "JSON Patch a mutable resource."
       ],
       [
-       "`gloomberb remote batch <json> [--dry-run]`",
+       "`gloom remote batch <json> [--dry-run]`",
        "Run a multi-step workflow."
       ],
       [
-       "`gloomberb remote watch <resource> [--interval ms] [--limit n]`",
+       "`gloom remote watch <resource> [--interval ms] [--limit n]`",
        "Poll for changes."
       ]
      ]
@@ -5696,7 +5903,7 @@
     },
     {
      "type": "code",
-     "code": "gloomberb remote get app://snapshot --app desktop --json\ngloomberb remote get app://pane-templates --app desktop --json\ngloomberb remote get ui://tree --app desktop --json"
+     "code": "gloom remote get app://snapshot --app desktop --json\ngloom remote get app://pane-templates --app desktop --json\ngloom remote get ui://tree --app desktop --json"
     },
     {
      "type": "paragraph",
@@ -5704,7 +5911,7 @@
     },
     {
      "type": "code",
-     "code": "gloomberb remote call pane.screenshot '{ \"paneId\": \"chart:main\" }' --app desktop --json"
+     "code": "gloom remote call pane.screenshot '{ \"paneId\": \"chart:main\" }' --app desktop --json"
     },
     {
      "type": "heading",
@@ -5717,7 +5924,7 @@
     },
     {
      "type": "code",
-     "code": "gloomberb remote call pane.createFromTemplate '{ \"templateId\": \"market-heatmap-pane\" }' --app desktop --json\ngloomberb remote call ticker.pin '{ \"symbol\": \"NVDA\", \"forceNewPane\": true }' --app desktop --json"
+     "code": "gloom remote call pane.createFromTemplate '{ \"templateId\": \"market-heatmap-pane\" }' --app desktop --json\ngloom remote call ticker.pin '{ \"symbol\": \"NVDA\", \"forceNewPane\": true }' --app desktop --json"
     },
     {
      "type": "paragraph",
@@ -5725,7 +5932,7 @@
     },
     {
      "type": "code",
-     "code": "gloomberb remote batch '{\n  \"type\": \"batch\",\n  \"include\": [\"panes\", \"commandBar\"],\n  \"requests\": [\n    { \"type\": \"call\", \"operation\": \"app.search\", \"input\": { \"mode\": \"ticker\", \"query\": \"NVDA\" } },\n    { \"type\": \"call\", \"operation\": \"commandBar.activateResult\", \"input\": { \"index\": 0 } }\n  ]\n}' --app desktop --json"
+     "code": "gloom remote batch '{\n  \"type\": \"batch\",\n  \"include\": [\"panes\", \"commandBar\"],\n  \"requests\": [\n    { \"type\": \"call\", \"operation\": \"app.search\", \"input\": { \"mode\": \"ticker\", \"query\": \"NVDA\" } },\n    { \"type\": \"call\", \"operation\": \"commandBar.activateResult\", \"input\": { \"index\": 0 } }\n  ]\n}' --app desktop --json"
     },
     {
      "type": "heading",
@@ -5734,7 +5941,7 @@
     },
     {
      "type": "code",
-     "code": "gloomberb remote call layout.setGrid '{ \"columns\": 2 }' --app desktop --json\ngloomberb remote call layout.focusRegion '{ \"region\": \"right\" }' --app desktop --json\ngloomberb remote call layout.closeFloating '{}' --app desktop --json"
+     "code": "gloom remote call layout.setGrid '{ \"columns\": 2 }' --app desktop --json\ngloom remote call layout.focusRegion '{ \"region\": \"right\" }' --app desktop --json\ngloom remote call layout.closeFloating '{}' --app desktop --json"
     },
     {
      "type": "paragraph",
@@ -5742,7 +5949,7 @@
     },
     {
      "type": "code",
-     "code": "gloomberb remote call app.switchPanel '{ \"panel\": \"right\" }' --app desktop --json"
+     "code": "gloom remote call app.switchPanel '{ \"panel\": \"right\" }' --app desktop --json"
     },
     {
      "type": "paragraph",
@@ -5759,7 +5966,7 @@
     },
     {
      "type": "code",
-     "code": "gloomberb remote get ui://tree --app desktop --json\ngloomberb remote call ui.invokeMatching '{ \"role\": \"button\", \"label\": \"Done\", \"action\": \"press\" }' --app desktop --json"
+     "code": "gloom remote get ui://tree --app desktop --json\ngloom remote call ui.invokeMatching '{ \"role\": \"button\", \"label\": \"Done\", \"action\": \"press\" }' --app desktop --json"
     },
     {
      "type": "paragraph",
@@ -6529,7 +6736,7 @@
     },
     {
      "type": "code",
-     "code": "gloomberb install user/repo\ngloomberb install https://github.com/user/repo\ngloomberb plugins\ngloomberb update\ngloomberb update my-plugin\ngloomberb remove my-plugin\ngloomberb plugin enable my-plugin\ngloomberb plugin disable my-plugin"
+     "code": "gloom install user/repo\ngloom install https://github.com/user/repo\ngloom plugins\ngloom update\ngloom update my-plugin\ngloom remove my-plugin\ngloom plugin enable my-plugin\ngloom plugin disable my-plugin"
     },
     {
      "type": "paragraph",
@@ -6541,7 +6748,7 @@
     },
     {
      "type": "paragraph",
-     "text": "Not loading? `gloomberb plugin doctor <name-or-path>` checks the entry, export, id, targets, hosts, and browser build, even for a plugin that failed to load."
+     "text": "Not loading? `gloom plugin doctor <name-or-path>` checks the entry, export, id, targets, hosts, and browser build, even for a plugin that failed to load."
     },
     {
      "type": "image",
@@ -6568,7 +6775,7 @@
     },
     {
      "type": "code",
-     "code": "gloomberb plugin link ./hello-gloom\ngloomberb plugin doctor hello-gloom\ngloomberb hello Vince --json"
+     "code": "gloom plugin link ./hello-gloom\ngloom plugin doctor hello-gloom\ngloom hello Vince --json"
     },
     {
      "type": "paragraph",
@@ -6651,6 +6858,10 @@
      "type": "paragraph",
      "text": "The [financial news API](/news) page shows the live wire and has the Get API key button."
     },
+    {
+     "type": "paragraph",
+     "text": "Comparing news APIs? See [the best financial news APIs](/alternatives/financial-news-apis), or Gloom side by side with [NewsAPI.org](/alternatives/newsapi-org) and [newsfilter.io](/alternatives/newsfilter-io)."
+    },
     {
      "type": "paragraph",
      "text": "See also: [Gloom Datasets](/docs/datasets), a separate paid API for alternative signals, filings, macro, news and market data, with its own `gds_` keys."
@@ -6929,7 +7140,7 @@
     {
      "type": "list",
      "items": [
-      "**Alternative data:** GPU rental prices, supply chain, hiring postings and momentum, social mentions, app attention, power and grid, perpetuals, catalysts and litigation, research attention, congressional trades, operating exposure.",
+      "**Alternative data:** GPU rental prices, supply chain, hiring postings and momentum, social mentions, app attention, power and grid, perpetuals, catalysts and litigation, congressional trades, operating exposure.",
       "**Filings and company text:** KPIs and guidance, executive pay, risk factors, 8-K events, transcripts, credit documents, debt maturities, revenue breakdown, SEC filings, insiders and 13F, document search.",
       "**News:** Real-time stories, sources and topics.",
       "**Macro and positioning:** CPI, EIA inventories, COT, yield curves and macro series, central bank rates, short volume and interest, CDS, government awards.",
@@ -7420,7 +7631,7 @@
    "title": "Mergers and acquisitions (MA)",
    "summary": "MA lists pending, rumored and closed takeover deals with their terms, their stage and, for listed targets, the arbitrage spread between the offer and the market price.",
    "chapter": "Fundamentals and earnings",
-   "minutes": 4
+   "minutes": 5
   },
   {
    "url": "/academy/compare-screen-follow-money/compare-and-screen/comparison-chart",
@@ -7455,7 +7666,7 @@
    "title": "Screening the market (EQS)",
    "summary": "EQS keeps only the stocks in its stored universe that meet all your rules (valuation, growth, margins, liquidity, ownership and more) and ranks the matches.",
    "chapter": "Compare, screen and follow the money",
-   "minutes": 4
+   "minutes": 5
   },
   {
    "url": "/academy/compare-screen-follow-money/who-owns-it/holders-and-13f",
@@ -7508,10 +7719,10 @@
   },
   {
    "url": "/academy/compare-screen-follow-money/filings-and-attention/attention",
-   "title": "Attention: research and social buzz (ATTN, BUZZ)",
-   "summary": "ATTN ranks the tickers Gloom users are researching against each ticker's usual level, and BUZZ counts the day's posts on X naming a ticker, with the top posts and their stance.",
+   "title": "Social buzz (BUZZ)",
+   "summary": "BUZZ counts the day's posts on X naming a ticker against its usual level, with the top posts and their stance.",
    "chapter": "Compare, screen and follow the money",
-   "minutes": 4
+   "minutes": 3
   },
   {
    "url": "/academy/options-and-volatility/options-from-zero/what-is-an-option",