vault ของคุณ จากเทอร์มินัล

taskforge คือเครื่องมือบรรทัดคำสั่งสำหรับงานและโน้ตใน vault Obsidian ของคุณ ค้นหาและทำงานให้เสร็จ สร้างและแก้ไขโน้ต หรือส่งคำสั่งชุดเดียวกันให้ shell script หรือเอเจนต์ใช้ก็ได้ ใช้ตัวแยกวิเคราะห์เดียวกับแอปและเขียนไฟล์ Markdown จริงบนเครื่องของคุณ

CLI หรือ MCP server?

ใช้ CLI จาก shell ที่ไม่มีการเชื่อมต่อ MCP เช่น script, cron, CI หรือเอเจนต์เขียนโค้ดที่ทำงานอยู่ใน repo ที่ checkout ไว้ ถ้าเอเจนต์ของคุณมีการเชื่อมต่อ MCP กับ TaskForge อยู่แล้ว ให้เลือกใช้ MCP tools แทน มันมี type ชัดเจน คืนค่า error แบบมีโครงสร้างที่เอเจนต์ใช้แก้ไขตัวเองได้ และไม่ต้องมีอะไรใน PATH ของคุณเลย ทั้งสองแบบขับเคลื่อนเอนจินเดียวกันด้วย semantics เดียวกัน จึงเลือกอันไหนที่ runtime ของคุณต่อไว้แล้วก็ได้ การแก้ไฟล์ vault ด้วยมือคือทางเลือกสุดท้าย

ติดตั้ง

ลองใช้กับ Node.js (มี npm และ npx รวมอยู่ด้วย):

npx -y taskforge-md --version

ติดตั้งคำสั่ง taskforge แบบโกลบอล:

npm install -g taskforge-md

ต้องใช้ Node.js พร้อม npm/npx โดยติดตั้ง CLI แยกจากแอป และไม่รองรับ Homebrew อีกต่อไป

เริ่มต้นอย่างเร็ว

ชี้ taskforge ไปที่ vault ด้วย --vault หรือตั้งค่า TASKFORGE_VAULT ไว้ครั้งเดียว คำสั่งอ่านทุกตัวรับ --json เพื่อให้ได้เอาต์พุตที่เครื่องอ่านได้ ซึ่งเอเจนต์นำไปแยกวิเคราะห์ต่อได้

taskforge dialect

แสดงสำเนียงงานของ 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/Settings/dialect.json ที่ TaskForge เขียนลงใน vault ของคุณ ไฟล์นี้อธิบายรูปแบบงานที่ตรงกับ vault นี้เป๊ะๆ เพื่อให้ CLI แก้ไขงานตามแบบของคุณแทนการเดา เปิด vault ใน TaskForge 3.0 ขึ้นไปอย่างน้อยหนึ่งครั้ง ไปที่ Settings, AI & Agents แล้วเปิด "Generate agent files" ทิ้งไว้ นั่นคือสิ่งที่เขียนสัญญานี้ขึ้นมา TaskForge/Settings เป็นตำแหน่งเริ่มต้น และเปลี่ยนชื่อโฟลเดอร์หลักได้ในแอป

ถ้า taskforge หา vault ไม่เจอ มันจะบอกคุณสามวิธีในการชี้ไปที่ vault:

ส่ง --vault /path/to/vault เข้าไปในคำสั่ง
ตั้งค่าตัวแปรสภาพแวดล้อม TASKFORGE_VAULT
เปิด vault ใน TaskForge 3.0 ขึ้นไปสักครั้งเพื่อให้ TaskForge/Settings/dialect.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 และ Windows

ดาวน์โหลดสำหรับ Windows

รับแจ้งเมื่อพร้อมสำหรับ Linux