refactor(web): rebrand the web output as the "OpenTab browser", not a "report"

OpenTab is a browser for your AI spend, not a report generator -- so the
--html/--serve/--web output is the "OpenTab browser" everywhere users read it:
the page title/brand/footer, the CLI help for --html/--serve/--web/--theme/
--bind, the console lines, the TUI theme picker, and the README/CLAUDE docs.
The product name is "OpenTab" (never "opentab"/"Opentab") in prose; the
command, package, import, theme id, config paths, and the default
opentab-report.html filename stay lowercase/unchanged, and internal symbols
(ReportServer, open_report) are untouched. No behaviour change.

Author: hamidi-dev

CLAUDE.md

@@ -47,9 +47,9 @@ ruff format --check src/opentab test_opentab.py   # format check (matches CI)
 python3 -m compileall -q src/opentab          # byte-compile smoke check
 python3 -m opentab --demo                     # run the TUI with anonymized/synthetic data
 opentab --status "$PWD"                       # one-shot: current session's cost incl. subagents (tmux status line; OpenCode only)
-opentab --demo --html demo.html               # one-shot: write the self-contained HTML report
-opentab --serve                               # same report served on http://localhost:8321 (+ live Turns/Tools)
-opentab --web                                 # --serve, and open the report in the default browser
+opentab --demo --html demo.html               # one-shot: write the self-contained HTML browser
+opentab --serve                               # same browser served on http://localhost:8321 (+ live Turns/Tools)
+opentab --web                                 # --serve, and open it in the default browser
 ```
 
 `test_opentab.py` is **not** pytest — it has its own runner at the bottom that just runs
@@ -97,7 +97,7 @@ Follow [Conventional Commits](https://www.conventionalcommits.org) — `type(sco
   `--refresh-models` / `r` in the `P` overlay), the warm-start rollup cache under
   `~/.config/opentab/cache/` (one JSON per backend, rewritten after a parse when that
   backend's files change; off under `--demo` / `--no-cache`), `opentab-*.csv` exports
-  (on `e`), and the HTML report (only on `--html`, default `opentab-report.html`).
+  (on `e`), and the HTML browser (only on `--html`, default `opentab-report.html`).
 - **Python 3.9+.** `MIN_PYTHON = (3, 9)`; `target-version = py39`. Don't use newer syntax.
 
 ## Architecture
@@ -117,11 +117,11 @@ src/opentab/
   util.py            clipboard/launchers/git_root/fuzzy/parse_range/tool_namespace
   sources.py         make_store/resolve_source/available_sources/source_cycle + path routing
   state.py           load_state/save_state/apply_state
-  themes.py          THEMES palettes (single source for the web report + the TUI) + hex math
+  themes.py          THEMES palettes (single source for the web browser + the TUI) + hex math
   stores/            opencode, claude, codex, hermes, csv_source, jsonl_source, copilot, vscode, pi, openclaw, combined, cached
   tui/               renderer (Renderer), app (App)
   web.py             build_payload/session_extras + html_command/serve_command (ReportServer)
-  webpage.py         render_html: the self-contained report page (inline CSS/JS strings)
+  webpage.py         render_html: the self-contained browser page (inline CSS/JS strings)
 ```
 
 Three logical layers (the class names below live in the files above — `Store` in
@@ -434,7 +434,7 @@ exists. The `c`/`L`/price-prompt pickers are all small centered modals via
 `Renderer.draw_modal` (drawn after the body so context shows behind), unlike the full-body
 help/prices/trends overlays.
 
-### The web report (`--html` / `--serve`)
+### The web browser (`--html` / `--serve`)
 
 A second frontend over the same data, stdlib-only (`http.server`), curses-free (works on
 native Windows). `cli.web_command` builds the usual **headless App** — rollups, worktree
@@ -504,8 +504,8 @@ export **omits Turns/Tools** (embedding them would be a startup-wide scan), whil
 `--serve` (`web.ReportServer`) exposes them as `/api/session/<id>` fetched on drill-in,
 plus `/api/reload`. The server is **deliberately single-threaded** — the stores' sqlite
 connections are bound to their creating thread — and binds 127.0.0.1 by default (the
-report leaks prompt titles/paths/spend; `--bind` warns beyond localhost). **`--web` is
-`--serve` plus opening the report in the default browser** (`web.open_report`, stdlib
+browser leaks prompt titles/paths/spend; `--bind` warns beyond localhost). **`--web` is
+`--serve` plus opening it in the default browser** (`web.open_report`, stdlib
 `webbrowser` → `open`/`xdg-open`/Windows shell-association, so it's cross-platform),
 launched from a daemon thread once the socket is listening (a console-browser fallback
 can't block `serve_forever`, and it never touches the sqlite-bound store); a headless box

README.md

@@ -10,8 +10,8 @@
 </p>
 
 <p align="center">
-  <img src="https://github.com/user-attachments/assets/a84029a3-7887-42c7-ba5a-d8c905f3fa19" alt="OpenTab web report — the same data as a self-contained page" width="900">
-  <br><sub><b>Also a web report</b> — <code>opentab --web</code> renders the same data as one self-contained, shareable page</sub>
+  <img src="https://github.com/user-attachments/assets/a84029a3-7887-42c7-ba5a-d8c905f3fa19" alt="OpenTab web browser — the same data as a self-contained page" width="900">
+  <br><sub><b>Also a web browser</b> — <code>opentab --web</code> renders the same data as one self-contained, shareable page</sub>
 </p>
 
 A local, standard-library terminal UI for your AI coding spend. It reads the records your
@@ -39,13 +39,13 @@ no accounts — it opens those files **read-only**. Standard-library-only at run
 - Git worktrees folded into their main repo
 - Live fuzzy filter (fzf-style, title / project / id) and live date-range scoping
 - CSV export of any view
-- A self-contained **HTML report** (`--html`) — same drill-in, calendar heatmap, and
+- A self-contained **HTML browser** (`--html`) — same drill-in, calendar heatmap, and
   `$` toggle in one shareable file — and a local live server for it (`--serve`, or
   `--web` to also pop it open in your browser)
 - Keyboard- and mouse-driven (scroll, click to select, double-click to drill)
 - Remembers your range, sort, ignored projects, and the `$` view between runs
 - Colour themes (opentab, Catppuccin, Tokyo Night, Gruvbox, Nord, Dracula, Rosé Pine —
-  light and dark) shared by the TUI (`C`) and the web report, set with `--theme`
+  light and dark) shared by the TUI (`C`) and the web browser, set with `--theme`
 - Read-only, local-only, standard-library runtime (nothing extra to pull in)
 - Demo mode for screenshots and live demos
 
@@ -87,7 +87,7 @@ touches, all on your own machine:
   source, range, and sort; disable with `--no-state`), an optional model-price cache at
   `~/.config/opentab/prices.json` (only when you run `--refresh-models` or press `r` in the
   `P` overlay), and — only when you press `e` or run `--html` — an `opentab-*.csv`
-  export or the HTML report file in the current directory.
+  export or the HTML browser file in the current directory.
 - **Runs** external programs only on the key you press: your file opener
   (`open`/`xdg-open`, or Explorer on Windows) for `o`, and for `L` either `tmux`, your own
   [launcher hook](#custom-launchers) (`~/.config/opentab/launcher`), or your clipboard tool
@@ -155,7 +155,7 @@ opentab --db /path/to/opencode.db  # default: ~/.local/share/opencode/opencode.d
 opentab --source claude          # browse Claude Code spend instead (see below)
 opentab --demo                   # safe for live demos / screenshots (see below)
 opentab --html                   # write opentab-report.html and exit (see below)
-opentab --serve                  # same report on http://localhost:8321, live
+opentab --serve                  # same browser on http://localhost:8321, live
 opentab --web                    # --serve, and open it in your browser
 ```
 
@@ -235,7 +235,7 @@ and months, and the model mix (which models, in what ratio) — but the absolute
 numbers do not. A `DEMO — synthetic` tag shows in the header so synthetic figures
 are never mistaken for real ones.
 
-### Web report (`--html` / `--serve` / `--web`)
+### Web browser (`--html` / `--serve` / `--web`)
 
 `opentab --html` writes the whole browser as **one self-contained HTML file** —
 no server, no dependencies, works from disk or any static host. It's the TUI in
@@ -255,12 +255,12 @@ this year, or a custom span). The **theme** button switches the palette live
 Pine — light and dark) and remembers your pick; `--theme <name>` bakes the
 default. Combine with `--demo` for a page you can publish.
 
