chronicle-stats GitHub Copilot plugin: install and usage

Q: How do I install chronicle-stats in GitHub Copilot?

Run `copilot plugin install chronicle-stats@awesome-copilot`.

What chronicle-stats does

chronicle-stats gives you a local view of GitHub Copilot token usage. It breaks the data down by day, model, and session, so you can inspect where usage comes from. The plugin also provides tips for using Copilot more economically.

You need the GitHub Copilot app with canvas support and Node 22.13 or newer. The extension uses node:sqlite, so it will not load on older Node versions. Install it with copilot plugin install chronicle-stats@awesome-copilot.

Install this plugin when you want a local breakdown of Copilot token usage. It is a poor fit for a setup without GitHub Copilot or canvas support.

What it helps with

review Copilot token usage by day
compare usage across models
inspect individual Copilot sessions
get tips for reducing token usage

Example prompts for the agent

Show my Copilot token usage by day.
Compare model usage across my sessions.
Give me tips for using Copilot with fewer tokens.

How to install chronicle-stats

Command from the source

copilot plugin install chronicle-stats@awesome-copilot

From the same set554

The whole set →

git-commit official github This skill reviews Git changes, stages related files, and creates Conventional Commits. Use it when you want an agent to make one commit or split work into separate commits. GitHub Copilot 47,165installs excalidraw-diagram-generator official github Turn a plain-language description into an Excalidraw diagram. Useful for mapping processes, system structure, and relationships between entities. GitHub Copilot 31,639installs multi-stage-dockerfile official github This skill guides GitHub Copilot in writing multi-stage Dockerfiles for different languages and frameworks. Use it when the final runtime image should contain fewer build dependencies. GitHub Copilot 29,688installs documentation-writer official github Skill that turns the agent into a technical writer following the Diátaxis framework: tutorials, how-to guides, reference, and explanation. Proposes structure before writing. GitHub Copilot 27,757installs prd official github Turns a feature idea into a structured PRD with user stories, technical requirements, and risks. Use it when planning a software feature or an AI-powered one. GitHub Copilot 24,035installs refactor official github This skill reshapes existing code without changing its external behavior. Use it for gradual cleanup of large functions, duplication, weak types, and code smells. GitHub Copilot 22,321installs java-springboot official github Gives GitHub Copilot Spring Boot development practices, from project layout to tests and security. Use it when writing or reviewing Java application code. GitHub Copilot 21,272installs create-readme official github This skill reviews a project and creates a structured README.md. Use it when the repository needs clear documentation based on its actual files and code. GitHub Copilot 19,081installs

Questions about chronicle-stats

How do I install chronicle-stats in GitHub Copilot?

Run copilot plugin install chronicle-stats@awesome-copilot.

What does chronicle-stats do?

The plugin shows local GitHub Copilot token usage by day, model, and session. It also provides tips for using Copilot more economically.

What does chronicle-stats require?

It requires the GitHub Copilot app with canvas support and Node 22.13 or newer. The extension uses node:sqlite.

Source text

chronicle-stats · MIT

# My AI Usage Plugin

See your local Copilot token usage by day, model, and session, and get tips to use it more efficiently.

## Requirements

- GitHub Copilot app with canvas support
- Node 22.13+ (the extension uses `node:sqlite` and will not load on older Node versions)

## Installation

```bash
copilot plugin install chronicle-stats@awesome-copilot
```

## Source

This plugin is part of [Awesome Copilot](https://github.com/github/awesome-copilot).

## License

MIT

chronicle-stats — GitHub Copilot plugin: install and usage