Support for Github Copilot with the omarchy quickshell agents plugin by wellatleastitried · Pull Request #7798 · omacom/omarchy

wellatleastitried · 2026-08-22T17:19:56Z

Adds support for displaying GitHub Copilot token usage and statistics in the
agents bar widget, alongside Claude, Codex, and Fireworks providers.

Changes

New collector script: bin/omarchy-agent-usage-copilot reads from
~/.copilot/session-store.db
Updated shell/plugins/agents/manifest.json to include copilot as an
enabled provider by default
Copilot usage now displays with daily totals, per-model breakdown, and
7-day history
Uses stored OAuth tokens (from sign-ins through third-party plugins like VSCode, copilot.vim, Jetbrains, etc) to query API usage limits OR an authenticated gh session as a fallback

Implementation Details

The collector reads from the Copilot session-store SQLite database and
aggregates token usage (input, output, cache read/write) by date and model.
Output follows the same JSON schema as other providers for seamless
integration with the existing panel UI.

Preview

Copilot

Pull request overview

This PR adds a fourth usage provider — GitHub Copilot — to the Omarchy Quickshell "agents" bar widget, which already displays usage for Claude, Codex, and Fireworks. It follows the plugin's established contract: the panel is display-only and simply renders whatever JSON record a bin/omarchy-agent-usage-<agent> collector prints, so adding a provider means shipping a collector plus enabling it in the manifest. The new collector reads the local Copilot SQLite session store (~/.copilot/session-store.db) and aggregates token usage by day and model into the shared record schema.

Changes:

New bin/omarchy-agent-usage-copilot Python collector that reads session-store.db and emits daily totals, per-model breakdown, and 7-day history as JSON.
Enables copilot by default in shell/plugins/agents/manifest.json and updates the widget description.
As noted in the PR, Copilot exposes no usage limits, so limits is intentionally left empty.

Tip

If you aren't ready for review, convert to a draft PR.
Click "Convert to draft" or run gh pr ready --undo.
Click "Ready for review" or run gh pr ready to reengage.

Reviewed changes

Copilot reviewed 1 out of 2 changed files in this pull request and generated no comments.

File	Description
`bin/omarchy-agent-usage-copilot`	New collector reading the Copilot session-store DB and emitting the shared usage-record JSON.
`shell/plugins/agents/manifest.json`	Enables the `copilot` provider by default and updates the panel description text.

Notes not attached to changed lines: the plugin README.md "Data" table lists each collector (claude, codex, fireworks) but was not updated to include copilot, and no assets/copilot.svg mark is shipped (the panel falls back to the bar glyph, which is supported).

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

- Add omarchy-agent-usage-copilot collector script with dual data sources - Reads session history from ~/.copilot/session-store.db for usage tracking - Fetches quota/limits from copilot_internal/user API using OAuth tokens - Includes copilot.svg and copilot-light.svg icons for bar widget - Update manifest.json to include copilot as an enabled provider by default - Copilot agent displays in the agents widget with usage and quota info The collector merges local historical token usage (per-model breakdown, 7-day stats) with account quota information from the official GitHub API.

Copilot

Pull request overview

Copilot reviewed 1 out of 4 changed files in this pull request and generated no new comments.

wellatleastitried · 2026-08-23T18:08:38Z

FYI: I noticed PR #7893 was submitted with a similar objective, just missing tokens per day and per model usage.

Copilot

Pull request overview

Copilot reviewed 1 out of 4 changed files in this pull request and generated no new comments.

gustavobragac · 2026-08-23T18:23:56Z

Thanks for the heads up — closed #7893 in favor of this one, since you've also got the token/session stats from session-store.db that mine couldn't provide (Copilot really has no local data for that outside the CLI's own store).

One thing to flag before a maintainer review does: your quota code's AUTH_HELP and docstring say the OAuth token is shared with "official Copilot clients (VS Code, JetBrains, CLI)" — I made the same claim initially and it's wrong for the standalone copilot CLI. Checked its binary directly with strings: no reference to ~/.config/github-copilot or apps.json anywhere, only COPILOT_HOME (~/.copilot/ by default, which is also where your session-store.db read already looks — so your two data sources actually come from two different credential stores, not one). Worth scoping that line to editor plugins only (VS Code, JetBrains, copilot.vim).

wellatleastitried · 2026-08-23T18:29:32Z

@gustavobragac I appreciate the warning. I will be sure to address that!

…ctiveDays, remove dead code, add tests

Copilot

Pull request overview

Copilot reviewed 2 out of 5 changed files in this pull request and generated no new comments.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Copilot

Pull request overview

Copilot reviewed 2 out of 5 changed files in this pull request and generated no new comments.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

