あなたのvaultを、ターミナルから

CLIかMCPサーバーか

MCP接続のないシェル環境、スクリプトやcron、CI、リポジトリのチェックアウト内で動くコーディングエージェントなどでは、CLIを使ってください。エージェントがすでにTaskForgeへのMCP接続を持っているなら、MCPツールの方がおすすめです。型があり、エージェントが自己修正できる構造化されたエラーを返し、PATHに何も必要ありません。どちらも同じエンジンを同じ意味論で動かすので、ランタイムにすでに用意されている方を選べば十分です。vaultファイルを手で編集するのは最後の手段です。

インストール

macOSとLinuxでは、Homebrew経由でインストールできます。

brew install azhard/tap/taskforge

npmの方がよければ、同じバイナリがパッケージとしても配布されています。

npm install -g taskforge

vaultを開いたときに自動でインストールされるアプリ同梱版は近日公開予定です。それまでは、上記のtapが唯一の入手方法です。

クイックスタート

--vaultでtaskforgeにvaultの場所を伝えるか、TASKFORGE_VAULTを一度設定しておきます。読み取り系のコマンドはすべて--jsonに対応しており、エージェントが解析できる機械可読な出力を返します。

クエリ文法

クエリ引数は、スペース区切りのトークンの集合です。すべてのトークンが一致する必要があります。よく使うものは次のとおりです。

カスタムフィールドのキーには、英字、数字、アンダースコアを使えます。priority_label と area_2 のどちらも有効です。

ローカルのみ

taskforgeはあなたのマシン上で動作し、指定したvault内のマークダウンファイルにのみ触れます。アカウントもAPIキーもネットワーク通信も不要です。iCloud、Dropbox、Obsidian Syncなど、すでにvaultを同期している仕組みが、変更を他のデバイスにも届けます。

エージェントに操作させたいですか？

CLIはターミナルやスクリプト向けです。Claude Desktopや他のMCPクライアントにツールインターフェース経由でタスクの追加や完了をさせたい場合は、代わりにMCPサーバーをセットアップしてください。同じvault、同じルールです。どちらも同じtaskforgeバイナリなので、taskforge mcp --stdioを実行するだけでMCPサーバーに切り替わります。