poe-code

Poe Code ایک ایسا ٹول ہے جو آپ کے پسندیدہ کوڈنگ ایجنٹس (Claude Code، Codex، OpenCode، Goose وغیرہ) کو Poe API کے ذریعے روٹ کرتا ہے، تاکہ آپ کو متعدد فراہم کنندگان یا اکاؤنٹس سنبھالنے کے بجائے صرف ایک Poe سبسکرپشن کی ضرورت ہو۔ ایک بار کنفیگریشن کے بعد یہ ایجنٹس کے عام CLIs یا ڈیسک ٹاپ ایپس کے ساتھ کام کرتا ہے، اور اسکرپٹنگ اور 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 کلید استعمال کرتا ہے۔ پہلی بار چلانے پر، آپ کو براؤزر کے ذریعے لاگ ان کرنے کے لیے کہا جائے گا (OAuth)۔ آپ کلید براہ راست بھی فراہم کر سکتے ہیں: ```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`۔ - **ایجنٹ CLIs انسٹال کریں**: `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 ماڈلز کی فہرست بنائیں، اینڈ پوائنٹ، فراہم کنندہ، یا تلاش کے ذریعے فلٹر کریں: ```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)` – ایک پرامپٹ چلاتا ہے؛ اختیارات میں `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 ``` ورژن چیکس، ڈرائی رنز، اور مینیجڈ ورک ٹریز کے لیے، مکمل حوالہ دیکھیں۔