Un poste de pilotage local pour les runs Codex.

CodexDeck garde le plan AI_TODO.md, la sortie live, l'état du run et les contrôles essentiels dans une seule interface terminal. L'objectif est simple : lancer Codex depuis le dossier du projet sans perdre le fil.

Voir le code Installation pipx

Windows et Ubuntu. Une seule exécution Codex active à la fois.

Interface terminal CodexDeck avec le plan AI_TODO, la sortie Codex, un résumé des tâches et une barre de statut. — Capture réelle de la TUI CodexDeck.

Pourquoi

Réduire le bruit autour d'un agent local.

Un run Codex peut vite disperser l'attention entre le plan, les logs, le terminal, les permissions et le statut du process. CodexDeck rassemble ces signaux dans une TUI compacte.

Le projet ne remplace pas Codex. Il encadre son exécution locale : un plan Markdown, un process, des logs persistants, et des commandes explicites pour lancer, stopper ou reprendre.

Workflow

Un cycle de travail lisible.

Préparer le plan Créer ou éditer AI_TODO.md dans le dossier du projet.
Lancer CodexDeck La commande codexdeck résout les chemins depuis le dossier courant.
Exécuter le run r démarre Codex sur la première tâche non cochée.
Suivre et contrôler Sortie live, logs locaux, stop avec s, aide avec h.
Reprendre proprement Le plan reste la source de vérité, modifiable avec l'éditeur ou la touche n.

Fonctions clés

Ce qui rend le run contrôlable.

Plan visible

Lecture des tâches Markdown cochées/non cochées et focus sur la première action ouverte.

Sortie live

Flux Codex visible pendant l'exécution et logs écrits dans logs/agent.log.

Contrôle du process

Démarrage, arrêt, confirmation de sortie et restauration propre du terminal.

Configuration locale

codexdeck.conf, variables d'environnement, modèles et labels de permissions configurables.

Mode automatique prudent

Relance seulement si le run précédent avance réellement dans le plan.

Packaging simple

Commande globale via pipx, sans dépendance runtime externe côté package Python.

Installation

Un outil local, lancé depuis le dossier à traiter.

CodexDeck lit par défaut AI_TODO.md, codexdeck.conf et logs/ dans le répertoire où la commande est exécutée.

pipx install git+https://github.com/MLyte/CodexDeck.git
codexdeck --version
codexdeck

Statut

Un MVP volontairement cadré.

Version package lue dans le repo : 0.1.2.
Compatibilité annoncée : Windows et Ubuntu.
Limite assumée : un seul process Codex actif.
Focus actuel : packaging, validation terminal cross-platform, documentation et comportement prévisible.

Open source

Le repo documente l'usage, la configuration et le flow pipx.

Ouvrir GitHub Retour aux projets