Codex Headless Mode

Overview

Dieser Skill ermoeglicht die Nutzung von OpenAI Codex CLI fuer delegierbare Aufgaben. Codex laeuft im Headless-Mode mit --full-auto Flag.

WICHTIG:

• Nutzt ChatGPT Plus/Pro Subscription, KEINEN API Key!
• NUR Workspace-Zugriff (--sandbox workspace-write)
• NIEMALS --yolo verwenden (gibt System-Zugriff)!
• Standard-Modell: gpt-5.2-codex

Quick Start

Code-Aufgaben (ohne Web):

codex exec --full-auto "Deine Aufgabe hier"

Web-Recherche:

codex exec --full-auto --enable web_search_request "Recherchiere im Web nach..."

Authentifizierung (Subscription)

IMMER ChatGPT Login nutzen (Subscription), NIEMALS API Key!

# Erster Login (einmalig, oeffnet Browser)
codex login

# Status pruefen
codex login status

Nach dem Login ist die ChatGPT Plus/Pro Subscription aktiv.

Sicherheit: Nur Repo-Zugriff!

IMMER diese Sandbox-Einstellung verwenden:

codex exec --full-auto "PROMPT"

--full-auto setzt automatisch:

• --sandbox workspace-write (NUR aktuelles Repo)
• --ask-for-approval on-request

NIEMALS verwenden:

# VERBOTEN! Gibt System-Zugriff!
codex exec --yolo "..."
codex exec --sandbox danger-full-access "..."

Core Instructions

Wann Codex nutzen

• Dokumentationserstellung (.md, README, etc.)
• Code-Reviews und Analysen
• Textgenerierung und Zusammenfassungen
• Bild-Analyse mit --image
• Web-Recherche mit --search
• Wenn der User explizit /codex aufruft

Standard-Workflow

1. Aufgabe verstehen: Was soll Codex tun?
2. Kontext sammeln: Relevante Dateien identifizieren
3. Prompt konstruieren: Aufgabe + Kontext zusammenfuehren
4. Codex ausfuehren: Via Bash mit --full-auto Flag
5. Output verarbeiten: Ergebnis in Datei schreiben/anzeigen

Bash-Commands

Einfache Aufgabe:

codex exec --full-auto "Erstelle eine README.md fuer dieses Projekt"

Web-Recherche:

codex exec --full-auto --enable web_search_request "Recherchiere im Web nach React 19 Features"

Mit Datei-Kontext:

cat src/main.ts | codex exec --full-auto "Erklaere diesen Code"

Output in Datei speichern:

codex exec --full-auto -o docs/api.md "Erstelle eine API-Dokumentation"

Mit JSON Output (fuer Parsing):

codex exec --full-auto --json "Analysiere" | jq '.content'

Mit Bild-Input:

codex exec --full-auto -i screenshot.png "Beschreibe was du auf diesem Bild siehst"

Einfache Schreibaufgabe (schneller, guenstiger):

codex exec --full-auto -m gpt-5.1-codex-mini "Erstelle README.md"

Session fortsetzen:

codex exec resume --last

Alle Sessions auflisten:

codex resume --all

Examples

Beispiel 1: README erstellen

codex exec --full-auto "Erstelle eine kurze README.md fuer dieses Projekt"

Beispiel 2: Code dokumentieren

cat src/services/auth.service.ts | codex exec --full-auto "Erstelle JSDoc Kommentare"

Beispiel 3: Code-Review

git diff HEAD~1 | codex exec --full-auto "Review diese Aenderungen"

Beispiel 4: Bild analysieren

codex exec --full-auto -i ui-mockup.png "Implementiere dieses UI Design"

Erlaubte Flags

Haupt-Flags

| Flag | Beschreibung | |------|--------------| | exec | PFLICHT - Non-Interactive Mode | | --full-auto | PFLICHT - Auto-Accept mit Workspace-Sandbox |

Output-Flags

| Flag | Beschreibung | |------|--------------| | --json | JSON Lines Output (NDJSON) | | -o, --output-last-message <path> | Letzte Antwort in Datei | | --output-schema <path> | JSON Schema Validierung | | --color <mode> | ANSI-Farben (always/never/auto) |

Kontext-Flags

| Flag | Beschreibung | |------|--------------| | -i, --image <path> | Bild(er) an Prompt anhaengen |

Konfigurations-Flags

| Flag | Beschreibung | |------|--------------| | -m, --model <name> | Modell waehlen (siehe Modellauswahl) | | -c, --config key=value | Konfiguration inline |

Modellauswahl

| Aufgabentyp | Modell | Flag | |-------------|--------|------| | Komplexe Aufgaben (Code, Analyse, Recherche) | gpt-5.2-codex | Standard (kein Flag) | | Einfache Schreibaufgaben (README, Doku, Text) | gpt-5.1-codex-mini | -m gpt-5.1-codex-mini |

Session-Flags

| Flag | Beschreibung | |------|--------------| | codex exec resume <ID> | Session fortsetzen | | codex exec resume --last | Letzte Session | | codex resume --all | Alle Sessions listen |

VERBOTENE Flags (geben System-Zugriff!)

| Flag | Warum verboten | |------|----------------| | --yolo | Deaktiviert ALLE Sicherheiten | | --sandbox danger-full-access | Gibt Vollzugriff auf System | | --ask-for-approval never | Keine Rueckfragen bei gefaehrlichen Aktionen | | --add-dir / | Wuerde Root-Zugriff geben |

Installation

npm install -g @openai/codex
# oder
brew install --cask codex

WICHTIG: Keine API Keys!

FALSCH (API Key):

# NICHT VERWENDEN!
export OPENAI_API_KEY="sk-..."
printenv OPENAI_API_KEY | codex login --with-api-key

RICHTIG (Subscription):

# ChatGPT Login nutzen
codex login