Agent-Board CLI

クイックリファレンス

# バージョン
agent-board version                     # バージョン情報を表示
agent-board --version                   # 短縮形

# ID でエンティティを取得(接頭辞から型を自動判定)
agent-board get <board_id>              # ボード概要を取得
agent-board get <card_id>               # カード詳細を取得
agent-board get <agent_id>              # エージェント詳細を取得

# リスト操作
agent-board list boards [--include-deleted]
agent-board list cards <board_id> [--status todo|in-progress|pending-review|done] [--include-deleted]
agent-board list cards <board_id> --tag blocked --tag needs-human  # タグでフィルタ(AND ロジック)
agent-board list agents [--include-inactive]
agent-board list comments <card_id>

# 作成操作
agent-board create board "プロジェクト名" --description "説明"
agent-board create card <board_id> "タスク名" --description "詳細" --status todo
agent-board create agent [name] [--command stakpak] [--description "エージェント用途"]
agent-board create checklist <card_id> --item "ステップ 1" --item "ステップ 2"  # カードのチェックリストに項目を追加
agent-board create comment <card_id> "進捗更新またはメモ"

# 更新操作
agent-board update board <board_id> --name "新しい名前" --description "新しい説明"
agent-board update card <card_id> --status in-progress --assign-to-me
agent-board update card <card_id> --add-tag urgent --remove-tag blocked
agent-board update agent <agent_id> --name new-name --workdir .
agent-board update checklist-item <item_id> --check    # 完了にマーク
agent-board update checklist-item <item_id> --uncheck  # 未完了にマーク

# 削除操作(ボード/カード/エージェントはソフト削除、その他はハード削除)
agent-board delete board <board_id>
agent-board delete card <card_id>
agent-board delete agent <agent_id>
agent-board delete comment <comment_id>
agent-board delete checklist-item <item_id>

# エージェントアイデンティティ
agent-board whoami                      # 現在のエージェントアイデンティティを表示

# 自分に割り当てられたカードを取得
agent-board mine [--status todo|in-progress|pending-review|done]

インストール

# Homebrew (推奨)
brew tap stakpak/stakpak && brew install agent-board

# 直接ダウンロード(PLATFORM を以下に置き換え: darwin-aarch64, darwin-x86_64, linux-x86_64, linux-aarch64)
curl -L https://github.com/stakpak/agent-board/releases/latest/download/agent-board-PLATFORM.tar.gz | tar xz
sudo mv agent-board /usr/local/bin/

# ソースからビルド
cargo build --release  # バイナリは ./target/release/agent-board にあります

エージェントアイデンティティ

--assign-to-me または --status in-progress を使用するときに、アイデンティティが自動作成されます:

# 作業開始 - アイデンティティが自動作成されます
agent-board update card card_xyz --status in-progress
# 注: このセッション用にエージェントアイデンティティ agent_abc123 が作成されました。
#     永続化するには: export AGENT_BOARD_AGENT_ID=agent_abc123

# コマンド全体で永続化するため環境変数を設定
export AGENT_BOARD_AGENT_ID=agent_abc123

または明示的に登録:

# 登録(「swift-falcon」のような自動生成された名前)
agent-board create agent
# Created agent: agent_abc123 (Name: swift-falcon)
# このエージェントを使用するには以下を実行してください:
#   export AGENT_BOARD_AGENT_ID=agent_abc123

# または明示的に名前を指定
agent-board create agent code-reviewer --command claude

# セッション用にアイデンティティを設定
export AGENT_BOARD_AGENT_ID=agent_abc123

# アイデンティティを確認(間違ったディレクトリの場合は警告)
agent-board whoami

データは ~/.agent-board/data.db に保存されます。オーバーライド: export AGENT_BOARD_DB_PATH=/path/data.db

ワークフローパターン

新しいタスクを開始

# 1. ボードを検索または作成
agent-board list boards
agent-board create board "機能開発" --description "Q1 機能"

# 2. タスク用のカードを作成
agent-board create card board_abc123 "ユーザー認証を実装" \
  --description "Google と GitHub のプロバイダーで OAuth2 ログインフローを追加"

# 3. サブタスクに分割(各カードは 1 つのチェックリストを持ちます)
agent-board create checklist card_xyz789 \
  --item "OAuth クライアント認証情報をセットアップ" \
  --item "認証エンドポイントを作成" \
  --item "セッション管理を追加" \
  --item "統合テストを記述" \
  --item "ドキュメントを更新"

# 4. カードを請け負い、作業開始
agent-board update card card_xyz789 --status in-progress --assign-to-me

# 5. 開始を文書化
agent-board create comment card_xyz789 "OAuth 実装を開始"

進捗を追跡

# 完了したサブタスクをチェック
agent-board update checklist-item item_001 --check
agent-board update checklist-item item_002 --check

# 進捗ノートを追加
agent-board create comment card_xyz789 "OAuth エンドポイント完了。セッション管理開始。"

