# Codex Usage

> Show Codex rate-limit usage and pace, or configure the native Codex status line

- Skill: `shenxingy/codex-usage` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add shenxingy/codex-usage`
- Raw SKILL.md: https://api.skillmd.com/api/skills/shenxingy/codex-usage/raw
- Safety review: PASS (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: shenxingy (https://skillmd.com/u/shenxingy)
- Updated: 2026-08-19
- Page: https://skillmd.com/skills/shenxingy/codex-usage

---


# Codex Usage

Shows authenticated Codex rate-limit windows and compares usage with a 95%
target pace. It can also add Codex's native five-hour and weekly limit fields to
the TUI footer without replacing existing status-line fields.

## Usage

```text
$codex-usage
$codex-usage setup minimal
$codex-usage style icon
$codex-usage theme
$codex-usage theme bird
$codex-usage --json
```

The helper talks to `codex app-server`; it does not read or print Codex login
credentials.