beadsの使い方——コーディングAIに「やること」の記憶を持たせるOSS、bd initから閉じるまで

2026年9月14日 13:20

コーディングAIに「昨日の続きから」と言って、通じたことがありますか？

僕は、ほぼありません。

セッションが変わると、何をやっていて、何が終わっていて、何が何を待っているのかが消える。だから毎朝、TODO.mdを貼り直す。で、そのTODO.mdが古くて、AIが終わった仕事をもう一回やる。

これを「AIの記憶」の問題として解こうとしているOSSがあります。

beadsです。GitHubのリポジトリの説明には「A memory upgrade for your coding agent」とあります。この記事では、READMEに書いてある手順だけで、入れてから課題を閉じるまでを並べます。確認日は2026年9月13日です。

beadsとは——「やること」を依存関係つきのグラフで持つ課題管理

READMEの1行目は、こうです。

「Distributed graph issue tracker for AI agents, powered by Dolt.」

分解すると、3つの言葉です。

1つ目、issue tracker。課題管理。GitHubのIssuesと同じ「やること」の置き場です。

2つ目、graph。課題どうしに依存関係がある。「AがBを待っている」を持てる。だから「いま手を付けられる仕事」を機械が出せる。

3つ目、Dolt。バージョン管理ができるSQLデータベース。READMEによれば、Doltは同梱されていて、既定では組み込み（.beads/embeddeddolt/）で動く。別に入れる必要はない。サーバーモードも選べます。

要するに、AIが「やること」を読み書きする専用の帳簿を、リポジトリの中に置く道具です。Go製、MIT、スターは約2.7万。最新リリースはv1.2.2（2026年8月15日）。

（僕らの会社は、AI社員の状態をMarkdownの案件カードで持たせています。beadsはそれをグラフにして、コマンドで引けるようにした形だと理解しました）

ステップ1: 入れる——brew・npm・install.shの3通り

READMEにある入れ方は3つです。

brew install beads
npm install -g @beads/bd
curl -fsSL https://raw.githubusercontent.com/gastownhall/beads/main/scripts/install.sh | bash

コマンド名は bd です。beadsではなく bd。ここを間違えて「command not found」を1回やりました。

入ったら、リポジトリに移動して初期化します。

cd your-project
bd init

これで .beads/ ディレクトリができます。ここが帳簿の置き場です。

ステップ2: AIにつなぐ——bd setup claude

ここがbeadsの肝です。

bd setup claude

READMEによれば、これでClaude Code用のhookと設定が入ります。Codexなら bd setup codex。READMEにはFactory.aiやCursorなど、他のエージェント向けの設定コマンドも載っています。

何が起きるかというと、AIがセッションを始めるときに bd prime が走る。bd prime はREADMEの説明で「エージェントの作業手順の文脈と、保存した記憶を出力する」コマンドです。

つまり、毎朝TODO.mdを貼っていた作業が、hookに置き換わる。

いや、それって結局ファイルを読ませてるだけでは？

半分そうです。違うのは、読ませる中身が「いま準備ができている仕事」に絞られていること。終わった仕事は出てこない。待ちの仕事も出てこない。

ステップ3: 課題を作って、拾って、閉じる——bd create・ready・claim・close

日々の流れは、READMEのクイックスタートどおりです。

bd create "Title" -p 0
bd ready
bd update <id> --claim
bd close <id>

順に説明します。

bd create で課題を作る。-p 0 は優先度です。IDはハッシュ式で bd-a1b2 のような形になります。連番ではないので、READMEによれば複数のエージェントが同時に作っても衝突しない。

bd ready で「いま手を付けられる課題」だけを出す。依存先が閉じていない課題は出てきません。これがgraphの意味です。

bd update <id> --claim で「これは自分がやる」と印を付ける。複数のAIを並走させるとき、同じ課題を2体が取らないための操作です。

bd close <id> で閉じる。閉じた瞬間、それを待っていた課題が bd ready に出てくる。

この4つで、1日が回ります。AIに頼むときは「bd readyで出た課題を1つ取って、終わったらcloseして」と言うだけになる。

ステップ4: 記憶を残す——bd remember と bd prime

課題とは別に、beadsには「覚えておいてほしいこと」の置き場があります。

bd remember "insight"

READMEの説明では、bd remember はプロジェクトの記憶を保存し、あとで bd prime が注入する、とあります。「このリポジトリではテストの前にmigrateが要る」のような、課題ではないけれど毎回言いたいことをここに入れる。

これでCLAUDE.mdやAGENTS.mdに書くことが減ります。READMEによれば、bd setup はAGENTS.mdも更新するので、手で書く量はさらに減る。

ここで1つ、僕の注意点です。

bd remember に入れた記憶は、bd prime のたびに読み込まれます。入れすぎると、毎回の文脈が太る。うちの案件カードで起きたのと同じことが起きるはずなので、記憶は「同じ指摘を2回したとき」だけ入れる、と決めています。

気をつけること——Gitと一緒に使う前提と、そうでない道

beadsは基本、Gitのリポジトリの中で使います。.beads/ をコミットすれば、チームの誰のAIも同じ帳簿を見る。

READMEには BEADS_DIR という環境変数でGitなしでも動かせる、ともあります。Gitで管理していないフォルダで試したいときの道です。

もう1つ、Doltの2つのモード。既定の組み込みモードは1プロセスで完結します。複数のプロセスから同時に叩くなら、READMEはサーバーモード（外部の dolt sql-server）を用意している。最初は組み込みで十分です。

そして、これはREADMEでなく僕の実感ですが、beadsが効くのは「課題が3つ以上あって、依存関係がある」ときです。1つの仕事を1回頼むだけなら、TODO.mdでいい。

beadsの使い方は、bd readyを毎朝の入口にすること

まとめます。

beadsは、コーディングAIに「やること」の記憶を持たせるOSS。入れて bd init、bd setup claude でつなぐ。日々は bd create → bd ready → --claim → bd close。覚えてほしいことは bd remember。

今日やるなら、いま抱えている仕事を3つだけ bd create して、1つに依存関係を付けて、bd ready を打ってみてください。2つしか出てこなければ、beadsが何をしているかは、それで分かります。

オープンソース研究所の6大特典

beadsのようなOSSを、自分の開発フローに組み込むところまで進めたい方へ。OSS活用の型をまとめた6大特典をご案内しています。

👉 オープンソース研究所の6大特典を受け取る