概要

tco は「TaskChute for Obsidian」のタスクデータをコマンドラインから操作するためのツールです。完全ローカル動作を重視して設計されており、Obsidian Vault 内のファイルを直接読み書きしてタスクの一覧表示・追加・移動・削除、ルーチン（繰り返しタスク）化、リマインダーの設定／解除などを行えます。AI エージェントとやり取りするための JSON 出力モード（—json）を備え、Claude Code や Codex 等と組み合わせた自動化ワークフローを想定しています。TypeScript + esbuild 構成で配布・利用がしやすい形になっています。

リポジトリの統計情報

スター数: 1
フォーク数: 0
ウォッチャー数: 1
コミット数: 2
ファイル数: 12
メインの言語: TypeScript

主な特徴

Obsidian Vault 内の TaskChute Plus データをローカルで直接操作
AI エージェント連携向けの JSON 出力モード（—json）
タスクの一覧表示・追加・移動・削除、ルーチン化、リマインダー管理
アトミックなデータ更新（失敗時ロールバック）による安全性確保

技術的なポイント

tco は TypeScript をベースにした CLI ツールで、esbuild の設定ファイル（esbuild.config.mjs）が含まれていることから配布用にバンドルして単一実行ファイルまたは軽量な Node モジュールとして配布する設計が見て取れます。コアの設計方針は「完全ローカル動作」と「AI エージェントとの連携容易化」です。Vault 内のファイルを直接読み書きするため、ファイルパス解決やマークダウン／JSON フォーマットの解析・生成が重要になります。JSON 出力モード（—json）はエージェントが扱いやすい構造化データを返すため、プログラム的なパイプラインと親和性が高いです。

安全性の観点では「アトミック操作」による更新が特徴で、失敗時に変更をロールバックする仕組みを用意しており、テンポラリファイルへの書き出し→リネームなどの一般的な手法でデータ整合性を保つ実装が想定されます。AGENTS.md や CLAUDE.md が含まれていることから、特定の AI エージェント向けの操作手順や対話フォーマット例が提供されており、実運用での連携をサポートします。ネットワーク通信を行わない設計は、機密性の高い Vault データを扱う上での安心感を高め、オフラインの自動化パイプライン構築に向いています。

ユースケースとしては、AI による日次タスク整理・リマインド設定・ルーチン化の自動化、CLI を用いたスクリプト連携、CI／ローカルバッチでのタスク集計や分析などが考えられます。要件として Node.js 18 以上が必要で、TypeScript ソースを esbuild でビルドして配布・実行する流れが想定されています。

プロジェクトの構成

主要なファイルとディレクトリ：

.gitignore: file
AGENTS.md: file
CLAUDE.md: file
README.md: file
esbuild.config.mjs: file

…他 7 ファイル

まとめ

Obsidian の TaskChute データを安全かつ AI 連携しやすく操作する実用的な CLI ツールです。

リポジトリ情報：

名前: tco
説明: TaskChute for Obsidian CLI - AI agent friendly CLI tool for interacting with TaskChute plugin data
スター数: 1
言語: TypeScript
URL: https://github.com/hiroyaiizuka/tco
オーナー: hiroyaiizuka
アバター: https://avatars.githubusercontent.com/u/39001773?v=4

READMEの抜粋：

tco - TaskChute for Obsidian CLI

AIエージェント（Claude Code、Cline、Codex 等）がCLI経由で TaskChute for Obsidian (Obsidian プラグイン) のタスクデータを操作するためのCLIツールです。

完全ローカル動作。ネットワーク通信なし。Obsidian Vault 内のファイルを直接読み書きします。

Features

Obsidian Vault 内の TaskChute Plus データをコマンドラインから操作
JSON 出力モード (--json) によるAIエージェント連携
タスクの一覧表示・追加・移動・削除
ルーチン（繰り返しタスク）への変換
リマインダーの設定・解除
アトミック操作による安全なデータ変更（失敗時ロールバック）

Installation

Prerequisites

Node.js 18 以上 -…