Vault anda, dari terminal

taskforge ialah alat baris arahan kecil yang membaca dan menulis tugas dalam vault Obsidian anda. Ia menggunakan penghurai yang sama seperti aplikasi, jadi tugas berulang maju ke kejadian seterusnya, arkib disimpan di tempat yang betul, dan baris tugas anda kekal dalam format anda. Serahkan kepada skrip shell atau agen dan ia menyunting fail markdown sebenar, tiada yang dihoskan.

Akan Datang dengan TaskForge 3.0

CLI TaskForge dan pelayan MCP akan disertakan dengan keluaran TaskForge 3.0. Semua yang ada di halaman ini menerangkan cara ia akan berfungsi apabila dilancarkan. Apl TaskForge pula sudah tersedia untuk dimuat turun hari ini.

CLI atau pelayan MCP?

Gunakan CLI daripada konteks shell tanpa sambungan MCP: skrip, cron, CI, atau agen pengekodan yang bekerja dalam checkout repo. Jika agen anda sudah mempunyai sambungan MCP ke TaskForge, utamakan alat MCP; alat ini bertaip, memulangkan ralat berstruktur yang membolehkan agen membetulkan dirinya sendiri, dan tidak memerlukan apa-apa dalam PATH anda. Kedua-duanya menggerakkan enjin yang sama dengan semantik yang sama, jadi pilih mana-mana yang sudah tersedia dalam runtime anda. Menyunting fail vault secara manual adalah pilihan terakhir.

Pasang

macOS dan Linux, melalui Homebrew:

Tersedia semasa pelancaran

brew install azhard/tap/taskforge

Lebih suka npm? Binari yang sama dihantar sebagai pakej:

Tersedia semasa pelancaran

npm install -g taskforge

Salinan terbenam aplikasi yang memasang dirinya sendiri apabila anda membuka vault akan datang tidak lama lagi. Sementara itu, tap di atas ialah cara masuknya.

Mula Pantas

Halakan taskforge ke satu vault dengan --vault, atau tetapkan TASKFORGE_VAULT sekali sahaja. Setiap arahan baca menerima --json untuk output yang boleh dibaca mesin yang boleh dihurai oleh agen.

taskforge schema

Cetak dialek tugas vault: simbol status, format tarikh, medan tersuai, ke mana tugas baharu pergi. Inilah perkara pertama yang dibaca oleh agen.

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

Tambah tugas ke sasaran tugas-baharu lalai vault, diformat mengikut cara vault anda menulis tugas.

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

Kira tugas yang membawa medan tersuai priority_label:: urgent, paling mendesak dahulu. Buang --count untuk menyenaraikannya.

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

Cari tugas yang penerangannya menyebut invois dan tajuknya menyebut acme, sebagai JSON. Aksen dan huruf besar/kecil diabaikan, jadi cafe sepadan dengan café.

taskforge done <task-id>

Lengkapkan tugas. Jika ia berulang, kejadian seterusnya ditulis semula ke dalam fail, tepat seperti yang dilakukan oleh aplikasi.

taskforge show <task-id> --json

Baca satu tugas berserta hash kandungannya, supaya suntingan susulan boleh menghantar --if-hash dan menolak untuk menulis ke atas salinan lapuk.

Tatabahasa carian

Argumen carian ialah satu set token dipisahkan ruang, semuanya mesti sepadan. Yang biasa digunakan:

text:word	Tajuk mengandungi perkataan itu (tidak peka aksen dan huruf besar/kecil).	text:groceries
desc:"phrase"	Penerangan tugas mengandungi frasa itu.	desc:"send invoice"
tag:name	Tugas membawa tag #name.	tag:work
prop:key=value	Medan tersuai key sama dengan value.	prop:area=home
prop:key	Medan tersuai key wujud, sebarang nilai.	prop:estimate
--sort due\|priority\|created	Susun hasil. Lalai ialah tarikh akhir, paling hampir dahulu.	--sort priority
--count	Pulangkan bilangan padanan dan bukannya tugas itu sendiri.	--count

Key medan tersuai boleh mengandungi huruf, digit dan garis bawah, jadi priority_label dan area_2 kedua-duanya berfungsi.

Satu keperluan: kontrak vault

taskforge membaca satu fail kontrak kecil, taskforge/schema.json, yang ditulis oleh TaskForge ke dalam vault anda. Ia menerangkan format tugas anda dengan tepat supaya CLI menyunting tugas mengikut cara anda dan bukan meneka. Buka vault dalam TaskForge 3.0 atau lebih baharu sekurang-kurangnya sekali, pergi ke Settings, AI & Agents, dan biarkan "Generate agent files" dihidupkan. Itu menulis kontrak tersebut.

Jika taskforge tidak dapat mencari vault, ia memberitahu anda tiga cara untuk menghalakannya ke satu:

Hantar --vault /path/to/vault dalam arahan tersebut.
Tetapkan pemboleh ubah persekitaran TASKFORGE_VAULT.
Buka vault sekali dalam TaskForge 3.0+ supaya taskforge/schema.json wujud, kemudian jalankan dari dalam folder vault.

Tempatan sahaja

taskforge berjalan pada mesin anda dan hanya menyentuh fail markdown dalam vault yang anda halakan. Tiada akaun, tiada kunci API, tiada panggilan rangkaian. Apa sahaja yang sudah menyegerakkan vault anda, iCloud, Dropbox atau Obsidian Sync, membawa suntingan itu ke peranti lain anda.

Mahu agen mengendalikannya?

CLI ini untuk terminal dan skrip. Jika anda mahu Claude Desktop atau klien MCP lain menambah dan melengkapkan tugas melalui antara muka alat, sediakan pelayan MCP sebaliknya. Vault yang sama, peraturan yang sama. Kedua-duanya binari taskforge yang sama, jadi taskforge mcp --stdio sahaja sudah cukup untuk menukarkannya menjadi pelayan MCP.

Sediakan pelayan MCP →

CLI menyunting tugas. Aplikasi mengekalkannya.

taskforge menulis ke vault anda dari mana-mana terminal; TaskForge mengubah fail yang sama itu menjadi senarai, widget, dan peringatan pada telefon serta desktop anda. Percuma untuk dimuat turun pada iPhone, iPad, Mac, dan Android.

Dapatkan Percuma - iOS & Mac

Dapatkan Percuma - Android