इस प्रोजेक्ट के बारे में

Poe Code एक ऐसा टूल है जो आपके पसंदीदा कोडिंग एजेंट्स (Claude Code, Codex, OpenCode, Goose, आदि) को Poe API के माध्यम से रूट करता है, ताकि आपको कई प्रोवाइडर या अकाउंट प्रबंधित करने के बजाय केवल एक Poe सदस्यता की आवश्यकता हो। एक बार कॉन्फ़िगर करने के बाद यह एजेंट्स के सामान्य CLI या डेस्कटॉप ऐप्स के साथ काम करता है, और स्क्रिप्टिंग तथा CI/CD के लिए एकबारगी प्रॉम्प्ट स्पॉन करने का भी समर्थन करता है। ## क्विकस्टार्ट किसी एजेंट के लिए Poe Code को डिफ़ॉल्ट प्रोवाइडर के रूप में सेट करें (कॉन्फ़िग फ़ाइलें अपडेट करता है): ```bash npx poe-code@latest configure npx poe-code@latest configure codex # or claude, opencode, goose ``` `unconfigure` के साथ ओवरराइड हटाएँ: ```bash npx poe-code@latest unconfigure claude ``` ## प्रमाणीकरण आपकी Poe API key का उपयोग करता है। पहली बार चलाने पर, आपको ब्राउज़र के माध्यम से लॉग इन करने के लिए कहा जाएगा (OAuth)। आप key सीधे भी दे सकते हैं: ```bash npx poe-code@latest login npx poe-code@latest login --api-key <your-key> export POE_API_KEY=<your-key> ``` क्रेडेंशियल्स `~/.poe-code/` में संग्रहीत होते हैं। `poe-code auth status` से स्थिति जाँचें, `logout` से हटाएँ। ## उपयोगिताएँ - **एकबारगी प्रॉम्प्ट स्पॉन करें**: `npx poe-code@latest spawn codex "Say hello" --mode read` (मोड: yolo, auto, edit, read; TTY के बिना CI में आवश्यक)। - **GitHub रेपो के विरुद्ध स्पॉन करें**: `--cwd github://owner/repo` या ref/subdir के साथ जैसे `github://owner/repo#main:packages/auth`। - **stdin के माध्यम से प्रॉम्प्ट पाइप करें**: `echo "Say hello" | npx poe-code@latest spawn codex --mode read`। - **GitHub PR की समीक्षा करें**: `code-review install`, `code-review run <url>`, `code-review commit <url> --dry-run`। - **कॉन्फ़िगर की गई सेवा का परीक्षण करें**: `npx poe-code@latest test codex`। - **एजेंट CLI इंस्टॉल करें**: `install claude-code`, `install codex`, `install opencode`, `install goose`। - **वैकल्पिक फ़्लैग**: `--dry-run` (डिस्क को छुए बिना परिवर्तन दिखाएँ), `--yes` (डिफ़ॉल्ट स्वीकार करें)। ## उपयोग और बिलिंग कंप्यूट पॉइंट्स बैलेंस और उपयोग इतिहास जाँचें: ```bash poe-code usage poe-code usage list poe-code usage list --limit 100 poe-code usage list --filter claude ``` ## मॉडल उपलब्ध Poe API मॉडल सूचीबद्ध करें, endpoint, प्रोवाइडर या खोज के आधार पर फ़िल्टर करें: ```bash poe-code models poe-code models --endpoint /v1/responses poe-code models --endpoint /v1/chat/completions poe-code models --search claude ``` ## SDK अपने स्वयं के कोड में Poe 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)` – एक प्रॉम्प्ट चलाता है; options में `prompt`, `cwd` (लोकल पथ या `github://` लोकेटर), `model`, `mode`, `args` शामिल हैं। `{ stdout, stderr, exitCode }` लौटाता है। - `spawn.pretty(service, options)` – वही, लेकिन रंगीन ACP इवेंट स्ट्रीम रेंडर करता है। - `getPoeApiKey()` – `POE_API_KEY` env var या क्रेडेंशियल्स फ़ाइल पढ़ता है। - `getPoeAuthIdentity()` – Poe अकाउंट पहचान प्राप्त करता है। प्लगइन-प्रथम संयोजन के लिए, `poe-code/agent` सबपाथ का उपयोग `agent()`, `openaiResponsesPlugin()`, `systemPromptPlugin()` के साथ करें। ## रिसर्च प्रीव्यू ऐसी सुविधाएँ जिनमें ब्रेकिंग बदलाव हो सकते हैं: - **SafeJS** – स्पष्ट होस्ट क्षमताओं, निष्पादन बजट, पुनःआरंभ करने योग्य चेकपॉइंट्स वाला JavaScript इंटरप्रेटर। `@poe-platform/safe-js` के रूप में प्रकाशित। पूर्ण अनुरूपता स्थापित नहीं है। - **Pipeline** – कॉन्फ़िगर करने योग्य चरणों, लाइव प्रगति, कतारबद्ध फ़ॉलो-अप्स के साथ कार्य योजनाएँ चलाएँ। - **Ralph** – मार्कडाउन दस्तावेज़ पर पुनरावृत्ति करने वाला एजेंटिक बिल्ड लूप। - **Experiment loop** – Karpathy-शैली का ऑप्टिमाइज़ लूप (एजेंट कोड बदलता है, eval स्कोर करता है, git के माध्यम से रखें/हटाएँ)। - **Poe Agent** – संयोजन योग्य एजेंट रनटाइम। ## अपडेट ```sh npx poe-code@latest update npx poe-code@latest update --package-manager pnpm ``` वर्शन जाँच, ड्राई रन और प्रबंधित वर्कट्री के लिए, पूर्ण संदर्भ देखें।