usage-cli 0.33.10__tar.gz → 0.34.1__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (281) hide show
  1. {usage_cli-0.33.10/usage_cli.egg-info → usage_cli-0.34.1}/PKG-INFO +16 -15
  2. {usage_cli-0.33.10 → usage_cli-0.34.1}/README.md +15 -14
  3. {usage_cli-0.33.10 → usage_cli-0.34.1}/analyzer/dispatch_ledger.py +6 -1
  4. {usage_cli-0.33.10 → usage_cli-0.34.1}/i18n.json +30 -10
  5. {usage_cli-0.33.10 → usage_cli-0.34.1}/installer/session_hooks.py +1 -1
  6. usage_cli-0.34.1/loaders/muse_quota_probe.py +278 -0
  7. {usage_cli-0.33.10 → usage_cli-0.34.1}/menubar/agy.py +2 -0
  8. {usage_cli-0.33.10 → usage_cli-0.34.1}/menubar/app.py +6 -28
  9. {usage_cli-0.33.10 → usage_cli-0.34.1}/menubar/chrome.py +15 -0
  10. {usage_cli-0.33.10 → usage_cli-0.34.1}/menubar/menu.py +21 -0
  11. usage_cli-0.34.1/menubar/muse.py +73 -0
  12. {usage_cli-0.33.10 → usage_cli-0.34.1}/menubar/notify.py +32 -0
  13. {usage_cli-0.33.10 → usage_cli-0.34.1}/menubar/prefs.py +6 -1
  14. {usage_cli-0.33.10 → usage_cli-0.34.1}/menubar/refresh.py +29 -12
  15. {usage_cli-0.33.10 → usage_cli-0.34.1}/menubar/state.py +91 -45
  16. {usage_cli-0.33.10 → usage_cli-0.34.1}/menubar/title.py +35 -51
  17. {usage_cli-0.33.10 → usage_cli-0.34.1}/panels/__init__.py +1 -0
  18. {usage_cli-0.33.10 → usage_cli-0.34.1}/panels/base.py +1 -0
  19. {usage_cli-0.33.10 → usage_cli-0.34.1}/panels/catalog.py +32 -16
  20. {usage_cli-0.33.10 → usage_cli-0.34.1}/panels/payload.py +22 -4
  21. {usage_cli-0.33.10 → usage_cli-0.34.1}/panels/web_panel.py +3 -0
  22. {usage_cli-0.33.10 → usage_cli-0.34.1}/pyproject.toml +1 -1
  23. {usage_cli-0.33.10 → usage_cli-0.34.1}/quota/codex_window_keeper.py +14 -1
  24. {usage_cli-0.33.10 → usage_cli-0.34.1}/quota/notifications.py +2 -0
  25. {usage_cli-0.33.10 → usage_cli-0.34.1}/quota/status_payload.py +46 -2
  26. {usage_cli-0.33.10 → usage_cli-0.34.1}/quota/window_keeper.py +16 -1
  27. {usage_cli-0.33.10 → usage_cli-0.34.1}/setup_app.py +1 -0
  28. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_analyzer_pipeline.py +5 -1
  29. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_check_upstream.py +23 -1
  30. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_codex_window_keeper.py +4 -0
  31. usage_cli-0.34.1/tests/test_compact_cards.py +264 -0
  32. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_desktop_quota_display.py +2 -3
  33. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_dispatch_ledger.py +33 -0
  34. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_menubar.py +182 -40
  35. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_menubar_agy.py +2 -0
  36. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_menubar_grok.py +3 -4
  37. usage_cli-0.34.1/tests/test_menubar_muse.py +88 -0
  38. usage_cli-0.34.1/tests/test_menubar_notify.py +190 -0
  39. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_menubar_prefs.py +17 -2
  40. usage_cli-0.34.1/tests/test_muse_coverage.py +94 -0
  41. usage_cli-0.34.1/tests/test_muse_quota_probe.py +274 -0
  42. usage_cli-0.34.1/tests/test_muse_review_regressions.py +203 -0
  43. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_panels.py +24 -11
  44. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_quota_aware.py +35 -1
  45. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_usage_notifications.py +20 -0
  46. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_web_panel_payload.py +20 -4
  47. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_window_keeper.py +32 -0
  48. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_wintray.py +50 -10
  49. {usage_cli-0.33.10 → usage_cli-0.34.1/usage_cli.egg-info}/PKG-INFO +16 -15
  50. {usage_cli-0.33.10 → usage_cli-0.34.1}/usage_cli.egg-info/SOURCES.txt +7 -0
  51. {usage_cli-0.33.10 → usage_cli-0.34.1}/usage_hooks/usage_quota_aware.py +5 -2
  52. {usage_cli-0.33.10 → usage_cli-0.34.1}/wintray/app.py +56 -43
  53. {usage_cli-0.33.10 → usage_cli-0.34.1}/wintray/menu.py +10 -0
  54. usage_cli-0.33.10/tests/test_menubar_notify.py +0 -91
  55. {usage_cli-0.33.10 → usage_cli-0.34.1}/LICENSE +0 -0
  56. {usage_cli-0.33.10 → usage_cli-0.34.1}/THIRD_PARTY_NOTICES.md +0 -0
  57. {usage_cli-0.33.10 → usage_cli-0.34.1}/adapters/__init__.py +0 -0
  58. {usage_cli-0.33.10 → usage_cli-0.34.1}/adapters/agy.py +0 -0
  59. {usage_cli-0.33.10 → usage_cli-0.34.1}/adapters/claude.py +0 -0
  60. {usage_cli-0.33.10 → usage_cli-0.34.1}/adapters/codex.py +0 -0
  61. {usage_cli-0.33.10 → usage_cli-0.34.1}/adapters/grok.py +0 -0
  62. {usage_cli-0.33.10 → usage_cli-0.34.1}/adapters/muse.py +0 -0
  63. {usage_cli-0.33.10 → usage_cli-0.34.1}/adapters/rate_limits.py +0 -0
  64. {usage_cli-0.33.10 → usage_cli-0.34.1}/adapters/registry.py +0 -0
  65. {usage_cli-0.33.10 → usage_cli-0.34.1}/adapters/types.py +0 -0
  66. {usage_cli-0.33.10 → usage_cli-0.34.1}/analyzer/__init__.py +0 -0
  67. {usage_cli-0.33.10 → usage_cli-0.34.1}/analyzer/aggregator.py +0 -0
  68. {usage_cli-0.33.10 → usage_cli-0.34.1}/analyzer/blocks.py +0 -0
  69. {usage_cli-0.33.10 → usage_cli-0.34.1}/analyzer/diagnoser.py +0 -0
  70. {usage_cli-0.33.10 → usage_cli-0.34.1}/analyzer/diagnosis_snapshot.py +0 -0
  71. {usage_cli-0.33.10 → usage_cli-0.34.1}/analyzer/history_persist.py +0 -0
  72. {usage_cli-0.33.10 → usage_cli-0.34.1}/analyzer/insights.py +0 -0
  73. {usage_cli-0.33.10 → usage_cli-0.34.1}/analyzer/ledger_backfill.py +0 -0
  74. {usage_cli-0.33.10 → usage_cli-0.34.1}/analyzer/persona_loader.py +0 -0
  75. {usage_cli-0.33.10 → usage_cli-0.34.1}/analyzer/reporter.py +0 -0
  76. {usage_cli-0.33.10 → usage_cli-0.34.1}/analyzer/subscription.py +0 -0
  77. {usage_cli-0.33.10 → usage_cli-0.34.1}/analyzer/usage_snapshot.py +0 -0
  78. {usage_cli-0.33.10 → usage_cli-0.34.1}/installer/__init__.py +0 -0
  79. {usage_cli-0.33.10 → usage_cli-0.34.1}/installer/claude_pane.py +0 -0
  80. {usage_cli-0.33.10 → usage_cli-0.34.1}/installer/codex_hook_trust.py +0 -0
  81. {usage_cli-0.33.10 → usage_cli-0.34.1}/installer/login_item.py +0 -0
  82. {usage_cli-0.33.10 → usage_cli-0.34.1}/installer/setup_hook.py +0 -0
  83. {usage_cli-0.33.10 → usage_cli-0.34.1}/installer/statusline_settings.py +0 -0
  84. {usage_cli-0.33.10 → usage_cli-0.34.1}/loaders/__init__.py +0 -0
  85. {usage_cli-0.33.10 → usage_cli-0.34.1}/loaders/_shared_cache_file.py +0 -0
  86. {usage_cli-0.33.10 → usage_cli-0.34.1}/loaders/agy_disk_cache.py +0 -0
  87. {usage_cli-0.33.10 → usage_cli-0.34.1}/loaders/agy_loader.py +0 -0
  88. {usage_cli-0.33.10 → usage_cli-0.34.1}/loaders/agy_quota_probe.py +0 -0
  89. {usage_cli-0.33.10 → usage_cli-0.34.1}/loaders/cache_quarantine.py +0 -0
  90. {usage_cli-0.33.10 → usage_cli-0.34.1}/loaders/chromium_cache.py +0 -0
  91. {usage_cli-0.33.10 → usage_cli-0.34.1}/loaders/claude_desktop.py +0 -0
  92. {usage_cli-0.33.10 → usage_cli-0.34.1}/loaders/claude_paths.py +0 -0
  93. {usage_cli-0.33.10 → usage_cli-0.34.1}/loaders/claude_usage.py +0 -0
  94. {usage_cli-0.33.10 → usage_cli-0.34.1}/loaders/codex_disk_cache.py +0 -0
  95. {usage_cli-0.33.10 → usage_cli-0.34.1}/loaders/codex_events.py +0 -0
  96. {usage_cli-0.33.10 → usage_cli-0.34.1}/loaders/codex_fork_replay.py +0 -0
  97. {usage_cli-0.33.10 → usage_cli-0.34.1}/loaders/codex_loader.py +0 -0
  98. {usage_cli-0.33.10 → usage_cli-0.34.1}/loaders/codex_paths.py +0 -0
  99. {usage_cli-0.33.10 → usage_cli-0.34.1}/loaders/disk_cache_common.py +0 -0
  100. {usage_cli-0.33.10 → usage_cli-0.34.1}/loaders/disk_cache_lifecycle.py +0 -0
  101. {usage_cli-0.33.10 → usage_cli-0.34.1}/loaders/grok_loader.py +0 -0
  102. {usage_cli-0.33.10 → usage_cli-0.34.1}/loaders/grok_quota_probe.py +0 -0
  103. {usage_cli-0.33.10 → usage_cli-0.34.1}/loaders/history_disk_cache.py +0 -0
  104. {usage_cli-0.33.10 → usage_cli-0.34.1}/loaders/history_loader.py +0 -0
  105. {usage_cli-0.33.10 → usage_cli-0.34.1}/loaders/jsonl_limits.py +0 -0
  106. {usage_cli-0.33.10 → usage_cli-0.34.1}/loaders/jsonl_utils.py +0 -0
  107. {usage_cli-0.33.10 → usage_cli-0.34.1}/loaders/muse_loader.py +0 -0
  108. {usage_cli-0.33.10 → usage_cli-0.34.1}/main.py +0 -0
  109. {usage_cli-0.33.10 → usage_cli-0.34.1}/menubar/__init__.py +0 -0
  110. {usage_cli-0.33.10 → usage_cli-0.34.1}/menubar/actions.py +0 -0
  111. {usage_cli-0.33.10 → usage_cli-0.34.1}/menubar/fsevents_watch.py +0 -0
  112. {usage_cli-0.33.10 → usage_cli-0.34.1}/menubar/grok.py +0 -0
  113. {usage_cli-0.33.10 → usage_cli-0.34.1}/menubar/manual_refresh.py +0 -0
  114. {usage_cli-0.33.10 → usage_cli-0.34.1}/menubar/new_badge.py +0 -0
  115. {usage_cli-0.33.10 → usage_cli-0.34.1}/menubar/popover.py +0 -0
  116. {usage_cli-0.33.10 → usage_cli-0.34.1}/menubar/update.py +0 -0
  117. {usage_cli-0.33.10 → usage_cli-0.34.1}/menubar/whats_new.py +0 -0
  118. {usage_cli-0.33.10 → usage_cli-0.34.1}/panels/dynamic_height.py +0 -0
  119. {usage_cli-0.33.10 → usage_cli-0.34.1}/panels/panel_scale.py +0 -0
  120. {usage_cli-0.33.10 → usage_cli-0.34.1}/panels/panel_window.py +0 -0
  121. {usage_cli-0.33.10 → usage_cli-0.34.1}/panels/panel_window_state.py +0 -0
  122. {usage_cli-0.33.10 → usage_cli-0.34.1}/panels/window_drag.py +0 -0
  123. {usage_cli-0.33.10 → usage_cli-0.34.1}/quota/__init__.py +0 -0
  124. {usage_cli-0.33.10 → usage_cli-0.34.1}/quota/agy_window_keeper.py +0 -0
  125. {usage_cli-0.33.10 → usage_cli-0.34.1}/quota/burn_rate.py +0 -0
  126. {usage_cli-0.33.10 → usage_cli-0.34.1}/quota/keeper_outcome.py +0 -0
  127. {usage_cli-0.33.10 → usage_cli-0.34.1}/quota/quota_snapshot.py +0 -0
  128. {usage_cli-0.33.10 → usage_cli-0.34.1}/quota/usage_rate.py +0 -0
  129. {usage_cli-0.33.10 → usage_cli-0.34.1}/setup.cfg +0 -0
  130. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_adapters_claude.py +0 -0
  131. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_adapters_codex.py +0 -0
  132. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_adapters_rate_limits.py +0 -0
  133. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_aggregator.py +0 -0
  134. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_agy_adapter.py +0 -0
  135. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_agy_disk_cache.py +0 -0
  136. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_agy_loader.py +0 -0
  137. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_agy_quota_probe.py +0 -0
  138. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_agy_window_keeper.py +0 -0
  139. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_analyzer_blocks.py +0 -0
  140. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_app_version.py +0 -0
  141. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_burn_rate.py +0 -0
  142. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_cache_quarantine.py +0 -0
  143. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_chromium_cache.py +0 -0
  144. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_claude_desktop.py +0 -0
  145. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_claude_pane.py +0 -0
  146. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_claude_paths.py +0 -0
  147. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_codex_consistency.py +0 -0
  148. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_codex_hook_trust.py +0 -0
  149. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_codex_loader.py +0 -0
  150. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_desktop_fresh_cache.py +0 -0
  151. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_desktop_quota_review.py +0 -0
  152. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_diagnoser.py +0 -0
  153. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_disk_cache_shards.py +0 -0
  154. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_doctor.py +0 -0
  155. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_dynamic_height.py +0 -0
  156. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_fsevents_watch.py +0 -0
  157. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_grok_loader.py +0 -0
  158. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_grok_quota_probe.py +0 -0
  159. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_history_loader.py +0 -0
  160. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_history_persist.py +0 -0
  161. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_hook_scripts_are_standalone.py +0 -0
  162. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_html_report_snapshot.py +0 -0
  163. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_i18n_format_fallback.py +0 -0
  164. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_i18n_key_parity.py +0 -0
  165. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_i18n_packaged_path.py +0 -0
  166. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_insights.py +0 -0
  167. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_jsonl_utils.py +0 -0
  168. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_keeper_menu.py +0 -0
  169. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_keeper_outcome.py +0 -0
  170. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_ledger_backfill.py +0 -0
  171. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_login_item.py +0 -0
  172. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_main.py +0 -0
  173. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_manual_refresh.py +0 -0
  174. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_menubar_state.py +0 -0
  175. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_menubar_update.py +0 -0
  176. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_muse_loader.py +0 -0
  177. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_new_badge.py +0 -0
  178. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_packaged_resources.py +0 -0
  179. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_packaging.py +0 -0
  180. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_panel_footer_layout.py +0 -0
  181. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_panel_scale.py +0 -0
  182. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_panel_window_state.py +0 -0
  183. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_panels_lazy_import.py +0 -0
  184. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_persona_loader.py +0 -0
  185. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_pricing.py +0 -0
  186. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_project_resolver.py +0 -0
  187. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_quota_label.py +0 -0
  188. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_report_cold_read.py +0 -0
  189. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_report_daily_chart.py +0 -0
  190. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_report_filter_js.py +0 -0
  191. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_report_share_mask.py +0 -0
  192. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_reporter_build_data.py +0 -0
  193. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_service_status.py +0 -0
  194. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_session_resume.py +0 -0
  195. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_setup_app.py +0 -0
  196. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_setup_hook.py +0 -0
  197. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_setup_hook_coexistence.py +0 -0
  198. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_setup_hook_resume.py +0 -0
  199. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_setup_hook_terse.py +0 -0
  200. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_subprocess_utils.py +0 -0
  201. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_subscription.py +0 -0
  202. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_taskbar_menu.py +0 -0
  203. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_time_utils.py +0 -0
  204. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_tui.py +0 -0
  205. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_tui_sprite.py +0 -0
  206. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_ui_tables.py +0 -0
  207. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_update_checker.py +0 -0
  208. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_update_gate.py +0 -0
  209. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_update_release_notes.py +0 -0
  210. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_usage_cli.py +0 -0
  211. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_usage_client.py +0 -0
  212. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_usage_diagnosis_snapshot.py +0 -0
  213. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_usage_dir_sweeper.py +0 -0
  214. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_usage_lang.py +0 -0
  215. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_usage_logging.py +0 -0
  216. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_usage_rate.py +0 -0
  217. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_usage_snapshot.py +0 -0
  218. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_usage_snapshot_replay.py +0 -0
  219. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_usage_statusline.py +0 -0
  220. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_usage_statusline_agy.py +0 -0
  221. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_usage_statusline_forwarder.py +0 -0
  222. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_usage_statusline_grok.py +0 -0
  223. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_usage_terse_mode.py +0 -0
  224. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_usage_terse_reminder.py +0 -0
  225. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_whats_new.py +0 -0
  226. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_wheel_packaging.py +0 -0
  227. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_win_login_item.py +0 -0
  228. {usage_cli-0.33.10 → usage_cli-0.34.1}/tests/test_windows_manifest.py +0 -0
  229. {usage_cli-0.33.10 → usage_cli-0.34.1}/tui/__init__.py +0 -0
  230. {usage_cli-0.33.10 → usage_cli-0.34.1}/tui/app.py +0 -0
  231. {usage_cli-0.33.10 → usage_cli-0.34.1}/tui/sprite.py +0 -0
  232. {usage_cli-0.33.10 → usage_cli-0.34.1}/ui/__init__.py +0 -0
  233. {usage_cli-0.33.10 → usage_cli-0.34.1}/ui/html_report.py +0 -0
  234. {usage_cli-0.33.10 → usage_cli-0.34.1}/ui/report_charts.py +0 -0
  235. {usage_cli-0.33.10 → usage_cli-0.34.1}/ui/report_daily_chart.py +0 -0
  236. {usage_cli-0.33.10 → usage_cli-0.34.1}/ui/report_filter.py +0 -0
  237. {usage_cli-0.33.10 → usage_cli-0.34.1}/ui/report_ledger.py +0 -0
  238. {usage_cli-0.33.10 → usage_cli-0.34.1}/ui/report_scripts.py +0 -0
  239. {usage_cli-0.33.10 → usage_cli-0.34.1}/ui/report_styles.py +0 -0
  240. {usage_cli-0.33.10 → usage_cli-0.34.1}/ui/tables.py +0 -0
  241. {usage_cli-0.33.10 → usage_cli-0.34.1}/updates/__init__.py +0 -0
  242. {usage_cli-0.33.10 → usage_cli-0.34.1}/updates/checker.py +0 -0
  243. {usage_cli-0.33.10 → usage_cli-0.34.1}/updates/gate.py +0 -0
  244. {usage_cli-0.33.10 → usage_cli-0.34.1}/updates/release_notes.py +0 -0
  245. {usage_cli-0.33.10 → usage_cli-0.34.1}/updates/whats_new.py +0 -0
  246. {usage_cli-0.33.10 → usage_cli-0.34.1}/usage_app/__init__.py +0 -0
  247. {usage_cli-0.33.10 → usage_cli-0.34.1}/usage_app/cli.py +0 -0
  248. {usage_cli-0.33.10 → usage_cli-0.34.1}/usage_app/doctor.py +0 -0
  249. {usage_cli-0.33.10 → usage_cli-0.34.1}/usage_cli.egg-info/dependency_links.txt +0 -0
  250. {usage_cli-0.33.10 → usage_cli-0.34.1}/usage_cli.egg-info/entry_points.txt +0 -0
  251. {usage_cli-0.33.10 → usage_cli-0.34.1}/usage_cli.egg-info/requires.txt +0 -0
  252. {usage_cli-0.33.10 → usage_cli-0.34.1}/usage_cli.egg-info/top_level.txt +0 -0
  253. {usage_cli-0.33.10 → usage_cli-0.34.1}/usage_common/__init__.py +0 -0
  254. {usage_cli-0.33.10 → usage_cli-0.34.1}/usage_common/app_version.py +0 -0
  255. {usage_cli-0.33.10 → usage_cli-0.34.1}/usage_common/i18n.py +0 -0
  256. {usage_cli-0.33.10 → usage_cli-0.34.1}/usage_common/prefs.py +0 -0
  257. {usage_cli-0.33.10 → usage_cli-0.34.1}/usage_common/pricing.py +0 -0
  258. {usage_cli-0.33.10 → usage_cli-0.34.1}/usage_common/project_resolver.py +0 -0
  259. {usage_cli-0.33.10 → usage_cli-0.34.1}/usage_common/service_status.py +0 -0
  260. {usage_cli-0.33.10 → usage_cli-0.34.1}/usage_common/subprocess_utils.py +0 -0
  261. {usage_cli-0.33.10 → usage_cli-0.34.1}/usage_common/time_utils.py +0 -0
  262. {usage_cli-0.33.10 → usage_cli-0.34.1}/usage_common/usage_dir_sweeper.py +0 -0
  263. {usage_cli-0.33.10 → usage_cli-0.34.1}/usage_common/usage_lang.py +0 -0
  264. {usage_cli-0.33.10 → usage_cli-0.34.1}/usage_common/usage_logging.py +0 -0
  265. {usage_cli-0.33.10 → usage_cli-0.34.1}/usage_hooks/__init__.py +0 -0
  266. {usage_cli-0.33.10 → usage_cli-0.34.1}/usage_hooks/usage_session_resume.py +0 -0
  267. {usage_cli-0.33.10 → usage_cli-0.34.1}/usage_hooks/usage_statusline.py +0 -0
  268. {usage_cli-0.33.10 → usage_cli-0.34.1}/usage_hooks/usage_statusline_agy.py +0 -0
  269. {usage_cli-0.33.10 → usage_cli-0.34.1}/usage_hooks/usage_statusline_forwarder.py +0 -0
  270. {usage_cli-0.33.10 → usage_cli-0.34.1}/usage_hooks/usage_statusline_grok.py +0 -0
  271. {usage_cli-0.33.10 → usage_cli-0.34.1}/usage_hooks/usage_terse_mode.py +0 -0
  272. {usage_cli-0.33.10 → usage_cli-0.34.1}/usage_hooks/usage_terse_reminder.py +0 -0
  273. {usage_cli-0.33.10 → usage_cli-0.34.1}/wintray/__init__.py +0 -0
  274. {usage_cli-0.33.10 → usage_cli-0.34.1}/wintray/login_item.py +0 -0
  275. {usage_cli-0.33.10 → usage_cli-0.34.1}/wintray/prefs.py +0 -0
  276. {usage_cli-0.33.10 → usage_cli-0.34.1}/wintray/quota_label.py +0 -0
  277. {usage_cli-0.33.10 → usage_cli-0.34.1}/wintray/taskbar_menu.py +0 -0
  278. {usage_cli-0.33.10 → usage_cli-0.34.1}/wintray/taskbar_obstacles.py +0 -0
  279. {usage_cli-0.33.10 → usage_cli-0.34.1}/wintray/taskbar_overlay.py +0 -0
  280. {usage_cli-0.33.10 → usage_cli-0.34.1}/wintray/watch.py +0 -0
  281. {usage_cli-0.33.10 → usage_cli-0.34.1}/wintray/whats_new.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: usage-cli
