Workban

Ratgeber · Codex

Codex im Team: Jede Aufgabe auf dem Board, ohne Nachtragen.

Codex von OpenAI arbeitet im Terminal auf deinem Rechner. Diese Anleitung zeigt, wie Codex seine Aufgaben selbst auf ein gemeinsames Kanban-Board schreibt, damit dein Team sieht, woran es arbeitet, wie lange es dauert und wie viele Tokens es verbraucht.

  • Codex
  • AGENTS.md
  • Hooks nach einmaliger Freigabe
  • Stand 30. Oktober 2026

Ausgangslage

Codex in der Cloud oder auf deinem Rechner.

Codex gibt es in zwei Formen. In der Cloud arbeitet es eine Aufgabe ab, die du ihm zuweist, etwa ein Issue in Linear oder GitHub, und meldet sich mit einem Ergebnis. Auf deinem Rechner arbeitet es im Terminal mit dir zusammen, Schritt für Schritt, in deinem Repository.

Für die Cloud gibt es Anbindungen an Ticketsysteme. Bei der Arbeit im Terminal fehlt dem Team dagegen der Überblick: Welche Sitzung läuft bei wem, woran arbeitet sie, was ist fertig, was hat es gekostet? Darum geht es in dieser Anleitung.

Einbindung

AGENTS.md für den Ablauf, Hooks für den Rest.

workban init schreibt den Ablauf in AGENTS.md, die Datei, die Codex in jedem Repository liest. Die Hooks stehen in deinen Benutzer-Einstellungen von Codex.

AGENTS.md
Der volle Ablauf: wann Codex eine Aufgabe anlegt, startet, auf Wartet setzt und abschließt, mit den Befehlen der CLI.
.workban.toml
Zu welchem Workban-Projekt das Repository gehört. Daran erkennen die Hooks, dass sie hier arbeiten sollen.
~/.codex/hooks.json
Die Hooks: der Riegel vor Änderungen, der Überblick beim Start einer Sitzung, der Token-Verbrauch nach jeder Runde und die Zeile für die Seite Live.
Freigabe
Codex führt Hooks erst aus, wenn du sie geprüft und freigegeben hast, über /hooks in Codex. Neu fragt es nur, wenn ein Update neue Hooks mitbringt. Fehlt die Freigabe, sagt es dir der Agent beim nächsten Start einer Aufgabe.

Mehrere Agenten

Vom Konzept zu Aufgaben, umgesetzt von mehreren Sitzungen gleichzeitig.

Codex kann ein ganzes Vorhaben planen und als Aufgaben ins Backlog legen. Danach arbeiten mehrere Sitzungen sie parallel ab, und das Board zeigt, welche woran sitzt.

  1. 01

    Konzept erstellen

    Lass Codex ein Konzept für das Vorhaben schreiben und in Aufgaben zerlegen, die sich einzeln umsetzen lassen.

  2. 02

    Als Aufgaben ablegen

    Codex legt jede Aufgabe mit Beschreibung im Backlog an, ohne sie zu starten.

    workban task create "Passkey-Knopf auf der Login-Seite" --assignee me --json

  3. 03

    Parallel starten

    Starte mehrere Sitzungen, am besten jede in einem eigenen Git-Worktree, damit sie sich nicht in die Quere kommen, und sag jeder, welche Aufgabe sie übernimmt: „erledige #31“.

    workban task start 31 --agent codex --json

  4. 04

    Auf dem Board verfolgen

    Jede Sitzung arbeitet unter ihrer eigenen Aufgabe, der Riegel zählt je Sitzung. Das Board zeigt live, welche Aufgabe schon läuft, welche testet und welche auf dich wartet, und workban task list zeigt der nächsten Sitzung, was schon vergeben ist.

Einrichten

In fünf Schritten verbunden.

Einmal pro Rechner und einmal pro Repository. Den Installationsbefehl für dein System nennt die Seite Einrichten.

  1. 01

    Workspace anlegen

    Registrieren, ohne Karte, und dem Bereich deines Teams einen Namen geben.

  2. 02

    CLI installieren

    Ein Befehl im Terminal installiert die Workban-CLI, für macOS, Linux und Windows. Node brauchst du nicht.

  3. 03

    Token erstellen

    In Workban im Benutzermenü unter Tokens einen persönlichen Zugangsschlüssel erstellen. Du siehst ihn nur einmal.

  4. 04

    Anmelden

    Die CLI meldet sich mit dem Token in deinem Namen an, einmal pro Rechner.

    workban auth login --token <token>

  5. 05

    Repository verbinden

    Im Ordner deines Projekts ausführen, dann in Codex die Hooks unter /hooks freigeben. Ab dann legt Codex seine Aufgaben selbst an.

    workban init

Riegel

Keine Änderung ohne Aufgabe, auch in Codex.

Sobald du die Hooks freigegeben hast, hält Workban die Änderungen von Codex im Repository an, bis eine eigene Aufgabe läuft.

  • Greift bei apply_patch und bei Shell-Befehlen, sobald sie erkennbar schreiben
  • Zählt je Sitzung: Eine zweite Sitzung im selben Repository braucht ihre eigene Aufgabe
  • Was außerhalb des Repositorys liegt, etwa /tmp, bleibt frei
  • Ist Workban nicht erreichbar, lässt der Riegel alles durch

Tokens

Der Verbrauch kommt aus dem Protokoll, das Codex ohnehin schreibt.

Codex legt jede Sitzung als Datei unter ~/.codex/sessions ab, mit laufenden Zählerständen der Tokens. Die Workban-CLI liest daraus nach jeder Runde, was seit dem letzten Stand dazukam, und bucht es auf die Aufgabe, die gerade In Arbeit ist. Gezählt wird nur, solange sie dort steht.

Daraus schätzt Workban die Kosten zu den Listenpreisen von OpenAI, getrennt nach Modell. Ein ChatGPT-Abo rechnet es nicht ein, die Zahl zeigt also, was die Arbeit zu Listenpreisen gekostet hätte.

Fragen

Was Teams vorher wissen wollen.

Funktioniert das auch mit Codex in der Cloud?
Nein. Workban bindet Codex auf deinem Rechner ein, über die CLI und die Hooks. Eine Aufgabe, die Codex in der Cloud abarbeitet, erscheint nicht von selbst auf dem Board.
Können Codex und Claude Code im selben Team arbeiten?
Ja. Auf dem Board steht an jeder Aufgabe, welcher Agent sie bearbeitet hat, und die Statistik zeigt erledigte Aufgaben nach Menschen, Claude Code, Codex und anderen Agenten.
Liest Workban unseren Code?
Nein. Workban sieht nur, was Codex über die CLI meldet: Titel, Beschreibung, Kommentare, Status und Branch einer Aufgabe, dazu für die Live-Ansicht eine kurze Zeile, was die Sitzung gerade tut.
Was kostet das?
Workban ist kostenlos, du registrierst dich ohne Karte.
Geht das mit meinem ChatGPT-Abo, etwa Pro?
Ja. Codex läuft so, wie du es angemeldet hast, mit einem ChatGPT-Abo wie Plus oder Pro oder mit einem API-Schlüssel. Workban braucht keinen Zugang zu deinem Konto bei OpenAI und keinen API-Schlüssel.

Weiter

Mehr zu Agenten und Kosten.

Loslegen

Probier es mit deiner nächsten Aufgabe.

Workban ist kostenlos. Dein Workspace steht in einer Minute, und die erste Aufgabe erscheint, sobald dein Agent loslegt.