@willh/copilotstatusline 0.2.1 → 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
@@ -53,7 +64,8 @@ copilotstatusline --install global Install a global binary command
53
64
  copilotstatusline --uninstall Remove an owned integration
54
65
  copilotstatusline --check Print integration status as JSON
55
66
  copilotstatusline --config <path> Use a custom formatter settings file
56
- copilotstatusline --version Print the package version
67
+ copilotstatusline -h Print help (alias: --help)
68
+ copilotstatusline -v Print the package version (alias: --version)
57
69
  ```
58
70
 
59
71
  When `--config` is combined with `--install`, the absolute config path is included in Copilot's command setting.