Configuration de Codex

Configuration en une seule commande pour le suivi automatique du temps dans OpenAI Codex.

Présentation

TeeckIn s'intègre à OpenAI Codex pour suivre automatiquement votre temps de développement. La configuration prend moins d'une minute avec notre paquet NPM.

Ce que vous obtenez :

+Codex vous demande sur quel Topic vous travaillez au début de la session
+Des outils MCP pour un contrôle fluide du suivi du temps
+Changez de Topic en cours de session en le demandant à Codex

Configuration rapide

Deux étapes pour démarrer :

1. Créez un agent

Allez dans Paramètres → Automatisation → Agents et créez un nouvel agent :

- Sélectionnez Codex comme type
- Donnez-lui un nom (par ex. « Mon agent Codex »)
- Copiez à la fois le Client ID et le Client Secret

Enregistrez votre secret maintenant

Le Client Secret n'est affiché qu'une seule fois ! Copiez-le immédiatement après avoir créé l'agent. Vous pourrez toujours revoir le Client ID plus tard, mais pas le secret.

2. Lancez la configuration

bash

# Run in your project directory
npx @teeckin/agent init --codex

# The CLI will prompt for your credentials

Vos identifiants sont enregistrés en toute sécurité dans les fichiers de configuration locaux.

Personnel ou entité de facturation

Créez un agent personnel dans Paramètres → Automatisation → Agents pour les projets en solo. Pour les projets d'équipe, utilisez un agent d'entité de facturation depuis Paramètres → Automatisation → Agents (avec l'entité de facturation sélectionnée).

Ce qui est créé

La commande de configuration crée ces fichiers :

~/.codex/config.toml

Configuration du serveur MCP (au niveau utilisateur, partagée entre les projets)

.codex/hooks.json

Hooks au niveau du projet pour les événements de session

AGENTS.md

Instructions pour que Codex demande le Topic

Un agent, plusieurs projets

Vous pouvez utiliser les mêmes identifiants d'agent dans plusieurs projets. Il suffit d'exécuter npx @teeckin/agent init --codex dans chaque répertoire de projet.

Sécurité

Gardez vos secrets en lieu sûr

Le fichier config.toml contient vos identifiants dans ~/.codex/. Veillez à protéger ce répertoire.

Rotation des secrets

Vous pouvez créer jusqu'à 5 secrets par agent pour une rotation sans interruption. Allez dans Paramètres → Automatisation → Agents, dépliez votre agent et cliquez sur « Nouveau secret » dans l'onglet Secrets. Exécutez ensuite à nouveau npx @teeckin/agent init pour mettre à jour votre configuration locale.

Commandes de la CLI

Le paquet fournit des commandes pour la configuration et le contrôle manuel du Timer :

Commandes de configuration

npx @teeckin/agent initConfiguration initiale (crée les fichiers, demande les identifiants)

npx @teeckin/agent authMet à jour les identifiants (pour la rotation des secrets)

npx @teeckin/agent updateMet à jour la configuration avec les derniers outils et fonctionnalités MCP

Commandes du Timer

npx @teeckin/agent exec:statusVérifie si un Timer est en cours

npx @teeckin/agent exec:update "notes"Met à jour les notes du Timer actif

npx @teeckin/agent exec:stopArrête manuellement le Timer actif

Mise à jour après les sorties de TeeckIn

Lorsque TeeckIn ajoute de nouveaux outils ou fonctionnalités MCP, exécutez npx @teeckin/agent update pour actualiser votre configuration sans ressaisir vos identifiants.

Outils disponibles

Une fois configuré, Codex a accès à ces outils MCP :

Contrôle du Timer

teeckin_get_statusVérifie l'état du Timer ; détecte les sessions récentes pour les reprendre

teeckin_list_topicsListe les Topics et catégories disponibles

teeckin_start_timerCommence à suivre le temps sur un Topic (inclut les tâches de suivi)

teeckin_stop_timerArrête le Timer actif

teeckin_log_timeEnregistre un pointage terminé de façon rétroactive

Suivi de la liste de tâches

teeckin_add_checklist_itemAjoute une tâche à suivre sur le Timer actif

teeckin_check_itemMarque une tâche comme terminée (correspondance approximative)

teeckin_uncheck_itemRouvre une tâche terminée

teeckin_get_followupAffiche les tâches inachevées de la dernière session

teeckin_accept_followupReporte les tâches inachevées sur la session actuelle

Notes et tags

teeckin_update_timerMet à jour les notes du Timer actif (mode texte)

teeckin_list_tagsListe les tags disponibles pour classer le travail

teeckin_add_tagsAjoute des tags au Timer actif (les crée si besoin)

Mode liste de tâches

Codex peut suivre le travail sous forme d'une liste de tâches, qu'il coche au fur et à mesure. Cela crée un document vivant de ce qui a été accompli pendant la session.

Lorsque des tâches sont ajoutées, Codex les suit sur le Timer actif. À mesure que le travail avance, il coche les éléments par correspondance approximative. La liste persiste avec le pointage, vous laissant un relevé exact de ce qui a été fait.

Timer en cours : Project Alpha (45 minutes)

Liste de tâches (2/3 terminées) :

- [x] Corriger le bug de validation de connexion

- [x] Ajouter des tests unitaires

- [ ] Mettre à jour la documentation

Reprise de session

Si vous démarrez une nouvelle session dans les 10 minutes suivant l'arrêt, Codex le détecte et propose de reprendre votre session précédente.

Cela évite de perdre le contexte lorsque vous effacez une conversation pour repartir de zéro tout en voulant continuer sur le même Topic. L'outil teeckin_get_status renvoie les informations de la session récente, y compris les tâches inachevées.

Aucun Timer en cours.

Session récente disponible :

- Topic : API Development

- Arrêté : il y a 3 minute(s)

- Tâches inachevées : 1

Demandez à l'utilisateur s'il souhaite reprendre.

Suivi entre les sessions

Si une session se termine avec des tâches inachevées, celles-ci sont enregistrées. Au démarrage d'une nouvelle session sur le même Topic, Codex peut les reporter automatiquement.

Utilisez teeckin_get_followup pour vérifier les éléments inachevés de la dernière session, puis teeckin_accept_followup pour les ajouter à la liste actuelle.

Flux automatique

Les instructions d'AGENTS.md indiquent à Codex de vérifier les tâches de suivi au début de la session et de vous demander si vous souhaitez les reporter.

Référence config.toml

Le serveur MCP est configuré dans votre configuration utilisateur avec une authentification OAuth :

toml

# ~/.codex/config.toml

[mcp_servers.teeckin]
url = "https://api.teeckin.com/api/mcp"
required = false
oauth_client_id = "teeckin_agent_..."
oauth_client_secret = "tcs_..."

Dépannage

Codex ne demande pas le Topic

Assurez-vous que le fichier AGENTS.md a bien été créé. Vérifiez que la section TeeckIn figure en bas.

Les outils MCP ne sont pas disponibles

Vérifiez que ~/.codex/config.toml contient la section [mcp_servers.teeckin] avec des identifiants valides.

Erreur « Authentication failed » pendant l'init

Vérifiez vos identifiants dans Paramètres → Automatisation → Agents. Si le secret a été perdu, créez-en un nouveau dans l'onglet Secrets.

Erreur « invalid_client »

Vérifiez les identifiants dans ~/.codex/config.toml. Le client_id commence par « teeckin_agent_ » et le client_secret par « tcs_ ». Exécutez init à nouveau pour les ressaisir.

Cet article vous a-t-il été utile ?