Skip to content

docs: document always-on widget default #9

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
SergioChan merged 1 commit into from
Aug 18, 2026
Merged

docs: document always-on widget default #9

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,12 @@ published.
window gets a bound face without a CDP debugging port, launch flags, or any
quit/relaunch of Codex. The overlay installs and runs on machines without
Claude installed, and the app is now named "Token Widget".
- The widget and **Always Visible** mode are enabled by default. Claude Chat,
Cowork, Settings, auxiliary windows, and periods when neither Claude nor Codex
is frontmost now show the machine-wide global face instead of hiding the
widget. That face has no Session ID, reports `binding.exact = false`, and
never displays another Session's numbers. Both visibility choices remain
available from the Token Widget menu-bar menu.
- Deprecated the Codex CDP adapter (`scripts/install-token-meter-macos.sh`). It
still works but will be removed in a future release; prefer the app.
- Hardened live rollout scanning when Codex prunes a JSONL file between
Expand Down
4 changes: 2 additions & 2 deletions CONTRIBUTING.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@ Changes must preserve these properties:
- Child-Agent usage remains visible and explicitly labeled.
- Renderer scripts are registered only after the target passes semantic verification.
- Codex CDP remains loopback-only and is accepted only from the verified official Codex process tree.
- Claude binds only the exact local Session exposed by the focused Accessibility window and never falls back to recency or display name.
- Claude's Session face binds only the exact local Session exposed by the focused Accessibility window and never falls back to recency or display name. Non-Session Claude surfaces and non-frontmost hosts may show only the machine-wide global face, which has no Session ID, reports a non-exact binding, and never displays Session-scoped numbers.
- The Claude companion remains independent from Claude.app, waits quietly when permission is absent, and never quits or relaunches Claude.
- The collector never retains prompt, reasoning, tool, or assistant content.
- Shutdown removes injected DOM or the native companion panel and never force-quits a host.
Expand Down Expand Up @@ -62,7 +62,7 @@ For Claude compatibility changes, also verify:

1. The focused Code Session binds by exact `local_<uuid>`.
2. Switching Sessions replaces the complete snapshot without retaining previous values.
3. Chat, Cowork, Settings, auxiliary windows, and non-frontmost Claude hide the panel.
3. Chat, Cowork, Settings, auxiliary windows, and non-frontmost hosts never show a Session-bound face. With the default visibility preferences they show the machine-wide global face; disabling **Always Visible** hides it when no supported host is frontmost, and disabling the widget hides it everywhere.
4. Expanded and collapsed layouts both drag and persist correctly.
5. Active Context uses root input-side usage and an exact model-window source.
6. Missing Accessibility permission produces no repeated prompt, process churn, or Claude restart.
Expand Down
Loading