vibekanban

Vibe Kanban

AI コーディングエージェント向けのオーケストレーションプラットフォームです。分離された Git ワークツリーで、AI が生成したコードを計画、レビュー、管理できます。

リンク

• ドキュメント
• リリース
• GitHub

クイックナビゲーション

トピック	リファレンス
インストールとセットアップ	getting-started.md
ワークスペース（ベータ）	workspaces.md
プロジェクト、タスク、レビュー	core-features.md
サブタスク、試行、競合	advanced-features.md
設定、エージェント、タグ	configuration.md
GitHub、Azure、VSCode、MCP	integrations.md
よくある問題	troubleshooting.md
ベストプラクティス	vibe-guide.md

クイックスタート

インストールと実行

npx vibe-kanban

npx vibe-kanban は、引き続きクロスプラットフォームでの標準的な起動方法です。v0.1.30 以降、パッケージ化されたデスクトップアプリは Tauri v2 シェルに移行しており、インストール済みのデスクトップビルドでは自動更新機能が組み込まれています。

リリースの主な変更点（0.1.15 → 0.1.28）

• MCP サーバーを拡張：より詳細な課題取得（get_issue にタグ、関連情報、サブ課題を含む）と、新しいワークスペース／関連情報／タグのツール（例：update_workspace、関連情報とタグの変更）。
• フロントエンドのルーティングを TanStack Router に移行（ナビゲーションや URL は古いスクリーンショットと異なる場合があります）。
• Electric のフォールバックやキャンセル／タブ切り替え処理の信頼性を向上。
• レビュー／差分 UI を改善（横スクロール時の注釈幅を修正）。
• リモートアクセス：コードを使ってホストとペアリングし、別のデバイスからそのワークスペースにアクセスできます。
• ブランチと実行環境の設定をより確実に保持することで、スピンオフ／複製操作時のワークスペース操作の安全性を向上。
• 実行中のエージェントに画像を添付できるようになりました。進行中のセッションに UI の状態、スクリーンショット、デザインへのフィードバックを渡す際に便利です。
• トランスポートの信頼性を向上：リレーの切断処理と署名セッションの更新を改善。
• Claude：デフォルトの Sonnet モデルを 4.6 に更新。
• ワークツリー：クリーンアップ後もワークツリーのパスを保持し、Claude Code セッションの継続性を維持。
• ワークスペース：ワークスペースのログ取得を改善（ルート実行プロセスプロバイダー）。
• モバイル UI の修正とリモートアクセスのドキュメントの更新。

リリースの主な変更点（0.1.44）

• Claude Code CLI の固定バージョンを再度更新し、Codex 実行環境の機能を Codex 0.124.0 に合わせて刷新。
• 古いプロジェクトルートはエクスポート専用ページに移行中です。そのため、古いプロジェクトページへのディープリンクやスクリーンショットは、現在の UX と一致しない場合があります。
• 正規化されたストリーミングの開始前に実行ログを事前登録するようになり、実行中のログを利用しやすくなりました。
• モデルセレクターの並び順がアルファベット順になり、セットアップ／レビューダイアログでの一部のオペレーター操作に、わずかながら目に見える変更が生じています。

リリースの主な変更点（0.1.37 → 0.1.43）

• Codex、OpenCode、Claude Code の固定バージョンを更新し、実行環境の機能を刷新。
• Claude Code に xhigh effort バリアントを追加。
• クロスコンパイル／ランタイムを修正し、Windows/MSVC と musl のビルドの信頼性を向上。

リリースの主な変更点（0.1.31 → 0.1.32）

• デスクトップ／Tauri：Windows デスクトップアプリに対応し、Tauri の通知が利用可能になりました。また、フォントサイズの拡大縮小を中心に、デスクトップのズーム動作を見直しました。
• ワークスペース：セッションの名前変更と自動命名に対応し、ワークスペース作成時の下書き設定が保存されるようになりました。
• 添付ファイル：ワークスペースと課題の両方で、任意の添付ファイルに対応しました。
• MCP：MCP インターフェースから課題をフィルタリングできるようになりました。
• リモート／管理：リモート監査ログを追加し、短い課題 ID を組織単位に変更しました。また、PostHog の設定が空欄の場合は分析機能が無効になります。
• エディター UX：WYSIWYG の入力候補、ツールバー、課題の説明編集フローを改善しました。

ブラウザーが自動的に開きます。固定ポートを使用するには、PORT=8080 npx vibe-kanban を実行してください。

前提条件

• Node.js LTS
• 認証済みのコーディングエージェント（Claude Code、Codex、Gemini など）
• PR 連携用の GitHub CLI（gh）

はじめに

1. コーディングエージェントに外部で認証します
2. npx vibe-kanban を実行します
3. セットアップダイアログを完了します
4. 既存の git リポジトリからプロジェクトを作成します
5. タスクを追加して実行を開始します

2 つの UI モード

クラシックカンバン（タスク）

「未着手」→「進行中」→「レビュー中」→「完了」の列で構成される従来のボードです。

v0.1.7 の更新：

• プロジェクトごとのカンバンビューと、刷新されたフィルターダイアログ
• サブ課題とワークスペースの表示切り替えをフィルターバーに移動

ワークスペース（ベータ版）— 新機能

次の機能を備えた最新のインターフェースです。

