Ga naar hoofdinhoud

Je kluis, vanuit de terminal

taskforge is een klein opdrachtregelprogramma dat de taken in je Obsidian-kluis leest en schrijft. Het gebruikt dezelfde parser als de app, dus terugkerende taken schuiven door, archieven komen op de juiste plek terecht en je taakregels blijven in jouw formaat. Geef het door aan een shellscript of een agent en het bewerkt echte markdown-bestanden, niets gehost.

Komt eraan in TaskForge 3.0

De TaskForge CLI en de MCP-server verschijnen bij de release van TaskForge 3.0. Alles op deze pagina beschrijft hoe ze bij lancering zullen werken. De TaskForge-app is nu al beschikbaar.

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

macOS en Linux, via Homebrew:

Beschikbaar bij lancering 
brew install azhard/tap/taskforge

Liever npm? Hetzelfde programma wordt ook als pakket uitgebracht:

Beschikbaar bij lancering 
npm install -g taskforge

Een in de app gebundelde versie die zichzelf installeert zodra je een kluis opent, komt eraan. Tot die tijd is de tap hierboven de manier om te installeren.

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.

taskforge schema

Toont het taakdialect van de kluis: statussymbolen, datumnotatie, aangepaste velden, waar nieuwe taken terechtkomen. Dit is wat een agent als eerste leest.

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

Voegt een taak toe aan de standaardlocatie voor nieuwe taken in de kluis, opgemaakt zoals jouw kluis taken schrijft.

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

Telt taken met het aangepaste veld priority_label:: urgent, meest urgent eerst. Laat --count weg om ze op te sommen.

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

Vindt taken waarvan de beschrijving invoice noemt en de titel acme, als JSON. Accenten en hoofdlettergebruik worden genegeerd, dus cafe komt overeen met café.

taskforge done <task-id>

Vinkt een taak af. Als deze terugkeert, wordt de volgende gebeurtenis teruggeschreven in het bestand, precies zoals de app dat zou doen.

taskforge show <task-id> --json

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.

Eén vereiste: het kluiscontract

taskforge leest een klein contractbestand, taskforge/schema.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:

  1. Geef --vault /path/to/vault mee aan het commando.
  2. Stel de omgevingsvariabele TASKFORGE_VAULT in.
  3. Open de kluis eenmaal in TaskForge 3.0+ zodat taskforge/schema.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 en Android.

Apple Gratis downloaden - iOS & Mac Android Gratis downloaden - Android