feat: manage AI providers without CodexBar

Author: bernardopg

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -39,7 +39,7 @@ body:
         Quickshell:
         Compositor:
         Distro:
-        bash/node/jq/curl:
+        bash/jq/curl:
     validations:
       required: true
   - type: textarea
@@ -75,4 +75,4 @@ body:
       placeholder: |
         jq . plugin.json
         bash -n providers/get-provider-usage providers/get-copilot-usage providers/get-claude-usage
-        ./providers/get-provider-usage "$(command -v codexbar)" "codex,claude,copilot" "cli" ./providers/get-copilot-usage
+        ./providers/get-provider-usage "codex,claude,copilot" ./providers/get-copilot-usage

.github/workflows/ci.yml

@@ -165,7 +165,7 @@ jobs:
           from pathlib import Path
 
           # collect stub IDs: get-<id>-usage (strip known non-provider scripts)
-          skip = {'provider', 'provider-wrapper', 'copilot', 'claude'}
+          skip = {'provider', 'provider-wrapper', 'copilot', 'claude', 'codex', 'provider-health'}
           stubs = set()
           for f in Path('providers').glob('get-*-usage'):
               name = f.name.removeprefix('get-').removesuffix('-usage')
@@ -237,7 +237,7 @@ jobs:
 
       - name: Smoke test — get-provider-usage single provider (error path)
         run: |
