Votre coffre, depuis le terminal
taskforge est un gestionnaire de tâches en ligne de commande pour les tâches et les notes de votre coffre Obsidian. Interrogez et terminez des tâches, créez et modifiez des notes, ou confiez les mêmes commandes à un script shell ou à un agent. Il utilise l’analyseur de l’application et écrit de vrais fichiers Markdown sur votre machine.
La CLI ou le serveur MCP ?
Utilisez la CLI depuis des contextes shell sans connexion MCP : scripts, cron, CI, ou un agent de code qui travaille dans une copie locale d’un dépôt. Si votre agent dispose déjà d’une connexion MCP à TaskForge, préférez les outils MCP ; ils sont typés, renvoient des erreurs structurées que l’agent peut utiliser pour se corriger, et n’exigent rien dans votre PATH. Les deux pilotent le même moteur avec une sémantique identique, choisissez donc celui déjà branché dans votre environnement. Modifier les fichiers du coffre à la main reste le dernier recours.
Installation
Essayez avec Node.js (qui inclut npm et npx) :
Installez la commande taskforge globalement :
Nécessite Node.js avec npm/npx. npm installe un binaire natif pour macOS, Windows (x64) et Linux (x64 et arm64). L’app TaskForge n’existe pas encore sous Linux ; vous y avez la CLI et le serveur MCP. Installez la CLI séparément de l’app ; Homebrew n’est plus pris en charge.
Démarrage rapide
Pointez taskforge vers un coffre avec --vault, ou définissez TASKFORGE_VAULT une bonne fois pour toutes. Chaque commande de lecture accepte --json pour une sortie exploitable par une machine, qu’un agent peut analyser.
Affiche le dialecte de tâches du coffre : symboles de statut, format de date, champs personnalisés, où vont les nouvelles tâches. C’est ce qu’un agent lit en premier.
Ajoute une tâche à la cible par défaut du coffre pour les nouvelles tâches, formatée comme votre coffre écrit ses tâches.
Compte les tâches qui portent le champ personnalisé priority_label:: urgent, les plus urgentes en premier. Enlevez --count pour les lister.
Trouve les tâches dont la description mentionne une facture et dont le titre mentionne acme, en JSON. Les accents et la casse sont ignorés, donc cafe correspond à café.
Termine une tâche. Si elle est récurrente, la prochaine occurrence est réécrite dans le fichier, exactement comme le ferait l’application.
Lit une tâche avec son hash de contenu, pour qu’une modification ultérieure puisse passer --if-hash et refuser d’écraser une copie périmée.
Grammaire de requête
L’argument de requête est un ensemble de jetons séparés par des espaces, qui doivent tous correspondre. Les plus courants :
| text:word | Le titre contient le mot (insensible aux accents et à la casse). | text:groceries |
| desc:"phrase" | La description de la tâche contient la phrase. | desc:"envoyer la facture" |
| tag:name | La tâche porte le tag #name. | tag:work |
| prop:key=value | Le champ personnalisé key est égal à value. | prop:area=home |
| prop:key | Le champ personnalisé key existe, quelle que soit sa valeur. | prop:estimate |
| --sort due|priority|created | Ordonne les résultats. Par défaut, date d’échéance, la plus proche en premier. | --sort priority |
| --count | Renvoie le nombre de correspondances plutôt que les tâches. | --count |
Les clés de champ personnalisé peuvent inclure des lettres, des chiffres et des underscores, donc priority_label et area_2 fonctionnent tous les deux.
Une seule exigence : le contrat de coffre
taskforge lit un petit fichier de contrat, TaskForge/Settings/dialect.json, que TaskForge écrit dans votre coffre. Il décrit votre format de tâches exact, pour que la CLI modifie les tâches à votre façon plutôt que de deviner. Ouvrez le coffre dans TaskForge 3.0 ou une version ultérieure au moins une fois, allez dans Paramètres > IA et agents et laissez « Générer les fichiers agents » activé. Cela écrit le contrat. TaskForge/Settings est l’emplacement par défaut ; le dossier de base peut être renommé dans l’app.
Si taskforge ne trouve pas de coffre, il indique les trois façons de l’y diriger :
- Ajoutez --vault /chemin/vers/coffre à la commande.
- Définissez la variable d’environnement TASKFORGE_VAULT.
- Ouvrez le coffre une fois dans TaskForge 3.0+ pour que TaskForge/Settings/dialect.json existe, puis lancez la commande depuis le dossier du coffre.
Local uniquement
taskforge s’exécute sur votre machine et ne touche que les fichiers markdown du coffre que vous lui indiquez. Aucun compte, aucune clé API, aucun appel réseau. L’outil qui synchronise déjà votre coffre (iCloud, Dropbox ou Obsidian Sync) transmet les modifications à vos autres appareils.
Vous voulez qu’un agent le pilote ?
La CLI est faite pour les terminaux et les scripts. Si vous voulez que Claude Desktop ou un autre client MCP ajoute et termine des tâches via une interface d’outils, configurez plutôt le serveur MCP. Même coffre, mêmes règles. C’est de toute façon le même binaire taskforge : taskforge mcp --stdio suffit à le transformer en serveur MCP.
Configurer le serveur MCP →La CLI modifie les tâches. L’app les fait vivre au quotidien.
taskforge écrit dans votre coffre depuis n’importe quel terminal ; TaskForge transforme ces mêmes fichiers en listes, widgets et rappels sur votre téléphone et votre ordinateur. Gratuit à télécharger sur iPhone, iPad, Mac, Android et Windows.
