Worktree Kanban English

Vibe Kanban から移る方法

2026年11月7日に、Vibe Kanban の告知とソースコードで確かめた内容です。Worktree Kanban は Vibe Kanban・bloop とは関係ありません。

コードは失われません。Vibe Kanban の作業は普通の git のブランチと worktree にあるので、アプリがなくても残ります。Worktree Kanban は Vibe Kanban のボードを自動では取り込めないため、このページでは、大事なものを先に保存してから、進行中の作業を手で移します。目安は、1リポジトリあたり30分ほどです。

Vibe Kanban に何が起きたか

ローカルのワークスペースだけを使っているなら、今すぐ移る必要はありません。移行を考える理由は、開発を支える会社がなくなったことと、4月から新しいリリースが出ていないことです。

何が引き継げるか

Vibe KanbanWorktree Kanban
git のブランチとコミットリポジトリに残るので、そのまま使えます
進行中のワークスペース今のブランチをもとにタスクを作り直します(手順5)
ボード・Issue・エージェントとの会話取り込めません。バックアップを参照用に残し、未完了のものを作り直します
Setup scriptセットアップスクリプト
Copy filesセットアップスクリプトに cp の行を足します
Dev server script実行スクリプト(worktree タブから手で起動します)
Cleanup script・Archive script片付けスクリプト(worktree を消す直前に動きます)
エージェントのログインそのまま使えます。どちらも手元の CLI を動かします

先に確かめておく違い

Worktree Kanban は完全な代わりではありません。始める前に、次の点を確かめてください。

できなくなること

できるようになること

移行の6つの手順

1. 作業を git に保存する

リポジトリごとに次を実行して、Vibe Kanban の worktree とブランチを一覧にします。Vibe Kanban の設定で変えていなければ、ブランチの接頭辞は vk です。

git worktree list
git branch --list 'vk/*'

残したい worktree は、コミットしていない変更をコミットし、ブランチを push します。既定の worktree の場所は一時フォルダなので、ここが大事です。

git -C <worktree のパス> status --short
git -C <worktree のパス> add -A
git -C <worktree のパス> commit -m "WIP: move from Vibe Kanban"
git -C <worktree のパス> push -u origin HEAD

2. クラウドのデータをエクスポートする(使っていた場合)

Vibe Kanban で /export を開くと、issues.csv・projects.csv・users.csv と、選べば添付ファイルの入った zip をダウンロードできます。クラウドのサービスの提供期間は30日と告知されていたので、今は使えないかもしれません。クラウドのプロジェクトを使っていなければ、飛ばしてください。

3. ローカルのデータをバックアップする

次のフォルダを安全な場所にコピーします。データベース(db.v2.sqlite)・config.json・profiles.json が入っています。credentials.json が入っていることもあるので、コピーは人に渡さず、コミットもしないでください。

OSフォルダ
Mac~/Library/Application Support/ai.bloop.vibe-kanban
Linux~/.local/share/vibe-kanban
Windows%APPDATA%\bloop\vibe-kanban\data

4. Worktree Kanban をインストールする

Mac / Linux:

curl -fsSL https://raw.githubusercontent.com/kazuya83/worktree-kanban/main/install.sh | bash

Windows(PowerShell):

irm https://raw.githubusercontent.com/kazuya83/worktree-kanban/main/install.ps1 | iex

Releases からダウンロードすることもできます。署名・公証がないため、初めて開くときに OS の警告が出ることがあります。インストールしたらリポジトリを開き、設定の「使うエージェント」でエージェントを選び、「ブランチと取り込み」にスクリプトを入れます。

5. 進行中の作業を移す

エージェントは Vibe Kanban での会話を読めません。終わったことと残っていることを、新しいタスクに書いてください。

6. 片付ける

すべてマージか push が終わったら、古い worktree と、いらなくなったブランチを消します。git branch -d は、マージしていないブランチの削除を断ります。

git worktree remove <worktree のパス>
git branch -d vk/<ブランチ名>
git worktree prune

迷うなら、あとで構いません。しばらく両方のアプリを残しておいても問題ありません。

Worktree Kanban をダウンロード