-          OUT="$(providers/get-provider-usage "" "openrouter" "cli" "" 2>/dev/null || true)"
+          OUT="$(providers/get-provider-usage "openrouter" "" 2>/dev/null || true)"
           echo "$OUT" | jq --exit-status '. | type == "array" and length > 0' >/dev/null || {
             echo "::error::get-provider-usage did not return a non-empty JSON array"
             echo "Output was: ${OUT}"
@@ -256,7 +256,7 @@ jobs:
           for stub in providers/get-*-usage; do
             name="$(basename "$stub")"
             case "$name" in
-              get-provider-usage|get-copilot-usage|get-claude-usage) continue ;;
+              get-provider-usage|get-provider-health|get-copilot-usage|get-claude-usage|get-codex-usage) continue ;;
             esac
             # Each stub must exec get-provider-wrapper — verify it contains the pattern
             grep -q 'get-provider-wrapper' "$stub" || {
@@ -266,6 +266,22 @@ jobs:
           done
           exit "$FAIL"
 
+      - name: Smoke test — prerequisite health schema
+        run: |
+          OUT="$(providers/get-provider-health "codex,perplexity")"
+          echo "$OUT" | jq --exit-status '
+            type == "array" and length == 2 and
+            all(.[]; has("provider") and has("status") and has("detail"))
+          ' >/dev/null
+
+      - name: Reject removed aggregation dependency
+        run: |
+          removed_name="codex""bar"
+          if grep -Rin --exclude-dir=.git --exclude='screenshot*.png' "$removed_name" .; then
+            echo "::error::Removed aggregation dependency is still referenced"
+            exit 1
+          fi
+
   # ─── qml ─────────────────────────────────────────────────────────────────────
   qml:
     name: QML lint

AiOverviewControlSettings.qml

@@ -2,6 +2,29 @@
 
 ## [Unreleased]
 
+## 1.3.0 - 2026-06-10
+
+### Architecture
+- Removed the external aggregation executable and its settings, detection, dispatcher arguments, documentation, and diagnostics.
+- Added a native Codex adapter using the official `codex app-server` protocol and `account/rateLimits/read`.
+- Preserved Copilot quota collection through the authenticated GitHub session without an external aggregator.
+- Added provider prerequisite health checks and a truthful coverage model: quota, local analytics, authentication, or informational.
+
+### Providers
+- Replaced undocumented Cloudflare, Cohere, Fireworks, MiniMax, GLM, and AI21 quota claims with documented authentication checks or explicit informational states.
+- Added Ollama `/api/ps` running-model status alongside `/api/tags`.
+- Added upstream verification policy and source links in `docs/provider-verification.md`.
+
+### UI and settings
+- Added compact and comfortable dashboard density modes.
+- Added provider filtering when more than eight cards are visible.
+- Rebuilt settings around provider health, telemetry coverage, informational coverage, and plugin-managed diagnostics.
+- Removed obsolete source mode and external-binary path controls.
+
+### Quality
+- Updated CI for the new dispatcher contract, health schema, and a regression check preventing the removed dependency from returning.
+- Rebuilt English, Brazilian Portuguese, and Simplified Chinese locale bundles with key parity.
+
 ## 1.2.4 - 2026-05-26
 
 ### Dashboard — UX
@@ -35,7 +58,7 @@
 - Pill settings: added pill display options (single/multi accent, label visibility) to the Settings panel.
 
 ### Providers — New
-- **Warp** (`warp`): codexbar fallback + note-card.
+- **Warp** (`warp`): provider note-card.
 - **Qwen / DashScope** (`qwen`): key validation via DashScope compatible-mode models endpoint; note-card (no public balance API).
 - **Vertex AI** (`vertexai`): `gcloud auth print-access-token` check; note-card (no programmatic quota endpoint).
 - Added all 3 providers to `availableProviderOptions`, `providerName()`, `iconForProvider()`, `providerAccent()`, and `allProviders` in Settings.
@@ -86,7 +109,7 @@
 - Polished provider cards, metric tiles, overview styling, hover states, and displayed provider counts.
 - Fixed Claude daily totals to use the current weekday instead of a hard-coded weekday index.
 - Fixed the plugin author metadata.
-- Added `codexbar` timeout handling and safer shell interpolation in usage helpers.
+- Added external-helper timeout handling and safer shell interpolation in usage helpers.
 - CI: restored `actions/checkout@v6.0.2` and `softprops/action-gh-release@v3.0.0` (versões corretas, não existentes antes de 2026).
 - Release: corrigido `zip -r "$ZIP" -@` → `zip "$ZIP" -@` (flags `-r` e `-@` são mutuamente exclusivos).
 - Release: substituídas duas etapas separadas `shogo82148/actions-upload-release-asset` pelo parâmetro `files:` nativo do `softprops/action-gh-release@v3.0.0`.
@@ -97,18 +120,18 @@
 ## 1.2.0 - 2026-04-30
 
 - Added a local `get-provider-usage` backend so AiOverviewControl no longer depends on another DMS plugin for provider aggregation.
-- Made `codexbar` an optional executable fallback instead of a hard plugin requirement.
+- Made the provider aggregator optional instead of a hard plugin requirement.
 - Added native/fallback provider handling for Claude, Copilot, Gemini, and OpenRouter with structured per-provider errors.
 - Improved dashboard responsiveness with adaptive cards, grids, provider controls, and long-text handling.
 - Made **Show Provider Errors** actually filter provider cards when disabled.
 - Updated settings copy to describe local helpers, fallback source mode, and optional fallback binary behavior.
 - Reworked the user documentation in Portuguese with a shorter README and focused guides under `docs/`.
 - Added practical installation, configuration, provider, troubleshooting, and architecture references.
-- Clarified that the plugin is self-contained in `AiOverviewControl` and uses the `codexbar` executable only as a provider fallback, not as another DMS plugin.
+- Clarified that the plugin is self-contained in `AiOverviewControl`.
 
 ## 1.1.3 - 2026-04-29
 
-- Fixed Copilot on Linux by bypassing the unsupported CodexBar `copilot --source cli` path.
+- Fixed Copilot on Linux by using the authenticated GitHub session directly.
 - Added `get-copilot-usage`, which uses the authenticated GitHub session to read real Copilot subscription quota data.
 - Mapped Copilot Premium, Chat, and Completions windows into the same provider-card data model used by the other providers.
 - Updated provider-card labels so named quota windows such as Premium and Chat are shown consistently.
@@ -117,7 +140,7 @@
 
 - Normalized provider display logic so cards use the same current window, weekly window, account, login, credits, source, and error helpers.
 - Fixed inconsistent current-vs-weekly percentage rendering in collapsed provider cards.
-- Simplified CodexBar error output so unsupported providers show the real provider error instead of raw JSON.
+- Simplified aggregator error output so unsupported providers show the real provider error instead of raw JSON.
 - Added a dashboard provider manager with an **Add provider** button.
 - Added per-card remove controls and a custom provider list field in settings.
 
@@ -140,7 +163,7 @@
 
 ## 1.0.0 - 2026-04-29
 
-- Created AiOverviewControl as a renamed and expanded successor to the DMS CodexBar widget.
+- Created AiOverviewControl as a renamed and expanded AI usage widget.
 - Added configurable provider sets and source modes.
 - Added Linux-friendly `cli` default.
 - Added partial provider failure handling.

AiOverviewControlWidget.qml

@@ -1,142 +1,52 @@
 # CLAUDE.md
 
-This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+## Project
 
-## Cooauthor
-Do not mention the AI provider/model as a cooauthor in the commit message or PR description.
+AiOverviewControl is a self-contained DankMaterialShell widget for AI quota, billing, authentication, and local usage telemetry.
 
-## Project Overview
+Runtime: QML/Quickshell plus Bash helpers. Core dependencies: `bash`, `jq`, and `curl`.
 
-DMS widget plugin that monitors AI provider quota health. Shows most-limited provider in DankBar pill; floating dashboard with per-provider cards.
+## Rules
 
-**Runtime stack:** QML (Quickshell), bash helper scripts, optional `codexbar` CLI fallback.
+- Do not mention an AI provider/model as coauthor in commits or pull requests.
+- Keep provider failures isolated.
+- Never fabricate quota percentages for providers without a documented surface.
+- Prefer official CLI protocols and documented APIs; do not scrape authenticated dashboards.
+- Keep the plugin self-contained and preserve user settings during upgrades.
 
-**Key dependencies:** `bash`, `node`, `jq`, `curl`. Optional: `codexbar`, `gh` (Copilot), `claude` CLI.
+## Data flow
 
-## Key Files
+1. Widget runs `providers/get-provider-usage <providers> <copilot-helper>`.
+2. Dispatcher calls one local adapter per provider.
+3. Every result follows `{provider, source, usage, credits, error}`.
+4. Widget renders healthy and failed providers independently.
+5. Claude analytics run separately from the main dispatcher.
 
-| File | Role |
-|------|------|
-| `AiOverviewControlWidget.qml` | DankBar pill, popout dashboard, QML data collection and normalization |
-| `AiOverviewControlSettings.qml` | DMS settings UI |
-| `providers/get-provider-usage` | Unified shell backend — dispatches per-provider, returns JSON array |
-| `providers/get-copilot-usage` | GitHub Copilot bridge via `gh auth token` or env tokens |
-| `providers/get-claude-usage` | Claude Code analytics from `~/.claude` JSONL logs + optional OAuth |
-| `plugin.json` | Plugin metadata, capabilities, permissions |
+## Settings
 
-## Data Flow
+`refreshInterval`, `providerSelection`, `showErrorProviders`, `pillMode`, `pillProviders`, `densityMode`, `costCurrency`, `showClaudeProjects`, `languageOverride`.
 
-1. Widget calls `providers/get-provider-usage` with `providerSelection`, `sourceMode`, optional `codexbarPath`, optional Copilot helper path.
-2. Script dispatches per provider — local bridges first, `codexbar` fallback for others.
-3. Returns JSON array. Each item: `{ provider, source, usage, credits, error }`.
-4. Widget normalizes and renders cards. Errors become isolated cards — do not suppress healthy providers.
-5. Provider with highest `usedPercent` drives the compact DankBar indicator.
-6. For `claude`, widget may also spawn `providers/get-claude-usage` for 5h/7d windows, token counts, cost estimates.
-
-## Provider Output Schema
-
-```text
-provider / source / error
-usage.identity.accountEmail
-usage.primary / secondary / tertiary
-  usedPercent, windowMinutes, resetsAt, resetDescription, remaining, unlimited, hasQuota
-credits.remaining
-```
-
-## Settings Keys
-
-`refreshInterval`, `codexbarPath`, `providerSelection`, `sourceMode`, `showErrorProviders`
-
-Stored in DMS settings store — never overwrite user preferences when updating plugin files.
-
-## Validation Commands
+## Validation
 
 ```bash
-# Lint QML
-qmllint AiOverviewControlWidget.qml AiOverviewControlSettings.qml || true
-
-# Validate plugin metadata
 jq . plugin.json
+bash -n providers/get-*
+shellcheck providers/get-*
+qmllint AiOverviewControlWidget.qml AiOverviewControlSettings.qml AiOverviewControlI18n.qml
+./providers/get-provider-health "codex,claude,copilot" | jq .
+./providers/get-codex-usage | jq .
+./providers/get-provider-usage "codex,claude,copilot" ./providers/get-copilot-usage | jq .
+```
 
-# Test data pipeline end-to-end
-~/.config/DankMaterialShell/plugins/AiOverviewControl/providers/get-provider-usage \
-  "$(command -v codexbar)" "codex,claude,copilot" "cli" \
-  ~/.config/DankMaterialShell/plugins/AiOverviewControl/providers/get-copilot-usage
-
-# Test individual bridges
-~/.config/DankMaterialShell/plugins/AiOverviewControl/providers/get-copilot-usage
-~/.config/DankMaterialShell/plugins/AiOverviewControl/providers/get-claude-usage
+## Provider policy
 
-# Test via codexbar fallback
-codexbar usage --format json --provider codex --source cli
-codexbar usage --format json --provider claude --source cli
-```
+See `docs/providers.md` for behavior and `docs/provider-verification.md` for upstream documentation links and evidence level.
 
 ## Release
 
-Releases trigger on `v*` tags. CI runs on push/PR to `main` (validates `plugin.json` + optional `qmllint`).
+Tag must match `plugin.json` and the changelog entry:
 
 ```bash
-git tag v1.x.y && git push origin v1.x.y
+git tag v1.x.y
+git push origin v1.x.y
 ```
-
-Artifacts: `AiOverviewControl-vX.Y.Z.zip` and `.tar.gz` built from `git ls-files`.
-
-## Provider Matrix
-
-| ID | Name | Source | Env vars required | API endpoint |
-|----|------|--------|-------------------|--------------|
-| `codex` | Codex | codexbar → 9router fallback | — | codexbar CLI |
-| `claude` | Claude | OAuth local + JSONL | `~/.claude/.credentials.json` | `api.anthropic.com/api/oauth/usage` |
-| `copilot` | Copilot | GitHub API | `gh auth login` or `COPILOT_GITHUB_TOKEN` | `api.github.com/copilot_internal/user` (AI Credits model since 2026-06-01: `entitlement`/`remaining`/`token_based_billing`) |
-| `gemini` | Gemini | OAuth local or API key | `GEMINI_API_KEY` or `~/.gemini/oauth_creds.json` | Validates key only |
-| `openrouter` | OpenRouter | REST API | `OPENROUTER_API_KEY` | `openrouter.ai/api/v1/auth/key` |
-| `9router` | 9Router | SQLite local | — | `~/.9router/db/data.sqlite` |
-| `deepseek` | DeepSeek | REST API | `DEEPSEEK_API_KEY` | `api.deepseek.com/user/balance` |
-| `kimi` | Kimi | REST API | `MOONSHOT_API_KEY` or `KIMI_API_KEY` (opt. `MOONSHOT_API_BASE`) | `api.moonshot.ai` (global/USD) → `api.moonshot.cn` (China/CNY) fallback, `/v1/users/me/balance` |
-| `mistral` | Mistral | API key validation only | `MISTRAL_API_KEY` | `api.mistral.ai/v1/models` (no quota endpoint) |
-| `glm` | GLM/Zhipu | REST API | `GLM_API_KEY` or `ZHIPU_API_KEY` | `bigmodel.cn/api/monitor/usage/quota/limit` |
-| `minimax` | MiniMax | REST API | `MINIMAX_API_KEY` | `minimax.io/v1/token_plan/remains` |
-| `qwen` | Qwen | API key validation only | `DASHSCOPE_API_KEY` or `QWEN_API_KEY` | No quota endpoint — UI only |
-| `nvidia` | NVIDIA NIM | API key validation only | `NVIDIA_API_KEY` | No quota endpoint — UI only |
-| `cloudflare` | Cloudflare AI | REST API | `CLOUDFLARE_AI_TOKEN`, `CLOUDFLARE_ACCOUNT_ID` | `api.cloudflare.com/v4/accounts/{id}/ai/usage` |
-| `vertexai` | Vertex AI | gcloud OAuth | `gcloud auth login` | gcloud local auth check |
-| `byteplus` | BytePlus Ark | API key validation only | `BYTEPLUS_API_KEY` or `ARK_API_KEY` | No quota endpoint — UI only |
-| `ollama` | Ollama | Local HTTP | `OLLAMA_HOST` (default: localhost:11434) | `localhost:11434/api/tags` |
-| `perplexity` | Perplexity | codexbar or note | — | No public quota endpoint |
-| `cursor` | Cursor | codexbar or note | — | No public quota endpoint |
-| `cline` | Cline | note | — | No REST endpoint |
-| `opencode` | OpenCode | note | — | Proxy only, no billing |
-| `kilo` | Kilo | codexbar or note | — | No public quota endpoint |
-| `kiro` | Kiro | codexbar or note | — | No public quota endpoint |
-| `warp` | Warp | codexbar or note | — | No public quota endpoint |
-| `amp` | Amp | codexbar or note | — | No public quota endpoint |
-
-**Providers not implemented (no API, ToS issues):** Antigravity (Google, ToS violation risk).
-
-## Design Constraints
-
-- Plugin must be self-contained — no imports from other DMS plugins.
-- Per-provider isolation: one provider failure must not hide others.
-- New provider bridges must output `provider/source/usage/credits/error` schema.
-- Collection timeout: 45 seconds. Exceeded → show timeout error, discard stale output.
-- Follow DMS theme tokens and Quickshell UI patterns for visual consistency.
-
-## Design Context
-
-### Users
-Power users and developers using Dank Material Shell as a daily desktop control surface. They need to glance at AI assistant quota health while switching between CLIs, editors, and providers.
-
-### Brand Personality
-Refined, premium, calm. The interface should feel like a dependable shell instrument: compact, readable, and direct, without marketing-style decoration.
-
-### Aesthetic Direction
-Dark, token-driven DMS styling with restrained provider accents. Prefer layered surfaces, precise spacing, and a premium control-surface feel that adapts from narrow popouts to larger desktop panels without hiding core actions.
-
-### Design Principles
-- Make provider health scannable first, details second.
-- Keep every dependency local to AiOverviewControl unless it is an explicit external CLI/API fallback.
-- Use responsive component reflow instead of fixed desktop-only rows.
-- Treat errors as actionable provider states, not global failure.
-- Preserve DMS theme tokens and interaction patterns for consistency with the shell.
-- Keep motion subtle, purposeful, and calm.