Laat een agent je takenlijst runnen

MCP of de CLI?

Geef de voorkeur aan de MCP-tools als je agent al een MCP-verbinding met TaskForge heeft. Ze zijn getypeerd, geven gestructureerde foutmeldingen terug waarmee de agent zichzelf kan corrigeren, en hebben niets in je PATH nodig. Grijp anders naar de CLI vanuit shell-contexten zonder MCP-verbinding: scripts, cron, CI, of een coding-agent die in een lokale repo-checkout werkt. Beide sturen dezelfde engine aan met identieke semantiek, kies dus wat er al is aangesloten in jouw omgeving. Kluisbestanden met de hand bewerken is het laatste redmiddel.

Installeren

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

taskforge zelf uit de broncode gebouwd in plaats van npx te gebruiken? Wijs de configuratie dan direct naar het programma:

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

Alleen desktop, want daar leven MCP-clients. taskforge wordt uitgebracht als één native programma voor macOS, Windows en Linux, en de MCP-server is een van de subcommando's daarvan.

De volledige toolset

22 tools in totaal, die de hele levenscyclus van een taak dekken: aanmaken, lezen, bijwerken, afronden, archiveren en verwijderen, elk met een bulkvariant; verplaatsen, een andere ouder toewijzen en converteren tussen een inline regel en een TaskNotes-bestand; een lint-controle voordat je een regel schrijft; een doctor-aanroep voor de gezondheid van de kluis; en schema- en lijstresources, zodat de agent je formaat leert kennen voordat hij iets doet. De zes hieronder gebruik je het vaakst. Elke aanroep leest de kluis opnieuw van schijf, dus de agent werkt altijd met de actuele bestanden.

Elke tool draagt annotaties, zodat een client in één oogopslag ziet welke aanroepen alleen lezen, welke schrijven en welke verwijderen. De rest van de set voegt 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 en get_schema toe.

Drie resources

Naast de tools stelt de server alleen-lezen context beschikbaar, zodat de agent de regels van je kluis kent voordat hij iets doet:

Als hij je kluis niet kan vinden

De server start altijd, zelfs voordat hij weet waar je kluis staat, zodat Claude Desktop nooit een cryptische "server failed to start" toont. Als een tool-aanroep geen kluis kan vinden, geeft hij een duidelijke foutmelding terug die de agent kan doorgeven: stel de omgevingsvariabele TASKFORGE_VAULT in op het pad van je kluis, of installeer het pakket opnieuw en voer de kluismap in wanneer daarom wordt gevraagd.

Alleen lokaal

taskforge mcp --stdio leest en schrijft alleen de markdown-bestanden in de kluis die je instelt, en verder niets. Geen account, geen cloud. Je bestaande synchronisatie, iCloud, Dropbox of Obsidian Sync, brengt de wijzigingen naar je andere apparaten.

Liever een terminal?

Wil je je taken scripten of eenmalige commando's uitvoeren in plaats van ze door een agent te laten aansturen, dan werkt de taskforge CLI met dezelfde kluis en dezelfde regels.

Veelgestelde vragen