3
- Version: 0.33.10
3
+ Version: 0.34.1
4
4
  Summary: usage — 在 macOS menu bar 與 Windows 系統匣顯示 Claude Code、Codex、Antigravity 用量的小工具(也提供終端機 TUI)
5
5
  License-Expression: AGPL-3.0-only
6
6
  Requires-Python: >=3.13
@@ -26,7 +26,7 @@ Dynamic: license-file
26
26
 
27
27
  # usage
28
28
 
29
- ### Your Claude Code, Codex, Antigravity and Grok CLI quota, always on screen.
29
+ ### Your Claude Code, Codex, Antigravity, Grok CLI, and Muse Code quota, always on screen.
30
30
 
31
31
  `usage` puts your 5-hour and weekly limits in the macOS menu bar or Windows system tray, colored from green to red. Hitting the limit halfway through a long refactor is a bad way to find out you were running low. Now you see it coming. There's nothing to run and no page to open.
32
32
 
@@ -47,8 +47,8 @@ Dynamic: license-file
47
47
  <img src="docs/showcase-v3.en.png" alt="usage — Claude Code, Codex, and Antigravity quota pinned to the macOS menu bar" width="820">
48
48
  </p>
49
49
 
50
- - **Every quota at a glance:** Claude Code, Codex, and Antigravity session and weekly limits with reset countdowns, plus Grok CLI's weekly credit.
51
- - **Reads what's already on your machine:** Claude Code, Codex, and Grok CLI numbers come from local logs. Antigravity quota comes from Google's official endpoint, using the sign-in its CLI already stores.
50
+ - **Every quota at a glance:** Claude Code, Codex, Antigravity, and Muse Code session and weekly limits with reset countdowns, plus Grok CLI's weekly credit.
51
+ - **Reads what's already on your machine:** Claude Code, Codex, Grok CLI, and Muse Code tokens and cost come from local logs. Antigravity quota comes from Google's official endpoint, using the sign-in its CLI already stores. Muse quota comes from a small background model call through its own signed-in CLI.
52
52
  - **Warns before tokens go to waste:** The Claude Code status line flags a bloating context window and a cold prompt cache. A banner shows Claude or Codex outages.
