trekker

Trekker

概要

Trekker は、AI コーディングエージェント向けに設計された CLI ベースの課題管理ツールです。データをローカルの SQLite（.trekker/trekker.db）に保存し、エピック、タスク、サブタスク、依存関係、コメント、全文検索、監査履歴ログに対応しています。トークン効率のよい出力を利用するには、任意のコマンドで --toon を使用してください。

使用する場面： エージェントの作業セッションの追跡、ローカルでのタスク管理、カンバン形式のワークフロー、依存関係を考慮したタスクの順序付け、セッションをまたいでコンテキストを保持するためのチェックポイントコメント。

使用しない場面： チーム全体でのプロジェクト管理（GitHub Issues／Linear を使用）、リアルタイムの共同作業、リモート中心のワークフロー、CI/CD と統合された課題管理。

主なコマンド

trekker init
trekker --toon ready
trekker --toon task list --status in_progress
trekker --toon task list --status todo
trekker --toon task list --epic EPIC-1
trekker --toon task show TREK-1
trekker --toon epic list
trekker --toon epic show EPIC-1
trekker --toon comment list TREK-1
trekker --toon search "query" --type task
trekker --toon list --status in_progress
trekker --toon history --entity TREK-1
trekker epic create -t "Title" -d "description" -p 2
trekker task create -t "Title" -d "description" -e EPIC-1 -p 2 --tags "a,b"
trekker subtask create TREK-1 -t "Title" -d "description" -p 2
trekker task update TREK-1 -s in_progress
trekker task update TREK-1 -s completed
trekker epic complete EPIC-1
trekker dep add TREK-2 TREK-1
trekker comment add TREK-1 -a "agent" -c "Summary: what was done and which files changed"

ステータス — タスク／サブタスク：todo、in_progress、completed、wont_fix、archived | エピック：todo、in_progress、completed、archived

優先度 — 0 重大、1 高、2 中（デフォルト）、3 低、4 バックログ、5 いつか

コマンドごとに使用できるフラグ

ここに記載されているフラグのみを使用してください。フラグを推測したり、作り出したりしないでください。

コマンド	使用できるフラグ
epic create	-t -d -p -s
epic list	--status
epic update	-t -d -p -s
epic show/complete/delete	（フラグなし。ID のみ）
task create	-t -d -p -s -e --tags
task list	--status --epic
task update	-t -d -p -s -e --tags --no-epic
task show/delete	（フラグなし。ID のみ）
subtask create	-t -d -p -s
subtask update	-t -d -p -s
subtask list/delete	（フラグなし。ID のみ）
comment add	-a -c （両方必須）
comment update	-c
comment list/delete	（フラグなし。ID のみ）
dep add/remove	（フラグなし。ID を 2 つ指定）
dep list	（フラグなし。ID のみ）
search	--type --status --limit --page --rebuild-index
history	--entity --type --action --since --until --limit --page
list	--type --status --priority --since --until --sort --limit --page
ready	（フラグなし）
wipe	-y

存在しないフラグ（エージェントがよく誤って生成するもの）：

• --offset — 代わりに --page と --limit を使用してください
• --assignee — trekker に担当者フィールドはありません
• --label — 代わりに、タスクの作成／更新で --tags を使用してください
• --verbose / --json / --quiet — 簡潔な出力には --toon を使用してください。デフォルトは詳細出力です
• --filter — 代わりに --status、--type、--priority を個別のフラグとして使用してください
• task list の --sort — trekker list でのみ使用できます
• --all — どのコマンドにもありません
• --force / -f — -y を受け付けるのは wipe のみです
• --name / -n — 代わりに -t / --title を使用してください

フラグについて不明な場合は、任意のコマンドで --help を実行してください。

trekker --help
trekker task --help
trekker task create --help

よくある間違い

間違い	正しいパターン
先に検索せずにタスクを作成する	重複を避けるため、作成前に必ず trekker search "keyword" を実行します
要約コメントなしでタスクを完了する	実施内容と変更したファイルを記載した Summary: コメントを追加します
--toon フラグを使用しない	エージェントのコンテキストでトークン使用量を減らすため、必ず --toon を使用します
作業前に in_progress を設定し忘れる	他のエージェントがタスクの担当者を把握できるよう、作業開始前にステータスを設定します
epic complete ではなく epic delete を使用する	epic delete はタスクを通知なく孤立させます。アーカイブするには epic complete を使用します
依存関係の方向を逆にする	dep add TREK-2 TREK-1 は、TREK-2 が TREK-1 に依存することを意味します（TREK-1 が TREK-2 をブロックします）
コンテキストをリセットする前にチェックポイントコメントを追加しない	完了項目、次の手順、影響を受けるファイルを記載した Checkpoint: コメントを追加します
計画を立てる前にコーディングする	コードを書く前にエピックを作成し、依存関係を設定してタスクに分割します
曖昧なタスクの説明	実装手順、変更するファイル、受け入れ条件を記載します
タイプで絞り込まずに検索する	結果を絞り込むには --type task または --status in_progress を使用します
空の検索クエリ trekker search ""	FTS5 は空文字列を拒否します。必ず検索語を指定してください
タスクが延期されただけなのに wont_fix を使用する	wont_fix は今後も対応しないという意味です。延期または置き換えられた作業には archived を使用します
comment add で -a または -c が欠落している	-a（作成者）と -c（内容）の両方が必須です
trekker init を2回実行する	冪等ではありません。.trekker/ がすでに存在する場合はエラーになります
.trekker/ を gitignore に追加し忘れる	タスクの状態を共有しない場合は、初期化後に .trekker/ を .gitignore に追加します

委任

• タスクの発見と優先順位付け：コードベースをスキャンして作業を特定するには、Explore エージェントを使用します
• 複数タスクの実行：サブタスクを並行して完了するには、Task エージェントを使用します

参考資料

• エージェントのワークフローとセッション管理
• コマンドと CLI の使い方