poe-code

Poe Code est un outil qui achemine vos agents de codage préférés (Claude Code, Codex, OpenCode, Goose, etc.) via l'API Poe, de sorte que vous n'avez besoin que d'un seul abonnement Poe au lieu de gérer plusieurs fournisseurs ou comptes. Il fonctionne avec les CLI ou applications de bureau normales des agents après une configuration unique, et prend également en charge le lancement de prompts ponctuels pour le scripting et le CI/CD. ## Démarrage rapide Définir Poe Code comme fournisseur par défaut pour un agent (met à jour les fichiers de configuration) : ```bash npx poe-code@latest configure npx poe-code@latest configure codex # ou claude, opencode, goose ``` Supprimer les remplacements avec `unconfigure` : ```bash npx poe-code@latest unconfigure claude ``` ## Authentification Utilise votre clé API Poe. Au premier lancement, vous serez invité à vous connecter via le navigateur (OAuth). Vous pouvez aussi fournir la clé directement : ```bash npx poe-code@latest login npx poe-code@latest login --api-key <your-key> export POE_API_KEY=<your-key> ``` Les identifiants sont stockés dans `~/.poe-code/`. Vérifiez l'état avec `poe-code auth status`, supprimez avec `logout`. ## Utilitaires - **Lancer un prompt ponctuel** : `npx poe-code@latest spawn codex "Say hello" --mode read` (modes : yolo, auto, edit, read ; requis en CI sans TTY). - **Lancer contre un dépôt GitHub** : `--cwd github://owner/repo` ou avec ref/sous-répertoire comme `github://owner/repo#main:packages/auth`. - **Transmettre un prompt via stdin** : `echo "Say hello" | npx poe-code@latest spawn codex --mode read`. - **Réviser une PR GitHub** : `code-review install`, `code-review run <url>`, `code-review commit <url> --dry-run`. - **Tester un service configuré** : `npx poe-code@latest test codex`. - **Installer les CLI des agents** : `install claude-code`, `install codex`, `install opencode`, `install goose`. - **Options facultatives** : `--dry-run` (afficher les mutations sans toucher au disque), `--yes` (accepter les valeurs par défaut). ## Utilisation et facturation Vérifier le solde de points de calcul et l'historique d'utilisation : ```bash poe-code usage poe-code usage list poe-code usage list --limit 100 poe-code usage list --filter claude ``` ## Modèles Lister les modèles disponibles de l'API Poe, filtrer par endpoint, fournisseur ou recherche : ```bash poe-code models poe-code models --endpoint /v1/responses poe-code models --endpoint /v1/chat/completions poe-code models --search claude ``` ## SDK Utiliser Poe Code par programmation dans votre propre code : ```typescript import { spawn, getPoeApiKey, getPoeAuthIdentity } from "poe-code"; const apiKey = await getPoeApiKey(); const identity = await getPoeAuthIdentity(); const result = await spawn("claude-code", { prompt: "Fix the bug in auth.ts", cwd: "/path/to/project", model: "claude-sonnet-4-6" }); console.log(result.stdout); ``` - `spawn(service, options)` – exécute un seul prompt ; les options incluent `prompt`, `cwd` (chemin local ou localisateur `github://`), `model`, `mode`, `args`. Retourne `{ stdout, stderr, exitCode }`. - `spawn.pretty(service, options)` – identique mais affiche le flux d'événements ACP en couleur. - `getPoeApiKey()` – lit la variable d'environnement `POE_API_KEY` ou le fichier d'identifiants. - `getPoeAuthIdentity()` – récupère l'identité du compte Poe. Pour une composition orientée plugin, utilisez le sous-chemin `poe-code/agent` avec `agent()`, `openaiResponsesPlugin()`, `systemPromptPlugin()`. ## Aperçu de recherche Fonctionnalités susceptibles de subir des changements incompatibles : - **SafeJS** – interpréteur JavaScript avec capacités hôtes explicites, budgets d'exécution, points de contrôle reprenables. Publié sous `@poe-platform/safe-js`. Conformité complète non établie. - **Pipeline** – exécuter des plans de tâches avec étapes configurables, progression en direct, suivis en file d'attente. - **Ralph** – boucle de build agentique itérant sur un document markdown. - **Experiment loop** – boucle d'optimisation de style Karpathy (l'agent modifie le code, l'évaluation note, conserver/rejeter via git). - **Poe Agent** – runtime d'agent composable. ## Mise à jour ```sh npx poe-code@latest update npx poe-code@latest update --package-manager pnpm ``` Pour les vérifications de version, les exécutions à blanc et les worktrees gérés, consultez la référence complète.