Stickies

Stickies（Claude Code プラグイン）

Claude Code 用の永続的な付箋です。 決定事項、ブロッカー、ToDo などのメモをピン留めすると、セッションのリセット、/clear、ターミナルを閉じた後も残ります。次回そのプロジェクトで Claude を開くと、まだ必要なメモが自動的に Claude に渡されます。

Stickies はメモリシステムではなく、そうなろうともしていません。 セッションを監視して、何を記憶するかを判断することはありません。むしろその逆です。あなた（または依頼を受けた Claude）が意図的に書き留める少数のメモは、自然に期限切れになり、読み返したり、整理したり、信頼したりできます。ベクトルも、LLM による要約も、クラウドもありません。すべてを自動で記憶する AI が必要なら、Claude Code の組み込みメモリを使ってください。これはデフォルトで有効です。Stickies は、本当に重要な 20 件のメモだけを残し、それらを期限切れにしたい場合に使うものです。

---

クイックスタート（60 秒）

Node ≥ 22.5 が必要です（組み込みの SQLite 用です。node -v で確認してください）。

claude plugin marketplace add dumbspacecookie/stickies
claude plugin install stickies@stickies --scope user

Claude Code を再起動します。これで完了です。一度インストールすれば、どのプロジェクトでも使えます。さっそく試してみましょう。

• Claude に何かを覚えておくよう頼む： 「リリース前に認証情報の漏えいを修正する、P1 の ToDo をピン留めして。」 Claude が書き留めるので、次のセッションで確認できます。
• メモを見る： Claude Code で /stickies と入力します。シェルを使いたい場合は、npm i -g stickies-mcp で stickies コマンドをインストールし、stickies list を実行します。
• ブラウザーでボードを開く： /stickies dashboard を実行し、続けて stickies dashboard --link を実行すると、認証済み URL が表示されます（ボードはメモを配信するため、アクセスを許可したブラウザーにのみ応答します）。

あなたのマシンからデータが外に出ることはありません。オプションの Git 同期を有効にしない限り、すべてのデータはローカルの SQLite ファイルとしてディスクに保存されます。

---

対応環境

メモは使用中のアプリではなく、プロジェクトに属します。プロジェクトごとにスコープされた、1 つのローカルデータベースを使います。環境によって異なるのは、自動で行われる処理の範囲です。

環境	利用できる機能	方法
ターミナル（Claude Code CLI）	✅ 自動記録、セッション開始時のダイジェスト、/stickies、ステータスライン、ダッシュボードを含むすべての機能	プラグインをインストール
Claude Desktop（チャットアプリ）	✅ MCP ツールを使った読み書き（フックなし。プロジェクトパスを指定）	MCP サーバーを claude_desktop_config.json に追加
iPhone / Web（Remote Control）	✅ すべての機能を利用可能。スマートフォンから、あなたのマシンで実行中のセッションを操作	あなたのマシンで claude remote-control を実行
iPhone / Web（クラウドサンドボックス）	✅ repo-mode ですべての機能を利用可能。メモはリポジトリにコミットされます	stickies init-repo（Repo-modeを参照）
任意の MCP クライアント	✅ 読み書き	MCP Registry に io.github.dumbspacecookie/stickies として登録済み
どこからでも読み取り専用で	✅ ボードをひと目で確認	Discord ダイジェスト / ボードカード

---

ここでしか見つからない 2 つの機能

• ゼロターン記録。 Claude は、すでに書いている返信の中に 1 行書くだけでメモを保存します。!!sticky todo P1 :: fix the auth leak。Stop フックがこれを永続化します。追加のツール呼び出しもターンも不要で、往復処理にトークンを消費しません。（自動記録を参照。）
• 重要度に応じた注入。 セッション開始時のダイジェストは、位置ではなく重要度に応じて情報を減らします。P1 は全文、P2 は短縮、P3 は件数のみです。行数 N でリストを単純に切り捨てることはありません。

---

フローボード

プロジェクトで .planning/ROADMAP.md（GSD の計画規約）を使って作業を計画している場合、Stickies はそのロードマップから直接生成したライブのカンバンボードも提供します。To-Do／Doing／Done に分かれ、付箋は関連するフェーズに相互リンクされます。これは計画をその場で反映した表示なので、計画との不一致が生じることはありません。

同じボードを確認できる場所は4つあります。状況に合ったものをお選びください。

