codex-debugging

---
name: codex-debugging
description: "Use when working with codex debugging: codex-rs core/tui/exec/cli/app-server/config from steipete/agent-scripts."
source: https://github.com/steipete/agent-scripts/tree/main/skills/codex-debugging
generated: 2026-05-27T20:55:29.830Z
category: tool
audience: engineers
---

## When to use

- Investigating Codex CLI/app behavior, config parsing, tool behavior, prompts, MCP/app wiring, or runtime bugs.
- Using the codex-debugging skill's upstream workflow, guardrails, and local-tool assumptions.
- Auditing commands or operational steps before changing codex debugging behavior.
- Needing a compact agent reference for codex debugging: codex-rs core/tui/exec/cli/app-server/config.

## Key concepts

### Source First

Prefer local source before web/docs: Then search targeted areas:.

### 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.

## API reference

```
npx skills add steipete/agent-scripts --skill codex-debugging
```

Install the codex-debugging skill from steipete/agent-scripts.

```
npx skills add steipete/agent-scripts --skill codex-debugging
```

```
cd ~/Projects/codex.
```

Command or snippet documented by the upstream codex-debugging skill.

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

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

Command or snippet documented by the upstream codex-debugging skill.

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

## Gotchas

- Prefer local source before web/docs:.

---
Generated by SkillMake from https://github.com/steipete/agent-scripts/tree/main/skills/codex-debugging on 2026-05-27T20:55:29.830Z.
Verify against source before relying on details.

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