Vault ของคุณ จากเทอร์มินัล
taskforge คือเครื่องมือบรรทัดคำสั่งขนาดเล็กที่อ่านและเขียนงานใน Vault Obsidian ของคุณ มันใช้ตัวแยกวิเคราะห์เดียวกับที่แอปใช้ ดังนั้นงานที่เกิดซ้ำจะเลื่อนไปข้างหน้าอย่างถูกต้อง ไฟล์เก็บถาวรจะไปอยู่ในตำแหน่งที่ถูกต้อง และบรรทัดงานของคุณยังคงอยู่ในรูปแบบเดิม ส่งต่อให้ shell script หรือเอเจนต์ตัวไหนก็ได้ มันจะแก้ไขไฟล์ Markdown จริง ไม่มีอะไรถูกโฮสต์ไว้ที่ไหน
เร็วๆ นี้ใน TaskForge 3.0
CLI และเซิร์ฟเวอร์ MCP ของ TaskForge จะมาพร้อมกับ TaskForge 3.0 เนื้อหาในหน้านี้อธิบายวิธีการทำงานเมื่อเปิดตัวจริง ส่วนแอป TaskForge นั้นดาวน์โหลดได้แล้ววันนี้
CLI หรือ MCP server?
ใช้ CLI จาก shell ที่ไม่มีการเชื่อมต่อ MCP เช่น script, cron, CI หรือเอเจนต์เขียนโค้ดที่ทำงานอยู่ใน repo ที่ checkout ไว้ ถ้าเอเจนต์ของคุณมีการเชื่อมต่อ MCP กับ TaskForge อยู่แล้ว ให้เลือกใช้ MCP tools แทน มันมี type ชัดเจน คืนค่า error แบบมีโครงสร้างที่เอเจนต์ใช้แก้ไขตัวเองได้ และไม่ต้องมีอะไรใน PATH ของคุณเลย ทั้งสองแบบขับเคลื่อนเอนจินเดียวกันด้วย semantics เดียวกัน จึงเลือกอันไหนที่ runtime ของคุณต่อไว้แล้วก็ได้ การแก้ไฟล์ Vault ด้วยมือคือทางเลือกสุดท้าย
ติดตั้ง
macOS และ Linux ผ่าน Homebrew:
brew install azhard/tap/taskforgeชอบใช้ npm มากกว่าไหม ไบนารีตัวเดียวกันนี้มีแพ็กเกจให้ใช้ด้วย:
npm install -g taskforgeกำลังจะมีเวอร์ชันที่ติดมากับแอปและติดตั้งตัวเองเมื่อคุณเปิด Vault ระหว่างนี้ tap ด้านบนคือทางเข้าที่ใช้ได้
เริ่มต้นอย่างเร็ว
ชี้ taskforge ไปที่ Vault ด้วย --vault หรือตั้งค่า TASKFORGE_VAULT ไว้ครั้งเดียว คำสั่งอ่านทุกตัวรับ --json เพื่อให้ได้เอาต์พุตที่เครื่องอ่านได้ ซึ่งเอเจนต์นำไปแยกวิเคราะห์ต่อได้
taskforge schema แสดงสำเนียงงานของ Vault: สัญลักษณ์สถานะ รูปแบบวันที่ ฟิลด์ที่กำหนดเอง และตำแหน่งที่งานใหม่จะไปอยู่ นี่คือสิ่งแรกที่เอเจนต์อ่าน
taskforge add "call the plumber" --due 2026-07-10 --priority high เพิ่มงานต่อท้ายเป้าหมายงานใหม่เริ่มต้นของ Vault จัดรูปแบบตามที่ Vault ของคุณเขียนงาน
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 อ่านงานหนึ่งงานพร้อม content hash ของมัน เพื่อให้การแก้ไขครั้งถัดไปส่ง --if-hash ได้ และปฏิเสธการเขียนทับสำเนาที่เก่าแล้ว
ไวยากรณ์การค้นหา
อาร์กิวเมนต์ query คือชุดโทเคนที่คั่นด้วยช่องว่าง ซึ่งทุกตัวต้องตรงกันหมด โทเคนที่ใช้บ่อยมีดังนี้:
| 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 |
คีย์ของฟิลด์ที่กำหนดเองใช้ตัวอักษร ตัวเลข และขีดล่างได้ ดังนั้น priority_label และ area_2 ใช้ได้ทั้งคู่
ข้อกำหนดเดียว: สัญญาของ Vault
taskforge อ่านไฟล์สัญญาขนาดเล็กชื่อ taskforge/schema.json ที่ TaskForge เขียนลงใน Vault ของคุณ ไฟล์นี้อธิบายรูปแบบงานที่ตรงกับ Vault นี้เป๊ะๆ เพื่อให้ CLI แก้ไขงานตามแบบของคุณแทนการเดา เปิด Vault ใน TaskForge 3.0 ขึ้นไปอย่างน้อยหนึ่งครั้ง ไปที่ Settings, AI & Agents แล้วเปิด "Generate agent files" ทิ้งไว้ นั่นคือสิ่งที่เขียนสัญญานี้ขึ้นมา
ถ้า taskforge หา Vault ไม่เจอ มันจะบอกคุณสามวิธีในการชี้ไปที่ Vault:
- ส่ง --vault /path/to/vault เข้าไปในคำสั่ง
- ตั้งค่าตัวแปรสภาพแวดล้อม TASKFORGE_VAULT
- เปิด Vault ใน TaskForge 3.0 ขึ้นไปสักครั้งเพื่อให้ taskforge/schema.json ถูกสร้างขึ้น แล้วรันคำสั่งจากภายในโฟลเดอร์ Vault
ทำงานในเครื่องเท่านั้น
taskforge ทำงานบนเครื่องของคุณเอง และแตะต้องเฉพาะไฟล์ Markdown ใน Vault ที่คุณชี้ไปเท่านั้น ไม่มีบัญชี ไม่มี API key ไม่มีการเรียกเครือข่ายใดๆ ระบบที่ซิงค์ Vault ของคุณอยู่แล้ว ไม่ว่าจะเป็น iCloud, Dropbox หรือ Obsidian Sync จะพาการแก้ไขไปยังอุปกรณ์อื่นของคุณเอง
อยากให้เอเจนต์เป็นคนควบคุมแทนไหม?
CLI นี้เหมาะสำหรับเทอร์มินัลและสคริปต์ ถ้าคุณอยากให้ Claude Desktop หรือ MCP client ตัวอื่นเพิ่มและทำงานให้เสร็จผ่านอินเทอร์เฟซเครื่องมือ ให้ตั้งค่า MCP server แทน Vault เดียวกัน กฎเดียวกัน ไม่ว่าทางไหนก็เป็นไบนารี taskforge ตัวเดียวกัน แค่รัน taskforge mcp --stdio ก็เปลี่ยนมันเป็น MCP server ได้เลย
ตั้งค่า MCP server →CLI แก้ไขงาน แอปทำให้งานยังใช้ได้ต่อ
taskforge เขียนลง Vault ของคุณจากเทอร์มินัลไหนก็ได้ ส่วน TaskForge เปลี่ยนไฟล์ชุดเดียวกันนั้นให้เป็นรายการ วิดเจ็ต และการแจ้งเตือนบนโทรศัพท์และเดสก์ท็อปของคุณ ดาวน์โหลดฟรีบน iPhone, iPad, Mac และ Android
ดาวน์โหลดฟรี - iOS และ Mac 
ดาวน์โหลดฟรี - Android