codex-qa

Codex CLI must be installed and configured:

```bash

npm install -g @openai/codex

# or

brew install --cask codex

```

An OpenAI API key must be configured (OPENAI_API_KEY environment variable or via codex initial setup).

Spawn the codex-qa subagent to handle the question:

```

Use the Task tool to spawn the codex-qa agent with the user's question.

```

The subagent will:

1. Formulate a clear prompt for Codex
2. Run codex exec "question" in read-only mode
3. Return Codex's response

If you prefer to run Codex directly:

```bash

codex exec "your question here"

```

Command Options

• Basic query: codex exec "question"
• With image: codex -i image.png exec "question about image"
• JSON output: codex exec --json "question"
• Longer timeout: codex exec --timeout 300000 "complex question"

• Code explanation: "What does this function do?"
• Architecture questions: "How is the database layer structured?"
• Finding patterns: "Where is error handling implemented?"
• Code review: "Review this file for potential issues"
• Comparison: Get a second opinion on a code question

• Codex exec runs in read-only mode by default - it cannot modify files
• Activity streams to stderr, final answer goes to stdout
• For complex questions, use the subagent for better context isolation