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

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

CLI या MCP सर्वर?

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

इंस्टॉल करें

Node.js के साथ आज़माएँ (npm और npx शामिल हैं):

npx -y taskforge-md --version

taskforge कमांड को ग्लोबल रूप से इंस्टॉल करें:

npm install -g taskforge-md

npm/npx के साथ Node.js आवश्यक है। CLI को ऐप से अलग इंस्टॉल करें; Homebrew अब समर्थित नहीं है।

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

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

taskforge dialect

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

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/Settings/dialect.json, जिसे TaskForge आपके वॉल्ट में लिखता है। यह आपका सटीक कार्य फ़ॉर्मेट बताती है, ताकि CLI अंदाज़ा लगाने की बजाय आपके तरीके से कार्य संपादित करे। TaskForge 3.0 या उसके बाद के वर्शन में वॉल्ट को कम से कम एक बार खोलें, सेटिंग्स में AI & Agents पर जाएं, और "एजेंट फ़ाइलें जनरेट करें" को चालू रहने दें। इससे कॉन्ट्रैक्ट लिख दिया जाता है। TaskForge/Settings डिफ़ॉल्ट जगह है; ऐप में बेस फ़ोल्डर का नाम बदला जा सकता है।

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

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

सिर्फ़ लोकल

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

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

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

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

CLI कार्यों को संपादित करता है। ऐप उन्हें जीवंत रखता है।

taskforge किसी भी टर्मिनल से आपके वॉल्ट में लिखता है; TaskForge उन्हीं फ़ाइलों को आपके फ़ोन और डेस्कटॉप पर सूचियों, विजेट और रिमाइंडर में बदल देता है। iPhone, iPad, Mac, Android और Windows पर मुफ़्त डाउनलोड के लिए उपलब्ध।

डाउनलोड करें Windows

सूचना पाएँ Linux