Make reports all-time by default

Author: ericweichun

CHANGELOG.en.md

@@ -7,6 +7,10 @@ Format follows [Keep a Changelog](https://keepachangelog.com/).
 
 ## [Unreleased]
 
+### Changed
+- **README now frames this fork more clearly as Codex-first**: clarified Codex as the primary path, Claude Code as optional, and documented the Project Usage all-time range.
+- **Reports now default to all-time**: the popover Analyze button and `usage_cli.py report` now generate all-data reports by default; use `--last30` in the CLI for the previous rolling 30-day range.
+
 ## [0.11.4+codex.2] - 2026-05-26
 
 ### Fixed

CHANGELOG.md

@@ -6,6 +6,10 @@
 
 ## [Unreleased]
 
+### 變更
+- **README 改成更明確的 Codex-first fork 說明**：補清楚 Codex 是主要流程、Claude Code 是可選整合，並同步 Project Usage 的 all-time range。
+- **Report 預設改為 all-time**：popover 的「分析」與 `usage_cli.py report` 現在預設產生全部資料報告；CLI 需要近 30 天時可使用 `--last30`。
+
 ## [0.11.4+codex.2] - 2026-05-26
 
 ### 修正

README.en.md

@@ -8,7 +8,7 @@
 [![Platform](https://img.shields.io/badge/platform-macOS-lightgrey.svg)](https://www.apple.com/macos/)
 [![License: AGPL-3.0](https://img.shields.io/badge/license-AGPL--3.0-blue.svg)](LICENSE)
 
-`usage` is a macOS menu bar tool that pins your **Codex** usage to the top-right of your screen, while keeping **Claude Code** as an optional integration. Click the icon for a popover showing Session, Weekly, per-project usage (today / 7-day / monthly), and today's token usage and cost estimate.
+`usage` is a macOS menu bar tool that pins your **Codex** usage to the top-right of your screen, while keeping **Claude Code** as an optional integration. Click the icon for a popover showing Session, Weekly, per-project usage (today / 7-day / monthly / all-time), and today's token usage and cost estimate; click Analyze to generate an all-time HTML report.
 
 It **never calls the Anthropic / OpenAI API** and **never reads the Keychain**, so it avoids the observer effect of "pinging once a minute counts as usage."
 
@@ -185,13 +185,13 @@ source .venv/bin/activate
 python3 main.py
 ```
 
-- **Menu bar format:** `🐾 37%`. If Codex usage is also detected, a Codex suffix is appended: `🐾 37% · 📜 10%`.
+- **Menu bar format:** with Codex only, it shows `📜 10%`. If Claude Code usage is also detected, it shows `🐾 37% · 📜 10%`.
 
   <img src="docs/menubar.png" alt="menu bar display" width="240">
 
 - **Click the icon to expand the popover.** It has four sections:
-  1. Two cards for Claude Code and Codex. Each shows Session and Weekly progress bars with reset countdowns.
-  2. A projects card listing the top three projects by usage. Click the button in the top-right corner to cycle between today / 7-day / monthly views.
+  1. Two cards for Claude Code and Codex. Codex is the primary path; Claude Code remains optional when it is not installed.
+  2. A projects card listing the top three projects by usage. Click the button in the top-right corner to cycle between today / 7-day / monthly / all-time views.
   3. A footer card showing current rate, sync status, and today's token usage and cost estimate (Claude uses the actual `costUSD` from its log when available; Codex cost is estimated from token count × pricing table).
   4. Two buttons: "Refresh now" and "Quit".
 - **Panel**: click the **Switch Panel** button in the top-right corner to change panel styles. Nine built-in panels are available — **Classic** (clean light cards), **Matrix** (neon green digital rain), **Windows 95** (retro Win95 interface), **Newspaper** (aged newsprint), **Cloud Observation** (weather-station glass cards), **Midnight Aquarium** (deep-sea animation), **Prism Arcade** (rainbow holographic animation), **Black Hole** (rotating accretion disk), and the brand-new **World Cup 2026** — FIFA broadcast HUD with a green pitch, stick-figure players that chase and kick the ball, and bidirectional duel bars instead of standard progress bars.
@@ -223,9 +223,9 @@ python3 main.py --tui
 
 Press `Ctrl+C` to exit.
 
-## Reports and deep analytics (CLI)
+## Reports and deep analytics
 
-Beyond the menu bar and TUI, there's an analytics CLI entrypoint `usage_cli.py` for exporting HTML reports or running an interactive terminal dashboard:
+Beyond the menu bar and TUI, the popover's **Analyze** button generates an **all-time HTML report**. If you want a specific range, the `usage_cli.py` analytics entrypoint can export HTML reports or run an interactive terminal dashboard:
 
 <p align="center">
   <img src="docs/report.en.png" alt="HTML report screen: Your AI Usage Recap" width="520">
@@ -241,8 +241,9 @@ python3 usage_cli.py
 python3 usage_cli.py claude
 python3 usage_cli.py codex
 
-# Generate an HTML report and open it in your default browser (default range: last 30 days)
+# Generate an HTML report and open it in your default browser (default range: all data)
 python3 usage_cli.py report
+python3 usage_cli.py report --last30            # last 30 days
 python3 usage_cli.py report --today              # today
 python3 usage_cli.py report --week               # this week
 python3 usage_cli.py report --month              # this month

README.md

@@ -8,7 +8,7 @@
 [![Platform](https://img.shields.io/badge/platform-macOS-lightgrey.svg)](https://www.apple.com/macos/)
 [![License: AGPL-3.0](https://img.shields.io/badge/license-AGPL--3.0-blue.svg)](LICENSE)
 
-`usage` 是一個 macOS menu bar（螢幕右上角的選單列）小工具，把 **Codex** 的用量釘在你的螢幕右上角，並保留 **Claude Code** 作為可選整合。點開可以看到 Session、Weekly、各專案用量（今日 / 7 日 / 月），以及今日 token 用量與成本估算。
+`usage` 是一個 macOS menu bar（螢幕右上角的選單列）小工具，把 **Codex** 的用量釘在你的螢幕右上角，並保留 **Claude Code** 作為可選整合。點開可以看到 Session、Weekly、各專案用量（今日 / 7 日 / 月 / 全部），以及今日 token 用量與成本估算；按「分析」會產生 all-time HTML report。
 
 不呼叫 Anthropic / OpenAI 的 API（接口）、也不讀 Keychain（macOS 內建的密碼保險箱），所以不會發生「自己每分鐘 ping 一次也算用量」這種事。
 
@@ -187,13 +187,13 @@ source .venv/bin/activate
 python3 main.py
 ```
 
-- **選單列那行字長這樣**：`🐾 37%`；如果同時有 Codex 用量，會變成 `🐾 37% · 📜 10%`：
+- **選單列那行字長這樣**：只有 Codex 時是 `📜 10%`；如果同時有 Claude Code 用量，會變成 `🐾 37% · 📜 10%`：
 
   <img src="docs/menubar.png" alt="menu bar 上方顯示樣式" width="240">
 
 - **點一下會展開 popover**，分四塊：
-  1. 上面兩張卡片分別是 Claude Code 跟 Codex；每張各有 Session 跟 Weekly 兩條進度條
-  2. 專案用量卡：列出近期用量前三名的專案，可點右上角按鈕在「今日 / 7 日 / 月」三段之間切換
+  1. 上面兩張卡片分別是 Claude Code 跟 Codex；Codex 是主要流程，Claude Code 沒裝時會自然維持可選狀態
+  2. 專案用量卡：列出近期用量前三名的專案，可點右上角按鈕在「今日 / 7 日 / 月 / 全部」之間切換
   3. 最下面那張小卡是目前速率、同步狀態、今日 token 用量與成本估算（Claude 若 log 有提供實際金額則直接顯示；Codex 成本為依 token 數估算）
   4. 兩顆按鈕：「立即更新」、「結束」
 - **面板**：點右上角「更換面板」按鈕可切換面板樣式。目前內建九款面板——「預設」（簡潔白色卡片）、「駭客任務」（黑底螢光綠＋數位雨動畫）、「視窗 95」（Windows 95 復古介面）、「復古報紙」（米黃報紙風）、「雲圖觀測」（氣象風玻璃卡片）、「午夜水族箱」（深海動畫）、「稜鏡街機」（彩虹全息動畫）、「黑洞視界」（旋轉吸積盤）、以及全新「世界盃 2026」——FIFA 轉播 HUD 風格，鮮綠球場、棒人球員追球踢球互動動畫、雙向對戰記分條。
@@ -225,9 +225,9 @@ python3 main.py --tui
 
 按 `Ctrl+C` 退出。
 
-## 報告與深度分析（CLI）
+## 報告與深度分析
 
-除了選單列跟 TUI，還有一個分析用的 CLI 進入點 `usage_cli.py`，可以匯出 HTML 報告、或在終端機開互動式 dashboard（儀表板，互動式統計面板）：
+除了選單列跟 TUI，popover 裡的「分析」按鈕會直接產生 **all-time HTML report**。如果你想指定時間範圍，也可以用 CLI 進入點 `usage_cli.py` 匯出 HTML 報告、或在終端機開互動式 dashboard（儀表板，互動式統計面板）：
 
 <p align="center">
   <img src="docs/report.png" alt="HTML 報告畫面：你的 AI 用量回顧" width="520">
@@ -243,8 +243,9 @@ python3 usage_cli.py
 python3 usage_cli.py claude
 python3 usage_cli.py codex
 
-# 產生 HTML 報告並用預設瀏覽器打開（預設範圍：近 30 天）
+# 產生 HTML 報告並用預設瀏覽器打開（預設範圍：全部資料）
 python3 usage_cli.py report
+python3 usage_cli.py report --last30            # 近 30 天
 python3 usage_cli.py report --today              # 今日
 python3 usage_cli.py report --week               # 本週
 python3 usage_cli.py report --month              # 本月

assets/panels/aquarium.html

@@ -843,7 +843,8 @@ <h1 data-i18n="projects_title">Project Usage</h1>
       }
       const bridge = window.webkit && window.webkit.messageHandlers && window.webkit.messageHandlers.usage;
       if (bridge && typeof bridge.postMessage === "function") {
-        bridge.postMessage(button.dataset.action);
+        const action = button.dataset.action === "analyze" && projectRange === "all" ? "analyze_all" : button.dataset.action;
+        bridge.postMessage(action);
       }
     });
 

assets/panels/black_hole.html

@@ -739,7 +739,8 @@ <h1 data-i18n="projects_title">Project Usage</h1>
       }
       const bridge = window.webkit && window.webkit.messageHandlers && window.webkit.messageHandlers.usage;
       if (bridge && typeof bridge.postMessage === "function") {
-        bridge.postMessage(button.dataset.action);
+        const action = button.dataset.action === "analyze" && projectRange === "all" ? "analyze_all" : button.dataset.action;
+        bridge.postMessage(action);
       }
     });
 