53
53
  - **Helpers inside Claude Code:** A side pane, shorter replies, a progress hand-off for new sessions, and quota-aware planning. All optional.
54
54
  - **Reports and 16 themes:** HTML reports of token trends and cost, and 16 panel themes to pick from.
@@ -88,7 +88,7 @@ Then click the menu bar or tray icon.
88
88
 
89
89
  </details>
90
90
 
91
- `usage` needs data from at least one of Claude Code, Codex, Antigravity, or Grok CLI, or a running Claude Desktop app.
91
+ `usage` needs data from at least one of Claude Code, Codex, Antigravity, Grok CLI, or Muse Code, or a running Claude Desktop app.
92
92
 
93
93
  ## First Launch: Set Up the Status Line
94
94
 
@@ -107,13 +107,13 @@ Once set up, the bottom of the Claude Code window will show a status line like t
107
107
 
108
108
  ### On Screen
109
109
 
110
- - **Menu bar monitor:** Quota color-coded from green to red. Click for the full session, weekly, and per-project breakdown.
110
+ - **Menu bar monitor:** Quota color-coded from green to red. Click for the full session, weekly, and per-project breakdown. On macOS, the menu bar keeps at most three tools with the highest Session usage, in Claude → Codex → Antigravity → Grok → Muse order; the panel still shows all tools.
111
111
  - **Antigravity card:** Shows the Gemini pool by default. Tap the `Gemini ⇄` tag to switch to the separate Claude / GPT pool; the choice is remembered.
