[global] ai-usage: adds the Shima AI usage dashboard

.github/workflows/ai-usage-collector.yml

@@ -13,15 +13,37 @@ on:
   pull_request:
     paths:
       - 'ryoku/rashin/usage/opencode-usage'
+      - 'ryoku/rashin/usage/codex-usage'
+      - 'ryoku/shell/quickshell/inir/defaults/widgets/ai-usage/**'
       - 'tests/opencode-usage.sh'
+      - 'tests/codex-usage.sh'
+      - 'tests/codex-usage-regression.py'
+      - 'tests/ai-usage-cache.py'
+      - 'tests/ai-usage-widget.py'
+      - 'tests/custom-widget-install.py'
+      - 'ryoku/shell/quickshell/inir/services/CustomWidgets.qml'
+      - 'ryoku/shell/quickshell/inir/modules/iris/settings/IrisOptions.qml'
+      - 'ryoku/shell/quickshell/inir/modules/iris/bar/IrisCustomModule.qml'
+      - 'ryoku/shell/quickshell/inir/modules/background/widgets/WidgetManagerPanel.qml'
       - '.github/workflows/ai-usage-collector.yml'
   push:
     branches:
       - main
       - unstable-dev
     paths:
       - 'ryoku/rashin/usage/opencode-usage'
+      - 'ryoku/rashin/usage/codex-usage'
+      - 'ryoku/shell/quickshell/inir/defaults/widgets/ai-usage/**'
       - 'tests/opencode-usage.sh'
+      - 'tests/codex-usage.sh'
+      - 'tests/codex-usage-regression.py'
+      - 'tests/ai-usage-cache.py'
+      - 'tests/ai-usage-widget.py'
+      - 'tests/custom-widget-install.py'
+      - 'ryoku/shell/quickshell/inir/services/CustomWidgets.qml'
+      - 'ryoku/shell/quickshell/inir/modules/iris/settings/IrisOptions.qml'
+      - 'ryoku/shell/quickshell/inir/modules/iris/bar/IrisCustomModule.qml'
+      - 'ryoku/shell/quickshell/inir/modules/background/widgets/WidgetManagerPanel.qml'
       - '.github/workflows/ai-usage-collector.yml'
   workflow_dispatch:
 
@@ -39,3 +61,24 @@ jobs:
       - name: Store-layout fixture test
         shell: bash
         run: bash tests/opencode-usage.sh
+
+      - name: Codex rollout fixture test
+        shell: bash
+        run: bash tests/codex-usage.sh
+
+      - name: Set up Node for widget parser checks
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+
+      - name: Codex replay and quota-window regression tests
+        run: python3 tests/codex-usage-regression.py
+
+      - name: Widget cache contract
+        shell: bash
+        run: python3 tests/ai-usage-cache.py
+
+      - name: Widget calendar and shared-loader compatibility
+        run: |
+          python3 tests/ai-usage-widget.py
+          python3 tests/custom-widget-install.py

CHANGELOG.md

@@ -106,6 +106,11 @@ for finer detail.
   mutable channels current without changing frozen distro snapshots.
 
 ### Added
+- **AI usage comes to Shima.** Enable the built-in module in Island settings
+  under Desktop page / Your modules for OpenCode and Codex sessions, token
+  trends, model usage, activity and available plan limits. OpenCode shows
+  recorded costs. Codex shows Est. Spending from saved daily API prices,
+  with incomplete coverage marked. Estimates are not bills or wallet balances.
 - **Community docks.** RyoStore gains a Docks section: anyone can submit a dock
   as a folder to the ryostore catalogue, users install it there and pick it in
   Edit desktop -> Dock, and it becomes the dock on every monitor and every bar