Skip to main content
skill CX Codex

codex-debugging — Claude Code skill: what it does, how to install

codex-debugging guides debugging across the codex-rs repository. Essential when investigating runtime bugs, CLI behavior, or config parsing issues.

MIT 108 installs ★ 7,554 updated 2026-10-20

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add steipete/agent-scripts --skill codex-debugging -a claude-code
Open on GitHub

What codex-debugging does

This skill provides a systematic debugging workflow for the codex-rs codebase. It directs the agent to investigate submodules such as CLI, TUI, app server, and configuration handling before touching any code.

Local source code comes first. The workflow inspects codex-rs/AGENTS.md and uses rg to trace symbols and errors across specific crates. Only after verifying the source contract does the agent inspect ~/.codex/config.toml. Speculation is avoided in favor of small reproductions and adjacent tests.

For browser automation in the CLI, you must use $browser-use because the bundled Browser plugin runs exclusively in the Codex desktop app.

What it helps with

  • trace runtime bugs across codex-rs submodules
  • debug configuration parsing issues in ~/.codex/config.toml
  • verify app-server protocol wiring before patching
  • create focused reproduction tests for CLI failures

Example prompts for the agent

  • Inspect the error in codex-rs/cli and check adjacent tests
  • Investigate configuration parsing issues in ~/.codex/config.toml using codex-rs/config
  • Trace the failure in app-server-protocol before suggesting fixes

How to install codex-debugging

1Skills CLI (Vercel)

npx skills add steipete/agent-scripts --skill codex-debugging -a claude-code

2Manually: put the files in place

~/.claude/skills/codex-debugging/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/codex-debugging/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about codex-debugging

How do I install codex-debugging in Claude Code?

Run npx skills add steipete/agent-scripts --skill codex-debugging -a claude-code. The skill file is placed at ~/.claude/skills/codex-debugging/SKILL.md.

What does codex-debugging do?

It establishes an inspection routine for the codex-rs architecture. The skill prioritizes local source code and targeted tests over external documentation.

How do I automate browser actions in CLI mode?

Use $browser-use for command-line browser tasks. The bundled Browser plugin works only inside the Codex desktop app.

Source text

SKILL.md · MIT
---
name: codex-debugging
description: "Codex debugging: codex-rs core/tui/exec/cli/app-server/config."
---

# Codex Debugging

Use when investigating Codex CLI/app behavior, config parsing, tool behavior, prompts, MCP/app wiring, or runtime bugs.

## Source First

Prefer local source before web/docs:

```bash
cd ~/Projects/codex
sed -n '1,220p' codex-rs/AGENTS.md
```

Then search targeted areas:

```bash
rg "<symbol|setting|error|feature>" codex-rs/{core,tui,exec,cli,app-server,app-server-protocol,config}
```

## Workflow

1. Identify whether the behavior is CLI, TUI, app server, protocol, config, or exec/tooling.
2. Read the owning module and adjacent tests before proposing changes.
3. Check local config in `~/.codex/config.toml` only after understanding the source contract.
4. Prefer small repros or focused tests over broad speculation.

## Notes

- For OpenAI API/product docs, use the official-docs path only when source is insufficient.
- For local browser automation in CLI, use `$browser-use`; the bundled Browser plugin is Codex app-only.

© steipete · MIT · steipete/agent-scripts

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set20

The whole set →
discord-clawd discord-clawd — a skill to send questions to a Discord-backed agent via OpenClaw relay. Not for archive search—use it to communicate directly with a live session. CX Codex +1 122installs openclaw-relay openclaw-relay is a Claude Code skill that routes prompts and messages to OpenClaw sessions via local acpx or SSH, resolving targets from named aliases in config/session_aliases.json. CX Codex +1 120installs mac-maintenance mac-maintenance automates macOS maintenance by upgrading Homebrew packages, pulling clean git repositories, and emptying the Trash. CX Codex +1 117installs cloudflare-registrar A skill to check domain availability in Cloudflare Registrar, retrieve pricing, and register domains from your code editor. Use it when you register domains regularly and want to skip the dashboard. CX Codex +1 108installs github-project-triage The github-project-triage Claude Code skill reviews open GitHub issues and pull requests when prompted with “triage.” It surfaces blockers, checks, risks, and a next action for each item. CX Codex +1 105installs obsidian A skill for Claude Code searches, reads, and edits local Obsidian vaults. It handles requests involving notes, backlinks, Bases, and Canvas. CX Codex +1 104installs beeper beeper is a Claude Code skill that searches local Beeper history. It resolves vague contact clues across iMessage and WhatsApp bridges. CX Codex +1 104installs openai-image-gen openai-image-gen — a skill for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode: calls the OpenAI Images API, renders a batch of images from structured prompts, and builds an HTML gallery. CX Codex +1 1installs

Project sponsors

Companies that keep this analytics open