wellatleastitried · 2026-08-23T22:25:32Z

Copilot

Pull request overview

Copilot reviewed 4 out of 7 changed files in this pull request and generated no new comments.

Suppressed comments (3)

Previously missed (3) — in code that hasn't changed since the last review.

test/shell.d/agent-usage-copilot-scanner-test.sh:66

This assertion locks in both incompatible behaviors: todayTokensByModel must contain numeric totals, while the detailed modelUsage.inputTokens must exclude cache tokens that are reported separately. Update the fixture expectations so the test catches both panel-schema regressions.

# Test 3: Model usage is tracked with correct schema
model_usage=$(jq '.todayTokensByModel.["gpt-4"]' <<<"$result")
[[ $(jq -r '.inputTokens' <<<"$model_usage") == "180" ]] ||
  fail "Copilot collector tracks todayTokensByModel with per-model breakdown" "$result"
pass "Copilot collector tracks todayTokensByModel with per-model breakdown"

test/shell.d/agent-usage-copilot-scanner-test.sh:129

The quota fixture uses a JSON number for entitlement, so it does not exercise the string-valued field returned by the current Copilot contract and misses the production failure above. Model the raw response with a numeric string.

                "entitlement": 100,

test/shell.d/agent-usage-copilot-scanner-test.sh:92

This creates two temporary directories outside TEST_HOME, but the EXIT trap only removes TEST_HOME, so every test run leaks both directories. Use unused paths beneath the already-trapped fixture directory instead.

result_empty=$(HOME="$(mktemp -d)" COPILOT_HOME="$(mktemp -d)" "$ROOT/bin/omarchy-agent-usage-copilot")

…ion as it is based on a false premise, but the TEST_HOME bug is fixed and the todayTokensByModel schema change are implemented

Copilot

Pull request overview

Copilot reviewed 4 out of 7 changed files in this pull request and generated no new comments.

Suppressed comments (1)

Previously missed (1) — in code that hasn't changed since the last review.

test/shell.d/agent-usage-copilot-scanner-test.sh:3

This test omits the repository's required set -euo pipefail preamble, so failures in unguarded setup commands and unset-variable mistakes can be silently carried into later assertions. Add the standard strict-mode line before sourcing base-test.sh (see docs/testing.md:38-46).

#!/bin/bash

source "$(dirname "$0")/base-test.sh"

Copilot

Pull request overview

Copilot reviewed 4 out of 7 changed files in this pull request and generated no new comments.

Copilot

Pull request overview

Copilot reviewed 4 out of 7 changed files in this pull request and generated 1 comment.

Copilot

Pull request overview

Copilot reviewed 4 out of 7 changed files in this pull request and generated no new comments.

wellatleastitried · 2026-08-31T03:39:51Z

Duplicate/related here: #8972 #9945

wellatleastitried · 2026-09-01T11:58:23Z

Resolves: #8425

get_oauth_token() only checked editor plugin config (apps.json/hosts.json/oauth.json under ~/.config/github-copilot), so machines using only the standalone Copilot CLI never got quota data even with a valid seat. The quota API accepts any GitHub token carrying Copilot entitlement, so an authenticated gh CLI works as a fallback via 'gh auth token'. Also softened AUTH_HELP text to mention the gh CLI path, and added scanner-test coverage for both the fallback succeeding and failing closed with no gh CLI available. Co-authored-by: JulianCodespoti <85543181+JulianCodespoti@users.noreply.github.com> Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

bjarneo · 2026-09-21T09:31:54Z

Automated duplication check: this pull request looks similar to #9945, which covers the same Copilot usage collector. I keep that one open and close this one to consolidate review.

If you feel this is the wrong decision, please open the PR again with a note on the difference.

wellatleastitried · 2026-09-21T13:32:45Z

