[bhavsarpratik]

Summary

Token Meter now groups spend by the Git branch each session ran on, using only local data: agent session files and this Mac's Git reflogs. Nothing calls GitHub, GitLab, or an issue tracker.

• Sessions › By branch (#sessions-branches): spend per branch with search (branch or issue key such as ENG-142), app, project, time range, push status, and a show-main toggle. Rows sort and expand to their sessions. All five Sessions tabs sit on one row.
• Branch chip: one shared :where(.branchChip) component on session cards, All sessions rows, the session header, and both branch tables. It opens the branch in By branch.
• Git › Branches: four metrics that should go down, each compared with the prior period: cost to ship a branch (median), unshipped spend, rework after the first push (session-level estimate), and hard-to-finish branches (3× or more your median spend per commit). Below them is a searchable, sortable table that shows five rows at a time and scrolls.

Privacy and data

• Branch names come from Claude gitBranch and Codex session_meta.git.branch. They are stored internally as _branch. Only /logs exposes branch and a path-free repo label.
• /state, /menubar, notifications, and every MCP tool, including git_stats, carry no branch. Tests check for both the key and a sample branch name.
• Git ledger schema 2 is additive: three new tables, and the v1 history is kept. It stores salted branch keys and each branch's own non-merge commits by you that were not already on the default branch. A test confirms the database file contains no ref names.
• Project totals on the Git page are unchanged. A test compares them with branch recording on and off.

Rule changes

• specs/ARCHITECTURE.md: branch names may appear on the local dashboard only, never in MCP, the menu bar, notifications, or logs.
• specs/DESIGN.md: the four branch metrics are scored lower-is-better; pushed-code volume and ratios stay neutral.
• specs/AGENTS.md: Sessions gains By branch. Root AGENTS.md was regenerated through the tested transform, because scripts/setup-agent-tools is absent on main.

Validation

• Full suite: 2,661 tests passed and 21 were skipped. Design contract, scripts/check-page, and py_compile pass.
• Headless Chrome at 1440 and 1024 px, zero console errors: tab row, filters, sort, expand, chip navigation, and Git table search, sort, and five-row scroll.
• Installed locally: /health OK and /menubar has no branch. Source and runtime match. Branch spend agrees for all 37 live branches between both pages.
• An independent tester and one privacy reviewer are running on 180b0df. The owner waived the second reviewer.

Known limits

• Apps that do not record a branch (Cursor, OpenCode, Kiro) show as "No branch recorded".
• Rework is a session-level estimate.
• A branch pushed under a different remote name, or to a remote whose name contains a slash, shows as not pushed.

🤖 Generated with Claude Code