codex-usage

Run `scripts/codex_usage.py` to produce a Codex profile report discovered from local auth profiles.

## Safe defaults
- `/codex_usage` is read-only.
- For mutations, require explicit confirmation and prefer `--dry-run` first.
- See `RISK.md` for allowed/denied operation boundaries.

## UX requirements (cross-channel)
Before running the script for a user-triggered `/codex_usage` request, send an immediate progress note as a separate message:
- "Running Codex usage checks now…"

Then send final usage result when complete (do not skip the progress note).

### Interaction adapter
- If inline buttons are supported: show selector buttons (default / all / discovered profiles).
- If inline buttons are not supported: show text menu fallback (`default | all | <profile>`).
- Apply duplicate-request suppression per user for ~20s to avoid accidental spam retries.

## Commands
- `/codex_usage` → **MUST** return selector buttons first (default / all / discovered profiles)
- `/codex_usage default`
- `/codex_usage all`
- `/codex_usage <profile>`
- `/codex_usage delete <profile>` (must require explicit confirmation before mutation)

## How to run
From workspace root:

```bash
python3 skills/codex-usage/scripts/codex_usage.py --profile all --timeout-sec 25 --retries 1 --debug
python3 skills/codex-usage/scripts/codex_usage.py --profile all --format text
```

Profile-specific examples:

```bash
python3 skills/codex-usage/scripts/codex_usage.py --profile default --timeout-sec 25 --retries 1 --debug
python3 skills/codex-usage/scripts/codex_usage.py --profile openai-codex:default --timeout-sec 25 --retries 1 --debug
python3 skills/codex-usage/scripts/codex_usage.py --profile <suffix> --timeout-sec 25 --retries 1 --debug
```

Delete examples (with safeguards):

```bash
# preview only (required guard response without --confirm-delete)
python3 skills/codex-usage/scripts/codex_usage.py --delete-profile openai-codex:mine

# safe preview with explicit confirm but no file mutation
python3 skills/...