second-brain マニュアル
はじめに
セットアップを行い、最初のデータを集めて、エントリーを検索するまでを説明します。
始める前に
必要なもの:
sbコマンド (インストールを参照)- ソースが一つ以上。Google アカウント、Slack のワークスペース、または追加したいドキュメントのいずれかです。
LLM のアカウントは任意です。なくても、データの収集と検索はできます。その場合、エントリーは要約を待つ状態になります。要約とコストを参照してください。
セットアップ画面
sb setup
ターミナルにセットアップ画面が開きます。左の列にセクションの一覧、右に選んだセクションの内容を表示します。最初は、次の順に進めます。
- Home。 画面が開く前に、ホームディレクトリとデータベースを作ります。自分だけが読める権限を設定します。
- Accounts。 Google アカウントまたは Slack のワークスペースを追加します。複数追加できます。あとから追加することもできます。
- Summarizer。 要約に使うものを選びます。画面からテストできます。
- Schedule。 毎日の同期の時刻 (既定は 19:30)、週一回のディープ同期の曜日 (既定は月曜) と時刻 (既定は 18:30) を確認して、ジョブを登録します。
- Agent skills。 使っている AI エージェント向けに、スキルをインストールします。
- First sync。 最初の同期でさかのぼる日数 (既定は 30) を選びます。コストの見積もりを確認して、最初の同期を実行できます。
左の列の ✓ は、完了したセクションです。あとからいつでも、sb setup をもう一度実行して、任意のセクションに戻れます。
| キー | 動作 |
|---|---|
| ↑ ↓ | 行を選ぶ |
| Tab、または 1〜8 | 別のセクションに移る |
| Enter | 行の操作を実行する (最下行に操作名を表示) |
| x | 行の二つ目の操作 (削除、無効化など) を実行する |
| Esc | フォームを閉じる。メイン画面では終了する |
| q | 終了する |
フォームでは、Tab と矢印キーで項目を移動し、Space で「はい / いいえ」を切り替え、Enter で次の項目に進みます。最後のボタンで Enter を押すと保存します。値が正しくないときは、フォームは開いたままエラーを表示します。
Google アカウントを追加するときは、画面を一時停止して、ブラウザーで Google の同意画面を開きます。終わったら Enter を押して、画面に戻ります。
画面を使わずにセットアップする
各ステップは、単独でも実行できます。
sb setup home
sb setup llm --preset anthropic
sb setup schedule
sb setup skills
sb setup env
画面を使わずに、既定値でセットアップするには sb setup --yes を実行します。--yes では、アカウントの追加と要約に使うものの選択は行いません。sb account add と sb setup llm を使ってください。セットアップ画面にはターミナルが必要です。スクリプトの中では、--yes か各ステップを使います。
注意: Google アカウントや Slack のワークスペースを追加する前に、認証情報を用意する必要があります。Google アカウントと Slack アカウントを参照してください。
最初のデータを集める
sb sync
最初の同期は、直近 30 日分を読みます。Ctrl+C でいつでも止められます。終わった分は保持されるので、もう一度実行すると続きから再開します。
要約のコストの見積もりを先に見るには、次を実行します。
sb sync --estimate
エントリーを探す
sb search CSV
一致したエントリーを、一致度の高い順に表示します。
1. [2026-09-03 09:15] Release plan (local.file, Local files) — Decisions
- Ship the CSV export first.
id: 01M4CDYKPSXV0KSB3F1J2S3JKY
結果には、日付、タイトル、ソースの種類、セクション、エントリーの id が表示されます。id を指定すると、エントリー全体を読めます。
sb show 01M4CDYKPSXV0KSB3F1J2S3JKY
状態を確認する
sb doctor
セットアップを点検して、対応が必要な点を表示します。メンテナンスを参照してください。