status

name	status
description	Project status dashboard — AGENTS.md budget, unfilled placeholders, lessons file size, hooks executability, jq availability, plugin states. One-glance health report.

Status Skill — Project Dashboard

Give a one-glance status report of the Codex Brain setup for this repo.

Run these checks in order and report each as ✅ / ⚠️ / ❌:

1. AGENTS.md budget

wc -c < AGENTS.md 2>/dev/null || echo "MISSING"
wc -l < AGENTS.md 2>/dev/null || echo "0"

• ✅ ≤ 32768 bytes (32KB) · ⚠️ 28000–32768 · ❌ > 32768 or missing

2. Unfilled placeholders

grep -rEc '\{\{[A-Z_]+\}\}' AGENTS.md brain/ .codex/ 2>/dev/null | awk -F: '{s+=$2} END {print s+0}'

• ✅ 0 (end-user repo) · ⚠️ > 0 (bootstrap still has unfilled slots)

3. Lessons file size

wc -l < brain/tasks/lessons.md 2>/dev/null || echo "0"

• ✅ ≤ 400 lines · ⚠️ 401–500 · ❌ > 500 (archive to brain/tasks/lessons-archive-YYYY.md)

4. Hooks executability

for h in .codex/hooks/*.sh; do test -x "$h" || echo "NOT_EXEC: $h"; done
echo "HOOKS_DONE"

• ✅ all executable · ❌ any NOT_EXEC line

5. jq availability

command -v jq &>/dev/null && echo "PRESENT" || echo "MISSING"

• ✅ present · ⚠️ missing — brew install jq / sudo apt install jq

6. Plugin states

command -v uvx &>/dev/null && echo "uvx: installed" || echo "uvx: MISSING (uvx-based plugins unavailable)"
command -v npx &>/dev/null && echo "npx: installed" || echo "npx: MISSING (playwright unavailable)"
command -v ccc &>/dev/null && echo "cocoindex CLI (ccc): installed" || echo "cocoindex CLI (ccc): optional"
# codebase-memory, code-review-graph, serena, cocoindex-code-mcp-server all run via uvx
# playwright runs via npx

• ✅ uvx installed · ⚠️ missing (run brew install uv / pip install uv)

7. MCP servers in config.toml

grep -c '^\[mcp_servers\.' .codex/config.toml 2>/dev/null || echo "0"

• ✅ ≥ 1 configured · ⚠️ 0 (uncomment MCP sections in .codex/config.toml)

Report Format

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  Codex Brain Status — <repo>
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  AGENTS.md budget         ✅ 218 lines / 7.1KB (budget: 32KB)
  Placeholders             ✅ 0 unfilled
  Lessons file             ✅ 312 / 500 lines
  Hooks                    ✅ 9/9 executable
  jq                       ✅ present
  codebase-memory-mcp      ✅ installed
  cocoindex (ccc)          ⚠️ missing — run setup-plugins.sh
  code-review-graph        ✅ installed
  serena                   ✅ available via uvx
  playwright               ✅ available via uvx
  MCP servers              ✅ 3 configured
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  Overall: ⚠️ healthy (1 warning)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

After the table, list ⚠️/❌ items with one-line fix instructions.