場所	コマンド	用途
GitHub／スマートフォン	stickies board → BOARD.md をコミット	スマートフォンのブラウザーから進捗をさっと確認できます。BOARD.md は github.com 上でネイティブに表示されるため、サーバーもアプリも不要です
ブラウザー（ローカル）	stickies dashboard → /board を開く	インタラクティブなカンバンです。/graph では計画の依存関係 DAG を確認できます
Discord	stickies board --discord	プッシュ通知でさっと確認できるカードです。進捗、列ごとの件数、フェーズごとのステータスを表示します
ステータスライン	（ステータスラインを参照）	常時表示される小さな 📋 ▶2 ☐1 ✓2（Doing／To-Do／Done）です

stickies board                     # write BOARD.md in the project root (commit it → view on GitHub)
stickies board --out docs/BOARD.md # write it somewhere else
stickies board --discord           # post the board to your Discord webhook instead

各フェーズには進捗（3/4）、ウェーブ、リリース済みかどうか（✓ shipped 4/4）、ブロック中かどうか（⛔）が表示されます。.planning/ がないクラウド／モバイルセッションでは、コミット済みの .flow/ スナップショットによってボードが自立して動作します。これはメモと同じリポジトリモードの考え方です。

---

日常的なコマンド

Claude Code 内（/stickies スラッシュコマンド）：

コマンド	動作
/stickies	このプロジェクトの有効なメモ（＋グローバルメモ）を一覧表示します
/stickies all	すべてのプロジェクトのメモを一覧表示します
/stickies add <text>	手動でメモを追加します
/stickies dismiss <id>	メモを消去します（To-Do は消去すると「完了」になります）
/stickies dashboard	ローカルのウェブボードを開きます
/stickies sync	git リポジトリ経由で同期します（設定済みの場合）

任意のシェル内（CLI。同じエンジンです）。npm i -g stickies-mcp でインストールして stickies コマンドを PATH に追加し、次を実行します。

stickies list                          # active notes for this dir + globals
stickies list --all                    # every project + globals
stickies add "ship the release" -c todo -i P1     # add a P1 todo to this project
stickies add "pay invoice" -c todo --due 2d       # a deadline (30m/2h/1d/1w/tomorrow/YYYY-MM-DD)
stickies add "call the bank" -c todo -p global    # a global todo — shows up everywhere
stickies dismiss <id> -r "done"        # clear it
stickies dashboard --open              # local web board, open the browser
stickies board                         # write a GitHub-viewable BOARD.md
stickies status                        # the one-line statusline summary
stickies sync                          # pull → merge → commit (push needs STICKIES_SYNC_PUSH=1)
stickies notify                        # push the open list to Discord
stickies init-repo                     # make notes work in cloud/mobile (repo-mode)

---

自動取り込み

最も手間のかからない方法です。Claude が返信に1行書いて確実に残すべき事実を記録し、Stop フックが保存します。ツール呼び出しも、追加のターンも必要ありません。

