मुख्य सामग्री पर जाएं

आपका वॉल्ट, टर्मिनल से

taskforge एक छोटा कमांड-लाइन टूल है जो आपके Obsidian वॉल्ट में कार्य पढ़ता और लिखता है। यह वही पार्सर इस्तेमाल करता है जो ऐप इस्तेमाल करता है, इसलिए आवर्ती कार्य आगे बढ़ते हैं, आर्काइव सही जगह पहुँचते हैं, और आपकी कार्य लाइनें आपके फ़ॉर्मेट में ही रहती हैं। इसे किसी शेल स्क्रिप्ट या एजेंट को सौंप दें, यह असली markdown फ़ाइलें संपादित करता है, कुछ भी होस्टेड नहीं।

TaskForge 3.0 में जल्द आ रहा है

TaskForge CLI और MCP सर्वर, TaskForge 3.0 रिलीज़ के साथ आएंगे। इस पेज पर बताया गया है कि लॉन्च के समय ये कैसे काम करेंगे। TaskForge ऐप आज ही उपलब्ध है।

CLI या MCP सर्वर?

बिना MCP कनेक्शन वाले shell संदर्भों में CLI का उपयोग करें: scripts, cron, CI, या repo checkout में काम करने वाला coding एजेंट। अगर आपके एजेंट के पास पहले से TaskForge से MCP कनेक्शन है, तो MCP tools को प्राथमिकता दें; ये टाइप्ड होते हैं, ऐसी structured errors लौटाते हैं जिनसे एजेंट खुद को ठीक कर सके, और आपके PATH में कुछ भी नहीं चाहिए। दोनों एक ही engine को समान semantics के साथ चलाते हैं, इसलिए जो भी आपके runtime में पहले से जुड़ा है उसे चुनें। वॉल्ट फ़ाइलों को हाथ से बदलना आखिरी विकल्प है।

इंस्टॉल करें

macOS और Linux पर, Homebrew के ज़रिए:

लॉन्च पर उपलब्ध 
brew install azhard/tap/taskforge

npm पसंद है? वही बाइनरी एक पैकेज के रूप में भी उपलब्ध है:

लॉन्च पर उपलब्ध 
npm install -g taskforge

एक ऐप-बंडल्ड कॉपी आ रही है जो वॉल्ट खोलते ही खुद इंस्टॉल हो जाएगी। तब तक, ऊपर दिया गया tap ही रास्ता है।

क्विकस्टार्ट

taskforge को --vault से किसी वॉल्ट की ओर इशारा करें, या एक बार TASKFORGE_VAULT सेट कर दें। हर read कमांड --json लेता है, जिससे मशीन-रीडेबल आउटपुट मिलता है जिसे कोई एजेंट पार्स कर सके।

taskforge schema

वॉल्ट की कार्य बोली प्रिंट करें: स्थिति चिह्न, तारीख़ फ़ॉर्मेट, कस्टम फ़ील्ड्स, नए कार्य कहाँ जाते हैं। एजेंट सबसे पहले यही पढ़ता है।

taskforge add "call the plumber" --due 2026-07-10 --priority high

वॉल्ट के डिफ़ॉल्ट नए-कार्य टार्गेट में एक कार्य जोड़ें, उसी फ़ॉर्मेट में जिस तरह आपका वॉल्ट कार्य लिखता है।

taskforge query 'prop:priority_label=urgent' --sort priority --count

उन कार्यों को गिनें जिनमें कस्टम फ़ील्ड priority_label:: urgent है, सबसे ज़्यादा अर्जेंट पहले। उन्हें सूची में देखने के लिए --count हटा दें।

taskforge query 'desc:"invoice" text:acme' --json

वे कार्य खोजें जिनके विवरण में invoice का ज़िक्र है और जिनके शीर्षक में acme का ज़िक्र है, JSON के रूप में। एक्सेंट और केस को नज़रअंदाज़ किया जाता है, इसलिए cafe, café से मेल खाता है।

taskforge done <task-id>

एक कार्य पूरा करें। अगर वह दोहराता है, तो अगली घटना फ़ाइल में वापस लिखी जाती है, बिल्कुल वैसे ही जैसे ऐप करता।

taskforge show <task-id> --json