-`opentab --serve` serves the same report on `http://localhost:8321` (`--port`)
+`opentab --serve` serves the same browser on `http://localhost:8321` (`--port`)
 and adds what a static file can't have: the per-session **Turns** timeline and
 **Tools** attribution fetched live on drill-in, plus a refresh button that
-re-reads your data. `opentab --web` is the same thing but also opens the report in
-your default browser (cross-platform — `open` on macOS, `xdg-open` on Linux, the
-shell association on Windows). It binds to localhost only — the report shows prompt
+re-reads your data. `opentab --web` is the same thing but also opens it in
+your default web browser (cross-platform — `open` on macOS, `xdg-open` on Linux, the
+shell association on Windows). It binds to localhost only — the browser shows prompt
 titles, project paths, and spend, so if you want it on another machine put it behind
 something like Tailscale (`--bind`), never a public interface.
 
@@ -295,7 +295,7 @@ detail — cost split, model mix, and subagent tree. `Esc` steps back out.
 | `o` | Open the selected session's / project's directory |
 | `L` | Launch the selected session in its own tool (`opencode --session <id>` / `claude --resume <id>` / `codex resume <id>`). Inside tmux a one-key menu opens it in a new **w**indow, **s**plit, **v**split, or **p**opup (cd'd to the project), with **y** copying the `cd <project> && …` command to the clipboard; outside tmux the menu offers only the copy. See [Custom launchers](#custom-launchers) to route launches through your own tooling |
 | `c` | Switch data source — any present backend (OpenCode, Claude Code, Codex, Hermes, Copilot CLI, VS Code, pi, OpenClaw, CSV, JSONL), or all merged |
-| `C` | Colours — pick a theme (opentab, Catppuccin Mocha/Latte, Tokyo Night/Day, Gruvbox, Nord, Dracula, Rosé Pine — the same set as the web report). `j`/`k` live-preview, `Enter` keeps, `Esc` reverts; light themes light up the whole screen. `--theme` sets it at launch |
+| `C` | Colours — pick a theme (opentab, Catppuccin Mocha/Latte, Tokyo Night/Day, Gruvbox, Nord, Dracula, Rosé Pine — the same set as the web browser). `j`/`k` live-preview, `Enter` keeps, `Esc` reverts; light themes light up the whole screen. `--theme` sets it at launch |
 | `r` | Reload the database |
 | `?` | Help; `q` quits |
 

src/opentab/cli.py

@@ -170,32 +170,32 @@ def parse_args() -> argparse.Namespace:
         const="opentab-report.html",
         default=None,
         metavar="FILE",
-        help="write a self-contained HTML report and exit: drill-in by month/day/"
+        help="write a self-contained HTML browser and exit: drill-in by month/day/"
         "project/session, calendar heat map, sortable tables, the $ what-if toggle "
         "-- all client-side in one file (default FILE: opentab-report.html). "
         "Pairs with --demo for a shareable page",
     )
     parser.add_argument(
         "--serve",
         action="store_true",
-        help="serve the HTML report from a local web server; adds the per-session "
+        help="serve the HTML browser from a local web server; adds the per-session "
         "Turns/Tools drill-in as live endpoints and a data-refresh button "
         "(Ctrl-C stops it)",
     )
     parser.add_argument(
         "--web",
         action="store_true",
-        help="like --serve, but also open the report in your default browser "
+        help="like --serve, but also open it in your default web browser "
         "(cross-platform via the stdlib webbrowser: `open` on macOS, `xdg-open` on "
         "Linux, the shell association on Windows); honors --port/--bind",
     )
     parser.add_argument(
         "--theme",
         choices=themes.THEME_IDS,
         default=themes.DEFAULT_THEME,
-        help="colour theme for the TUI and the --html/--serve report (opentab, "
+        help="colour theme for the TUI and the --html/--serve browser (opentab, "
         "catppuccin-mocha/latte, tokyo-night/-day, gruvbox, nord, dracula, rose-pine); "
-        "switch live in the TUI with Y or the report's theme button, and your choice is "
+        "switch live in the TUI with Y or the browser's theme button, and your choice is "
         f"remembered. Default: {themes.DEFAULT_THEME}",
     )
     parser.add_argument(
@@ -204,7 +204,7 @@ def parse_args() -> argparse.Namespace:
     parser.add_argument(
         "--bind",
         default="127.0.0.1",
-        help="address for --serve/--web (default: 127.0.0.1). The report exposes prompt "
+        help="address for --serve/--web (default: 127.0.0.1). The browser exposes prompt "
         "titles, project paths, and spend -- bind beyond localhost only on a "
         "trusted/VPN (e.g. Tailscale) interface, never a public one",
     )
@@ -446,7 +446,7 @@ def main() -> int:
         or getattr(args, "serve", False)
         or getattr(args, "web", False)
     ):
