Scripts et intégration continue avec la CLI DCode : dcode -p, JSON et exécutions planifiées

dcode -p exécute une seule requête sans l'espace de travail puis se termine. Il lit le dossier où il s'exécute, fait la tâche et affiche la réponse, pour qu'un script ou une tâche d'intégration continue (CI) puisse s'en servir. DCode 2.5, publié le 10 novembre 2026, lui donne les options dont ont besoin les scripts et les tâches de CI, une façon de se connecter sur une machine de CI, et dcode schedule pour des requêtes selon un horaire. Le reste de la version est dans notre article sur DCode 2.5, et l'espace de travail du terminal dans notre article sur la CLI DCode 2.0.

Comment exécuter une seule requête?

dcode -p "Explique les tests qui échouent dans ce dépôt"

Sans --model, une exécution prend votre choix enregistré, sinon Raven Flash; --model "Raven Max" choisit l'autre modèle. --attach ajoute un fichier, une image ou un PDF, et --cwd s'exécute dans un autre dossier. Une exécution ne s'arrête jamais pour demander une mise à jour.

Quoi de neuf pour les scripts dans DCode 2.5?

Ces options sont nouvelles pour dcode -p dans 2.5 :

• --allowed-tools <rules...> permet à des outils de s'exécuter sans demander pour cette exécution, par exemple "Bash(npm test:*) Edit".
• --add-dir <folders...> permet à l'agent de travailler dans d'autres dossiers que le dossier courant.
• --max-turns <n> arrête l'exécution après ce nombre de tours.
• --system-prompt <text> remplace l'invite système pour cette exécution.
• --append-system-prompt <text> ajoute du texte après l'invite système pour cette exécution.
• --input-format stream-json lit vos messages sur l'entrée standard, un objet JSON par ligne, avec --output-format stream-json.
• --json-schema <schema> fait de la réponse un JSON conforme à ce schéma, donné en texte JSON ou dans un fichier.
• --mcp-config <file|json> ajoute des serveurs MCP pour cette exécution.
• --settings <file|json> charge d'autres réglages pour cette exécution, en texte JSON ou dans un fichier.
• --fallback-model <name> est le modèle qu'utilise l'exécution quand celui choisi est occupé.
• --name, --session-id et --fork-session nomment la session, la démarrent avec l'identifiant de votre choix, ou continuent dans une copie d'une session.
• --worktree [name] travaille dans un nouvel arbre de travail git sur la branche dcode/<name>, pour que les changements de l'exécution restent à l'écart de votre copie de travail.

Que peut faire une exécution sans demander?

Personne ne peut répondre à une question pendant une exécution -p : une étape qui demanderait votre accord est donc refusée. C'est pourquoi -p travaille en Accès complet à moins que vous passiez un autre mode. Sur une machine ou un dépôt qui vous importe, choisissez ce que l'exécution peut faire :

# lire et planifier seulement
dcode -p "Planifie la migration vers la nouvelle API" --mode plan

# demander avant les modifications, avec les outils voulus permis d'avance
dcode -p "Lance les tests et corrige ce qui échoue" --mode build --allowed-tools "Bash(npm test:*) Edit"

# aucun interpréteur de commandes pour cette exécution
dcode -p "Résume les TODO ouverts" --disallowed-tools "Bash"

--allowed-tools prend des noms d'outils comme Edit, des règles comme Bash(npm test:*) et des outils MCP, séparés par des espaces. Une règle qui n'est pas une règle d'outil arrête l'exécution avant qu'elle commence.

Qu'affiche une exécution?

Toute autre valeur arrête l'exécution avec un message, pour qu'une faute de frappe ne devienne jamais du texte brut qu'un analyseur ne peut pas lire. L'objet JSON contient response, la réponse; sessionId, pour reprendre la session avec --resume; usage, les jetons de l'exécution quand ils sont connus; et, avec --json-schema, structuredOutput, la réponse comme valeur JSON.

Nouveauté de 2.5, --input-format stream-json envoie plusieurs messages sur l'entrée standard. Chaque ligne avec "type":"user" lance un tour, tous dans la même session, et chacun se termine par sa propre ligne result :

printf '%s\n' '{"type":"user","message":{"role":"user","content":"Trouve le test le plus lent"}}' \
  '{"type":"user","message":{"role":"user","content":"Maintenant, rends-le plus rapide"}}' \
  | dcode --input-format stream-json --output-format stream-json

Comment un script lit-il une réponse JSON?

Donnez un schéma à --json-schema, en texte JSON ou dans un fichier, et la réponse doit être un JSON qui y est conforme. Si la première réponse ne l'est pas, DCode redemande une fois dans la même session; si la deuxième ne l'est pas non plus, l'exécution affiche Error: the answer did not match --json-schema avec la raison et se termine avec le code 1. Un schéma pour une liste de noms de paquets, dans schema.json :