एक कार्य को उसके कंटेंट हैश के साथ पढ़ें, ताकि बाद का कोई संपादन --if-hash पास कर सके और किसी पुरानी कॉपी पर लिखने से इनकार कर सके।

क्वेरी व्याकरण

क्वेरी आर्गुमेंट स्पेस से अलग किए गए टोकनों का एक सेट है, जिनमें सभी का मेल होना ज़रूरी है। आम टोकन ये हैं:

text:word शीर्षक में वह शब्द है (एक्सेंट और केस से बेपरवाह)। text:groceries
desc:"phrase" कार्य के विवरण में वह वाक्यांश है। desc:"send invoice"
tag:name कार्य में #name टैग है। tag:work
prop:key=value कस्टम फ़ील्ड key, value के बराबर है। prop:area=home
prop:key कस्टम फ़ील्ड key मौजूद है, कोई भी वैल्यू। prop:estimate
--sort due|priority|created नतीजों को क्रम में लगाएं। डिफ़ॉल्ट नियत तारीख़ है, सबसे नज़दीकी पहले। --sort priority
--count कार्यों की बजाय मेल खाने वालों की संख्या लौटाएं। --count

कस्टम फ़ील्ड keys में अक्षर, अंक और underscore शामिल हो सकते हैं, इसलिए priority_label और area_2 दोनों काम करते हैं।

एक ज़रूरत: वॉल्ट कॉन्ट्रैक्ट

taskforge एक छोटी कॉन्ट्रैक्ट फ़ाइल पढ़ता है, taskforge/schema.json, जिसे TaskForge आपके वॉल्ट में लिखता है। यह आपका सटीक कार्य फ़ॉर्मेट बताती है, ताकि CLI अंदाज़ा लगाने की बजाय आपके तरीके से कार्य संपादित करे। TaskForge 3.0 या उसके बाद के वर्शन में वॉल्ट को कम से कम एक बार खोलें, Settings, AI & Agents पर जाएं, और "Generate agent files" को चालू रहने दें। इससे कॉन्ट्रैक्ट लिख दिया जाता है।

अगर taskforge को कोई वॉल्ट नहीं मिलता, तो यह आपको वॉल्ट की ओर इशारा करने के तीन तरीके बताता है:

  1. कमांड पर --vault /path/to/vault पास करें।
  2. TASKFORGE_VAULT एनवायरनमेंट वेरिएबल सेट करें।
  3. वॉल्ट को TaskForge 3.0+ में एक बार खोलें ताकि taskforge/schema.json मौजूद हो जाए, फिर वॉल्ट फ़ोल्डर के अंदर से चलाएं।

सिर्फ़ लोकल

taskforge आपकी मशीन पर चलता है और सिर्फ़ उस वॉल्ट की markdown फ़ाइलों को छूता है जिसकी ओर आप उसे इशारा करते हैं। न कोई अकाउंट, न कोई API key, न कोई नेटवर्क कॉल। आपका वॉल्ट जो भी पहले से सिंक करता है, iCloud, Dropbox, या Obsidian Sync, वही संपादन आपके बाकी डिवाइसों तक पहुँचा देता है।

किसी एजेंट से इसे चलवाना चाहते हैं?

CLI टर्मिनलों और स्क्रिप्टों के लिए है। अगर आप चाहते हैं कि Claude Desktop या कोई और MCP क्लाइंट किसी tool इंटरफ़ेस के ज़रिए कार्य जोड़े और पूरा करे, तो इसकी बजाय MCP सर्वर सेटअप करें। वही वॉल्ट, वही नियम। दोनों ही सूरत में यह वही taskforge बाइनरी है, इसलिए taskforge mcp --stdio चलाते ही यह MCP सर्वर बन जाता है।

MCP सर्वर सेटअप करें →

CLI कार्यों को एडिट करता है। ऐप उन्हें ज़िंदा रखता है।

taskforge किसी भी terminal से आपके vault में लिखता है; TaskForge उन्हीं फ़ाइलों को आपके फ़ोन और डेस्कटॉप पर lists, widgets और reminders में बदल देता है। iPhone, iPad, Mac और Android पर मुफ़्त डाउनलोड के लिए उपलब्ध।

Apple मुफ्त प्राप्त करें - iOS और Mac Android मुफ्त प्राप्त करें - Android