BlackBullet v1.2.1
Local-first · AI-native · Markdown

ローカルで動く、Markdown のノートアプリ

ノートは自分のフォルダの .md ファイルとして保存されます。意味検索、データベース表示、MCP による AI 連携つき。

インストールする GitHub で見る
space/Projects/Website.md
---
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
Projects / WebsiteCtrl-q r
Website renewal
statusactivedue2026-10-20

Kickoff notes are in Journal/2026-10-01.
Owner: me #work

Tasks

Pick a theme
Write the about page 10-12
Move old posts
Related Projects / Blog migrationmeaning · 0.82 Journal / 2026-10-01link
左: ファイル / 右: アプリでの表示
Features

機能

ショートカットはコマンドパレット Ctrl-/ からいつでも確認できます。

Write

ブロックエディタ

ドラッグハンドルと折りたたみつきのブロック編集、ドラッグ&ドロップで並べ替えるページツリー、カバー画像とアイコン。すべての変更は Undo できます。

Ctrl-q q クイックノートCtrl-q j 日誌
Find

言葉と意味で探す

全ノートの見出し単位で、文字一致とローカル埋め込みモデルによる意味検索を一度に。開いているページの関連ノートと、リンクと類似度のグラフも。

Ctrl-q s 検索Ctrl-q r 関連Ctrl-Shift-g グラフ
Organise

データベース

型つきプロパティ・フォルダ・テンプレートを一度宣言すれば、表・ボード・カレンダーで表示してその場で編集。復元できるゴミ箱つき。

Ctrl-Alt-n New
Ask

ノートに質問する

自分のノートから引用つきで回答。追加質問や、回答をページとして保存することもできます。Anthropic の API キーが必要です。

Ctrl-q a Ask
Documents

PDF や Office も検索対象

フォルダに置いた PDF、Word、Excel、PowerPoint、OpenDocument、HTML も検索できます。OCR はオプションです。

MCP

AI アシスタントと共有

同じノートを Claude Code や Claude Desktop などの MCP クライアントから検索・追記できます。トークンや鍵を置く CONFIG は読めません。

Principles

データの扱い

ファイルが唯一の正本

ノートはフォルダの中の Markdown です。検索インデックスや埋め込みは消しても作り直せます。既存のノートフォルダをそのまま使えます。

手元で動く

アプリも検索も自分のマシンで動きます。ノート本文が外に出るのは、自分で Ask を実行したときだけ。:confidential を付けたスペースは許可しない限り送りません。

スマホからも

スマホ幅のレイアウトに対応。オプションの Tailscale 専用 HTTPS 入口を使えば、許可したログインだけがパスワード画面なしで開けます。

Install

インストール

必要なのは 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 --upgradegit pull してビルドし直し、再起動
./setup.sh --tailnetTailscale ネットワーク内だけから届く HTTPS の入口を追加
./setup.sh --stopすべて停止。ノートはそのまま残ります

設定はすべて .env にあり、各項目の説明は .env.example にあります。アプリ内の使い方はヘッダーの ? ボタン(日本語ガイド)から。

Releases

リリース履歴

新しいものから順に。各リリースの詳細とダウンロードは GitHub にあります。

v1.2.1 2026-10-03 Latest

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).
v1.2.0 2026-10-03

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.
v1.1.0 2026-10-03

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

v1.0.0 2026-10-03

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 から自動で反映しています(すべてのリリース)。