Codex ist der KI-Agent von OpenAI. Du kannst ihn auf drei Wegen nutzen: als CLI im Terminal, als Desktop-App oder als ChatGPT-/Codex-Extension in VS Code, die die Welcome-Seite der MainPath-Extension direkt verlinkt. Die MainPath Toolbox installiert CLI und Desktop-Variante im Entwickler-Setup.
Starten
Für die CLI wechselst du in den Projektordner und rufst codex auf. Wie bei jedem Agenten gilt: Öffne den übergeordneten Projektordner, damit alle Repositories sichtbar sind.
cd ~/Documents/MainPath/<organisations-slug>/<projekt-slug>
codex
Vorkonfiguration
MainPath-Regeln kommen aus dem Agent-Plugin der mp CLI. mp agent install legt Plugin und Skills unter ~/.codex/ ab und schreibt den MCP-Server application-platform in ~/.codex/mcp.json. Codex kennt damit von Anfang an die Plattform-Konventionen: Anwendungen starten über mp run-local, .gitlab-ci.yml und env/*.generated.env verwaltet MainPath, eigene Werte gehören in env/*.custom.env. Projekt-eigene Ergänzungen landen in einer AGENTS.md im Anwendungs-Repository, siehe Eigene Regeln für KI-Agenten.
Agent-Plugin installieren
mp agent install
mp login
Ein eigener Marketplace-Eintrag ist nicht nötig. Ist die mp CLI noch nicht angemeldet, führst du mp login aus und startest Codex neu. Alle Installationswege, die Liste der MCP-Werkzeuge und die typischen Fehlerbilder stehen unter CLI und Agent-Plugin.
Ein Prompt wie „Lege ein neues MainPath-Projekt mit einer Flutter-App und einem FastAPI-Backend an und klone es.“ reicht danach; den Ablauf dahinter beschreibt Neues Projekt anlegen.