Quickstart

Rendez-vous sur l’application CodeCourier et connectez-vous avec la méthode de votre choix. CodeCourier utilise Clerk pour l’authentification, vous pouvez donc vous connecter avec Google, GitHub, e-mail ou tout autre provider OAuth configuré.

Après votre première connexion, CodeCourier crée votre enregistrement utilisateur et vous redirige vers l’écran de sélection de projet. Si vous avez été invité à un projet existant, vous le verrez listé avec un badge d’invitation en attente.

Cliquez sur New Project sur l’écran de sélection de projet. Saisissez un nom pour votre projet - cela génère automatiquement un slug d’URL. En option, indiquez dès maintenant l’URL de votre repository GitHub (vous pouvez aussi l’ajouter plus tard dans les paramètres du projet).

Une fois créé, CodeCourier vous définit comme owner du projet et vous redirige vers le dashboard du projet. La sidebar organise votre espace de travail en sections : Issues (sessions d’issues et work chains), Runs (tous les runs de workflow et de sandbox), Workflows, Personas, Learnings et Insights (usage, analytics et membres). Les sandboxes sont accessibles via les pages de détail de chaque run.

Rendez-vous dans Project Settings depuis la sidebar (l’icône clé à molette en bas). Ouvrez l’onglet API Keys. Vous devez configurer au moins deux providers :

1. E2B - Requis. Sert à provisionner les sandboxes cloud. Récupérez votre clé depuis le dashboard E2B sur e2b.dev/dashboard.
2. Anthropic / OpenRouter / OpenAI - Au moins un est requis. Cela alimente le modèle IA qui tourne dans vos sandboxes. Choisissez le provider qui correspond à l’outil CLI que vous voulez utiliser (Anthropic pour Claude Code, OpenRouter ou OpenAI pour un accès plus large aux modèles).
3. GitHub - Optionnel mais recommandé. Un personal access token avec le scope repo permet à CodeCourier de créer automatiquement des branches et des pull requests.

Les clés API sont chiffrées au repos et stockées par projet. Chaque membre de l’équipe ne voit que les quatre derniers caractères des clés configurées. Les clés ne sont déchiffrées côté serveur que lorsqu’un job Trigger.dev doit provisionner une sandbox.

Rendez-vous dans Workflows depuis la sidebar. Cliquez sur New Workflow pour ouvrir la boîte de dialogue de création. Pour votre premier workflow, commencez par le type Designer & Checker :

• Name: Donnez-lui un nom descriptif, p. ex., “Feature Builder”
• Type : Sélectionnez Designer & Checker
• Template: Choisissez le sandbox template de votre outil CLI préféré (p. ex., claude-code pour Claude Code)
• Max Iterations : Réglez sur 3 pour un compromis qualité/coût équilibré
• Timeout: 30 minutes (1 800 000 ms) est un bon point de départ
• Checker Instructions: Décrivez ce que le checker doit vérifier, p. ex., “Vérifie que l’implémentation suit les bonnes pratiques TypeScript, qu’elle n’a aucune erreur de type et qu’elle inclut une gestion d’erreurs appropriée.”

Cliquez sur Create. Votre blueprint de workflow est désormais enregistré et prêt à être exécuté.

Depuis la page des workflows, cliquez sur le bouton Run de votre nouveau workflow. Cela ouvre la boîte de dialogue de run où vous configurez l’exécution spécifique :

• Prompt : Écrivez une instruction claire et précise pour l’agent IA. Par exemple :

Add a new utility function to lib/utils.ts that formats
a number as a human-readable file size (e.g., 1024 becomes
"1 KB", 1048576 becomes "1 MB"). Include JSDoc comments
and handle edge cases like 0 and negative numbers.
Write a test file at lib/__tests__/utils.test.ts.

• GitHub Repo URL : Saisissez l’URL de votre repository si elle n’est pas déjà définie au niveau du projet
• Branch Name : Spécifiez éventuellement un nom de branche, ou laissez CodeCourier en générer un

Cliquez sur Start Run. CodeCourier dépêche un job en arrière-plan via Trigger.dev qui :

1. Provisionne une sandbox E2B avec le template que vous avez configuré
2. Installe et démarre l’outil CLI IA à l’intérieur de la sandbox
3. Envoie votre prompt avec tout document de contexte rattaché et les learnings approuvés du projet
4. Attend que le designer termine, puis exécute le checker avec vos instructions de revue
5. Si le checker rejette, renvoie le feedback au designer pour une nouvelle itération
6. Enregistre les scores de qualité de chaque étape (correction, sûreté de typage, style de code, couverture de tests, complétude)
7. À la fin, crée éventuellement une PR et extrait des learnings

Rendez-vous dans Runs depuis la sidebar pour voir votre run actif. Cliquez sur le run pour ouvrir sa vue de détail. Vous verrez :

• Statut du run : pending, running, completed ou failed
• Timeline des étapes : Chaque étape de designer et de checker est affichée avec son statut, son heure de début et sa durée
• Messages en direct : La conversation entre la plateforme et l’agent IA s’affiche en temps réel, y compris le raisonnement de l’agent et ses appels d’outils
• Verdicts du checker : Si vous utilisez un workflow designer/checker, chaque étape de checker affiche un verdict réussite/échec avec du feedback
• Scores de qualité : Les étapes terminées affichent le détail de leur score de qualité - visible dans le panneau de détails de l’étape

Une fois le run terminé, vérifiez les points suivants :

• Statut de la PR : Si l’intégration GitHub est configurée et que le run était réglé pour créer une PR, vous verrez l’URL et le statut de la PR (creating, created, merged ou failed) directement sur la page de détail du run. Les résultats des checks CI apparaîtront à mesure que votre pipeline s’exécute sur la branche de la PR.
• Scores de qualité : Le résumé du run affiche le score de qualité global. Dépliez les étapes individuelles pour voir les scores par dimension et identifier les axes d’amélioration de vos prompts ou de vos configurations de persona.
• Learnings : Rendez-vous dans la section Learnings. Si l’extraction de learnings était activée, vous verrez de nouveaux learnings en attente extraits de la session. Passez chacun en revue et approuvez-le ou rejetez-le - les learnings approuvés seront automatiquement inclus dans les runs futurs.
• Suivi des coûts : Rendez-vous dans Usage dans la section insights pour voir la consommation de tokens et le détail des coûts du run.