Ihr Vault, vom Terminal aus
taskforge ist eine To-do-App für die Kommandozeile, gemacht für die Aufgaben und Notizen in Ihrem Obsidian-Vault. Fragen Sie Aufgaben ab und schließen Sie sie ab, erstellen und bearbeiten Sie Notizen, oder geben Sie dieselben Befehle einem Shell-Skript oder einem Agenten in die Hand. Es nutzt den Parser der App und schreibt echte Markdown-Dateien auf Ihrem Rechner.
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, anhand derer 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 der letzte Ausweg.
Installation
Mit Node.js ausprobieren (enthält npm und npx):
Den Befehl taskforge global installieren:
Erfordert Node.js mit npm/npx. npm installiert eine native Binärdatei für macOS, Windows (x64) und Linux (x64 und arm64). Die TaskForge-App gibt es noch nicht für Linux; dort nutzen Sie die CLI und den MCP-Server. Die CLI wird separat von der App installiert; Homebrew wird nicht mehr unterstützt.
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.
Gibt den Aufgaben-Dialekt des Vaults aus: Status-Symbole, Datumsformat, benutzerdefinierte Felder, wo neue Aufgaben landen. Das liest ein Agent als Erstes.
Fügt dem Standardziel für neue Aufgaben im Vault eine Aufgabe hinzu, formatiert so, wie Ihr Vault Aufgaben schreibt.
Zählt Aufgaben mit dem benutzerdefinierten Feld priority_label:: urgent, dringendste zuerst. Lassen Sie --count weg, um sie aufzulisten.
Findet Aufgaben, deren Beschreibung „invoice“ enthält und deren Titel acme enthält, als JSON. Akzente und Groß- und Kleinschreibung werden ignoriert, sodass cafe auch café findet.
Schließt eine Aufgabe ab. Ist sie wiederkehrend, schreibt taskforge die nächste Wiederholung in die Datei zurück, genau so, wie es die App tun würde.
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" | Die Aufgabenbeschreibung enthält die Wortfolge. | desc:"send invoice" |
| tag:name | Aufgabe trägt den Tag #name. | tag:work |
| prop:key=value | Das benutzerdefinierte Feld key hat den Wert value. | prop:area=home |
| prop:key | Benutzerdefiniertes Feld key existiert, mit beliebigem Wert. | prop:estimate |
| --sort due|priority|created | Ordnet die Ergebnisse. Standard ist das Fälligkeitsdatum, früheste 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/Settings/dialect.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 Einstellungen, KI & Agenten, und lassen Sie „Agenten-Dateien generieren“ aktiviert. Das schreibt die Formatbeschreibung. TaskForge/Settings ist der Standardort; der Basisordner lässt sich in der App umbenennen.
Wenn taskforge keinen Vault findet, nennt es Ihnen drei Wege, es auf einen Vault 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/Settings/dialect.json existiert, und führen Sie den Befehl anschließend im Vault-Ordner 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. Ihre bisherige Synchronisierung (iCloud, Dropbox oder Obsidian Sync) überträ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 in beiden Fällen dieselbe taskforge-Binärdatei: taskforge mcp --stdio genügt, um sie in einen MCP-Server zu verwandeln.
MCP-Server einrichten →Die CLI bearbeitet die Aufgaben. Die App behält sie im Blick.
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, Android und Windows.
