---
name: CodexBar
slug: codexbar
category: AI Engineering
description: CodexBar reads provider usage, limits, credits, and configuration health from the CodexBar CLI, returning JSON output. Use it to inspect enabled providers and diagnose install/config state without mutating anything.
github: "https://github.com/steipete/CodexBar/tree/main/.agents/skills/codexbar"
language: Swift
stars: 20073
forks: 1701
install: "npx degit https://github.com/steipete/CodexBar/tree/main/.agents/skills/codexbar ~/.claude/skills/codexbar"
installs_to: ~/.claude/skills/codexbar
source_path: .agents/skills/codexbar/SKILL.md
collection_size: 3
category_size: 2451
collection_url: "https://dirskills.com/collections/steipete/CodexBar"
added: 2026-08-14T07:12:38.078Z
last_synced: 2026-08-14T07:12:38.078Z
canonical_url: "https://dirskills.com/skills/codexbar"
---

# CodexBar

CodexBar reads provider usage, limits, credits, and configuration health from the CodexBar CLI, returning JSON output. Use it to inspect enabled providers and diagnose install/config state without mutating anything.

**Install:**

```bash
npx degit https://github.com/steipete/CodexBar/tree/main/.agents/skills/codexbar ~/.claude/skills/codexbar
```

## README

# CodexBar

Read CodexBar. Never mutate config/auth.

## Run

```bash
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.