-        return web_command(args)  # HTML report / local report server; no curses
+        return web_command(args)  # HTML browser / local browser server; no curses
     if curses is None:
         raise SystemExit(
             "OpenTab needs Python's curses module, which native Windows Python doesn't bundle.\n"

src/opentab/state.py

@@ -43,7 +43,7 @@ def save_state(app: App) -> None:
         "bookmarks": sorted(app.bookmarks),  # sessions starred with `b`
         "show_api_prices": app.show_api_prices,
         "source": app.source_key,  # restore the last source (opencode/claude/all) next run
-        "theme": app.theme_id,  # the colour theme (shared with the web report)
+        "theme": app.theme_id,  # the colour theme (shared with the web browser)
         "cal_levels": app.cal_levels,  # the Calendar heat-map granularity (+/-)
         "prices_prompt_dismissed": app.prices_prompt_dismissed,  # "don't ask again" for prices
     }

src/opentab/stores/opencode.py

@@ -190,7 +190,7 @@ def cache_inputs(self) -> list[str]:
         # The DB file whose (size, mtime) fingerprints the warm-start cache, plus its
         # WAL sidecars. OpenCode runs SQLite in WAL mode, so new sessions land in
         # <db>-wal and the main .db's size/mtime don't move until a checkpoint -- so
