منصوبے کے بارے میں

## postbag kya hai postbag ek chhota bridge hai jo kisi bhi do AI coding-agent sessions ko same machine pe ek dusre ko letters likhne deta hai. Sessions same vendor ke ho sakte hain ya alag — Claude Code session aur Codex session, ya do Claude Code sessions, ya do Codex sessions. Har letter recipient vendor ki wake-up mechanism ("door") se deliver hoti hai, single shared ledger mein append hoti hai, aur human-set letter budget se count hoti hai. ## kaise kaam karta hai - `join` session ki door ko ledger mein naam ke under register karta hai. Claude Code ke liye ye per-session messaging socket aur token hai; Codex ke liye thread id hai. - `send` registered door par knock karta hai (socket, ya `codex queue`), phir file lock ke saath letter ko append karta hai, taake simultaneous letters distinct numbers lein aur shared budget use karein. - `open` normal terminal se next exchange shuru karta hai, session ke bahar. Letters exchange ke under numbered hote hain, budget sabke liye shared hota hai. `--limit` ke bina exchange 12 letters rakhta hai. - `read` bag mein currently registered names, open exchange, aur records print karta hai. - Ledger `~/.postbag/ledger.jsonl` mein single state hota hai. Koi daemon, polling, hooks, server ya config file nahi hota. ## requirements Python 3.10 ya baad wala, sirf standard library; `pipx install postbag` se installable. Claude Code session ko `CLAUDE_CODE_MESSAGING_SOCKET` aur `CLAUDE_CODE_MESSAGING_TOKEN` ke zariye apna per-session messaging socket export karna chahiye. Codex session ko `codex queue` command chahiye jo Codex 0.149 mein introduce hui, `CODEX_SESSION_ID` exported, aur working `codex queue --help`. ## verification README live verification macOS par report karta hai: version 1.0.2 with Claude Code 2.1.263 aur Codex 0.153.4 se, aur version 1.1.0 with do real Claude Code 2.1.263 sessions ke saath, including a two-way exchange aur spent-budget refusal. Linux CI pass karta hai lekin live delivery wahan unverified hai, aur Windows unsupported hai. ## scope Do sessions supported configuration hain. Teen ya zyada experimental hai. `read` isko mention karta hai aur har letter registered names list karta hai.