mirror of
https://github.com/Ark0N/Codeman.git
synced 2026-11-16 19:29:33 +01:00
feat(copilot): plan-usage chip row for the monthly premium-request quota (#662)
Squash of PR #662. The header plan-usage chip gains a Copilot row: the calendar-month premium-request quota, with the request counts and the reset in the tooltip, read every 10 minutes from GitHub's copilot_internal/user endpoint with the Copilot CLI's own sign-in token. It rides showPlanUsageLimits and is on by default while the CLI is installed and signed in; any failure leaves the chip without the row. Merge-time fixes by the maintainer: the gates (setting, then token, then the CLI probe) live in readCopilotPlanUsageIfEnabled() so a host with no Copilot sign-in never runs the login-shell probe each tick, with a test that Plan Usage Limits off means no request; the X-GitHub-Api-Version header the Copilot CLI itself does not send is dropped; and CLAUDE.md, architecture-invariants, README and copilot-integration describe the read. The hooks-config import in server.ts was merged with #666's. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
This commit is contained in:
1 parent
f80f107445
commit
34cf798b10
22 files changed
+642
-26
No files matched your search
+10
-1
@@ -72,7 +72,7 @@ output. The other CLIs expose no equivalent.
|
||||
| Docker cases, remote SSH cases | Yes | Yes |
|
||||
| Precise idle detection | Yes | Codex, Pi, OpenCode, OMP, Copilot, Gemini and Antigravity: same screen check, via their own prompt and working line. DeepSeek: reports its end of turn itself. Grok: generic cues only, unreliable |
|
||||
| Auto-resume when a usage limit resets | Yes | No |
|
||||
| Plan usage chip | Yes | No |
|
||||
| Plan usage chip | Yes | Codex (limits) and Copilot (monthly premium requests); the others no |
|
||||
| Approvals Inbox | Yes | DeepSeek and Codex as alerts (answer in the terminal); others no |
|
||||
| Read My Mind | Yes | No |
|
||||
| Ralph loop and its task tracker | Yes | No |
|
||||
@@ -280,6 +280,15 @@ GitHub's `copilot`, installed with `npm install -g @github/copilot` (CLI managem
|
||||
that for you). Codeman recognises it only when `--version` answers `GitHub Copilot CLI`, and
|
||||
`GET /api/copilot/status` reports the path and version that resolved.
|
||||
|
||||
**Quota in the plan usage chip.** While Copilot CLI is installed and signed in, the chip gains
|
||||
a **Copilot** row with the calendar-month premium-request quota (requests used and the reset in
|
||||
the tooltip). This is **on by default**, like the Codex usage poll: every 10 minutes the server
|
||||
asks `api.github.com` for the quota with Copilot's own sign-in token (read-only, redirects
|
||||
refused, the token never logged or stored). The token is read from `COPILOT_GITHUB_TOKEN`,
|
||||
`GH_TOKEN` or `GITHUB_TOKEN`, or from the plain-text `~/.copilot/config.json`, so a sign-in kept
|
||||
in the OS keychain (a macOS or desktop Linux keyring) shows no row. Any failure just leaves the row out. Turn off
|
||||
**Plan Usage Limits** in App Settings to stop the request.
|
||||
|
||||
**Signing in.** Codeman does not log it in: run `copilot` once and use `/login`, or sign in
|
||||
inside a Codeman tab. Copilot keeps the token in the OS keychain when there is one; a headless
|
||||
server has none, so it offers to save it as **plain text in `~/.copilot/config.json`**, which is
|
||||
|
||||
+6
-2
@@ -29,8 +29,12 @@ are Claude-only; [Agent CLIs](Agent-CLIs) has the table.
|
||||
|
||||
### Does Codeman send my code or prompts anywhere?
|
||||
|
||||
No. There is no telemetry, no analytics, and no phone-home. The only network traffic
|
||||
Codeman itself makes is between your browser and your server.
|
||||
No. There is no telemetry, no analytics, and no phone-home. Beyond the traffic between
|
||||
your browser and your server, the server makes a few requests of its own for features you use
|
||||
(the Codex usage poll, web push, webhooks). One is on by default: while GitHub Copilot CLI is
|
||||
installed and signed in, every 10 minutes the server asks `api.github.com` for your own
|
||||
premium-request quota with Copilot's own token. Turn off Plan Usage Limits in App Settings to
|
||||
stop it (see [Agent CLIs](Agent-CLIs)).
|
||||
|
||||
Your agent CLI is a separate matter: Claude Code talks to Anthropic, Codex talks to OpenAI,
|
||||
and so on. That traffic is the CLI's, on your own account, exactly as it would be in a
|
||||
|
||||
@@ -12,7 +12,10 @@ Getting Codeman onto a machine, verifying it works, updating it, and removing it
|
||||
| **An agent CLI** | At least one of [Claude Code](https://docs.anthropic.com/en/docs/claude-code), [OpenCode](https://opencode.ai), [Codex](https://developers.openai.com/codex/cli), [Antigravity](https://antigravity.google), [Gemini CLI](https://github.com/google-gemini/gemini-cli), [Pi](https://pi.dev), [Grok Build](https://github.com/xai-org/grok-build), [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness), [OMP](https://github.com/can1357/oh-my-pi). Plain shell sessions need none. See [Agent CLIs](Agent-CLIs). |
|
||||
|
||||
Codeman itself sends no telemetry and phones no home. The only network traffic is your
|
||||
browser to your server, and whatever the agent CLI you chose does on its own.
|
||||
browser to your server, and whatever the agent CLI you chose does on its own, plus the
|
||||
server's own few requests (Codex usage, web push, webhooks) and, on by default while Copilot
|
||||
CLI is installed and signed in, a read of your own GitHub Copilot quota every 10 minutes
|
||||
(Plan Usage Limits in App Settings turns it off; see [Agent CLIs](Agent-CLIs)).
|
||||
|
||||
## Route A: the installer (recommended)
|
||||
|
||||
|
||||
@@ -119,8 +119,9 @@ Recent Claude Code builds can compact a large idle session on their own shortly
|
||||
|
||||
## The plan usage chip
|
||||
|
||||
**Claude only.** A header chip showing live subscription usage, on by default on desktop and
|
||||
off on phones.
|
||||
A header chip showing live subscription usage: Claude (the 5-hour and weekly windows), Codex
|
||||
(its limits) and, while Copilot CLI is installed and signed in, Copilot's monthly premium-request
|
||||
quota. On by default on desktop and off on phones.
|
||||
|
||||
It works through a status line exporter that Codeman hands to `claude` as an ephemeral
|
||||
setting when it spawns the session, never written to disk, which posts Claude's own rate
|
||||
@@ -128,7 +129,8 @@ limit data back to Codeman. Your own status line (project-local, project, then
|
||||
`~/.claude/settings.json`) is wrapped and printed through, and a `claude` you run by hand
|
||||
outside Codeman sees nothing of it. Workspaces an older Codeman wrote the exporter into are
|
||||
cleaned up the first time a session starts there. Codex limits come from a read-only poll of
|
||||
its own app-server. Known limit: sessions inside a Docker case do not feed the chip yet.
|
||||
its own app-server, and the Copilot quota from a read-only request to `api.github.com` every
|
||||
10 minutes with Copilot's own token (on by default; Plan Usage Limits off stops it). Known limit: sessions inside a Docker case do not feed the chip yet.
|
||||
|
||||
The chip and the exporter are the same setting. Turning the chip on without the exporter
|
||||
would leave it showing a dash forever, so resolve it in one place: **App Settings**. A
|
||||
|
||||
@@ -101,8 +101,15 @@ Stated plainly, because a security page that only lists strengths is not useful:
|
||||
|
||||
## Privacy
|
||||
|
||||
No telemetry, no analytics, no phone-home. Codeman's only network traffic is between your
|
||||
browser and your server. Your agent CLI's traffic is its own, on your account.
|
||||
No telemetry, no analytics, no phone-home. Your agent CLI's traffic is its own, on your
|
||||
account. Beyond the traffic between your browser and your server, the server itself makes a few
|
||||
requests for features you use: the Codex usage poll, web push, and webhooks if you set one up.
|
||||
|
||||
The GitHub Copilot quota read behind the plan usage chip's **Copilot** row is **on by default
|
||||
while Copilot CLI is installed and signed in** (an absent plan-usage setting reads as on, even
|
||||
for a phone-only user whose chip is hidden). Every 10 minutes the server asks `api.github.com`,
|
||||
and nothing else, for your premium-request quota, with Copilot's own sign-in token. The token is
|
||||
never logged and redirects are refused. Turn off **Plan Usage Limits** in App Settings to stop it.
|
||||
|
||||
Two features send data outward, both off by default and both stated where they appear: voice
|
||||
dictation through your Claude login, and the Read My Mind prediction call.
|
||||
|
||||
@@ -148,7 +148,7 @@ The right side of the header. Almost all of these are off until you enable them
|
||||
| CPU / MEM | On | Server resource use. Drawn as a compact pill by default; see Header Stats Style below. |
|
||||
| File Viewer | On | Toggles the file browser panel. |
|
||||
| Settings gear | Always on | App Settings. |
|
||||
| Plan usage chip | On, desktop only | Live Claude subscription usage. Claude-only, and needs its telemetry exporter, which the same setting installs. |
|
||||
| Plan usage chip | On, desktop only | Live subscription usage: Claude (needs its telemetry exporter, which the same setting installs), Codex limits and the Copilot monthly quota. |
|
||||
| Session Manager | Off | The full session list, live and historical. |
|
||||
| Approvals bell | Off | Cross-session queue of prompts waiting on a human. Appears only when the count is above zero. Never shown on phones. |
|
||||
| Read My Mind 🧠 | Off | Predicts your next prompt for this case. Claude-only. |
|
||||
|
||||
Reference in new issue
Block a user