इस प्रोजेक्ट के बारे में
CLI Printing Press एक जनरेटर है जो मनमाने APIs या वेबसाइटों के लिए कमांड-लाइन टूल और MCP सर्वर बनाता है, जिसमें AI एजेंटों द्वारा उपयोग किए जाने पर मजबूत जोर दिया जाता है। यह Go में लिखा गया है और बाइनरी के साथ-साथ एजेंट कौशल (स्लैश कमांड) के एक सेट के रूप में वितरित किया जाता है जो बाइनरी को चलाते हैं।
यह क्या करता है
- आधिकारिक API दस्तावेज़ पढ़ता है, लोकप्रिय सामुदायिक CLIs और MCP सर्वरों का अध्ययन करता है, और ब्राउज़र ट्रैफ़िक को कैप्चर करके अप्रलेखित APIs को रिवर्स-इंजीनियर भी कर सकता है।
- इनपुट के रूप में OpenAPI स्पेक, वेबसाइट URL, या HAR फ़ाइल स्वीकार करता है।
- प्रति API दो बाइनरी बनाता है: एक Cobra-आधारित CLI (`<api>-pp-cli`) और एक MCP सर्वर (`<api>-pp-mcp`), जो समान क्लाइंट, स्टोर और प्रमाणीकरण कोड साझा करते हैं।
- कोड के साथ शोध दस्तावेज़, सत्यापन प्रमाण और गुणवत्ता स्कोर उत्पन्न करता है।
मुख्य डिज़ाइन बिंदु
- स्थानीय-प्रथम डेटा परत: डोमेन-विशिष्ट SQLite तालिकाएँ, FTS5 पूर्ण-पाठ खोज, कर्सर ट्रैकिंग के साथ वृद्धिशील सिंक, और सीधे प्रश्नों के लिए `sql` कमांड। `sync`, `search`, और `sql` जैसे कमांड ऑफ़लाइन काम करते हैं।
- यौगिक कमांड: एक बार डेटा स्थानीय हो जाने पर, `stale`, `health`, `bottleneck`, और `reconcile` जैसे कमांड संसाधनों में शामिल हो सकते हैं और इतिहास का विश्लेषण कर सकते हैं।
- एजेंट-मूल आउटपुट: टर्मिनल में मानव-पठनीय तालिकाएँ, पाइप होने पर स्वचालित JSON, कम टोकन आउटपुट के लिए `--compact`, टाइप किए गए निकास कोड (0/2/3/4/5/7), `--dry-run`, `--select`, `--csv`, `--stdin`, और हर कमांड पर अन्य फ़्लैग।
- दोहरा इंटरफ़ेस: CLI शेल-आधारित एजेंटों को लक्षित करता है, जबकि MCP सर्वर Claude Desktop और Cursor जैसे IDE एकीकरण को लक्षित करता है।
- सत्यापन: स्कोरकार्ड, डॉगफ़ूडिंग, व्यवहार-प्रमाण, और वैकल्पिक लाइव API स्मोक टेस्ट का उपयोग भ्रामक पथ, मृत फ़्लैग और प्रमाणीकरण बेमेल को पकड़ने के लिए किया जाता है।
कार्यप्रवाह
- स्थापना एक शेल स्क्रिप्ट के माध्यम से होती है जो जनरेटर के लिए `go install` चलाती है और `skills` npm CLI के माध्यम से कौशल स्थापित करती है। Claude Code डिफ़ॉल्ट और सबसे अच्छा परीक्षण किया गया लक्ष्य है; Codex `--agent codex` फ़्लैग के साथ समर्थित है।
- एजेंट सत्र के अंदर, `/printing-press <app-name>` एक जनरेशन रन शुरू करता है। अतिरिक्त कमांड में `/printing-press-reprint`, `/printing-press-polish`, `/printing-press-publish`, और `/printing-press-amend` शामिल हैं।
- पाइपलाइन चरणों से गुजरती है: रिज़ॉल्व/रीयूज़, शोध ब्रीफ़, इकोसिस्टम अवशोषण गेट, ब्राउज़र-स्निफ़ गेट, जनरेट, GOAT बनाएँ, शिपचेक, और वैकल्पिक लाइव स्मोक टेस्ट। उपयोगकर्ताओं के लिए एक लंबी 9-चरणीय प्रबंधित पाइपलाइन दस्तावेज़ित है जो व्यक्तिगत चरणों को रोकना, फिर से शुरू करना या फिर से चलाना चाहते हैं।
- आउटपुट `~/printing-press/` के अंतर्गत सक्रिय रन, प्रकाशित CLIs और संग्रहीत पांडुलिपियों के लिए अलग निर्देशिकाओं के साथ व्यवस्थित किया जाता है।
उल्लेखनीय अवधारणाएँ
- "गैर-स्पष्ट अंतर्दृष्टि" (NOI): एक-वाक्य पुनर्निर्माण कि एक API वास्तव में किस लिए उपयोगी है, जिसका उपयोग उत्पन्न कमांड के रचनात्मक आधार के रूप में किया जाता है।
- "अवशोषित और पार करना": मौजूदा टूल और MCP सर्वरों से सुविधाओं की सूची बनाना, उनका मिलान करना, फिर स्थानीय डेटा द्वारा सक्षम यौगिक क्षमताओं को जोड़ना।
- सरल एंडपॉइंट रैपर से व्यवहारिक अंतर्दृष्टि कमांड तक एक "रचनात्मकता सीढ़ी"।
आवश्यकताएँ और चेतावनियाँ
- Go 1.26.6 या नया, `npx` के लिए Node/npm, और कौशल-समर्थित एजेंट (Claude Code परीक्षण किया गया) की आवश्यकता है।
- README प्रदर्शन और गुणवत्ता के दावे करता है (उदाहरण के लिए, टोकन बचत और गति) जो स्वतंत्र रूप से सत्यापित बेंचमार्क के बजाय परियोजना के अपने दावे हैं।
- रिपॉजिटरी अब स्रोत कैटलॉग नहीं रखती है; प्रकाशित CLIs एक अलग लाइब्रेरी रिपॉजिटरी में बनाए रखी जाती हैं।
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.