starred/xdist
1
0
Fork 0
mirror of https://github.com/ForLoopCodes/xdist.git synced 2026-04-26 20:35:56 +03:00
Code Issues Projects Releases Packages Wiki Activity
An htop-style CLI dashboard for tracking AI usage, limits, and costs across multiple providers.
8 commits 1 branch 0 tags 118 KiB
Find a file
Exact
ForLoopCodes 2b773fed79 vbcv
2026-02-19 16:02:24 +05:30
.claude/skills/forloop aaaa 2026-02-13 18:41:12 +05:30
openusage@41e50e3959 vbcv 2026-02-19 16:02:24 +05:30
src vbcv 2026-02-19 16:02:24 +05:30
.gitignore eeeeee 2026-02-14 02:27:17 +05:30
bun.lock aaaa 2026-02-13 18:41:12 +05:30
index.ts dddddddd 2026-02-14 02:03:49 +05:30
package.json dddddddd 2026-02-14 02:03:49 +05:30
README.md vbcv 2026-02-19 16:02:24 +05:30
tsconfig.json aaaa 2026-02-13 18:41:12 +05:30

README.md

xDIST (Did I Ship Today?)

An htop-style CLI dashboard for tracking AI usage, limits, and costs across multiple providers.

Installation

bun install -g xdist

Usage

Simply run:

xdist

Or run without installing:

bunx xdist
  • Chernobyl Heatmap: Character-by-character scan animation for revealing historical data.
  • Provider Tracking: Support for GitHub Copilot, Anthropic, OpenAI, and more.
  • Claude Local Monitor: Reads Claude Code analytics from ~/.claude/stats-cache.json (offline).
  • Quota & Cost: Track both usage limits (requests) and cost caps (USD).
  • Theme Support: Unified "success" (scanline) aesthetics.
  • Auto-Config: Prompt-based credential setup for new providers.
    • bun run start

The app will also create .usage-limits.config.json in your project folder for local settings and stored credentials.

Keyboard shortcuts

Global:

  • q or Ctrl+C quit
  • r refresh usage
  • t cycle theme
  • s go to settings
  • d go to dashboard
  • tab toggle dashboard/settings

Dashboard:

  • ↑/↓ or j/k move selection
  • enter configure selected provider

Settings:

  • ↑/↓ or j/k move selection
  • space enable/disable provider
  • e or enter set credentials
  • b toggle billing mode (quota / payg)
  • m set monthly limit
  • u set manual used value
  • c set manual cost

GitHub token notes

For billing usage reports:

  • User endpoint typically needs Plan (read).
  • Organization endpoint typically needs Administration (read) on the organization.
  • You can use:
    • Fine-grained PAT
    • GitHub App user access token

This app queries the monthly premium-request endpoint across the last 24 months, keeps model-level breakdown for the current month, and builds the graph from monthly trend points.

Claude local stats notes

  • xDIST reads Claude Code usage from ~/.claude/stats-cache.json.
  • It shows message-based activity (7d/30d/365d), model token totals, and historical daily usage.
  • Remaining % / hard rate-limit values are not available from this local Claude cache format.
  • No additional API calls are made for this local mode.

Extending providers

Provider adapters live in src/providers/index.ts.

To add a new provider:

  1. Add a provider definition to PROVIDERS
  2. Implement isConfigured and fetchUsage
  3. Add any provider-specific config fields if needed