• セッション：ワークスペースごとに複数の会話スレッドを使用できます
• コマンドバー：すべての操作を Cmd/Ctrl + K で実行できます
• ワークスペースノート：要件や決定事項を記録できます
• 複数リポジトリのサポート：複数のリポジトリにわたって作業できます
• 統合ターミナル：シェルに対応した PTY ベースのターミナルです
• セッションのドロップダウン：セッションタイトルの横にエージェントアイコンが表示されます
• サイドバーフィルター：プロジェクトと PR のステータス（「プロジェクトなし」を含む）で絞り込めます
• 対応が必要：未確認のアクティビティがあるワークスペースが含まれます

コマンドバー →「Open in Old UI」からモードを切り替えられます。

主なコンセプト

Git Worktree

各タスク／ワークスペースは、分離された git worktree で実行されます。

• エージェント同士が干渉しません
• メインブランチの変更による影響を受けません
• 完了後に自動でクリーンアップされます

タスクの流れ（クラシック）

To do → In Progress → In Review → Done

• 未着手：タスクを作成
• 進行中：エージェントが実行中
• レビュー中：エージェントが完了し、レビュー待ち
• 完了：マージ済み、または PR がマージ済み

タスクの試行

1 つのタスクで複数回試行できます。

• 異なるエージェント
• 異なるブランチ
• 新しい会話コンテキスト

対応エージェント

エージェント	バリアント
Claude Code	DEFAULT, PLAN, ROUTER, XHIGH
Codex	DEFAULT, HIGH
Gemini	DEFAULT, FLASH
GitHub Copilot	DEFAULT
Amp	DEFAULT
Cursor Agent	DEFAULT
OpenCode	DEFAULT
Qwen Code	DEFAULT
Droid	DEFAULT
Antigravity	DEFAULT

タスクの試行またはワークスペースのセッションを作成するときに、エージェントを選択します。

プロジェクト設定

セットアップスクリプト

エージェントの実行前に実行します（例：npm install、cargo build）。

開発サーバースクリプト

プレビュー用の開発サーバーを起動します（例：npm run dev）。

クリーンアップスクリプト

エージェントの完了後に実行します（例：npm run format）。

ファイルのコピー

メインプロジェクトから worktree にコピーするファイルを指定します（例：.env）。

タスクの作成

Press C or click + to create task

オプション：

• タスクを作成：ボードにのみ追加します
• 作成して開始：追加して、デフォルトのエージェントですぐに実行します

タスクタグ

@メンション で再利用可能なスニペットを挿入できます。

• 説明欄で @ を入力します
• ドロップダウンからタグを選択します
• カーソル位置に内容が挿入されます

タスクの説明エディターでは、Markdown の貼り付けに対応し、インラインコードの書式が保持されます。

コードレビュー

1. エージェントが作業を完了すると、タスクは「レビュー中」に移動します
2. 差分アイコンをクリックして変更を確認します
3. 任意の行の + をクリックしてコメントを追加します
4. すべてのコメントをまとめて送信します
5. 修正のため、タスクは「進行中」に戻ります

Git 操作

操作	説明
マージ	対象ブランチにマージします
PR を作成	GitHub/Azure で PR を開きます
リベース	対象ブランチの変更を取り込みます
プッシュ	PR に追加の変更をプッシュします

プレビューモード

Vibe Kanban を離れずにウェブアプリをテストします。

1. プロジェクト設定で開発サーバーのスクリプトを設定します
2. プレビュータブで「開発サーバーを起動」をクリックします
3. 埋め込み iframe でアプリを表示します
4. コンポーネントを選択するには vibe-kanban-web-companion をインストールします

キーボードショートカット

キー	操作
C	タスクを作成します
⌘/Ctrl + Enter	メッセージを送信します
k/j	列内を上下に移動します
h/l	列間を左右に移動します
Enter	タスクを開きます
⌘/Ctrl + S	検索にフォーカスします

MCP 統合

エージェントに MCP サーバーを追加する

設定 → MCP サーバー → エージェントを選択 → サーバーを追加

Vibe Kanban MCP サーバー

外部 MCP クライアントに Vibe Kanban を公開します。

{
  "mcpServers": {
    "vibe_kanban": {
      "command": "npx",
      "args": ["-y", "vibe-kanban@latest", "--mcp"]
    }
  }
}

MCP ツールには、list_workspaces、update_workspace、list_projects、list_issues、get_issue、update_issue に加え、タグと関連付けのヘルパーが含まれます。

重要な安全上の注意

Vibe Kanban は自律的に動作するよう、デフォルトでエージェントを --dangerously-skip-permissions/--yolo を指定して実行します。各タスクは分離されたワークツリーで実行されますが、エージェントはシステムレベルの操作を実行する可能性があります。作業内容を確認し、バックアップを保持してください。

重要な禁止事項

• 初回使用前にエージェントの認証を省略しないでください
• ワークツリー分離の利点を無視しないでください
• 依存関係のセットアップ／クリーンアップスクリプトの設定を忘れないでください
• 新しい試行を行わずに、複数のエージェントを同じタスクに割り当てないでください
• リベースの競合を無視しないでください。解決するか、リベースを中止してください

リンク

• ドキュメント
• リリース
• GitHub
• Vibe ガイド