112
112
  - **Grok CLI card:** The weekly credit percentage from Grok CLI's local debug log. Its tokens also count toward cost and project totals.
113
- - **Muse Code spending:** Its tokens and cost count toward today's cost, project totals, reports, and the CLI. Muse keeps no quota data locally, so it has no card.
113
+ - **Muse Code card:** Shows 5-hour (Session) and weekly quota with reset countdowns. Available in all 15 quota themes, with a menu bar item and optional low, exhausted, and recovered quota notifications. Hidden automatically when Muse is not installed. Tokens and cost still count toward today's cost, project totals, reports, and the CLI.
114
114
  - **Outage alerts:** An orange-red banner when Claude Code, Claude API, or Codex API is down or degraded, read from their public status pages.
115
115
  - **Context and cache warnings:** The status line nudges you to `/clear` or `/compact` before the context window bloats, and says why the prompt cache missed.
116
- - **Hide what you don't use:** Hide the Claude Code, Codex, Grok CLI, or Antigravity section from the menu bar and panels in one click.
116
+ - **Hide what you don't use:** Hide the Claude Code, Codex, Grok CLI, Antigravity, or Muse Code section from the menu bar and panels in one click.
117
117
 
118
118
  ### Inside Claude Code
119
119
 
@@ -130,9 +130,9 @@ Once set up, the bottom of the Claude Code window will show a status line like t
130
130
  ### Reports and More
131
131
 
132
132
  - **HTML reports:** Daily and weekly token trends, project rankings, cost, and a Year in Review with a contribution heatmap. Export .html, .csv, or .png fully offline, with optional project-name masking.
