Biarkan agen menguruskan senarai tugas anda

MCP atau CLI?

Utamakan alat MCP apabila agen anda sudah mempunyai sambungan MCP ke TaskForge. Alat ini bertaip, memulangkan ralat berstruktur yang membolehkan agen membetulkan dirinya sendiri, dan tidak memerlukan apa-apa dalam PATH anda. Gunakan CLI pula daripada konteks shell tanpa sambungan MCP: skrip, cron, CI, atau agen pengekodan yang bekerja dalam checkout repo. 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

{
  "mcpServers": {
    "taskforge": {
      "command": "npx",
      "args": ["-y", "taskforge-md", "mcp", "--stdio"],
      "env": {
        "TASKFORGE_VAULT": "/path/to/your/vault"
      }
    }
  }
}

Membina taskforge daripada sumber dan bukannya menggunakan npx? Halakan konfigurasi terus ke binari:

"command": "taskforge",
"args": ["mcp", "--stdio"]

Desktop sahaja, kerana di situlah klien MCP berada. taskforge dihantar sebagai satu binari natif tunggal untuk macOS, Windows dan Linux, dan pelayan MCP ialah salah satu sub-arahannya.

Set alat yang lengkap

22 alat kesemuanya, merangkumi keseluruhan kitaran hayat tugas: cipta, baca, kemas kini, lengkapkan, arkibkan dan padam, setiap satu dengan versi pukal; alih, tukar induk dan tukar antara baris inline dengan fail TaskNotes; semakan lint sebelum anda menulis baris; panggilan doctor untuk kesihatan vault; serta sumber skema dan senarai supaya agen mempelajari format anda sebelum bertindak. Enam yang tersenarai di bawah ialah yang paling kerap anda gunakan. Setiap panggilan membaca semula vault daripada cakera, jadi agen sentiasa bertindak ke atas fail semasa.

Setiap alat kini membawa anotasi, supaya klien tahu sekali imbas panggilan mana yang hanya membaca, mana yang menulis, dan yang mana memadam. Selebihnya set ini turut merangkumi bulk_add_tasks, bulk_update_tasks, bulk_complete_tasks, bulk_delete_tasks, get_tasks, archive_task, move_task, bulk_move_tasks, convert_task, bulk_convert_tasks, outdent_task, bulk_reparent_tasks, lint_task, doctor, list_task_lists dan get_schema.

Tiga sumber

Selain alat, pelayan turut mendedahkan konteks baca sahaja supaya agen mempelajari peraturan vault anda sebelum ia bertindak:

Jika ia tidak dapat mencari vault anda

Pelayan ini sentiasa bermula, walaupun sebelum ia tahu di mana vault anda berada, jadi Claude Desktop tidak akan pernah menunjukkan "server failed to start" yang kabur. Apabila panggilan alat tidak dapat menyelesaikan lokasi vault, ia memulangkan ralat mudah yang boleh disampaikan semula oleh agen: tetapkan pemboleh ubah persekitaran TASKFORGE_VAULT ke laluan vault anda, atau pasang semula bungkusan itu dan masukkan direktori vault apabila diminta.

Tempatan sahaja

taskforge mcp --stdio membaca dan menulis fail markdown dalam vault yang anda konfigurasikan dan tiada apa-apa lagi. Tiada akaun, tiada awan. Penyegerakan sedia ada anda, iCloud, Dropbox atau Obsidian Sync, memindahkan perubahan itu antara peranti.

Lebih suka terminal?

Jika anda mahu menskrip tugas anda atau menjalankan arahan sekali sahaja dan bukannya menggerakkannya melalui agen, taskforge CLI meliputi vault yang sama dengan peraturan yang sama.

Soalan yang orang tanya