codexbar

name	codexbar
description	CodexBar read. Provider usage, limits, credits, config health. JSON. No writes.

CodexBar

Read CodexBar. Never mutate config/auth.

Run

skill="${CODEX_HOME:-$HOME/.codex}/skills/codexbar"
"$skill/scripts/codexbar" doctor
"$skill/scripts/codexbar" providers
"$skill/scripts/codexbar" usage
"$skill/scripts/codexbar" usage --provider codex
"$skill/scripts/codexbar" usage --all

All stdout: JSON. Upstream CodexBar shape kept. Less drift, fewer tokens.

Rules

• Start doctor when install/config unknown.
• usage reads enabled providers. Prefer this.
• usage --provider ID reads one provider.
• usage --all expensive; use only when needed.
• Identities hidden by default. --include-identities only when user explicitly needs them.
• Secrets always hidden.
• Helper read-only: fixed allowlist only. No config writes, auth repair, enable/disable, key storage.
• Timeout means upstream stuck. Narrow provider or raise CODEXBAR_TIMEOUT (default 120 seconds).

Binary

Auto-find: CODEXBAR_BIN, PATH, app bundle, Homebrew cask. If missing: open CodexBar, Preferences > Advanced > Install CLI; or set CODEXBAR_BIN.

Each stdout/stderr stream capped at 1 MiB while fully drained. Timeout kills process group.