thenamangoyal/codex-vision

Was macht codex-vision?

Claude-Code-Fähigkeit: Sende Bilder an (und generiere/bearbeite Bilder von) OpenAI Codex CLI. Umschließt codex exec -i mit drei Modi + optionaler tmux-Sitzung.

Überblick

thenamangoyal/codex-vision ist ein Skill für Claude Code, der die nahtlose Interaktion mit der OpenAI Codex CLI für bildbasierte Aufgaben ermöglicht. Er fungiert als Wrapper um den Befehl codex exec -i und bietet drei verschiedene Betriebsmodi:

1. Bild senden – Sende ein vorhandenes Bild zur Analyse oder Verarbeitung an Codex.
2. Bild generieren – Erstelle ein neues Bild basierend auf einer textuellen Beschreibung mithilfe von Codex.
3. Bild bearbeiten – Bearbeite ein vorhandenes Bild unter Verwendung von Codex (z. B. Anwendung von Filtern, Größenänderung, Formatkonvertierung).

Zusätzlich kann eine optionale tmux-Sitzung aktiviert werden, um die Ausführung in einer eigenen persistenten Terminalsitzung zu isolieren.

Voraussetzungen

• Claude Code muss installiert und konfiguriert sein.
• OpenAI Codex CLI (codex) muss installiert und im System-PATH verfügbar sein.
• tmux (optional, für den tmux-Modus) muss installiert sein.

Installation

1. Navigiere zu deinem Claude-Code-Projektverzeichnis.

2. Führe den folgenden Befehl aus, um den Skill zu installieren:

   claude add skill thenamangoyal/codex-vision
   

3. Der Skill wird heruntergeladen und steht dann für die Verwendung in Claude-Code-Sitzungen zur Verfügung.

Verwendung

Grundlegende Befehle

• vision-send <pfad_zum_bild> – Sende ein Bild zur Analyse an Codex.
• vision-generate <beschreibung> – Generiere ein neues Bild basierend auf der Beschreibung.
• vision-edit <pfad_zum_bild> <änderungen> – Bearbeite ein Bild mit den angegebenen Änderungen.

tmux-Modus

Füge die Option --tmux oder --tmux-session <name> an einen beliebigen Befehl an, um die Ausführung in einer dedizierten tmux-Sitzung zu starten. Beispiel:

vision-generate "Ein Roboterkatze, die im Sonnenuntergang eine Tastatur benutzt" --tmux

Konfiguration

Es sind keine speziellen Konfigurationsvariablen erforderlich. Der Skill verwendet die Standard-Konfiguration der Codex-CLI. Stelle sicher, dass die Umgebungsvariable OPENAI_API_KEY gesetzt ist, damit die Codex-CLI funktioniert.

Beispiele

Beispiel 1: Bild analysieren

vision-send screenshot.png

Dies sendet screenshot.png an Codex mit der Bitte, seinen Inhalt zu analysieren.

Beispiel 2: Bild generieren

vision-generate "Ein futuristisches Stadtbild mit fliegenden Autos und Neonlichtern"

Beispiel 3: Bild bearbeiten

vision-edit logo.png "Ändere die Hintergrundfarbe von Blau zu Grün"

Beispiel 4: Mit tmux

vision-edit foto.jpg "Weichzeichner anwenden" --tmux-session bildbearbeitung

Fehlerbehebung

• codex: Befehl nicht gefunden: Stelle sicher, dass die Codex-CLI korrekt installiert und im PATH ist.
• tmux-Fehler: Überprüfe, ob tmux installiert ist (which tmux).
• OpenAI-API-Fehler: Verifiziere, dass OPENAI_API_KEY korrekt gesetzt ist.

Lizenz

MIT