-        # fingerprinting the .db alone made a reload (r, or the report's refresh) serve
+        # fingerprinting the .db alone made a reload (r, or the browser's refresh) serve
         # the stale cache and never show sessions written since. The sidecars move on
         # every commit; a read-only connection still reads them, so a re-parse sees the
         # new rows. Missing sidecars (a non-WAL DB, or a checkpoint that removed them)

src/opentab/themes.py

@@ -1,8 +1,8 @@
-"""Shared theme palettes — the single source of truth for the web report and the TUI.
+"""Shared theme palettes — the single source of truth for the web browser and the TUI.
 
 Each theme names a role palette (semantic slots, not hues) plus a calendar heat ramp
 (`heat`, coldest→hottest) and a cheap→pricey price-heat ramp (`price_heat`), and a
-`dark` flag. The web report reads these verbatim (`web_payload()` reshapes them to the
+`dark` flag. The web browser reads these verbatim (`web_payload()` reshapes them to the
 JS token names and is injected into the page), and the curses TUI maps the same role
 hexes to color pairs via `init_color` on true-color terminals (or nearest-256 elsewhere).
 Adding a theme is one entry here; both frontends and the `--theme` CLI choices pick it up.

src/opentab/tui/app.py

@@ -200,7 +200,7 @@ def __init__(self, store: Store, args: argparse.Namespace, source_key: str = "")
         self.source_menu_index = 0  # highlighted row in that picker
         self.sort_menu = False  # the `s` sort-order picker overlay
         self.sort_menu_index = 0  # highlighted row in that picker
-        # Active colour theme (shared source with the web report). Seeded from
+        # Active colour theme (shared source with the web browser). Seeded from
         # --theme; a valid saved theme (apply_state) or the `Y` picker takes over.
         self.theme_id = getattr(args, "theme", None) or themes.DEFAULT_THEME
         if self.theme_id not in themes.THEMES:
@@ -2607,7 +2607,7 @@ def run(self, stdscr: curses.window) -> None:
         curses.curs_set(0)
         curses.use_default_colors()
         # Colours come from the active theme (opentab/themes.py, shared with the web
-        # report). The renderer maps its role hexes onto the fixed color-pair layout --
+        # browser). The renderer maps its role hexes onto the fixed color-pair layout --
         # exact via init_color on true-colour terminals, nearest-256 otherwise, and the
         # generated ANSI ramp on 8-colour. Foreground-only: a TUI paints over the
         # terminal's own background. Live theme switches re-run init_theme_colors().

src/opentab/tui/renderer.py

@@ -2077,7 +2077,7 @@ def help_sections(self) -> list[tuple[str, list[tuple]]]:
                     (
                         "C",
                         "colour-theme picker — j/k live-preview · Enter keep · Esc revert "
-                        "(also the web report's)",
+                        "(also the web browser's)",
                     ),
                     ("D", "toggle real / demo data (demo anonymizes titles and paths)"),
                 ],
@@ -2610,11 +2610,11 @@ def draw_source_menu(self, stdscr: curses.window, scr_h: int, scr_w: int) -> Non
 
     def draw_theme_menu(self, stdscr: curses.window, scr_h: int, scr_w: int) -> None:
         # The `C` (Colours) picker: a modal list of the themes (shared with the web
-        # report). j/k live-previews each (the whole UI is the swatch), Enter keeps it,
+        # browser). j/k live-previews each (the whole UI is the swatch), Enter keeps it,
         # Esc reverts to the theme active on open. Colours re-map via init_theme_colors.
         entries = self.theme_menu_entries()
         idx = self.theme_menu_index % len(entries) if entries else 0
-        lines = [("Colour theme (also the web report's):", curses.color_pair(4)), ("", 0)]
+        lines = [("Colour theme (also the web browser's):", curses.color_pair(4)), ("", 0)]
         for offset, (_tid, name, is_current) in enumerate(entries):
             marker = "●" if is_current else "○"
             suffix = "  (current)" if is_current else ""