@willh/copilotstatusline 0.2.2 → 0.2.3

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.
package/README.md CHANGED
@@ -43,6 +43,17 @@ The installer merges the following keys into the existing Copilot settings and p
43
43
 
44
44
  Restart Copilot CLI after changing its settings.
45
45
 
46
+ ## Local token usage history
47
+
48
+ Every valid Copilot status payload is recorded automatically as a local token-usage entry. No formatter setting or separate collector script is required. Records use the TokenUsageInsights-compatible JSONL format and are stored at:
49
+
50
+ - `$COPILOT_HOME/usage/usage-YYYY-MM-DD.jsonl`, or `~/.copilot/usage/usage-YYYY-MM-DD.jsonl` by default;
51
+ - `$COPILOT_HOME/copilotstatusline-usage-state.json` for per-session delta tracking.
52
+
53
+ The history includes token counters plus local session metadata such as the session name, working directory, and transcript path. It is never uploaded, and status rendering does not make network calls. Set `COPILOTSTATUSLINE_DISABLE_USAGE_RECORDING=1` to disable recording. Uninstalling the status-line integration preserves existing history.
54
+
55
+ TokenUsageInsights reads `~/.copilot/usage` by default. If `COPILOT_HOME` points elsewhere, set TokenUsageInsights' `COPILOT_DIR` to the same directory.
56
+
46
57
  ## Command line
47
58
 
48
59
  ```text