/usage help text does not explain mixed metric scopes
Nadie ha tomado este issue todavía.
- Lenguaje dominante
- Shell
- Estrellas
- 11.2k
- Forks
- 1.9k
- Merge medio
- 14 h 16 min
- PR fusionados (30 d)
- 6
Descripción
Describe the bug
The /usage command help text says:
Display session usage metrics and statistics
However, the command output combines metrics with three different scopes:
Activity · last 180 days · N messagesis aggregated from local history across multiple saved CLI sessions.Changes,AI Credits,Tokens, and the per-model breakdown describe the current session.Plandescribes account/plan usage for the current quota period.
Calling all of this "session usage" is misleading. In a new session with only one user prompt, /usage can report hundreds of messages and show a six-month activity graph, making it appear that either the session boundary or message count is incorrect.
Affected version
GitHub Copilot CLI 1.0.81-11
Steps to reproduce the behavior
- Use Copilot CLI across multiple sessions.
- Start a new session and send one prompt.
- Run
/usage. - Observe that the help describes session metrics, while the output includes a 180-day, multi-session message count and chart plus plan-period quota usage.
Representative output:
Activity · last 180 days · 861 messages
...
Changes +0 -0
AI Credits 2.72 (22h 1m 8s)
Tokens ↑ 23.3k (11.8k cached) • ↓ 179
gpt-5.6-sol ↑ 23.3k (11.8k cached) • ↓ 179
Plan ... 0% used • resets in 27 days
200 / 200,000 AIC
Expected behavior
The help text and documentation should make the scopes explicit. For example:
Display local activity history, current-session usage metrics, and plan quota usage
Ideally, the rendered output would also label each section's scope (for example, Local activity, Current session, and Plan period) so users do not have to infer it.
Additional context
- Operating system: Windows
- CPU architecture: x86_64
- Shell: PowerShell
- The current documentation describes
/usageas showing "session statistics," including current-session AI Credits, duration, code edits, and token usage. It does not explain that the command also includes local multi-session activity and account/plan-period quota information.
Guía de contribución
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Línea de trabajo
Localiza el texto de ayuda de /usage y la documentación referenciada en la incidencia, y luego inspecciona cómo la salida del comando etiqueta sus secciones. Actualiza la redacción para que sean explícitos los ámbitos de actividad local, las métricas de la sesión actual y las cuotas del período del plan; verifica que el texto de ayuda y la salida renderizada ya no describan todas las métricas como uso de la sesión.
Escrito por el modelo de indexación a partir del texto del issue.
Evaluación
- Stack tecnológico
- shell
- Área
- cli, documentation
- Tipo de issue
- Documentación
- Dificultad
- 2/5
- Tiempo estimado
- 1-3 horas
- Estado de actividad
- Activo
- Claridad
- Bastante claro
- Aptitud para principiantes
- 72/100