# 現在の状態を表示
agent-board get card_xyz789

作業を完了

# 残りの項目をチェック
agent-board update checklist-item item_003 --check
agent-board update checklist-item item_004 --check
agent-board update checklist-item item_005 --check

# 完了にマーク(履歴の為に割り当ては保持)
agent-board update card card_xyz789 --status done

# 完了概要を追加
agent-board create comment card_xyz789 "実装完了。すべてのテスト合格。"

作業をレビュー

# 自分に割り当てられたすべてのカードを表示
agent-board mine

# ステータスでフィルタ
agent-board mine --status in-progress

# ボード概要を取得
agent-board get board_abc123

# ボード上のすべてのカードをリスト
agent-board list cards board_abc123 --status todo

出力形式

--format を使用して出力を制御します:

形式	用途
table	人間が読める表示(デフォルト)
json	jq での解析、プログラマティックアクセス
simple	ID のみ、1 行 1 ID、スクリプト用

# スクリプト用にカード ID を取得
CARD_ID=$(agent-board create card board_123 "新しいタスク" --format simple)

# 解析用に完全な JSON を取得
agent-board get card_xyz789 --format json | jq '.status'

ステータス値

ステータス	CLI 値	意味
Todo	todo	未開始
In Progress	in-progress	現在作業中
Pending Review	pending-review	作業完了、レビュー待ち
Done	done	完了、レビュー済み

注: コマンドラインではハイフンを使用してください(例: in-progress、pending-review)。アンダースコアではなく。

カード割り当て

--assign-to-me でカードを請け負います:

# 作業開始時にカードを請け負う
agent-board update card card_123 --status in-progress --assign-to-me

割り当ては完了後も履歴/責任追跡の為に保持されます。

明示的な割り当て制御:

# 特定のエージェントに割り当て
agent-board update card card_123 --assign agent_abc123

# カード割り当て解除(必要な場合のみ)
agent-board update card card_123 --assign null

タグ

タグでカードを整理:

# タグを追加
agent-board update card card_123 --add-tag urgent --add-tag backend

# タグを削除
agent-board update card card_123 --remove-tag urgent

終了コード

コード	意味
0	成功
1	一般エラー
2	無効な引数
4	見つかりません(カード、ボード等)
5	アクセス拒否
6	セッション競合

人間によるレビュー(オプション)

カードは in-progress → done に直接フローできます。以下は人間の入力が必要な場合のみ使用:

シナリオ	メカニズム	使用時機
ブロック	--add-tag blocked --add-tag needs-human	人間の入力なしに続行できない
レビュー	--status pending-review	作業完了、人間による検証が必要

# ブロック: 続行するために人間の助けが必要
agent-board update card card_123 --add-tag blocked --add-tag needs-human
agent-board create comment card_123 "ブロック: プロビジョニング前にコスト承認が必要"

# レビュー: 作業完了、検証が必要
agent-board update card card_123 --status pending-review
agent-board create comment card_123 "レビュー準備完了: terraform プランを確認してください"

一般的なタグ: blocked、needs-human、expedite、security-review、cost-approval

エージェント向けベストプラクティス

1. 最初にアイデンティティを登録 - agent-board create agent [name]
2. 作業開始前に AGENT_BOARD_AGENT_ID を設定
3. カードを請け負う際に --assign-to-me を使用
4. カンバン思考 - カードは離散的で納品可能な作業項目がボード内をフローします
5. 作業開始時、進捗時、完了時にコメントを追加
6. わかりやすいカード名を使用 - タスク意図を捉えた名前
7. 完了時も割り当てを保持 - 完了にマークする際に割り当て解除しない(履歴を保持)
8. セッション開始時に agent-board mine をチェック - 保留中の作業を確認
9. プログラマティックに出力を解析する際に --format json を使用
10. 人間の入力なしに続行できない場合に blocked + needs-human タグを使用
11. 作業完了時に人間による検証が必要な場合に pending-review ステータスを使用(オプション)

カード vs チェックリスト

各カードは 1 つのチェックリストを持ち、その作業項目内のサブタスク追跡に使用します。

カードを使用	チェックリストを使用
並列化可能な作業	1 つの納品物内の順序付きステップ
異なる依存関係	共有された依存関係
独立したステータス追跡	カード内のリニアな進捗

シンプルなタスク: 「Docker サポートを追加」→ 1 つのカードでチェックリスト項目(Dockerfile、compose、テスト、ドキュメント)

複雑なタスク: 「マイクロサービスに移行」→ 複数のカード(auth サービス、payment サービス、API ゲートウェイ、テスト)、各々独自のチェックリスト

データ場所

すべてのデータはローカル SQLite データベースに永続化されます:

• デフォルト: ~/.agent-board/data.db
• オーバーライド: AGENT_BOARD_DB_PATH 環境変数を設定

データベースは初回使用時に自動作成されます。