ローカルで動く、Markdown のノートアプリ
ノートは自分のフォルダの .md ファイルとして保存されます。意味検索、データベース表示、MCP による AI 連携つき。
--- status: active due: 2026-10-20 icon: 🛠 --- # Website renewal Kickoff notes are in [[Journal/2026-10-01]]. Owner: me #work ## Tasks * [x] Pick a theme * [ ] Write the about page [due: 2026-10-12] * [ ] Move old posts
Kickoff notes are in Journal/2026-10-01.
Owner: me #work
Tasks
機能
ショートカットはコマンドパレット Ctrl-/ からいつでも確認できます。
ブロックエディタ
ドラッグハンドルと折りたたみつきのブロック編集、ドラッグ&ドロップで並べ替えるページツリー、カバー画像とアイコン。すべての変更は Undo できます。
言葉と意味で探す
全ノートの見出し単位で、文字一致とローカル埋め込みモデルによる意味検索を一度に。開いているページの関連ノートと、リンクと類似度のグラフも。
データベース
型つきプロパティ・フォルダ・テンプレートを一度宣言すれば、表・ボード・カレンダーで表示してその場で編集。復元できるゴミ箱つき。
ノートに質問する
自分のノートから引用つきで回答。追加質問や、回答をページとして保存することもできます。Anthropic の API キーが必要です。
PDF や Office も検索対象
フォルダに置いた PDF、Word、Excel、PowerPoint、OpenDocument、HTML も検索できます。OCR はオプションです。
AI アシスタントと共有
同じノートを Claude Code や Claude Desktop などの MCP クライアントから検索・追記できます。トークンや鍵を置く CONFIG は読めません。
データの扱い
ファイルが唯一の正本
ノートはフォルダの中の Markdown です。検索インデックスや埋め込みは消しても作り直せます。既存のノートフォルダをそのまま使えます。
手元で動く
アプリも検索も自分のマシンで動きます。ノート本文が外に出るのは、自分で Ask を実行したときだけ。:confidential を付けたスペースは許可しない限り送りません。
スマホからも
スマホ幅のレイアウトに対応。オプションの Tailscale 専用 HTTPS 入口を使えば、許可したログインだけがパスワード画面なしで開けます。
インストール
必要なのは Docker と Compose v2 だけです。Rust や Node をホストに入れる必要はありません。
取得してセットアップを実行
$ git clone https://github.com/HayatoShimada/blackbullet.git $ cd blackbullet $ ./setup.sh
初回はイメージのビルドに 10〜20 分かかります(Raspberry Pi クラスのマシンの目安)。2 回目以降は起動するだけです。
ブラウザで開く
http://127.0.0.1:3000
- ノートは
./spaceに保存されます。既存の Markdown フォルダを使うなら、setup.shの前に.envへSPACE_DIR=/path/to/notesを書きます。 - 検索サイドカーも同時に起動・接続されます。最初の索引作成で約 120 MB の埋め込みモデルを一度だけ取得し、CPU で動かします。
- ダウンロードしたくない場合は
.envにMEMO_EMBED=off。検索は文字一致のみになります。
AI アシスタントをつなぐ(任意)
サイドカーは http://127.0.0.1:3010/mcp で MCP を話します。setup.sh がトークン入りのコマンドを表示するので、それを実行するだけです。
$ claude mcp add --scope user --transport http memo http://127.0.0.1:3010/mcp \
--header "Authorization: Bearer <MEMO_MCP_TOKEN>"使えるツール: search_notes read_note read_section related_notes list_tasks list_projects list_journal recent_changes append_journal add_inbox complete_task doc_status reindex_docs
Ask を使う(任意)
コマンドパレットで Ask: Set up を一度実行し、Anthropic の API キーをスペースの CONFIG に保存します。以後 Ctrl-q a で質問できます。#tag、in:Folder/、kind:pdf、since:2026-01-01 で範囲を絞れます。
日々の運用
| コマンド | 内容 |
|---|---|
./setup.sh --status | アプリとサイドカーの状態、索引とモデルの状況、ディスク使用量 |
./setup.sh --backup [dir] [--with-secrets] | ノートの .tar.gz を日時つきで作成(--with-secrets がなければ秘密情報は空にする) |
./setup.sh --restore <file> | 安全のためのコピーを取ってから、バックアップをノートフォルダに統合 |
./setup.sh --upgrade | git pull してビルドし直し、再起動 |
./setup.sh --tailnet | Tailscale ネットワーク内だけから届く HTTPS の入口を追加 |
./setup.sh --stop | すべて停止。ノートはそのまま残ります |
設定はすべて .env にあり、各項目の説明は .env.example にあります。アプリ内の使い方はヘッダーの ? ボタン(日本語ガイド)から。
リリース履歴
新しいものから順に。各リリースの詳細とダウンロードは GitHub にあります。
BlackBullet v1.2.1
- Database views no longer show a vertical scrollbar at every height (the widget frame's negative iframe margin made its scrolling box 18px too short).
BlackBullet v1.2.0
- memo-mcp: tasks as todo pages. list_tasks returns Tasks/ pages (status, due, project, area, completed) alongside checkbox lines, with status and project filters; complete_task completes a todo page; add_inbox creates Tasks/<title> with status inbox; list_projects counts todo pages linked by project.
BlackBullet v1.1.0
Editor modes in the header.
- A mode chip next to the page name shows Edit or Preview, and Read-only for pages that cannot be written. Click it, or press Ctrl-Alt-p (Editor: Toggle Preview), to switch. On phones it replaces the lock button.
- With vim keys on, the chip shows NORMAL / INSERT / VISUAL / V-LINE / V-BLOCK / REPLACE. Esc steps out one level per press: Insert → Normal → Preview (then Tab leaves the editor).
- In Preview, read with j / k / / and the other motions; i a o I A O start typing where the cursor is, Enter returns to Normal. :preview and :edit switch too.
- The Fork Guide has a new section, 編集とプレビュー.
🤖 Generated with Claude Code
BlackBullet v1.0.0
First production release of BlackBullet, a personal, local-first, AI-native notes app forked from SilverBullet 2.11.
- One-command start (./setup.sh) with the search/MCP sidecar, and --status, --backup, --restore, --upgrade.
- Databases (database.define) with table, board and calendar views,
- New, filters, saved views, row menu and a restorable trash.
- Search by words and meaning, related notes, a graph of similar pages, and Ask (answers from your notes with citations).
- PDF / Office / OpenDocument / HTML documents are searchable.
- MCP server for AI assistants, also reachable through the tailnet-only HTTPS front door.
- Redesigned interface: one vocabulary, one New, undo for every change, a coherent keyboard scheme, light and dark, phone layout.
- Licensed GPL-2.0-only; the SilverBullet MIT notice is in NOTICE.md.
GitHub Releases から自動で反映しています(すべてのリリース)。