{
  "type": "object",
  "properties": {
    "packages": { "type": "array", "items": { "type": "string" } }
  },
  "required": ["packages"]
}

Lancez l'exécution avec la sortie JSON, puis lisez structuredOutput depuis n'importe quel script. Ici avec Node.js, dont la CLI a déjà besoin :

dcode -p "Énumère les paquets de ce dépôt" --json-schema schema.json \
  --output-format json > run.json
node read-packages.mjs

// read-packages.mjs
import { readFileSync } from "node:fs";

const run = JSON.parse(readFileSync("run.json", "utf8"));
for (const name of run.structuredOutput.packages) console.log(name);

Comment exécuter DCode en intégration continue?

Donnez à DCODE_API_KEY la valeur d'une clé d'API de votre tableau de bord, gardée dans les secrets de votre CI et jamais dans le dépôt. Elle connecte cette exécution sans navigateur. La clé est gardée en mémoire pour cette exécution seulement et n'est jamais enregistrée, et elle est retirée de l'environnement avant que quoi que ce soit s'exécute, pour que les commandes de l'agent ne la voient jamais. Si la clé est refusée, l'exécution le dit et se termine avec le code 1.

Voici une tâche pour GitHub Actions qui passe en revue chaque demande de tirage et garde la réponse en JSON. Toute CI qui fait tourner Node.js 22.13 ou version ultérieure fonctionne de la même façon : installer la CLI, définir la clé à partir des secrets, lancer dcode -p.

name: Revue DCode
on: pull_request

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
      - uses: actions/setup-node@v4
        with:
          node-version: 22
      - run: npm install -g @dipoleml/dcode-cli
      - run: |
          dcode -p "Passe en revue les changements de cette branche et énumère les risques" \
            --mode plan --output-format json > review.json
        env:
          DCODE_API_KEY: ${{ secrets.DCODE_API_KEY }}
      - run: node -e "console.log(require('./review.json').response)"

Les requêtes faites avec une clé d'API sont payées avec vos crédits d'API. Les crédits se vendent en paquets de 5, 10, 20 et 50 $ US; ils s'achètent une fois, ne se renouvellent jamais et n'expirent jamais. Une clé peut recevoir un plafond de dépenses et une date d'expiration, comme l'explique notre article sur une clé par application.

Quels codes de sortie une exécution renvoie-t-elle?

Une erreur tient en une ligne de texte sur la sortie d'erreur standard, avec le traceId de l'exécution, et --verbose affiche la sortie d'erreur complète. Sans DCODE_API_KEY, une exécution utilise la connexion enregistrée sur la machine par dcode login; sans l'une ni l'autre, elle se termine avec le code 2.

Comment exécuter une requête selon un horaire?

Nouveauté de 2.5, dcode schedule exécute une requête selon un horaire :

# chaque jour de semaine à 9 h, dans ce dossier
dcode schedule add "every weekday at 9:00" "Résume les commits d'hier et les TODO ouverts"

# une expression cron, un autre dossier, le mode plan
dcode schedule add "30 7 * * 1" "Vérifie les mises à jour des dépendances et énumère-les" --cwd ~/code/api --mode plan

dcode schedule list
dcode schedule run <id>
dcode schedule remove <id>

Le moment est une expression cron à cinq champs à l'heure locale (minute, heure, jour, mois, jour de la semaine), ou des mots anglais comme "every day at 9:00", "every monday at 8:30" ou "every 2 hours". Chaque exécution est un dcode -p avec votre requête dans ce dossier, le dossier courant à moins que vous passiez --cwd, en mode Auto à moins que vous passiez --mode. Le planificateur de votre ordinateur lance les exécutions, donc la CLI n'a pas besoin d'être ouverte, et la sortie de chaque exécution s'ajoute à un journal sous ~/.dcode/cli/schedules. list --json affiche les horaires en JSON.

Personne n'est là pour répondre pendant une exécution planifiée non plus : une étape qui demanderait votre accord est refusée. En mode Auto, tout ce sur quoi Auto demande toujours, comme une poussée ou un déploiement, n'a donc pas lieu. Passez --mode plan pour une tâche qui doit seulement lire et rendre compte.

Comment installer la CLI?

La CLI demande Node.js 22.13 ou version ultérieure. Installez-la en une ligne, ou avec npm :

# macOS et Linux
curl -fsSL https://dipoleml.com/install.sh | sh

# Windows (PowerShell)
irm https://dipoleml.com/install.ps1 | iex

# ou avec npm
npm install -g @dipoleml/dcode-cli

La CLI s'installe gratuitement, et les exécutions connectées avec votre compte puisent dans votre plan. Les plans et les prix de l'API par jeton sont sur la page des tarifs.