Agent skill

CodexBar Usage Reader

by steipete in steipete/CodexBar

“CodexBar read. Provider usage, limits, credits, config health. JSON. No writes.”

— description from SKILL.md by steipete
MITAuto-check passedAI & LLM Engineering

Install CodexBar Usage Reader

skills CLI
$ npx skills add steipete/CodexBar --skill codexbar -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install steipete/CodexBar codexbar --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/steipete/CodexBar.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/codexbar .claude/skills/codexbar && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
codexbar
GitHub stars
22k
Token cost
~320 tokens
SKILL.md length
115 words
Files
3 (incl. scripts)
Skills in repo
3
Repo updated
First seen
Licence
MIT

At a glance

  • SKILL.md covers Run, Rules and Binary
  • Runs Python scripts from its folder

About this skill

CodexBar Usage Reader is a skill in steipete/CodexBar (22k stars). Its SKILL.md is about 320 tokens, with 2 other files in the folder (scripts). Licence: MIT.

What it can do on your machine

Read from SKILL.md and the folder at commit f8b75cf. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 2 files in scripts/ (Python), which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

CodexBar Usage Reader loads about 320 tokens when it runs. Until then it costs about 22 tokens; SKILL.md has 115 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~22
When it runs · the whole SKILL.md, loaded when a task matches
~320

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from steipete/CodexBar at commit f8b75cf, republished under its MIT licence (© steipete). 115 words, ~320 tokens.

Download SKILL.mdSave it as .claude/skills/codexbar/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
codexbar
description
CodexBar read. Provider usage, limits, credits, config health. JSON. No writes.

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.

© steipete, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (scripts) in .agents/skills/codexbar of steipete/CodexBar.

  • SKILL.md
  • scripts/codexbar
  • scripts/test_codexbar.py

Open the folder on GitHubat commit f8b75cf

Compare with similar skills

CodexBar Usage Reader next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

CodexBar Usage Reader compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
CodexBar Usage Reader this skillsteipete/CodexBar22k—~320Automated safety check: PassMIT
Claude Code Daily Cost Reporttombelieber/claude-view110—~3kAutomated safety check: PassMIT
Caveman Workflow LabelerJuliusBrussee/caveman110k1 repos~1.3kAutomated safety check: PassApache-2.0
Caveman Evidence ReviewJuliusBrussee/caveman110k1 repos~927Automated safety check: PassApache-2.0
OmniRoute Cost and Usage CLIdiegosouzapw/OmniRoute74k1 repos~693Automated safety check: PassMIT
Omnifajarhide/omni374—~1.1kAutomated safety check: PassApache-2.0

Similar skills

  • Claude Code Daily Cost Report

    tombelieber/claude-view

    Shows today's Claude Code spending through the claude-view MCP server, with total cost, running sessions and a per-session breakdown, and other date ranges on request.

    110 GitHub stars~3k tokensUpdated 7 days ago
    AI & LLM EngineeringAuto-check passed
  • Caveman Workflow Labeler

    JuliusBrussee/caveman

    Finds every LLM workflow in a repository, proposes a labeling table and, once you agree, wires labels so Caveman Cloud groups spend per workflow.

    110k GitHub starsUsed in 1 repo~1.3k tokens
    AI & LLM EngineeringAuto-check passed
  • Caveman Evidence Review

    JuliusBrussee/caveman

    Read-only review of Caveman Cloud data to explain where LLM spend goes: cost, score, workflows, traces, latency, errors, routing and verified savings.

    110k GitHub starsUsed in 1 repo~927 tokens
    AI & LLM EngineeringAuto-check passed
  • OmniRoute Cost and Usage CLI

    diegosouzapw/OmniRoute

    View cost breakdowns, token usage, and call logs from the CLI. Filter by provider, model, or date range. Export usage reports and inspect per-connection…

    74k GitHub starsUsed in 1 repo~693 tokens
    AI & LLM EngineeringAuto-check passed
  • Omni

    fajarhide/omni

    A skill your agent uses when installing, verifying or configuring OMNI, when command output carries an [OMNI: ...] marker, or when output looks shorter than expected.

    374 GitHub stars~1.1k tokensUpdated yesterday
    AI & LLM EngineeringAuto-check passed
  • Mines local Claude Code session transcripts with a deterministic Python pipeline to show what the agent is actually used for, how often it fails and what it costs.

    1.6k GitHub stars~2.3k tokensUpdated today
    AI & LLM EngineeringAuto-check passed

More from steipete/CodexBar

  • CodexBar Live QA

    steipete/CodexBar

    Runs live QA for the CodexBar app: provider usage matrix checks through its packaged CLI, config validation and menu checks, with 1Password-backed credentials handled safely.

    22k GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • CodexBar macOS Release

    steipete/CodexBar

    Releases a signed, notarized CodexBar build: confirms the changelog, resolves signing credentials from 1Password, runs the release script in tmux, and updates the Sparkle appcast and Homebrew tap.

    22k GitHub stars~1.5k tokensUpdated today
    Auto-check passed

Works with

Questions about CodexBar Usage Reader

How do I install CodexBar Usage Reader in Claude Code?

Run `npx skills add steipete/CodexBar --skill codexbar -a claude-code`. Or copy the skill folder (.agents/skills/codexbar in steipete/CodexBar) into .claude/skills/codexbar in your project. Claude Code loads it when a task matches its description.

How do I install CodexBar Usage Reader in Codex?

Run `npx skills add steipete/CodexBar --skill codexbar -a codex`. Or copy the skill folder (.agents/skills/codexbar in steipete/CodexBar) into .agents/skills/codexbar in your project. Codex loads it when a task matches its description.

Can I use CodexBar Usage Reader in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add steipete/CodexBar --skill codexbar -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/codexbar, .gemini/skills/codexbar, .github/skills/codexbar and .opencode/skills/codexbar in your project.

What does CodexBar Usage Reader need to run?

Going by SKILL.md and its folder, CodexBar Usage Reader needs Python for the scripts in its folder.

Does CodexBar Usage Reader access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is CodexBar Usage Reader safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does CodexBar Usage Reader use?

CodexBar Usage Reader is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does CodexBar Usage Reader use?

About 320 tokens (SKILL.md is roughly 1.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to CodexBar Usage Reader?

Skills that share tags, products or a category with CodexBar Usage Reader: Claude Code Daily Cost Report (tombelieber/claude-view, 110 stars), Caveman Workflow Labeler (JuliusBrussee/caveman, 110k stars), Caveman Evidence Review (JuliusBrussee/caveman, 110k stars) and OmniRoute Cost and Usage CLI (diegosouzapw/OmniRoute, 74k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains CodexBar Usage Reader?

steipete (a GitHub user) maintains it in steipete/CodexBar, which has 22,293 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on October 8, 2026.

Source: steipete/CodexBar on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.