!!sticky <category> [P1|P2|P3] [global] [#tag ...] :: <content>
!!sticky decision P1 #storage :: storage is node:sqlite, no native deps
!!sticky todo P1 global :: cut the npm release

category は必須です。重要度の既定値は P2 で、メモは重複排除されます。global と #tags は任意で、順序は問いません。global がない場合、メモは現在のプロジェクトに限定されます。指定した場合、メモはすべてのプロジェクトに表示されます。

フックは完了したターン全体をスキャンするため、Claude がさらにツールを実行する前に書かれた指示も保存されます。サブエージェントの返信内にある指示は無視されます。保存時にシークレットは除去されます。

---

ステータスライン

Claude Code のステータスラインを Stickies に向けると、常時表示される要約を取得できます。オプトイン方式です。settings.json に次の設定を追加してください。

{ "statusLine": { "type": "command", "command": "stickies status" } }

（これは npm i -g stickies-mcp でインストールされる stickies コマンドを使用します）

デフォルトでは簡潔な表示になり、件数と緊急度フラグが表示されます。例：🟨 2!·19（19 件中 2 件が緊急）。メモのテキストは意図的に表示しません（機密情報がプロンプトに含まれないようにするためです）。先頭のメモのテキストも表示する場合は、STICKIES_STATUSLINE_VERBOSE=1 を設定してください。

ライト／ダーク。 ステータスラインではターミナルの背景色を変更できず、自身のテキストに色を付けることしかできません。そのため、テーマは現在の背景色にかかわらず読みやすさを保つようになっています。ダークパレット（デフォルト）ではターミナル本来の明るい色を使います。ライトパレットでは、白い背景でも見やすい、より暗いトゥルーカラー値に切り替わります（WCAG AA のテキストコントラストを満たすよう調整されています）。環境変数で STICKIES_THEME=light（または dark）を設定するか、実行時に stickies status --light ／ --theme dark を指定してください。$COLORFGBG を提供する macOS／Linux のターミナルでは自動検出も行われます。Windows Terminal ／ PowerShell ではこの変数が設定されないため、Windows でライトテーマのターミナルを使う場合は STICKIES_THEME を明示的に設定してください。ダッシュボード（/、/board、/graph）は実際のウェブページなので、ページ全体の背景を切り替える ☾／☀ トグルを利用できます。ステータスラインとは異なり、ダッシュボードはページ自体の背景を変更できます。

クリック可能なリンク。 OSC-8 ハイパーリンクに対応するターミナル（Windows Terminal、iTerm2、WezTerm、Kitty、Ghostty）では、このセグメントがCtrl キーを押しながらクリックするとダッシュボードが開くリンクになります。必要な条件は 2 つあります。

• ダッシュボードが実際に起動している必要があります。stickies dashboard --detach を実行してください。起動中の場合に限り、セグメントがリンクになります。起動していない場合も件数は表示されますが、下線もクリック機能も付きません。これは意図的な仕様です。閉じたポートへのリンクは一見有効に見えても、クリックするまで失敗せず、原因がブラウザーにあるように見えるためです。自動起動は明示的に有効にしない限りオフなので、新規インストール時はリンクがない状態がデフォルトです。セグメントをクリックできず、できるはずだと思う場合は、stickies doctor を実行すると、次の 2 つの条件のどちらに該当するかがわかります。
• Windows Terminal では、Claude Code がハイパーリンクのサポートを自動検出しません。そのため、Claude Code を起動する前に環境変数で FORCE_HYPERLINK=1 を設定してください（例：setx FORCE_HYPERLINK 1 を実行してから再起動します）。設定しない場合、セグメントは表示されますがクリックできません。

リンクは tmux 使用時には自動的に無効になります（OSC-8 が壊されるため）。--no-link で無効にでき、ポート番号は STICKIES_DASHBOARD_PORT に従います。

---

ダッシュボード

stickies dashboard                 # http://127.0.0.1:7317/
stickies dashboard --open          # and open the browser
stickies dashboard --detach        # run in the background
stickies dashboard --link          # print an authorized URL for a browser
stickies dashboard --stop          # stop the running one

ループバックのみ（127.0.0.1 から外部に出ることはありません）。ルートは / がメモボード、/board が Flow Board のカンバン、/graph が計画依存関係の DAG です。メモを取るすべてのプロジェクトを1つのダッシュボードで管理できます。ヘッダーの切り替え機能でプロジェクトを移動できるので、フォルダーごとに起動する必要はありません。

必要なときにだけ起動します。 Stickies をインストールしても、マシン上でサーバーが起動することはありません。各 Claude セッションで自動的に起動したい場合は、STICKIES_DASHBOARD_AUTOSTART=1 を設定してください（CI とリモートセッションでは、いずれの場合もスキップされます）。

「Not authorized」と表示されますか？ これは想定どおりの動作であり、不具合ではありません。ダッシュボードはメモと計画ドキュメントを提供するため、認証済みのブラウザーからのリクエストにのみ応答します。

stickies dashboard --link          # → paste into your browser

…または、ステータスラインの Stickies 部分を Ctrl キーを押しながらクリックしてください。こちらにも認証情報が含まれています。リンクを開くと Cookie が設定され、これが有効期間中保持されます。リンク自体は数分で期限切れになるため、スクロールバックにある古いリンクは拒否されます。新しいリンクを取得してください。認証なしで開いておきたい場合は、STICKIES_DASHBOARD_AUTH=0 を設定してください。

ボードからの計画編集は、デフォルトでは無効です。STICKIES_BOARD_WRITEBACK=1 を設定すると、カードをドラッグして、そのフェーズの .planning/ROADMAP.md にある **Status:** 行を書き換えられます。編集前のコピーは .flow/roadmap-backups/ に保存されます。フェーズの計画チェックボックスに反する移動は、書き込まずに拒否されます。

動作がおかしい場合は、stickies doctor を実行すると、実行中の内容、ポート、インストール済みプラグインのコピーが古くなっていないかなど、セットアップ全体をまとめて確認できます。出力ではホームディレクトリが ~ に短縮されるため、安全に貼り付けられます。

---

出所

各メモにはどこで書かれたかが記録されます。💻 ターミナル、🖥️ デスクトップ、📱 モバイルのいずれかが示されるので、ダッシュボードで、スマートフォンから書き留めたメモと、デスクで Claude が記録したメモを見分けられます。各エントリーポイントが把握している情報をもとに記録するベストエフォートのスタンプで、設定は不要です。

---

同期（git ベース、オプトイン）

自分が所有する git リポジトリを通じて同期します。サードパーティサービスも、新しいアカウントも不要です。ネットワークに接続する機能はこれだけで、リモートを指定した場合にのみ接続します。

export STICKIES_SYNC_REPO=/path/to/your/stickies-data   # a git clone you control
stickies sync           # pull → merge (last-writer-wins) → export → commit (push: STICKIES_SYNC_PUSH=1)

# or offline, through any file channel:
stickies export -f notes.json
stickies import -f notes.json

各メモには、プロジェクトのgit リモートから導出したマシンに依存しないキーが付与されます（SSH と HTTPS は同じキーになります）。そのため、チェックアウト先のパスがマシンごとに異なっていても、プロジェクトのメモをマシン間で引き継げます。マージは updated_at に基づくレコード全体の最終書き込み優先方式で、競合がなく、順序にも依存しません。

自動同期（こちらもオプトイン）を使うには、STICKIES_SYNC_REPO とともに STICKIES_AUTO_SYNC=1 を設定します。Stickies はセッション開始時にプルし、ターン中にメモを記録したときにコミットします。設定しなければ、自動で同期されることはありません。

プッシュは3つ目のオプトインです。 メモを記録すると同期リポジトリにコミットされますが、そこで止まります。git push も実行するには STICKIES_SYNC_PUSH=1 を設定してください。設定しない場合、メモはローカルでバージョン管理され、マシンの外に出ることはないため、別のマシンから見ることはできません。プッシュは、リモートも refspec も指定せずに実行されるため、どこに送るかは自分の git 設定によって決まります。こちらで送信先を導出しようとしたところ、3回も別々の問題が発生し、そのうち1回は共有 main に意図しないブランチを書き込んでしまいました。

Repo-mode（クラウド／モバイル）

プラグインは ~/.claude にあるため、クラウドセッションには存在しません（iPhone アプリ／ claude.ai/code は、クローンしたリポジトリだけを参照できる一時的な VM で実行されます）。Repo-mode を使えば、 プラグインもインストールも不要で、そこで Stickies を利用できます。

stickies init-repo         # run inside the repo you want notes in

これにより、依存関係のない自己完結型エンジンがコミットされ、以下が設定されます。

• .stickies/notes.json — ストア、および人が読める .stickies/NOTES.md ミラー
• .claude/settings.json — SessionStart フック（ダイジェスト）と Stop フック（!!sticky の記録）
• CLAUDE.md — !!sticky の規約を Claude に説明します
• .github/workflows/stickies-sync.yml — すべてのセッションブランチからのノートを main に統合します

クラウドセッションはそれぞれのブランチに書き込みます。バンドルされた Action が各ノートを main にマージするため （ユニオン＋却下優先＋重複排除）、リポジトリごとにひとつの統合済みボードを手間なく維持できます。!!sticky の構文も ローカルプラグインと同じで、機密情報のマスキングも同様です。

実行前に知っておくべきことが2つあります。ノートはそのリポジトリ内に保存されるため、リポジトリと同じ範囲で公開されます。また、安全に処理できない場合（たとえば、解析できない .claude/settings.json。多くの場合、未解決のマージコンフリクトが原因です）は、そのファイルには手を加えず、コマンドが警告を出してゼロ以外の終了コードで終了します。置き換えられることはありません。

---

sticky のモデル

フィールド：id、content（500文字以下）、category、importance（P1/P2/P3）、 project_path（絶対パス、またはグローバルの場合は null）、tags[]、origin、タイムスタンプ、expires_at、 source（auto/manual）、status（active/stale/dismissed）。

デフォルトの TTL： decision は30日 · blocker は7日 · preference は90日 · context は14日 · todo は期限なし （タスクはタイマーが切れたときではなく、却下したときに完了します）。これにより、todo ＋ global で実際に使える プロジェクト横断のタスクリストになります。未完了のタスクが気づかないうちに消えることはありません。

ストレージ： すべてのプロジェクトで1つの SQLite ファイルを使用し、プロジェクトごとにスコープを分けます。$STICKIES_DB が設定されていればその値を使い、そうでなければ ~/.stickies/stickies.db を使用します。Node の組み込み SQLite（node:sqlite、そのため Node ≥ 22.5 が必要）を使うため、 プラグインにコンパイル済み依存関係はなく、どのマシンでも Claude Code のプラグインキャッシュへのコピー後も動作します。

セッション開始時のダイジェスト： P1 は全文、P2 は約100文字、P3 は件数です。SessionStart フックの additionalContext を通じて Claude に渡されるため、ファイルに書き込まずにモデルへ届きます。

---

Claude Desktop（MCP のみ）

Claude Desktop は MCP ツール（stickies_write／stickies_read／stickies_dismiss）をサポートしていますが、 フックやスラッシュコマンドには対応していません。そのため、自動記録やダイジェストは利用できません。追加して、 プロジェクトパスを明示的に渡してください。claude_desktop_config.json（Windows では %APPDATA%\Claude\、 macOS では ~/Library/Application Support/Claude/）に記述します。

{
  "mcpServers": {
    "stickies": {
      "command": "node",
      "args": ["--disable-warning=ExperimentalWarning", "/abs/path/to/stickies/src/server.js"]
    }
  }
}

両方のクライアントは同じ ~/.stickies/stickies.db を読み取るため、一方で書き込んだノートは同期処理なしで もう一方にも表示されます。

---

コンポーネント（リファレンス）

コンポーネント	ファイル	目的
MCP サーバー	src/server.js	ツール stickies_write／stickies_read／stickies_dismiss
SessionStart フック	src/session-start.js	additionalContext を介してダイジェストを注入します（ファイルには触れません）
Stop フック（自動記録）	src/auto-capture.js、src/directives.js	!!sticky … ディレクティブを重複排除して保存します
ローカルダッシュボード	src/dashboard.js、src/dashboard-page.js	ループバックの Web UI：ノート、/board、/graph
Flow Board	src/flow/	.planning/ROADMAP.md からカンバンを生成し、BOARD.md にエクスポート、.flow/ にスナップショットを保存します
スラッシュコマンド	commands/stickies.md	/stickies …
CLI	src/cli.js	スラッシュコマンドを支え、単独でも使用できます
ストア／DB	src/store.js、src/db.js	CRUD ＋スキーマ＋TTL＋重複排除＋来歴
同期	src/sync.js、src/git-sync.js	エクスポート／インポート＋git pull→merge→commit（push はオプトイン）
マスキング	src/redact.js	書き込み時にコンテンツから機密情報を除去します
Repo-mode	src/repo-mode/	クラウド／モバイル向けのコミット済みストア＋フック＋調整用 Action

---

インストールと開発

# use it:
claude plugin marketplace add dumbspacecookie/stickies
claude plugin install stickies@stickies --scope user     # restart Claude Code after

# work on it:
git clone https://github.com/dumbspacecookie/stickies
cd stickies
npm test        # 27 suites, 558 assertions, no network

ユーザースコープに一度インストールすれば、すべてのプロジェクトで利用できます。プロジェクトごとの設定は、プロジェクト別にインストールするのではなく、各ノートの project_path で行います。

---

Stickies の比較

Claude Code 用の永続メモの分野は、競合がひしめいています。率直に言うと：

• Claude Code の組み込みメモリ — デフォルトで有効です。モデルが保存する内容を決めます。有効期限や重要度の段階、プロジェクトをまたいで共有されるグローバル設定はなく、リポジトリ単位のみです。Stickies はこれを無効にした人向けの、決定論的で人が作成する有効期限付きの代替手段です。
• ナレッジグラフ／ベクターメモリサーバー（mem0、OpenMemory、server-memory、basic-memory）— これまでに話した内容全体を対象に、あいまい検索を行います。用途が異なります。Stickies が保存するのは、エンベディングのインデックスではなく、少数の型付きデータです。
• フックベースのメモリプラグイン — いくつか存在し、優れたものもあります。Stickies の特徴は前述のとおりです。ターンを消費しない !!sticky による記録、重要度に応じた挿入、プロジェクトをまたいで表示されるグローバル層、そして計画から生成されるフローボードです。

履歴全体の自動呼び出しが必要なら、そうしたツールを使ってください。Stickies は、短く信頼でき、自動で整理されるリストと、スマートフォンからひと目で確認できるボードが欲しい人向けです。

---

MIT · dumbspacecookie 作成