I appreciate the cleanup, but I had already identified and documented the duplicates (#8972 #9945) in my own comment on this PR.

Since this was opened first includes and comprehensive test coverage (Tests 12-13 in the scanner-test), I'd prefer this one stay open for review rather than consolidating into a later PR.

Additionally, the collector from this PR has been tested in-depth, as it is currently a plugin listed on the the plugin marketplace where people have been able to use it and test it themselves.

@bjarneo Would you be able to reopen this? Or should I open a new PR that references this one?

Copilot AI balanced review requested due to automatic review settings August 22, 2026 17:19

Copilot started reviewing on behalf of wellatleastitried August 22, 2026 17:20

View session

Copilot AI reviewed Aug 22, 2026

View reviewed changes

wellatleastitried force-pushed the quattro branch from b18d722 to 4b052c5 Compare August 23, 2026 17:55

wellatleastitried requested a balanced review from Copilot August 23, 2026 17:58

Copilot started reviewing on behalf of wellatleastitried August 23, 2026 17:58

View session

Copilot AI reviewed Aug 23, 2026

View reviewed changes

Add quota reset date to limits display

96e2479

wellatleastitried requested a balanced review from Copilot August 23, 2026 18:15

Copilot started reviewing on behalf of wellatleastitried August 23, 2026 18:15

View session

gustavobragac mentioned this pull request Aug 23, 2026

Add GitHub Copilot collector to the agents panel #7893

Closed

Copilot AI reviewed Aug 23, 2026

View reviewed changes

Clarify OAuth token comes from editor plugins, not CLI

ed695a9

Fix Copilot collector: populate todaySessions, remove LIMIT 70, fix a…

91866ca

…ctiveDays, remove dead code, add tests

wellatleastitried requested a balanced review from Copilot August 23, 2026 18:33

Copilot started reviewing on behalf of wellatleastitried August 23, 2026 18:34

View session

Copilot AI reviewed Aug 23, 2026

View reviewed changes

wellatleastitried and others added 2 commits August 23, 2026 16:44

Clarify Copilot CLI session-store path

3c7ea4b

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Merge branch 'basecamp:quattro' into quattro

91cf6a8

wellatleastitried requested a balanced review from Copilot August 23, 2026 21:53

Copilot started reviewing on behalf of wellatleastitried August 23, 2026 21:53

View session

Copilot AI reviewed Aug 23, 2026

View reviewed changes

wellatleastitried and others added 2 commits August 23, 2026 17:06

Mention Copilot in AI manual

1e0a120

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Include premium request usage in Copilot limit label

abac8a2

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

wellatleastitried requested a balanced review from Copilot August 23, 2026 22:25

wellatleastitried requested a balanced review from Copilot August 28, 2026 04:07

Copilot started reviewing on behalf of wellatleastitried August 28, 2026 04:08

View session

Copilot AI reviewed Aug 28, 2026

View reviewed changes

fix: addressed copilot suggestions, ignored 'entitlement' recommendat…

e870820

…ion as it is based on a false premise, but the TEST_HOME bug is fixed and the todayTokensByModel schema change are implemented

wellatleastitried requested a balanced review from Copilot August 28, 2026 05:03

Copilot started reviewing on behalf of wellatleastitried August 28, 2026 05:03

View session

Copilot AI reviewed Aug 28, 2026

View reviewed changes

fix: addressed missing 'set -euo pipefail'

f4281cc

wellatleastitried requested a balanced review from Copilot August 28, 2026 13:32

Copilot started reviewing on behalf of wellatleastitried August 28, 2026 13:32

View session

Copilot AI reviewed Aug 28, 2026

View reviewed changes

wellatleastitried added 2 commits August 29, 2026 14:08

Addressed potential resource limit issues when reading database

c66695a

Removed unnecessary tmp file, oopsies

18478a1

wellatleastitried requested a balanced review from Copilot August 29, 2026 19:11

Copilot started reviewing on behalf of wellatleastitried August 29, 2026 19:12

View session

Copilot AI reviewed Aug 29, 2026

View reviewed changes

Comment thread test/shell.d/agent-usage-copilot-scanner-test.sh Resolved

fix: addressed test missing collectors real endpoint shape

8a23c27

wellatleastitried requested a balanced review from Copilot August 29, 2026 19:43

Copilot started reviewing on behalf of wellatleastitried August 29, 2026 19:43

View session

Copilot AI reviewed Aug 29, 2026

View reviewed changes

Merge remote-tracking branch 'origin/quattro' into quattro

9c37f34

ryanrhughes requested review from dhh and ryanrhughes as code owners September 8, 2026 16:50

aholbreich mentioned this pull request Sep 9, 2026

Triage data: 78 open PRs are 16 distinct fixes (verified by shared file) #11049

Closed

bjarneo closed this Sep 21, 2026

Conversation

wellatleastitried commented Aug 22, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Changes

Implementation Details

Preview

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

wellatleastitried commented Aug 23, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

gustavobragac commented Aug 23, 2026

Uh oh!

wellatleastitried commented Aug 23, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

wellatleastitried commented Aug 23, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

wellatleastitried commented Aug 31, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

wellatleastitried commented Sep 1, 2026

Uh oh!

bjarneo commented Sep 21, 2026

Uh oh!

wellatleastitried commented Sep 21, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

wellatleastitried commented Aug 22, 2026 •

edited

Loading

wellatleastitried commented Aug 23, 2026 •

edited

Loading

wellatleastitried commented Aug 31, 2026 •

edited

Loading

wellatleastitried commented Sep 21, 2026 •

edited

Loading