codex-setup SKILL.md skillA

codex-setup from watertian/cc-hud is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add watertian/cc-hud/codex-setup@git:20261105.e62a818

Pins git:20261105.e62a818 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
watertian/cc-hud
Path
skills/codex-setup/SKILL.md
Versions recorded
2
Latest version
git:20261105.e62a818, committed Nov 5, 2026
First version recorded
Nov 5, 2026
Size
2,390 bytes
Repository stars
9
License
MIT

Set up, check, restore, diagnose misleading quota colors, or style the cc-hud native footer in Codex CLI when requested. Claude Code uses /cc-hud:setup instead.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

Use the packaged CLI; no global npm installation is needed. Resolve the plugin
root two directories above this SKILL.md, then run:

```sh
node "<plugin-root>/dist/cli.js" setup codex
node "<plugin-root>/dist/cli.js" check codex
```

For a request to check only, run only `check`. For a request to restore the
previous footer, run `restore codex` instead of setup. Report the actual result.

Relay the setup/check color note: Codex colors 5h and weekly by the active
syntax theme, independent of remaining quota. For a color complaint, check
the active `tui.theme` and `tui.status_line_use_colors` before diagnosing it;
use the color the user reports, never infer the visible color from a percentage.
For a requested visual match or a misleading red/green quota color, run
`theme codex`. This installs the bundled native CC-HUD theme,
uses a fixed neutral teal accent for limits, and also changes code highlighting.
Tell the user to open `/theme`, search `cc-hud`, and press Enter for a
live preview/application. Theme names aren't slash-command arguments.
Use `restore-theme codex` to restore prior theme preferences when requested.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add watertian/cc-hud/codex-setup@sha256:055558d831834c21

The line at the top of this page pins the label git:20261105.e62a818, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_ahqve6a57vo7r4k6.svg)](https://markdownregistry.com/a/art_ahqve6a57vo7r4k6)

0 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 2 versions of this file, all committed on Nov 5, 2026.

versioncommittedcommitsizeaudit
git:20261105.e62a818 latest2026-11-05 e62a818 2,390 BA view · diff
git:20261105.d0d5cd52026-11-05 d0d5cd5 1,798 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (2390 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

watertian/cc-hud · 9 stars · license MIT · pushed 2026-11-06 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_ahqve6a57vo7r4k6
GET https://markdownregistry.com/api/v1/resolve?ref=watertian/cc-hud/codex-setup
GET https://markdownregistry.com/api/v1/blob/055558d831834c2192f36f33145abfa59098f11a96bd20db6832bcdcc80bfc6a

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from watertian/cc-hud

AGENTS.md AGENTS.md file
watertian/cc-hud · AGENTS.md
git:20261106.74e0de7 · audit B · 9 stars
CLAUDE.md CLAUDE.md file
watertian/cc-hud · CLAUDE.md
git:20261106.74e0de7 · audit A · 9 stars

Every file in watertian/cc-hud

Other files named codex-setup

codex-setup SKILL.md skill
sd0xdev/sd0x-harness · skills/codex-setup/SKILL.md · Initialize sd0x-dev-flow infrastructure for Codex CLI and other non-Claude agents. Generates AGENTS.md, installs the…
git:20261003.91caf8d · audit B · 194 stars

Browse by kind, by grade A, or by owner.