Sobre o projeto

O Poe Code é uma ferramenta que roteia seus agentes de programação favoritos (Claude Code, Codex, OpenCode, Goose, etc.) através da API do Poe, para que você precise apenas de uma assinatura Poe em vez de gerenciar múltiplos provedores ou contas. Ele funciona com as CLIs normais ou aplicativos desktop dos agentes após uma configuração única, e também suporta a execução de prompts avulsos para scripting e CI/CD. ## Início Rápido Defina o Poe Code como provedor padrão para um agente (atualiza arquivos de configuração): ```bash npx poe-code@latest configure npx poe-code@latest configure codex # ou claude, opencode, goose ``` Remova as substituições com `unconfigure`: ```bash npx poe-code@latest unconfigure claude ``` ## Autenticação Usa sua chave de API do Poe. Na primeira execução, você será solicitado a fazer login pelo navegador (OAuth). Você também pode fornecer a chave diretamente: ```bash npx poe-code@latest login npx poe-code@latest login --api-key <sua-chave> export POE_API_KEY=<sua-chave> ``` As credenciais são armazenadas em `~/.poe-code/`. Verifique o status com `poe-code auth status`, remova com `logout`. ## Utilitários - **Executar um prompt avulso**: `npx poe-code@latest spawn codex "Say hello" --mode read` (modos: yolo, auto, edit, read; obrigatório em CI sem TTY). - **Executar contra um repositório GitHub**: `--cwd github://owner/repo` ou com ref/subdiretório como `github://owner/repo#main:packages/auth`. - **Enviar prompt via stdin**: `echo "Say hello" | npx poe-code@latest spawn codex --mode read`. - **Revisar um PR do GitHub**: `code-review install`, `code-review run <url>`, `code-review commit <url> --dry-run`. - **Testar um serviço configurado**: `npx poe-code@latest test codex`. - **Instalar CLIs de agentes**: `install claude-code`, `install codex`, `install opencode`, `install goose`. - **Flags opcionais**: `--dry-run` (mostra mutações sem tocar no disco), `--yes` (aceita padrões). ## Uso e Cobrança Verifique o saldo de pontos de computação e o histórico de uso: ```bash poe-code usage poe-code usage list poe-code usage list --limit 100 poe-code usage list --filter claude ``` ## Modelos Liste os modelos disponíveis da API do Poe, filtre por endpoint, provedor ou busca: ```bash poe-code models poe-code models --endpoint /v1/responses poe-code models --endpoint /v1/chat/completions poe-code models --search claude ``` ## SDK Use o Poe Code programaticamente em seu próprio código: ```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)` – executa um único prompt; as opções incluem `prompt`, `cwd` (caminho local ou localizador `github://`), `model`, `mode`, `args`. Retorna `{ stdout, stderr, exitCode }`. - `spawn.pretty(service, options)` – o mesmo, mas renderiza o fluxo de eventos ACP colorido. - `getPoeApiKey()` – lê a variável de ambiente `POE_API_KEY` ou o arquivo de credenciais. - `getPoeAuthIdentity()` – obtém a identidade da conta Poe. Para composição com plugins em primeiro lugar, use o subcaminho `poe-code/agent` com `agent()`, `openaiResponsesPlugin()`, `systemPromptPlugin()`. ## Prévia de Pesquisa Recursos sujeitos a mudanças incompatíveis: - **SafeJS** – interpretador JavaScript com capacidades de host explícitas, orçamentos de execução, checkpoints retomáveis. Publicado como `@poe-platform/safe-js`. Conformidade total não estabelecida. - **Pipeline** – Execute planos de tarefas com etapas configuráveis, progresso ao vivo, acompanhamentos enfileirados. - **Ralph** – Loop de build agêntico iterando sobre um documento markdown. - **Experiment loop** – Loop de otimização estilo Karpathy (o agente altera o código, a avaliação pontua, mantém/descarta via git). - **Poe Agent** – Runtime de agente composável. ## Atualização ```sh npx poe-code@latest update npx poe-code@latest update --package-manager pnpm ``` Para verificações de versão, execuções de teste e worktrees gerenciados, consulte a referência completa.