codex-cli

# Codex CLI Interaction Skill

Interact with OpenAI Codex CLI to leverage its powerful reasoning capabilities for plan review, code analysis, and complex problem discussions.

> **⚠️ Naming Clarification**:
> - **"codex-cli" Skill** = This AI agent skill (current document)
> - **Codex CLI** = The OpenAI command-line tool being invoked (the program)
> - **gpt-X-codex** = Model name suffix (e.g., gpt-5.2-codex) indicating code-optimized variants
>
> Throughout this document, "Codex CLI" refers to the command-line tool being called.

## ⚠️ Prerequisites (Required!)

**You MUST have these installed before using this skill:**

1. **Codex CLI** - The OpenAI Codex command-line tool
   ```bash
   # Check if installed
   which codex
   codex --version
   ```

2. **OpenAI API Key** - Required for authentication

   **Option A: Interactive login (Recommended - most secure)**
   ```bash
   # Interactive prompt - API key won't appear in shell history
   codex login
   # Follow the prompts to enter your API key
   ```

   **Option B: Environment variable**
   ```bash
   # Add to ~/.zshrc or ~/.bashrc (not in shell history)
   export OPENAI_API_KEY="your-api-key-here"
   source ~/.zshrc

   # Then login
   codex login --with-api-key <<< "$OPENAI_API_KEY"
   ```

   **Option C: File-based (if interactive not available)**
   ```bash
   # Create a temporary file with your key
   echo "your-api-key" > /tmp/key.txt
   codex login --with-api-key < /tmp/key.txt
   rm /tmp/key.txt

   # Or pipe directly (⚠️ key appears in shell history)
   echo "YOUR_KEY" | codex login --with-api-key
   ```

   **Verify login:**
   ```bash
   codex login status
   # Should show: "Logged in using an API key - sk-proj-***"
   ```

3. **Active API Access** - Your OpenAI account must have API access and credits

4. **Security Best Practices**

   ```bash
   # Secure your config file (contains API key reference)
   chmod 600 ~/.codex/config.toml

   # Clear shell history if you used echo with API key
   histor