Ihr Vault, vom Terminal aus

taskforge ist ein kleines Kommandozeilen-Tool, das die Aufgaben in Ihrem Obsidian-Vault liest und schreibt. Es nutzt denselben Parser wie die App, also rücken wiederkehrende Aufgaben korrekt vor, Archive landen am richtigen Ort, und Ihre Aufgabenzeilen bleiben in Ihrem Format. Geben Sie es einem Shell-Skript oder einem Agenten in die Hand, und es bearbeitet echte Markdown-Dateien, nichts gehostet.

Kommt mit TaskForge 3.0

Die TaskForge-CLI und der MCP-Server erscheinen mit dem Release von TaskForge 3.0. Diese Seite beschreibt, wie beide zum Start funktionieren werden. Die TaskForge-App ist schon heute verfügbar.

CLI oder der MCP-Server?

Nutzen Sie die CLI aus Shell-Kontexten ohne MCP-Verbindung: Skripte, Cron, CI oder ein Coding-Agent, der in einem Repo-Checkout arbeitet. Hat Ihr Agent dagegen bereits eine MCP-Verbindung zu TaskForge, bevorzugen Sie die MCP-Tools; sie sind typisiert, liefern strukturierte Fehler, an denen sich der Agent selbst korrigieren kann, und brauchen nichts in Ihrem PATH. Beide steuern dieselbe Engine mit identischer Semantik, wählen Sie also, was in Ihrer Umgebung bereits eingerichtet ist. Vault-Dateien von Hand zu bearbeiten, ist die letzte Option.

Installation

macOS und Linux, über Homebrew:

Verfügbar zum Start

brew install azhard/tap/taskforge

Lieber npm? Dieselbe Binärdatei gibt es auch als Paket:

Verfügbar zum Start

npm install -g taskforge

Eine app-gebündelte Kopie, die sich beim Öffnen eines Vaults selbst installiert, ist in Vorbereitung. Bis dahin ist der Tap oben der Weg hinein.

Schnellstart

Richten Sie taskforge mit --vault auf einen Vault aus, oder setzen Sie einmalig TASKFORGE_VAULT. Jeder Lesebefehl akzeptiert --json für maschinenlesbare Ausgabe, die ein Agent parsen kann.

taskforge schema

Gibt den Aufgaben-Dialekt des Vaults aus: Status-Symbole, Datumsformat, benutzerdefinierte Felder, wo neue Aufgaben landen. Das liest ein Agent als Erstes.

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

Fügt dem Standardziel für neue Aufgaben im Vault eine Aufgabe hinzu, formatiert so, wie Ihr Vault Aufgaben schreibt.

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

Zählt Aufgaben mit dem benutzerdefinierten Feld priority_label:: urgent, dringendste zuerst. Lassen Sie --count weg, um sie aufzulisten.

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

Findet Aufgaben, deren Beschreibung eine Rechnung erwähnt und deren Titel acme enthält, als JSON. Akzente und Groß- und Kleinschreibung werden ignoriert, sodass cafe auch café findet.

taskforge done <task-id>

Schließt eine Aufgabe ab. Wenn sie wiederkehrt, wird das nächste Vorkommen in die Datei zurückgeschrieben, genau so, wie es die App tun würde.

taskforge show <task-id> --json

Liest eine Aufgabe samt Inhalts-Hash, sodass eine nachfolgende Bearbeitung --if-hash übergeben und das Überschreiben einer veralteten Kopie verweigern kann.

Abfragegrammatik

Das Abfrageargument ist eine durch Leerzeichen getrennte Menge von Tokens, die alle zutreffen müssen. Die gängigsten:

text:word	Titel enthält das Wort (unabhängig von Akzenten und Groß- und Kleinschreibung).	text:groceries
desc:"phrase"	Aufgabenbeschreibung enthält die Phrase.	desc:"send invoice"
tag:name	Aufgabe trägt den Tag #name.	tag:work
prop:key=value	Benutzerdefiniertes Feld key entspricht value.	prop:area=home
prop:key	Benutzerdefiniertes Feld key existiert, mit beliebigem Wert.	prop:estimate
--sort due\|priority\|created	Ordnet die Ergebnisse. Standard ist Fälligkeitsdatum, das nächste zuerst.	--sort priority
--count	Gibt die Anzahl der Treffer zurück statt der Aufgaben selbst.	--count

Schlüssel benutzerdefinierter Felder können Buchstaben, Ziffern und Unterstriche enthalten, sodass sowohl priority_label als auch area_2 funktionieren.

Eine Voraussetzung: der Vault-Vertrag

taskforge liest eine kleine Vertragsdatei, taskforge/schema.json, die TaskForge in Ihren Vault schreibt. Sie beschreibt Ihr genaues Aufgabenformat, damit die CLI Aufgaben auf Ihre Art bearbeitet, statt zu raten. Öffnen Sie den Vault mindestens einmal in TaskForge 3.0 oder neuer, gehen Sie zu Settings, AI & Agents, und lassen Sie "Generate agent files" aktiviert. Das schreibt den Vertrag.

Wenn taskforge keinen Vault findet, nennt es Ihnen die drei Wege, ihn darauf auszurichten:

Übergeben Sie --vault /path/to/vault beim Befehl.
Setzen Sie die Umgebungsvariable TASKFORGE_VAULT.
Öffnen Sie den Vault einmal in TaskForge 3.0+, sodass taskforge/schema.json existiert, und führen Sie den Befehl anschließend von innerhalb des Vault-Ordners aus.

Nur lokal

taskforge läuft auf Ihrem Rechner und rührt nur die Markdown-Dateien im Vault an, auf den Sie es ausrichten. Kein Konto, kein API-Schlüssel, keine Netzwerkaufrufe. Was auch immer Ihren Vault bereits synchronisiert, iCloud, Dropbox oder Obsidian Sync, trägt die Änderungen auf Ihre anderen Geräte.

Soll ein Agent es steuern?

Die CLI ist für Terminals und Skripte gedacht. Wenn Claude Desktop oder ein anderer MCP-Client Aufgaben über eine Tool-Schnittstelle hinzufügen und abschließen soll, richten Sie stattdessen den MCP-Server ein. Derselbe Vault, dieselben Regeln. Es ist ohnehin dasselbe taskforge-Binary: taskforge mcp --stdio genügt, um es in einen MCP-Server zu verwandeln.

MCP-Server einrichten →

Die CLI bearbeitet die Aufgaben. Die App hält sie am Leben.

taskforge schreibt von jedem Terminal aus in Ihren Vault; TaskForge macht aus denselben Dateien Listen, Widgets und Erinnerungen auf Ihrem Telefon und Desktop. Kostenlos für iPhone, iPad, Mac und Android.

Gratis - iOS & Mac

Gratis - Android