Je kluis, vanuit de terminal
taskforge is een takenapp voor de opdrachtregel, voor de taken en notities in je Obsidian-kluis. Zoek en voltooi taken, maak en bewerk notities, of geef dezelfde commando's aan een shellscript of een agent. Het gebruikt de parser van de app en schrijft echte Markdown-bestanden op je computer.
De CLI of de MCP-server?
Gebruik de CLI vanuit shell-contexten zonder MCP-verbinding: scripts, cron, CI, of een coding-agent die in een lokale repo-checkout werkt. Heeft je agent al een MCP-verbinding met TaskForge, geef dan de voorkeur aan de MCP-tools; ze zijn getypeerd, geven gestructureerde foutmeldingen terug waarmee de agent zichzelf kan corrigeren, en hebben niets in je PATH nodig. 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
Probeer het met Node.js (inclusief npm en npx):
Installeer het commando taskforge globaal:
Vereist Node.js met npm/npx. npm installeert een native binary voor macOS, Windows (x64) en Linux (x64 en arm64). De TaskForge-app is er nog niet voor Linux; daar gebruik je de CLI en de MCP-server. Installeer de CLI apart van de app; Homebrew wordt niet meer ondersteund.
Snel aan de slag
Wijs taskforge naar een kluis met --vault, of stel eenmalig TASKFORGE_VAULT in. Elk leescommando accepteert --json voor machineleesbare uitvoer die een agent kan verwerken.
Toont het taakdialect van de kluis: statussymbolen, datumnotatie, aangepaste velden, waar nieuwe taken terechtkomen. Dit is wat een agent als eerste leest.
Voegt een taak toe aan de standaardlocatie voor nieuwe taken in de kluis, opgemaakt zoals jouw kluis taken schrijft.
Telt taken met het aangepaste veld priority_label:: urgent, meest urgent eerst. Laat --count weg om ze op te sommen.
Vindt taken waarvan de beschrijving invoice noemt en de titel acme, als JSON. Accenten en hoofdlettergebruik worden genegeerd, dus cafe komt overeen met café.
Vinkt een taak af. Als deze terugkeert, wordt de volgende herhaling teruggeschreven in het bestand, precies zoals de app dat zou doen.
Leest één taak met de hash van de inhoud, zodat een volgende bewerking --if-hash kan meegeven en weigert een verouderde kopie te overschrijven.
Query-grammatica
Het query-argument is een door spaties gescheiden verzameling tokens, die allemaal moeten overeenkomen. De meest gebruikte:
| text:word | Titel bevat het woord (ongevoelig voor accenten en hoofdlettergebruik). | text:groceries |
| desc:"phrase" | Taakbeschrijving bevat de frase. | desc:"send invoice" |
| tag:name | Taak heeft de tag #name. | tag:work |
| prop:key=value | Aangepast veld key is gelijk aan value. | prop:area=home |
| prop:key | Aangepast veld key bestaat, ongeacht de waarde. | prop:estimate |
| --sort due|priority|created | Sorteert de resultaten. Standaard op deadline, eerst de eerstvolgende. | --sort priority |
| --count | Geeft het aantal treffers terug in plaats van de taken. | --count |
Namen van aangepaste velden mogen letters, cijfers en underscores bevatten, dus priority_label en area_2 werken allebei.
Één vereiste: het kluiscontract
taskforge leest een klein contractbestand, TaskForge/Settings/dialect.json, dat TaskForge in je kluis schrijft. Het beschrijft je exacte taakformaat, zodat de CLI taken op jouw manier bewerkt in plaats van te gokken. Open de kluis minstens één keer in TaskForge 3.0 of hoger, ga naar Settings, AI & Agents, en laat "Generate agent files" aan staan. Dat schrijft het contract.
Als taskforge geen kluis kan vinden, vertelt het je de drie manieren om er een aan te wijzen:
- Geef --vault /path/to/vault mee aan het commando.
- Stel de omgevingsvariabele TASKFORGE_VAULT in.
- Open de kluis eenmaal in TaskForge 3.0+ zodat TaskForge/Settings/dialect.json bestaat, en voer het commando daarna uit vanuit de kluismap.
Alleen lokaal
taskforge draait op je eigen apparaat en raakt alleen de markdown-bestanden aan in de kluis waar je het naartoe wijst. Geen account, geen API-sleutel, geen netwerkverkeer. Wat je kluis ook al synchroniseert, iCloud, Dropbox of Obsidian Sync, brengt de wijzigingen naar je andere apparaten.
Wil je dat een agent het bestuurt?
De CLI is bedoeld voor terminals en scripts. Wil je dat Claude Desktop of een andere MCP-client taken toevoegt en afvinkt via een tool-interface, zet dan in plaats daarvan de MCP-server op. Dezelfde kluis, dezelfde regels. Het is hoe dan ook hetzelfde taskforge-programma: taskforge mcp --stdio is genoeg om er een MCP-server van te maken.
Zet de MCP-server op →De CLI bewerkt de taken. De app houdt ze in leven.
taskforge schrijft naar je kluis vanuit elke terminal; TaskForge maakt van diezelfde bestanden lijsten, widgets en herinneringen op je telefoon en desktop. Gratis te downloaden voor iPhone, iPad, Mac, Android en Windows.
