# Tasks

Live checklist. `[x]` done, `[ ]` open. Update it as work finishes or is added, and refresh "Next up" so the next agent knows where to start. Open questions are in `DECISIONS.md`.

## Next up (start here)

1. **Austin: install 0.3.1 and try it on the real claude.ai** (steps on `/reframe`). It was built and tested only against stand-in pages, because the build environment can't reach claude.ai. Report what the popup's status box says, what looks wrong, and paste "Copy diagnostics" output. The likely first problems: the wrong wrapper moves (use Pane level − and +), the pane background doesn't match the theme, or a Claude menu opens behind the pane.
1a. **Check the usage readout against the real thing.** Its two addresses (`/api/organizations`, `/api/organizations/<id>/usage`) are from memory of how other trackers work and were never reached from here. If it says "Usage unavailable", Copy diagnostics (the status includes the error) and Claude Code can fix the address or shape.
2. Try it on Claude Code on the web (`claude.ai/code`). Its layout is different; the nudge is remembered separately there.
3. Answer the open questions in `DECISIONS.md`.

## Phase 3b — v0.3.1 popups and pickers (done)

- [x] Repository picker on the Claude Code front page no longer distorts the page (search fields in popups are never the message box; open overlays freeze re-layout; their text doesn't count as a conversation)
- [x] Sanity checks: too-small conversation areas are not split; a split that comes out wrong is undone with a back-off
- [x] Pane z-index below Claude's popups; a pane that fits no longer clips things opening from inside it
- [x] Message box less intrusive (scrollbar only when needed, thin, wrappers keep their height); diagnostics include the box's width, padding and scrollbar size
- [x] A long message's own scrolling wrapper is no longer mistaken for the conversation scroller (found by the new tests: re-splitting after a long message picked only the text area, and the safety check caught it)
- [x] End-to-end: Claude Code front page with three picker variants, the model menu during a split, a tiny conversation area (35 checks)
- [ ] Voice recording shrinking the text width: not reproducible here. If it persists in 0.3.1, copy diagnostics from the popup while recording

## Phase 3 — v0.3.0 pace, tall-box fix, strip in the pane (done)

- [x] Pace meters for session and week: used bar, elapsed shade and line, over/under verdict, reset clock time and time left
- [x] Pane starts below the top-right buttons (Claude Code share, view options, folder), which stay clickable
- [x] The message box stops growing at the top of the pane and scrolls inside itself, so Send and the model picker stay visible
- [x] The button, meters and a ⚙ settings icon sit in a strip inside the pane (bottom or top) with reserved space; corners still available; normal view uses the bottom right corner
- [x] Unit tests (12) and end-to-end checks (28), including a header-button layout and a very long message with a Send button

## Phase 2 — v0.2.0 dock, usage, colors, settings (done)

- [x] Renamed Claude Reframe; use-at-your-own-risk notices on the download page, About page, popup, settings page, install text and manifest
- [x] On-page Split view / Normal view button (corner selectable), also on claude.ai/code
- [x] Session and weekly usage readout with reset times; "Usage unavailable" when it can't be read
- [x] Chat vs. Code colors: top line, pane edge, optional tint, optional [Code] tab title prefix, colors editable
- [x] Settings page (options page) with export, import (validated, refuses foreign files) and reset
- [x] Unit tests (10) and end-to-end checks (25)

## Phase 1 — v0.1.0 split screen (done)

- [x] Folder, rules, README, decisions, download page with install and update steps, version history and zips (same pattern as DustyTab)
- [x] MV3 manifest with a fixed id, runs on `https://claude.ai/*` only, Alt+Shift+S, icons
- [x] Message box found by behavior (lowest visible text field), composer and conversation found by text amount and scrolling, no Claude class names
- [x] Split: conversation left, tall pane right, full height; resize by dragging the edge; width slider; double-click resets
- [x] Waits for the first message; leaves windows under 900 px alone
- [x] Survives the page replacing the composer or renaming every class; handles transformed ancestors; works when the page scrolls instead of an inner block
- [x] Popup: status explaining what it found, on/off, width, pane level − and + per area, copy diagnostics, check for updates
- [x] Switching off removes every marker (tested)
- [x] Unit tests (6) and end-to-end checks (18) against three stand-in layouts

## Later

- [ ] Verify against live claude.ai and Claude Code on the web and add stand-in layouts for whatever differs
- [ ] Optional cap on how tall the message box may get before it scrolls (today it uses all the room the pane has)
- [ ] Confirm the usage endpoint and add a stand-in with the real response shape
- [ ] Pane background and divider that follow Claude's theme exactly
- [ ] Option: pane on the left, or stacked (box below) in a short window
- [ ] A "custom CSS" box that keeps Austin's own tweaks per area, applied by the same marker approach
- [ ] More layout tweaks: wider or narrower reading column, hiding parts of the page
