Cursor の Composer / Agent スレッドの会話を Markdown にエクスポートするツールです。Cursor の拡張機能としても、ターミナルから使う CLI としても使えます。
Cursor 標準の「Export Transcript」は GUI の保存ダイアログが必須で、コマンドパレットにも出ません。本ツールはローカルの SQLite(state.vscdb)を読み取り専用で開き、そこからトランスクリプトを再構成します。会話の読み取りに Cursor の非公開 API は使いません。
ステータス: 保守モードです。大きな機能追加の予定はありません。動作を確認した環境は Cursor 3.25.x(Electron 42) です。VS Code / Cursor の Marketplace には公開していないので、Release の .vsix を使うか、ソースからビルドして導入してください。
- スレッドの一覧表示(名前、メッセージ数、Agent / Chat の区別、作成日時)
- スレッドの Markdown エクスポート(thinking ブロックを含めるかどうかは選べる)
- コマンドパレットからの出力先ディレクトリの変更
- エクスポートしたファイルを Composer に
@参照として自動で追加(Cursor の内部コマンドを使うため、追加できない場合はエクスポートだけを行う) - バックグラウンドでの自動保存(既定ではオフ)
- CLI の
cursor-thread-tools list/export
- GitHub Releases から、自分の環境に合う
.vsixをダウンロードします。 - Cursor で
Cmd+Shift+P→Extensions: Install from VSIX...を実行し、ダウンロードしたファイルを選んでから、ウィンドウをリロードします。 Cmd+Shift+P→Thread Tools: List ThreadsまたはThread Tools: Export Thread to Markdownを実行します。
.vsix にはネイティブモジュールの better-sqlite3 が入っているため、OS とアーキテクチャが一致するファイルを使ってください。現在の Release は Apple Silicon 向け(darwin-arm64)だけです。
npm install
bash scripts/setup-cli.sh # Node.js 向けに rebuild して npm link する
cursor-thread-tools list
cursor-thread-tools export --all --since 7dインストールとビルドの詳しい手順は INSTALL.md を、CLI のオプションと使用例は CLI_USAGE.md を参照してください。
- macOS(Windows / Linux のパスにも対応していますが、テストはしていません)
- CLI を使う場合とソースからビルドする場合は Node.js 20 以上(
@electron/rebuildを使うなら 22 以上を推奨) - Cursor を一度は起動していること(
state.vscdbが作られている必要があります) - 拡張機能のビルド対象は Electron 42.10.0(
ELECTRON_VERSION=...で変更できます)
state.vscdbを読み取り専用で開きます。cursorDiskKVテーブルからcomposerData:*のメタデータを読みます。conversationState(protobuf)をデコードし、そこから参照されるagentKv:blobをたどってメッセージ本文を取り出します。- Markdown として出力します。
SQLite ライブラリの選定、protobuf の解析方法、配布方法などの設計判断は docs/decisions/ にまとめています。
cursor-thread-tools/
├── README.md # 本ファイル(日本語)
├── README.en.md # 英語版
├── INSTALL.md # インストール手順(日本語)
├── INSTALL.en.md # インストール手順(英語)
├── CLI_USAGE.md # CLI の使い方(日本語)
├── LICENSE # MIT
├── docs/decisions/ # ADR(日本語が正本、英語は *.en.md)
├── src/ # 拡張機能と CLI のソース
├── scripts/
│ ├── install.sh # 拡張機能向けのビルド(Electron 向けに rebuild)
│ ├── setup-cli.sh # CLI 向けのセットアップ(Node.js 向けに rebuild して npm link)
│ └── release.sh # .vsix と GitHub Release の作成
├── esbuild.mjs # バンドル設定
└── package.json
本ツールは、公開されていない Cursor のディスク上の保存形式に依存しています。Cursor の更新によって、一覧表示やエクスポートが動かなくなることがあります。対応していない形式や空のスレッドは、警告を出してスキップします。将来の Cursor のバージョンとの互換性は保証しないので、自己責任で利用してください。