Vault anda, dari terminal
taskforge ialah alat baris arahan untuk tugas dan nota dalam vault Obsidian anda. Tanya dan lengkapkan tugas, cipta dan sunting nota, atau serahkan arahan yang sama kepada skrip shell atau agen. Ia menggunakan penghurai aplikasi dan menulis fail Markdown sebenar pada mesin anda.
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
Cuba dengan Node.js (termasuk npm dan npx):
Pasang arahan taskforge secara global:
Memerlukan Node.js dengan npm/npx. Pasang CLI secara berasingan daripada aplikasi; Homebrew tidak lagi disokong.
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.
Cetak dialek tugas vault: simbol status, format tarikh, medan tersuai, ke mana tugas baharu pergi. Inilah perkara pertama yang dibaca oleh agen.
Tambah tugas ke sasaran tugas-baharu lalai vault, diformat mengikut cara vault anda menulis tugas.
Kira tugas yang membawa medan tersuai priority_label:: urgent, paling mendesak dahulu. Buang --count untuk menyenaraikannya.
Cari tugas yang penerangannya menyebut invois dan tajuknya menyebut acme, sebagai JSON. Aksen dan huruf besar/kecil diabaikan, jadi cafe sepadan dengan café.
Lengkapkan tugas. Jika ia berulang, kejadian seterusnya ditulis semula ke dalam fail, tepat seperti yang dilakukan oleh aplikasi.
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/Settings/dialect.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. TaskForge/Settings ialah lokasi lalai; folder asas boleh dinamakan semula dalam aplikasi.
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/Settings/dialect.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, Android, dan Windows.