133
- - **Terminal integration:** `usage status --json` hands your Claude Code, Codex, Antigravity, and Grok quota to Starship, tmux, or your own scripts. [Ready-made snippets](docs/DEVELOPMENT.md#quota-status-for-other-tools-usage-status).
133
+ - **Terminal integration:** `usage status --json` hands your Claude Code, Codex, Antigravity, Grok, and Muse quota to Starship, tmux, or your own scripts. [Ready-made snippets](docs/DEVELOPMENT.md#quota-status-for-other-tools-usage-status).
134
134
  - **AI Update Daily:** A daily public [page](https://aqua5230.github.io/ai-updates/) of Claude Code, Codex, and Antigravity changes, with plain-language summaries in five languages.
135
- - **Your layout:** Drag the panel anywhere, drag quota cards to reorder them, and switch among 16 themes. The UI follows your system language: Traditional Chinese, Simplified Chinese, English, Japanese, or Korean.
135
+ - **Your layout:** Drag the panel anywhere, drag quota cards to reorder them, and switch among 16 themes. The UI follows your system language: Traditional Chinese, Simplified Chinese, English, Japanese, or Korean. With four or more quota cards visible, all cards switch to a compact layout; three or fewer keep the usual layout.
136
136
 
137
137
  <details>
138
138
  <summary>Thresholds, versions, and fine print</summary>
@@ -146,8 +146,8 @@ Once set up, the bottom of the Claude Code window will show a status line like t
146
146
  - **Linux:** CI verifies `usage setup` on Ubuntu.
147
147
  - **Progress Concierge:** When you `/resume` a conversation that sat long enough for its cache to expire, it warns how many tokens the next message will re-send and suggests `/compact` first.
148
148
  - **Beginner Mode (macOS and Windows):** Terms appear above the prompt in your UI language. Press 9 to mark them understood; skipped terms come back after 1, 3, then 7 days. Understood terms return as a one-question multiple-choice quiz 7, 21, then 60 days later, at most one a day, and a wrong answer puts the term back in the hints. `/terms` opens your term history. Picking terms asks Claude Haiku through your Claude Code, and pauses while your 5-hour quota is at 90% or more.
149
- - **Quota-Aware Mode (macOS and Windows):** Claude Code gets one line with what is left and when it resets when a 5-hour quota passes 80%, 90%, or 95%, or a weekly quota passes 95%. It covers Claude Code, Codex, and Antigravity, says each level once per conversation, and treats each quota and model group separately, so a used-up one only matters for work that runs on it.
150
- - **Auto-start 5-hour session:** Claude gets Haiku, Antigravity gets Gemini 3.8 Flash Low, and Codex gets its cheapest model. The quota used is negligible. Checking your quota never sends a message; only this switch does.
149
+ - **Quota-Aware Mode (macOS and Windows):** Claude Code gets one line with what is left and when it resets when a 5-hour quota passes 80%, 90%, or 95%, or a weekly quota passes 95%. It covers Claude Code, Codex, Antigravity, and Muse, says each level once per conversation, and treats each quota and model group separately, so a used-up one only matters for work that runs on it.
150
+ - **Auto-start 5-hour session:** Claude gets Haiku, Antigravity gets Gemini 3.8 Flash Low, and Codex gets its cheapest model. The quota used is negligible.
151
151
  - **Panel:** It stays put when another app takes focus; a second click on the menu bar icon, or Escape, closes it. Card order is shared across every theme with quota cards (all except World Cup 2026) and survives restarts.
152
152
  - **HTML reports:** A "What you worked on" section lists the names Claude Code gave your recent conversations, and masking covers those titles too.
153
153
  - **AI Update Daily:** Unreviewed items show the original source text. The full history is kept.
@@ -225,7 +225,7 @@ Switch between **16 visual themes** directly from the UI:
225
225
  | Claude Code & Codex usage | ✅ | ✅ | ✅ |
226
226
  | Antigravity usage (Gemini and Claude / GPT) | ✅ | — | — |
227
227
  | Grok CLI usage | ✅ | — | — |
228
- | Muse Code token spend | ✅ | — | — |
228
+ | Muse Code quota, tokens, and cost | ✅ | — | — |
229
229
  | Claude Code & Codex service-status alerts | ✅ | — | — |
230
230
  | HTML deep reports & UI | ✅ | ✅ | — |
231
231
  | Claude Code helpers (Token Saver, Progress Concierge, Beginner and Quota-Aware modes, health check) | ✅ | — | — |
@@ -235,7 +235,7 @@ Switch between **16 visual themes** directly from the UI:
235
235
  ## When usage Isn't the Right Fit
236
236
 
237
237
  - You only live in the terminal and don't want another menu bar icon running in the background — a one-off CLI check fits better.
238
- - You don't use Claude Code, Codex, Antigravity, Grok CLI, or Claude Desktop — there's no usage data for `usage` to read.
238
+ - You don't use Claude Code, Codex, Antigravity, Grok CLI, Muse Code, or Claude Desktop — there's no usage data for `usage` to read.
239
239
  - You want a menu bar on Linux. Only macOS and Windows have one today, though the terminal interface (`uvx usage-cli`) runs on Linux.
240
240
 
241
241
  ## Windows Support
@@ -269,9 +269,10 @@ If the menu bar shows `--`, it's usually not broken — there's just no local da
269
269
 
270
270
  ## Privacy & Data Sources
271
271
 
272
- - **Local logs:** Claude Code, Codex, Grok CLI, and Muse Code numbers are read from log files on your machine. Their contents are never uploaded.
272
+ - **Local logs:** Claude Code, Codex, Grok CLI, and Muse Code token and cost numbers are read from log files on your machine. Their contents are never uploaded.
273
273
  - **Claude Desktop:** Without the Claude Code CLI or a status line, keep Claude Desktop open and `usage` reads its local plan-usage history. No cookies, login tokens, or API calls are needed. Reset times appear only when its local cache confirms them; they are never estimated.
274
274
  - **Antigravity**, only if you use it, needs network access: quota is fetched from Google's official quota endpoint with the OAuth credential the Antigravity CLI already stored after sign-in — read from macOS Keychain, Windows Credential Manager, or a local token file depending on CLI version. `usage` never writes that credential back and keeps any refreshed access token in memory only; the call itself reads quota metadata.
275
+ - **Muse quota:** Muse stores no quota file locally. `usage` runs `muse exec --json` through Muse's own sign-in and saves the returned quota to `~/.usage/muse_quota.json`. This connects to Muse and makes a real model call, using a little Muse quota. It runs in an empty folder with `--no-session-log`. With Muse installed and a conversation available, it fetches the first snapshot; later probes require a snapshot over 30 minutes old and a newer Muse conversation. After failure, it waits at least 30 minutes and requires new Muse usage before retrying. Hide its card under **Hide sections**.
275
276
  - **Other background network activity:** Public Claude and Codex status pages to flag outages, a public model-pricing table to estimate cost (built-in prices are used offline), and an occasional GitHub check for a new version.
276
277
  - **Beginner Mode**, only if you turn it on, sends Claude Code's latest answer to Claude Haiku through your own Claude Code sign-in to pick terms. Your term list stays in `~/.usage/glossary.json`.
277
278
  - **Long-term history:** Claude Code deletes transcripts older than 30 days by default. While the app runs, `usage` saves daily totals to `~/.usage/usage_snapshot.json` and `~/.usage/year_ledger.json` every 6 hours, so reports keep older days. Nothing leaves your machine. When you move to a new computer, copy the whole `~/.usage/` folder too.
@@ -4,7 +4,7 @@
4
4
 
5
5
  # usage
6
6
 
7
- ### Your Claude Code, Codex, Antigravity and Grok CLI quota, always on screen.
7
+ ### Your Claude Code, Codex, Antigravity, Grok CLI, and Muse Code quota, always on screen.
8
8
 
9
9
  `usage` puts your 5-hour and weekly limits in the macOS menu bar or Windows system tray, colored from green to red. Hitting the limit halfway through a long refactor is a bad way to find out you were running low. Now you see it coming. There's nothing to run and no page to open.
10
10
 
@@ -25,8 +25,8 @@
25
25
  <img src="docs/showcase-v3.en.png" alt="usage — Claude Code, Codex, and Antigravity quota pinned to the macOS menu bar" width="820">
26
26
  </p>
27
27
 
28
- - **Every quota at a glance:** Claude Code, Codex, and Antigravity session and weekly limits with reset countdowns, plus Grok CLI's weekly credit.
29
- - **Reads what's already on your machine:** Claude Code, Codex, and Grok CLI numbers come from local logs. Antigravity quota comes from Google's official endpoint, using the sign-in its CLI already stores.
28
+ - **Every quota at a glance:** Claude Code, Codex, Antigravity, and Muse Code session and weekly limits with reset countdowns, plus Grok CLI's weekly credit.
29
+ - **Reads what's already on your machine:** Claude Code, Codex, Grok CLI, and Muse Code tokens and cost come from local logs. Antigravity quota comes from Google's official endpoint, using the sign-in its CLI already stores. Muse quota comes from a small background model call through its own signed-in CLI.
30
30
  - **Warns before tokens go to waste:** The Claude Code status line flags a bloating context window and a cold prompt cache. A banner shows Claude or Codex outages.
31
31
  - **Helpers inside Claude Code:** A side pane, shorter replies, a progress hand-off for new sessions, and quota-aware planning. All optional.
32
32
  - **Reports and 16 themes:** HTML reports of token trends and cost, and 16 panel themes to pick from.
@@ -66,7 +66,7 @@ Then click the menu bar or tray icon.
66
66
 
67
67
  </details>
68
68
 
69
- `usage` needs data from at least one of Claude Code, Codex, Antigravity, or Grok CLI, or a running Claude Desktop app.
69
+ `usage` needs data from at least one of Claude Code, Codex, Antigravity, Grok CLI, or Muse Code, or a running Claude Desktop app.
70
70
 
71
71
  ## First Launch: Set Up the Status Line
72
72
 
@@ -85,13 +85,13 @@ Once set up, the bottom of the Claude Code window will show a status line like t
85
85
 
86
86
  ### On Screen
87
87
 
88
- - **Menu bar monitor:** Quota color-coded from green to red. Click for the full session, weekly, and per-project breakdown.
88
+ - **Menu bar monitor:** Quota color-coded from green to red. Click for the full session, weekly, and per-project breakdown. On macOS, the menu bar keeps at most three tools with the highest Session usage, in Claude → Codex → Antigravity → Grok → Muse order; the panel still shows all tools.
89
89
  - **Antigravity card:** Shows the Gemini pool by default. Tap the `Gemini ⇄` tag to switch to the separate Claude / GPT pool; the choice is remembered.
90
90
  - **Grok CLI card:** The weekly credit percentage from Grok CLI's local debug log. Its tokens also count toward cost and project totals.
91
- - **Muse Code spending:** Its tokens and cost count toward today's cost, project totals, reports, and the CLI. Muse keeps no quota data locally, so it has no card.
91
+ - **Muse Code card:** Shows 5-hour (Session) and weekly quota with reset countdowns. Available in all 15 quota themes, with a menu bar item and optional low, exhausted, and recovered quota notifications. Hidden automatically when Muse is not installed. Tokens and cost still count toward today's cost, project totals, reports, and the CLI.
92
92
  - **Outage alerts:** An orange-red banner when Claude Code, Claude API, or Codex API is down or degraded, read from their public status pages.
93
93
  - **Context and cache warnings:** The status line nudges you to `/clear` or `/compact` before the context window bloats, and says why the prompt cache missed.
94
- - **Hide what you don't use:** Hide the Claude Code, Codex, Grok CLI, or Antigravity section from the menu bar and panels in one click.
94
+ - **Hide what you don't use:** Hide the Claude Code, Codex, Grok CLI, Antigravity, or Muse Code section from the menu bar and panels in one click.
95
95
 
96
96
  ### Inside Claude Code
97
97
 
@@ -108,9 +108,9 @@ Once set up, the bottom of the Claude Code window will show a status line like t
108
108
  ### Reports and More
109
109
 
110
110
  - **HTML reports:** Daily and weekly token trends, project rankings, cost, and a Year in Review with a contribution heatmap. Export .html, .csv, or .png fully offline, with optional project-name masking.
111
- - **Terminal integration:** `usage status --json` hands your Claude Code, Codex, Antigravity, and Grok quota to Starship, tmux, or your own scripts. [Ready-made snippets](docs/DEVELOPMENT.md#quota-status-for-other-tools-usage-status).
111
+ - **Terminal integration:** `usage status --json` hands your Claude Code, Codex, Antigravity, Grok, and Muse quota to Starship, tmux, or your own scripts. [Ready-made snippets](docs/DEVELOPMENT.md#quota-status-for-other-tools-usage-status).
112
112
  - **AI Update Daily:** A daily public [page](https://aqua5230.github.io/ai-updates/) of Claude Code, Codex, and Antigravity changes, with plain-language summaries in five languages.
113
- - **Your layout:** Drag the panel anywhere, drag quota cards to reorder them, and switch among 16 themes. The UI follows your system language: Traditional Chinese, Simplified Chinese, English, Japanese, or Korean.
113
+ - **Your layout:** Drag the panel anywhere, drag quota cards to reorder them, and switch among 16 themes. The UI follows your system language: Traditional Chinese, Simplified Chinese, English, Japanese, or Korean. With four or more quota cards visible, all cards switch to a compact layout; three or fewer keep the usual layout.
114
114
 
115
115
  <details>
116
116
  <summary>Thresholds, versions, and fine print</summary>
@@ -124,8 +124,8 @@ Once set up, the bottom of the Claude Code window will show a status line like t
124
124
  - **Linux:** CI verifies `usage setup` on Ubuntu.
125
125
  - **Progress Concierge:** When you `/resume` a conversation that sat long enough for its cache to expire, it warns how many tokens the next message will re-send and suggests `/compact` first.
126
126
  - **Beginner Mode (macOS and Windows):** Terms appear above the prompt in your UI language. Press 9 to mark them understood; skipped terms come back after 1, 3, then 7 days. Understood terms return as a one-question multiple-choice quiz 7, 21, then 60 days later, at most one a day, and a wrong answer puts the term back in the hints. `/terms` opens your term history. Picking terms asks Claude Haiku through your Claude Code, and pauses while your 5-hour quota is at 90% or more.
127
- - **Quota-Aware Mode (macOS and Windows):** Claude Code gets one line with what is left and when it resets when a 5-hour quota passes 80%, 90%, or 95%, or a weekly quota passes 95%. It covers Claude Code, Codex, and Antigravity, says each level once per conversation, and treats each quota and model group separately, so a used-up one only matters for work that runs on it.
128
- - **Auto-start 5-hour session:** Claude gets Haiku, Antigravity gets Gemini 3.8 Flash Low, and Codex gets its cheapest model. The quota used is negligible. Checking your quota never sends a message; only this switch does.
127
+ - **Quota-Aware Mode (macOS and Windows):** Claude Code gets one line with what is left and when it resets when a 5-hour quota passes 80%, 90%, or 95%, or a weekly quota passes 95%. It covers Claude Code, Codex, Antigravity, and Muse, says each level once per conversation, and treats each quota and model group separately, so a used-up one only matters for work that runs on it.
128
+ - **Auto-start 5-hour session:** Claude gets Haiku, Antigravity gets Gemini 3.8 Flash Low, and Codex gets its cheapest model. The quota used is negligible.
129
129
  - **Panel:** It stays put when another app takes focus; a second click on the menu bar icon, or Escape, closes it. Card order is shared across every theme with quota cards (all except World Cup 2026) and survives restarts.
130
130
  - **HTML reports:** A "What you worked on" section lists the names Claude Code gave your recent conversations, and masking covers those titles too.
131
131
  - **AI Update Daily:** Unreviewed items show the original source text. The full history is kept.
@@ -203,7 +203,7 @@ Switch between **16 visual themes** directly from the UI:
203
203
  | Claude Code & Codex usage | ✅ | ✅ | ✅ |
204
204
  | Antigravity usage (Gemini and Claude / GPT) | ✅ | — | — |
205
205
  | Grok CLI usage | ✅ | — | — |
206
- | Muse Code token spend | ✅ | — | — |
206
+ | Muse Code quota, tokens, and cost | ✅ | — | — |
207
207
  | Claude Code & Codex service-status alerts | ✅ | — | — |
208
208
  | HTML deep reports & UI | ✅ | ✅ | — |
209
209
  | Claude Code helpers (Token Saver, Progress Concierge, Beginner and Quota-Aware modes, health check) | ✅ | — | — |
@@ -213,7 +213,7 @@ Switch between **16 visual themes** directly from the UI:
213
213
  ## When usage Isn't the Right Fit
214
214
 
215
215
  - You only live in the terminal and don't want another menu bar icon running in the background — a one-off CLI check fits better.
216
- - You don't use Claude Code, Codex, Antigravity, Grok CLI, or Claude Desktop — there's no usage data for `usage` to read.
216
+ - You don't use Claude Code, Codex, Antigravity, Grok CLI, Muse Code, or Claude Desktop — there's no usage data for `usage` to read.
217
217
  - You want a menu bar on Linux. Only macOS and Windows have one today, though the terminal interface (`uvx usage-cli`) runs on Linux.
218
218
 
219
219
  ## Windows Support
@@ -247,9 +247,10 @@ If the menu bar shows `--`, it's usually not broken — there's just no local da
247
247
 
248
248
  ## Privacy & Data Sources
249
249
 
250
- - **Local logs:** Claude Code, Codex, Grok CLI, and Muse Code numbers are read from log files on your machine. Their contents are never uploaded.
250
+ - **Local logs:** Claude Code, Codex, Grok CLI, and Muse Code token and cost numbers are read from log files on your machine. Their contents are never uploaded.
251
251
  - **Claude Desktop:** Without the Claude Code CLI or a status line, keep Claude Desktop open and `usage` reads its local plan-usage history. No cookies, login tokens, or API calls are needed. Reset times appear only when its local cache confirms them; they are never estimated.
252
252
  - **Antigravity**, only if you use it, needs network access: quota is fetched from Google's official quota endpoint with the OAuth credential the Antigravity CLI already stored after sign-in — read from macOS Keychain, Windows Credential Manager, or a local token file depending on CLI version. `usage` never writes that credential back and keeps any refreshed access token in memory only; the call itself reads quota metadata.
253
+ - **Muse quota:** Muse stores no quota file locally. `usage` runs `muse exec --json` through Muse's own sign-in and saves the returned quota to `~/.usage/muse_quota.json`. This connects to Muse and makes a real model call, using a little Muse quota. It runs in an empty folder with `--no-session-log`. With Muse installed and a conversation available, it fetches the first snapshot; later probes require a snapshot over 30 minutes old and a newer Muse conversation. After failure, it waits at least 30 minutes and requires new Muse usage before retrying. Hide its card under **Hide sections**.
253
254
  - **Other background network activity:** Public Claude and Codex status pages to flag outages, a public model-pricing table to estimate cost (built-in prices are used offline), and an occasional GitHub check for a new version.
254
255
  - **Beginner Mode**, only if you turn it on, sends Claude Code's latest answer to Claude Haiku through your own Claude Code sign-in to pick terms. Your term list stays in `~/.usage/glossary.json`.
255
256
  - **Long-term history:** Claude Code deletes transcripts older than 30 days by default. While the app runs, `usage` saves daily totals to `~/.usage/usage_snapshot.json` and `~/.usage/year_ledger.json` every 6 hours, so reports keep older days. Nothing leaves your machine. When you move to a new computer, copy the whole `~/.usage/` folder too.
@@ -16,7 +16,7 @@ from typing import Any, TypedDict
16
16
 
17
17
  from adapters import rate_limits
18
18
  from adapters.types import UsageEntry
19
- from loaders import agy_loader, agy_quota_probe, codex_loader
19
+ from loaders import agy_loader, agy_quota_probe, codex_loader, muse_quota_probe
20
20
  from loaders.claude_paths import claude_config_dirs
21
21
 
22
22
  _DISPATCH = {
@@ -303,6 +303,11 @@ def load_windows() -> dict[str, QuotaWindow]:
303
303
  windows[group_key] = window
304
304
  for model in group.models:
305
305
  windows[f"antigravity-model:{model.lower()}"] = window
306
+ muse = muse_quota_probe.read_cache()
307
+ if muse:
308
+ window = _window(muse["weekly"]["used_percent"], muse["weekly"]["resets_at"], 7 * 24 * 60)
309
+ if window:
310
+ windows["muse"] = window
306
311
  return windows
307
312
 
308
313
 
@@ -19,6 +19,9 @@
19
19
  "panel_world_cup": "世界盃 2026",
20
20
  "panel_ai_daily": "AI 更新日報",
21
21
  "switch_panel": "更換面板",
22
+ "settings_button": "⚙ 設定",
23
+ "statusline_sync_menu": "狀態列同步額度",
24
+ "statusline_sync_tooltip": "從 Claude Code 的狀態列讀取額度。關掉後,Claude 的額度就不會再更新。",
22
25
  "launch_at_login": "開機自動啟動",
23
26
  "reset_panel_position": "重設面板位置",
24
27
  "hide_sections_menu": "隱藏區塊",
@@ -74,8 +77,8 @@
74
77
  "service_degraded": "效能降級",
75
78
  "service_partial_outage": "部分中斷",
76
79
  "service_major_outage": "大規模中斷",
77
- "today_text": "今日:${cost} ({tokens} tokens)",
78
- "yesterday_text": "昨日:${cost} ({tokens} tokens)",
80
+ "today_label": "今日:",
81
+ "yesterday_label": "昨日:",
79
82
  "percent_used": "{value}% 已用",
80
83
  "reset_in": "重置 {time}",
81
84
  "reset_imminent": "即將重置",
@@ -109,6 +112,7 @@
109
112
  "agy_stale_tooltip": "顯示的是快取舊值。額度直接向官方 API 取得,通常每幾分鐘自動更新;出現舊值代表最近取用失敗(多半是 agy 尚未登入,或網路問題),成功後會自動恢復。",
110
113
  "grok_name": "Grok",
111
114
  "muse_name": "Muse",
115
+ "muse_stale_tooltip": "資料來自上次 Muse 額度探測,可能已過期;Muse 有新用量後會自動重試。",
112
116
  "grok_stale_minutes": "約 {minutes} 分鐘前",
113
117
  "grok_stale_hours": "約 {hours} 小時前",
114
118
  "grok_stale_tooltip": "資料來自 Grok CLI 本機 log,不是即時 API;請最近執行過 grok 指令後再查看,才會更新。",
@@ -577,6 +581,9 @@
577
581
  "panel_world_cup": "World Cup 2026",
578
582
  "panel_ai_daily": "AI Update Daily",
579
583
  "switch_panel": "Switch Panel",
584
+ "settings_button": "⚙ Settings",
585
+ "statusline_sync_menu": "Sync quota via status line",
586
+ "statusline_sync_tooltip": "Reads the Claude quota from Claude Code's status line. Turn it off and the Claude quota stops updating.",
580
587
  "launch_at_login": "Launch at Login",
581
588
  "reset_panel_position": "Reset panel position",
582
589
  "hide_sections_menu": "Hide Sections",
@@ -632,8 +639,8 @@
632
639
  "service_degraded": "Degraded performance",
633
640
  "service_partial_outage": "Partial outage",
634
641
  "service_major_outage": "Major outage",
635
- "today_text": "Today: ${cost} ({tokens} tokens)",
636
- "yesterday_text": "Yesterday: ${cost} ({tokens} tokens)",
642
+ "today_label": "Today:",
643
+ "yesterday_label": "Yesterday:",
637
644
  "percent_used": "{value}% used",
638
645
  "reset_in": "Resets in {time}",
639
646
  "reset_imminent": "Reset imminent",
@@ -667,6 +674,7 @@
667
674
  "agy_stale_tooltip": "Showing a cached value. Quota is fetched straight from the official API, usually updating every few minutes; an old value means the last fetch failed (often agy isn't signed in, or there's a network issue), and it recovers automatically once a fetch succeeds.",
668
675
  "grok_name": "Grok",
669
676
  "muse_name": "Muse",
677
+ "muse_stale_tooltip": "Data comes from the last Muse quota probe and may be outdated. It will retry automatically after Muse has new usage.",
670
678
  "grok_stale_minutes": "about {minutes} minutes ago",
671
679
  "grok_stale_hours": "about {hours} hours ago",
672
680
  "grok_stale_tooltip": "Data comes from Grok CLI's local log, not a live API. Run a grok command recently for it to update.",
@@ -1135,6 +1143,9 @@
1135
1143
  "panel_world_cup": "世界杯 2026",
1136
1144
  "panel_ai_daily": "AI 更新日报",
1137
1145
  "switch_panel": "切换面板",
1146
+ "settings_button": "⚙ 设置",
1147
+ "statusline_sync_menu": "状态栏同步额度",
1148
+ "statusline_sync_tooltip": "从 Claude Code 的状态栏读取额度。关闭后,Claude 的额度就不会再更新。",
1138
1149
  "launch_at_login": "开机自动启动",
1139
1150
  "reset_panel_position": "重设面板位置",
1140
1151
  "hide_sections_menu": "隐藏区块",
@@ -1190,8 +1201,8 @@
1190
1201
  "service_degraded": "性能降级",
1191
1202
  "service_partial_outage": "部分中断",
1192
1203
  "service_major_outage": "大规模中断",
1193
- "today_text": "今日:${cost} ({tokens} tokens)",
1194
- "yesterday_text": "昨天:${cost} ({tokens} tokens)",
1204
+ "today_label": "今日:",
1205
+ "yesterday_label": "昨天:",
1195
1206
  "percent_used": "{value}% 已用",
1196
1207
  "reset_in": "重置 {time}",
1197
1208
  "reset_imminent": "即将重置",
@@ -1225,6 +1236,7 @@
1225
1236
  "agy_stale_tooltip": "显示的是缓存旧值。额度直接从官方 API 获取,通常每隔几分钟自动更新;出现旧值说明最近获取失败(多半是 agy 尚未登录,或网络问题),成功后会自动恢复。",
1226
1237
  "grok_name": "Grok",
1227
1238
  "muse_name": "Muse",
1239
+ "muse_stale_tooltip": "资料来自上次 Muse 额度探测,可能已过期;Muse 有新用量后会自动重试。",
1228
1240
  "grok_stale_minutes": "约 {minutes} 分钟前",
1229
1241
  "grok_stale_hours": "约 {hours} 小时前",
1230
1242
  "grok_stale_tooltip": "资料来自 Grok CLI 本地日志,不是即时 API;请最近运行过 grok 指令后再查看,才会更新。",
@@ -1693,6 +1705,9 @@
1693
1705
  "panel_world_cup": "ワールドカップ 2026",
1694
1706
  "panel_ai_daily": "AI更新日報",
1695
1707
  "switch_panel": "パネル切替",
1708
+ "settings_button": "⚙ 設定",
1709
+ "statusline_sync_menu": "ステータスラインで使用量を同期",
1710
+ "statusline_sync_tooltip": "Claude Code のステータスラインから使用量を読み取ります。オフにすると Claude の使用量は更新されなくなります。",
1696
1711
  "launch_at_login": "ログイン時に起動",
1697
1712
  "reset_panel_position": "パネルの位置をリセット",
1698
1713
  "hide_sections_menu": "セクションを非表示",
@@ -1748,8 +1763,8 @@
1748
1763
  "service_degraded": "パフォーマンス低下",
1749
1764
  "service_partial_outage": "一部障害",
1750
1765
  "service_major_outage": "大規模障害",
1751
- "today_text": "今日: ${cost} ({tokens} tokens)",
1752
- "yesterday_text": "昨日: ${cost} ({tokens} tokens)",
1766
+ "today_label": "今日:",
1767
+ "yesterday_label": "昨日:",
1753
1768
  "percent_used": "{value}% 使用済み",
1754
1769
  "reset_in": "{time}後にリセット",
1755
1770
  "reset_imminent": "まもなくリセット",
@@ -1783,6 +1798,7 @@
1783
1798
  "agy_stale_tooltip": "キャッシュされた値を表示しています。利用枠は公式 API から直接取得し、通常数分ごとに自動更新されます。古い値が表示されるのは直近の取得に失敗したためです(多くの場合 agy が未サインイン、またはネットワークの問題)。取得に成功すると自動的に復旧します。",
1784
1799
  "grok_name": "Grok",
1785
1800
  "muse_name": "Muse",
1801
+ "muse_stale_tooltip": "前回の Muse 利用枠確認のデータです。古い可能性があります。Muse に新しい利用があると自動で再試行します。",
1786
1802
  "grok_stale_minutes": "約 {minutes} 分前",
1787
1803
  "grok_stale_hours": "約 {hours} 時間前",
1788
1804
  "grok_stale_tooltip": "データは Grok CLI のローカルログから読み取るもので、リアルタイム API ではありません。更新するには最近 grok コマンドを実行してください。",
@@ -2251,6 +2267,9 @@
2251
2267
  "panel_world_cup": "월드컵 2026",
2252
2268
  "panel_ai_daily": "AI 업데이트 일보",
2253
2269
  "switch_panel": "패널 전환",
2270
+ "settings_button": "⚙ 설정",
2271
+ "statusline_sync_menu": "상태 표시줄로 사용량 동기화",
2272
+ "statusline_sync_tooltip": "Claude Code 상태 표시줄에서 사용량을 읽습니다. 끄면 Claude 사용량이 더 이상 업데이트되지 않습니다.",
2254
2273
  "launch_at_login": "로그인 시 시작",
2255
2274
  "reset_panel_position": "패널 위치 재설정",
2256
2275
  "hide_sections_menu": "섹션 숨기기",
@@ -2306,8 +2325,8 @@
2306
2325
  "service_degraded": "성능 저하",
2307
2326
  "service_partial_outage": "부분 장애",
2308
2327
  "service_major_outage": "대규모 장애",
2309
- "today_text": "오늘: ${cost} ({tokens} tokens)",
2310
- "yesterday_text": "어제: ${cost} ({tokens} tokens)",
2328
+ "today_label": "오늘:",
2329
+ "yesterday_label": "어제:",
2311
2330
  "percent_used": "{value}% 사용됨",
2312
2331
  "reset_in": "{time} 후 초기화",
2313
2332
  "reset_imminent": "곧 초기화",
@@ -2341,6 +2360,7 @@
2341
2360
  "agy_stale_tooltip": "캐시된 값을 표시하고 있습니다. 사용량은 공식 API에서 직접 가져오며 보통 몇 분마다 자동 업데이트됩니다. 예전 값이 보이는 건 최근 가져오기에 실패했기 때문입니다(대개 agy 미로그인 또는 네트워크 문제). 가져오기에 성공하면 자동으로 복구됩니다.",
2342
2361
  "grok_name": "Grok",
2343
2362
  "muse_name": "Muse",
2363
+ "muse_stale_tooltip": "마지막 Muse 할당량 확인 데이터로, 오래되었을 수 있습니다. Muse에 새 사용량이 생기면 자동으로 다시 시도합니다.",
2344
2364
  "grok_stale_minutes": "약 {minutes}분 전",
2345
2365
  "grok_stale_hours": "약 {hours}시간 전",
2346
2366
  "grok_stale_tooltip": "데이터는 Grok CLI의 로컬 로그에서 읽으며 실시간 API가 아닙니다. 업데이트하려면 최근에 grok 명령을 실행하세요.",
@@ -94,7 +94,7 @@ _TERSE_REMINDER_MARKER = "usage-terse-reminder"
94
94
  _TERSE_REMINDER_MARKERS = (_TERSE_REMINDER_MARKER, "usage_terse_reminder")
95
95
  # Independent, opt-in Claude Code UserPromptSubmit hook.
96
96
  QUOTA_AWARE_HOOK_TARGET = Path(os.path.expanduser("~/.claude/usage-quota-aware.py"))
97
- QUOTA_AWARE_HOOK_VERSION = "1.2"
97
+ QUOTA_AWARE_HOOK_VERSION = "1.3"
98
98
  QUOTA_AWARE_MATCHER = ""
99
99
  _QUOTA_AWARE_MARKER = "usage-quota-aware"
100
100
  _QUOTA_AWARE_MARKERS = (_QUOTA_AWARE_MARKER, "usage_quota_aware")