assets/panels/classic.html

@@ -587,7 +587,8 @@ <h1 data-i18n="projects_title">Project Usage</h1>
       }
       const bridge = window.webkit && window.webkit.messageHandlers && window.webkit.messageHandlers.usage;
       if (bridge && typeof bridge.postMessage === "function") {
-        bridge.postMessage(button.dataset.action);
+        const action = button.dataset.action === "analyze" && projectRange === "all" ? "analyze_all" : button.dataset.action;
+        bridge.postMessage(action);
       }
     });
 

assets/panels/cloud_observation.html

@@ -825,7 +825,8 @@ <h1 data-i18n="projects_title">Project Usage</h1>
       }
       const bridge = window.webkit && window.webkit.messageHandlers && window.webkit.messageHandlers.usage;
       if (bridge && typeof bridge.postMessage === "function") {
-        bridge.postMessage(button.dataset.action);
+        const action = button.dataset.action === "analyze" && projectRange === "all" ? "analyze_all" : button.dataset.action;
+        bridge.postMessage(action);
       }
     });
 

assets/panels/matrix.html

@@ -689,7 +689,8 @@ <h1 data-i18n="projects_title"></h1>
       }
       const bridge = window.webkit && window.webkit.messageHandlers && window.webkit.messageHandlers.usage;
       if (bridge && typeof bridge.postMessage === "function") {
-        bridge.postMessage(button.dataset.action);
+        const action = button.dataset.action === "analyze" && projectRange === "all" ? "analyze_all" : button.dataset.action;
+        bridge.postMessage(action);
       }
     });
 

assets/panels/newspaper.html

@@ -652,7 +652,8 @@ <h1 data-i18n="projects_title">Project Usage</h1>
       }
       const bridge = window.webkit && window.webkit.messageHandlers && window.webkit.messageHandlers.usage;
       if (bridge && typeof bridge.postMessage === "function") {
-        bridge.postMessage(button.dataset.action);
+        const action = button.dataset.action === "analyze" && projectRange === "all" ? "analyze_all" : button.dataset.action;
+        bridge.postMessage(action);
       }
     });