LimitDeck

中文说明

A compact, privacy-safe terminal dashboard for AI coding subscription limits.

› Codex    Codex    7d  ━━━━━━━━━━━━━━──────────  61%
           Spark    5h  ━━━━━━━━━━━━━━━━━━━━━━━━ 100%
           Spark    7d  ━━━━━━━━━━━━━━━━━━━━━━━━ 100%

LimitDeck reuses official local login surfaces when they exist. It does not copy credentials, read browser cookies, scrape subscription pages, or read Codex auth.json.

Supported data sources

Codex App Server is preferred over the OMP fallback when both are available.

Install

Homebrew

brew install rockythink/tap/limitdeck

Cargo

Rust 1.88 or newer is required:

cargo install limitdeck

Prebuilt binaries

Download macOS or Linux archives and SHA256SUMS from the latest GitHub Release.

Run LimitDeck from any terminal:

limitdeck

LimitDeck automatically discovers an installed and authenticated Codex CLI. No additional LimitDeck login is required.

Claude setup

Claude Code exposes subscription rate limits through its official status-line input. Add this to ~/.claude/settings.json:

{
  "statusLine": {
    "type": "command",
    "command": "limitdeck ingest claude",
    "refreshInterval": 60
  }
}

This command keeps a quota-only snapshot at $XDG_CACHE_HOME/limitdeck/claude.json, or ~/.cache/limitdeck/claude.json when XDG_CACHE_HOME is unset. Claude Code provides rate_limits only for eligible subscriptions and only after the first API response in a session.

This setting replaces an existing custom Claude Code status line. If you already use one, call limitdeck ingest claude from your existing status-line script and pass the original JSON through stdin.

Controls

The layout degrades to compact percentages in narrow terminals and keeps the selected plan visible when the list is taller than the viewport.

Rainbow is the default theme: a deep background with green, violet, pink, orange, and blue accents inspired by OMP. Theme changes apply immediately to both the list and detail views for the current session.

Open a plan to see locally sampled quota history when the terminal has enough rows. A changing current-cycle history with at least three samples is rendered as a compact Braille line with its actual time span, start and end values, and delta; flat or sparse history stays textual instead of drawing a misleading bar. A quota increase starts a new visual cycle. History is stored at $XDG_CACHE_HOME/limitdeck/history.json, or ~/.cache/limitdeck/history.json when XDG_CACHE_HOME is unset. LimitDeck keeps at most 30 days and 2,048 samples per quota window; after the first two real samples, unchanged values are sampled no more than once every 15 minutes.

Troubleshooting

A source that cannot refresh stays visible. If a previous snapshot exists, LimitDeck marks it as cached; otherwise the row shows 不可用 · Enter 查看原因 (unavailable · press Enter for the reason). Press Enter to see the safe failure category and the next action:

Diagnostics retain and display only a fixed source label and a failure category. Raw stderr, provider payloads, credentials, account fields, email addresses, and local paths are never retained in application state.

Privacy model

LimitDeck retains only:

• provider, plan, and quota-window identifiers
• display labels and window durations
• remaining percentages and reset times
• quota-history timestamps, remaining percentages, and availability state

It deliberately ignores account email, account ID, organization, plan tier, billing data, raw credentials, and raw provider responses. Parser inputs and subprocess output are size-bounded. Child processes have explicit timeouts and are reaped on exit.

Development

cargo fmt --check
cargo test --all-targets --all-features
cargo clippy --all-targets --all-features -- -D warnings
cargo build --release

The architecture is intentionally small:

official protocol / safe snapshot / optional fallback
                         |
                    PlanAdapter
                         |
           CodingPlan -> UsageWindow
                         |
             App state + local history -> TUI

Adapters own provider-specific parsing and timeouts. The domain and UI do not depend on Codex, Claude, or OMP response formats.

Disclaimer

LimitDeck is an independent project and is not affiliated with or endorsed by OpenAI, Anthropic, or OMP. Provider interfaces and subscription limits may change.

License

MIT