task-memory (tm)

AIエージェント（および人間）がタスクの状態とコンテキストを管理し、長時間のセッションにおける「記憶喪失」を防ぐためのCLIツールです。

特徴

• 状態の永続化: タスクの状態を ~/.task-memory.json に保存します。
• コンテキストスイッチ: tm update コマンドで複数のタスクを一度に更新できます。
• LLMフレンドリー: AIエージェントが理解しやすいJSON形式で出力します。

インストール

ローカルインストール

git clone <repository-url> task-memory
cd task-memory
bun install
bun link

これで tm コマンドが使用可能になります。

使い方

詳細な使い方は docs/usage/index.md を参照してください。

Usage

Create a Task

tm new "Refactor auth" --status wip --body "Starting now" --priority high --goal "Complete by Friday"

Aliases: tm n (not yet impl), tm new

List Tasks

tm list
# or
tm ls
tm l

By default, shows todo and wip tasks.

Filtering Options:

# すべてのタスク（done/closed含む）を表示
tm list --status-all
tm ls -a

# オープンなタスク（todo, wip, pending, long）を表示
tm list --open

# ステータスでフィルタリング
tm list --status pending
tm ls -s wip

# 優先度でフィルタリング
tm list --priority high

# バージョンでフィルタリング
tm list --version 1.0.0
tm list --tbd           # version が tbd のタスク
tm list --released      # リリース済み（version が tbd 以外）のタスク

# 表示件数を制限
tm list --head 5        # 最初の5件
tm list --tail 10       # 最後の10件
tm list --head          # 最初の10件（デフォルト）

Update a Task

tm update 1 --status done
# or
tm up 1 -s done
tm u 1 -s done

Supports context switching:

tm up 1 -s done 2 -s wip

Update version:

tm update 1 --version 1.0.0
# or
tm u 1 -v 1.0.0

Get Task Details

tm get 1
# or
tm g 1

Finish a Task

tm finish 1
# or
tm fin 1
tm f 1

Reviews

tm review new "Design Review" --body "Check this out"
# or
tm rev new ...
tm tmr new ...

Subcommands: new, list, get, update, return, accept, reject.

Environment

tm env

開発

開発者向けの情報は docs/dev/index.md を参照してください。

bun test