Nix

Nix

https://paulocesaaars.github.io/nix/

Markdown の Wiki を開発エージェント（Cursor、VS Code、Claude Code、Codex）に公開する MCP サーバーです。ハイブリッド検索、ノートの読み書きに対応し、埋め込みとベクトルデータベースはローカルで無料です。推論はクライアント側で行い、Nix はツールを提供するだけです。デフォルトでは無効になっている Mega Brain は、選択した Wiki にエージェント間のメモリを保存します。

トランスポート：MCP stdio。ターミナルでサブコマンドなしに nix を実行すると、インターフェースが開きます。MCP クライアントは、ターミナルがなくても引き続きサーバーを利用できます。

使用する理由

• エディターのエージェントは、単語だけでなくアイデアを見つけます。Vault 内を意味検索と語彙検索で検索します。
• Cursor を離れずに、Markdown のノートを作成・更新できます。
• すべてがお使いのマシン上で動作します。Vault の内容が埋め込み API に送信されることはありません。
• インデックスを更新するタイミングは自分で制御できます。バックグラウンドで動作するウォッチャーはありません。

要件

• Windows amd64、Linux（amd64 または arm64）、または macOS Apple Silicon
• Markdown（.md）のノートを保存するフォルダー
• 初回同期時に約 220 MB の空き容量（デフォルトモデル lulu）。spitz（BAAI/bge-m3）は約 2.3 GB です

リリースのバイナリを使う場合、Python のインストールは不要です。ダウンロードしたファイルにはランタイムが含まれています。会社によって .exe、PowerShell、インストーラーのダウンロードリンクがブロックされている場合は、リリースからソースコードの zip をダウンロードし、Git Bash で Python を使ってインストールしてください。手順は実行ファイル、PowerShell、ダウンロードリンクがブロックされている場合のセクションをご覧ください。

インストール

インストーラーは最新のリリースからnixとnix-hookをダウンロードし、それぞれのSHA-256を確認して、NIX_HOMEを設定します。Wikiは後でインターフェースから登録します。セッションフックはnix-hookを呼び出します。

Windows（PowerShell）：

irm https://raw.githubusercontent.com/paulocesaaars/nix/main/install.ps1 | iex

LinuxおよびmacOS：

curl -fsSL https://raw.githubusercontent.com/paulocesaaars/nix/main/install.sh | sh

完了したら、nixを実行してインターフェースを開きます。コマンドが動作しない場合は、ターミナルを閉じて開き直してから、もう一度お試しください。

インストールフォルダーは、Windowsでは%LOCALAPPDATA%\nix、macOSでは~/Library/Application Support/nix、Linuxでは~/.local/share/nixです（既存のNIX_HOMEがある場合はその場所です）。バイナリは{NIX_HOME}/binにあります。Windows arm64とmacOS Intelにはバイナリがありません。インストーラーはその旨を表示して終了します。

初回起動時に、バイナリがキャッシュ（Windowsでは%LOCALAPPDATA%\nix\onefile-<versão>、macOSでは~/Library/Caches/nix/onefile-<versão>、Linuxでは~/.cache/nix/onefile-<versão>）に展開されます。インストーラーがこの初回起動を実行します。2回目以降はキャッシュを再利用します。nix-hookはnixと同じ場所にあります。完全なバイナリは起動のたびにペイロード全体のCRCを確認するため、セッションフックの300 msの予算内に収まりません。nix hooks installを実行すると、エージェントがnix-hookを使うように設定されます。キャッシュは同じフォルダー内のhook-<versão>に保存されます。

次に、エディターにサーバーを登録します。MCP クライアントへの登録を参照してください。インストーラーはNIX_HOMEを設定し、nixをPATHに追加します。nixを実行してインターフェースを開きます。コマンドが動作しない場合は、ターミナルを閉じて開き直してから、もう一度お試しください。自動登録に失敗した場合は、NIX_HOMEとPATHを手動で登録するを参照してください。Nixパッケージマネージャー（NixOS）がすでにPATHにある場合、インストーラーが通知します。このnixが優先されるようになります。

NIX_VERSION=1.2.3（vの有無は問いません）を指定すると、特定のリリースをインストールできます。

実行ファイル、PowerShell、ダウンロードリンクがブロックされている場合

ネットワークによっては、.exe、PowerShell の実行、install.ps1 が行うダウンロード（スクリプトとリリースバイナリの irm）がブロックされます。最新のリリースからソースコードの zip ファイル（Source code (zip)）をダウンロードし、ソースから（開発者向け）のセクションと同じ Python を使った方法でインストールしてください。マシンに nix.exe は入りません。

会社のコンピューターから GitHub を開けない場合は、別のマシンでこの zip をダウンロードし、ファイルをコピーしてください。展開してフォルダー（nix-<versão>）に移動します。Git Bash で、Python 3.11 以降を使います。

python scripts/bootstrap.py

bootstrap.py は .venv を作成し、requirements.txt のパッケージをインストールして、NIX_HOME を設定し、nix を PATH に追加します。Wiki は後でインターフェースから登録します。リリースの zip には、このスクリプトと requirements.txt が含まれています。requirements-dev.txt は Git の完全なクローンにのみ含まれます。このファイルを使う開発者向けセクションのコマンド一覧は、クローンからコードを変更する場合に適用されます。pip は PyPI にアクセスできる必要があります。

この Bash で python が使えない場合は、py または python3 を使ってください。Git が利用可能な場合は、クローンの後に同じスクリプトを実行できます。

git clone https://github.com/paulocesaaars/nix.git
cd nix
python scripts/bootstrap.py

nix を実行してインターフェースを開きます。コマンドが機能しない場合は、ターミナルを閉じて開き直し、もう一度試してください。すでに開いているターミナルでは、次を実行します。

source bin/env.sh

MCP には nix.exe はありません。command を環境の Python に設定し、モジュールを args に渡してください。zip またはクローンを別の場所に置いた場合は、フォルダーを変更してください。

{
  "mcpServers": {
    "nix": {
      "command": "C:/Git/nix/.venv/Scripts/python.exe",
      "args": ["-P", "-m", "nix"]
    }
  }
}

このインストールのフックは python -m nix hook を呼び出します。リリースの nix-hook.exe は入りません。

このインストールを元に戻すには、展開したフォルダーまたはクローン内で python scripts/uninstall.py を実行します。Wiki のフォルダーは変更されません。--yes を指定すると確認を省略し、--keep-data を指定すると settings.db とインデックスを保持します。install.ps1 または install.sh でインストールしたバイナリは、アンインストールのセクションにあるコマンドで削除できます。

初回の同期では、引き続き埋め込みモデル（約 220 MB の lulu）がダウンロードされます。

ソースから（開発者向け）

Nix を変更する場合は venv を使います。ルートにある install.ps1 は公開済みのバイナリをダウンロードするもので、このチェックアウトをインストールするものではありません。

python -m venv .venv
# Windows (Git Bash): source .venv/Scripts/activate
# Linux/macOS:        source .venv/bin/activate

pip install -r requirements-dev.txt
pip install -e .
python -m nix init                # ou: python -m nix init --wiki "C:/Notas/MinhaWiki"

PATH の登録を含む同じ手順は python scripts/bootstrap.py です。チェックアウトを元に戻すには python scripts/uninstall.py を実行します。

python -m nix は venv を有効にした後に使えます。Cursor はターミナルの PATH を引き継がないため、開発用 MCP では command を .venv の Python に設定して -P -m nix を渡すか、このチェックアウトの shim bin/nix を指定してください。

エージェントスキル（開発者向け）

ドキュメントの更新、コードレビュー、コミットを行う開発用スキルは、このリポジトリの .claude/skills/（Claude Code と Cursor）および .agents/skills/（Cursor と VS Code）でバージョン管理されています。skills-lock.json には、同期済みスキルの取得元が記録されています。

Mega Brain

インターフェースで Mega Brain → 設定 を開き、登録済みの wiki を選択して、この機能を有効または無効にします。保存して MCP クライアントを再起動してください。メモリツールはフックなしで動作しますが、セッションの自動キャプチャにはフックが必要です。環境変数で設定したフィールドは個別にロックされ、もう一方は引き続き編集できます。

デフォルトではオフです。ページ用の wiki を選択して有効にします。

nix brain enable --wiki Default

この wiki は 100 件の上限に含まれ、Mega Brain が有効な間は削除できません。キャプチャには引き続きフックが必要です。エージェントは初期状態では選択されていません。既存ファイルを変更する前に、プレビュー、確認、バックアップが行われます。グローバルスコープでは、他のリポジトリのイベントが記録される可能性があることが通知されます。

nix brain hooks install --scope project
nix brain hooks install --scope global

プロジェクトは Git のルート、リポジトリがない場合はフォルダーです。.nix.toml では、project、[capture] enabled / exclude、[profile] contribute / consume を設定できます。Toml を読み取れない場合、キャプチャは無効になります。

エージェント	プロジェクト内のフックファイル
Cursor	.cursor/hooks.json
VS Code	.github/hooks/nix.json
Claude Code	.claude/settings.local.json
Codex	.codex/hooks.json（/hooks で信頼を設定した後にのみ実行）
Devin（CLI と Desktop）	.devin/hooks.v1.json

nix brain hooks install --all は、これらのクライアントにこの順序でインストールします。リストにあるその他のクライアント（Command Code、OpenCode、Gemini CLI、GitHub Copilot CLI など）では、キャプチャは一部のみ対応しています。JSON が自動生成されることはありません。グローバルスコープでは、パスが確認された場合にのみファイルが書き込まれます。

セッションページは、Mega Brain の wiki 内にある projects/<projeto>/sessions/ に保存されます。セッションが終了し、nix brain work が実行されたときにのみ書き込まれます。ハンドオフとメッセージはベースに保存され、このページには保存されません。

ダッシュボード。 各カードは 1 つのプロジェクトを表します。エージェントが作業したフォルダーの Git ルート、またはリポジトリがない場合はそのフォルダー自体です。名前はフォルダー名、または .nix.toml の project フィールドです。カードは最初のセッションがキャプチャされた後に表示され、セッション数、エージェント、最終アクティビティを示します。プロジェクトを開くと、概要、エージェント、トークン、セッション、ナレッジを確認できます。

受信箱。 ハンドオフとは別の、エージェント間メッセージのキューです。brain_message_send は、宛先またはプロジェクト内の誰でも受け取れる相手にテキストを送信します。状態は「待機中」になります。brain_message_pop は最も古いメッセージを一度だけ配信し、「配信済み」にします。それまではキャンセルしてキューから削除できます。画面には、配信済みのものも含め、プロジェクト、宛先、テキスト、状態（待機中、配信済み、キャンセル済み）が表示されます。

プロフィール。 これは、言語モデルを使わずに、依頼の中でユーザーが記述した設定です。Nix は「always use」、「I prefer」、「never use」およびそれらに相当する英語表現の後に続く単語を探します。既知のツール（pnpm、pytest、ruff、docker、git など）は profile/tools/ に保存されます。それ以外は profile/habits/ に保存されます。同じトピックが少なくとも 2 つのプロジェクトで確認された場合にのみ、その文が追加されます（profile.min_projects のデフォルトは 2）。新しい文が優先されます。nix brain profile rebuild は再学習を行います。forget は墓標になり、次の実行ではエントリが再作成されません。セッション開始時のブリーフィングには有効な文が含まれますが、.nix.toml で [profile] consume = false に設定した場合は含まれません。

nix brain handoff create --text "..." は、プロジェクトごとに最大 1 件のハンドオフを作成します。nix brain handoff accept --agent NOME は、それを一度だけ引き受けます。セッション開始時には、ブリーフィングが指示ではなく履歴として表示されます。

nix run claude（または別のエージェント）は、不足している場合にフックと MCP をインストールします。--no-autowire を指定すると、これを無効にできます。Claude Code と Codex では、以前の履歴の読み取り専用コピーが NIX_PREVIOUS_SESSION_HISTORY に保存され、エージェントの終了時に消去されます。読み取りツールがない場合、警告を表示してコマンドを続行します。

remember は引き続きデフォルトの wiki に書き込み、Mega Brain には含まれません。

更新

インストール済みのバージョンを入れ替えるには、nix と nix-hook を終了し、この2つのバイナリだけを削除して、インストーラーを再実行してください。Wiki、settings.db、.nix フォルダー（インデックスと Mega Brain）はそのまま残ります。次のセクションのアンインストーラーを使うと、--keep-data を指定しない限り、settings.db と .nix も削除されます。

Windows（PowerShell）：

Stop-Process -Name nix,nix-hook -Force -ErrorAction SilentlyContinue
$root = if ($env:NIX_HOME) { $env:NIX_HOME } else { Join-Path $env:LOCALAPPDATA "nix" }
Remove-Item -Force (Join-Path $root "bin\nix.exe"), (Join-Path $root "bin\nix-hook.exe")
irm https://raw.githubusercontent.com/paulocesaaars/nix/main/install.ps1 | iex

新しいバイナリを読み込ませるため、MCP クライアントを閉じてから開き直してください。Windows では、インストーラーは新しいバイナリを書き込む前に既存のバイナリを名前変更し、問題が発生した場合は元に戻します。以前のコピー（.bak）を削除できない場合は通知し、ファイルを残します。手動で削除してください。

Linux および macOS： インストーラーがファイルを置き換えます。プロセスを終了し、インストーラーを再実行してください。

pkill -x nix || true
pkill -x nix-hook || true
curl -fsSL https://raw.githubusercontent.com/paulocesaaars/nix/main/install.sh | sh

アンインストール

アンインストーラーは NIX_HOME と PATH の nix コマンドを削除し、nix と nix-hook、展開キャッシュ（onefile-* と hook-*）を削除します。また、既定では .nix/（インデックス、バックアップ、ログ）と settings.db も削除します。インストールフォルダーが空になった場合は、そのフォルダーも削除されます。Wiki フォルダーは変更されません。 バージョンだけを入れ替える場合は、更新を使用してください。

Windows では、nix.exe または nix-hook.exe が開いていると、アンインストーラーは PATH を変更する前に停止し、ファイルが使用中であることを通知します。Nix を開いたままにしているクライアントを閉じるか、プロセスを終了してから、もう一度実行してください。

s を入力して確認します。スクリプトでは --yes を指定してください。--keep-data を指定すると、settings.db とインデックスが保持されます。

PowerShell でインストールした Nix

install.ps1 を使ってインストールした場合は、リポジトリフォルダーがなくてもアンインストールできます。PowerShell で次を実行してください。

irm https://raw.githubusercontent.com/paulocesaaars/nix/main/uninstall.ps1 -OutFile "$env:TEMP\uninstall-nix.ps1"
& "$env:TEMP\uninstall-nix.ps1"

Continuar? [s/N] に s と入力してください。ファイルが使用中という応答があった場合は、プロセスを終了して、同じアンインストーラーをもう一度実行してください。

Stop-Process -Name nix,nix-hook -Force -ErrorAction SilentlyContinue
& "$env:TEMP\uninstall-nix.ps1"

このスクリプトは onefile-* と hook-* キャッシュも削除します。%LOCALAPPDATA%\nix が空になった場合は、フォルダーも削除されます。完了を知らせる行には、フォルダーを削除したこと、または残っていたファイルをフォルダーから削除したことが表示されます。その後、新しいターミナルを開いてください。

& "$env:TEMP\uninstall-nix.ps1" --yes
# para manter settings.db e o índice:
& "$env:TEMP\uninstall-nix.ps1" --keep-data --yes

Linux および macOS では、リリーススクリプトを実行してください。

curl -fsSL https://raw.githubusercontent.com/paulocesaaars/nix/main/uninstall.sh | sh
# ou: curl -fsSL .../uninstall.sh -o uninstall.sh && sh uninstall.sh --yes

リポジトリフォルダーまたは zip フォルダーから

クローンしたフォルダー、または Source code (zip) を展開したフォルダー（bootstrap.py によるインストール）で、次を実行してください。

python scripts/uninstall.py
# ou: python scripts/uninstall.py --yes
# ou: python scripts/uninstall.py --keep-data --yes

このコマンドは、NIX_HOME がこのフォルダーを指している場合はその設定を解除し、.venv を削除します。また、--keep-data を指定しない限り、.nix/ と settings.db も削除します。フォルダー内のソースコードは残ります。

リポジトリのルートにあるスクリプトを使う場合：

uninstall.bat
:: ou, sem pergunta:
uninstall.bat --yes
:: para manter settings.db e o índice:
uninstall.bat --keep-data --yes

.\uninstall.ps1
# ou: .\uninstall.ps1 --yes
# ou: .\uninstall.ps1 --keep-data --yes

sh uninstall.sh
# ou: sh uninstall.sh --yes
# ou: sh uninstall.sh --keep-data --yes

その後、新しいターミナルを開いてください。このプロジェクトの nix は使えなくなります。永続的な登録に失敗した場合は、NIX_HOME と PATH を手動で削除するを参照してください。また、エディターの mcp.json から nix サーバーも削除してください。

埋め込みモデルは Hugging Face キャッシュに残る場合があります（BAAI/bge-m3 は約 2.3 GB です）。このキャッシュは他のプログラムと共有されており、アンインストーラーでは削除されません。各プロジェクトの mcp.json にある nix サーバーも残ります。エディターでこの項目を削除してください。

MCP クライアントへの登録

クライアントがプロセスを起動します。保存後、MCP サーバーを再読み込みしてください。

command は PATH 上の nix という名前ではなく、インストールフォルダー（NIX_HOME）内のバイナリを指定する必要があります。Dock やメニューから起動したエディターは、ターミナルの PATH を引き継ぎません（spawn nix ENOENT）。パスは nix doctor の comando nix: 行に表示されます。

Cursor — ワークスペース内の .cursor/mcp.json：

Windows

{
  "mcpServers": {
    "nix": {
      "command": "${env:NIX_HOME}/bin/nix.exe"
    }
  }
}

Windows では、IDE がユーザー環境変数 NIX_HOME を読み取ります。絶対パスも使用できます。例：C:/Users/voce/AppData/Local/nix/bin/nix.exe

macOS / Linux

{
  "mcpServers": {
    "nix": {
      "command": "/Users/voce/Library/Application Support/nix/bin/nix"
    }
  }
}

nix doctor の comando nix: 行に表示されたパスに置き換えてください。Linux のデフォルトフォルダーは ~/.local/share/nix/bin/nix です。IDE では "command": "nix" は機能しません。${env:NIX_HOME} も通常は展開されません。アプリは .zshrc / .bashrc を読み取らないためです。

インターフェースで 統合 → クライアントを接続 を開くと、このインストール先の絶対パスを含む設定をコピーできます。形式が確認済みのクライアントの手順では、プロジェクトスコープを使用します。

• Cursor： .cursor/mcp.json。上記の例にある mcpServers ブロックを使用します。
• VS Code： .vscode/mcp.json。type: "stdio" を含み、command が実行ファイルを指定する servers.nix を使用します。
• Claude Code： プロジェクトフォルダーで claude mcp add nix --scope project -- "CAMINHO_ABSOLUTO_DO_NIX" を実行します。設定は .mcp.json に保存されます。
• Codex： 信頼済みのプロジェクトで .codex/config.toml を作成または編集します。

[mcp_servers.nix]
command = "C:/Users/voce/AppData/Local/nix/bin/nix.exe"

この設定を読み込むには、Codex でプロジェクトを信頼してください。Linux または macOS では、コマンドを対応する実行ファイルの絶対パスに置き換えてください。

• Devin： .devin/mcp_config.json。上記の例にある mcpServers ブロックを使用します。

保存後、クライアントを再起動するか、MCP サーバーを再読み込みしてください。stdout は MCP プロトコル用です。ログは Nix フォルダー内の .nix/logs/nix.log にのみ記録されます。

Python でインストールしたため nix.exe がない場合は、実行ファイル、PowerShell、ダウンロードリンクがブロックされている場合 のように .venv のインタープリターを使用してください。

はじめに

インストール時に nix init は実行されません。ターミナルで nix を実行してインターフェースを開きます。コマンドが見つからない場合は、ターミナルを閉じて開き直し、もう一度試してください。

最初の Wiki は Wikis 画面から追加するか、nix init で追加します。画面でフォルダーを設定すると、最初のフォルダーがデフォルトになります。nix init ではモデルも選択でき、MCP サーバーと nix ui コマンドに必要なマーカーが記録されます。このマーカーがないと、エディターは接続できません。

nix init
nix doctor
nix sync
nix status

最初の sync（または埋め込みを行う操作）で、設定済みのモデルがダウンロードされます。デフォルトは lulu（約220 MB）です。埋め込みは CPU で実行され、ファイルの処理が終わるまで進捗バーは進みません。spitz（BAAI/bge-m3、約2.3 GB）に切り替えると検索精度が向上しますが、ノート1件の処理に数分かかることがあります。nix init または nix config set index.embedding_model spitz で切り替え、nix sync --full を実行してください。

パスにフォルダーが指定されていない新しいノートは、Wiki の default_new_note_folder（デフォルトは Inbox）に保存されます。

NIX_HOME と PATH を手動で登録する

インストーラーは NIX_HOME（Nix フォルダー）と {NIX_HOME}/bin をユーザーの PATH に登録しようとします。これに失敗した場合（権限、ポリシー、レジストリの制限など）でも、バイナリのインストールは続行されます。環境変数を自分で登録し、新しいターミナルを開いてください。

例の代わりに、実際のインストールフォルダーを使用してください。

Windows（インターフェース）

1. Win+R を押して sysdm.cpl を実行し、詳細設定 → 環境変数 を開きます。
2. ユーザー環境変数 で 新規 を選択します。
   • 変数名：NIX_HOME
   • 変数値：Nix フォルダー。例：C:\Users\voce\AppData\Local\nix
3. ユーザー環境変数の Path を選択し、編集 → 新規 をクリックして %NIX_HOME%\bin を追加します。
4. すべてのウィンドウで OK をクリックして確定します。

Windows（PowerShell、永続設定）

$nixHome = "$env:LOCALAPPDATA\nix"
[Environment]::SetEnvironmentVariable("NIX_HOME", $nixHome, "User")
$expand = "%NIX_HOME%\bin"
$p = [Environment]::GetEnvironmentVariable("Path", "User")
if ($p -notlike "*$expand*") {
  [Environment]::SetEnvironmentVariable("Path", "$p;$expand", "User")
}

Linux、macOS、Git Bash

~/.bashrc に追加します（ターミナルがログインシェルの場合は ~/.profile にも追加します）。macOS ではパスは $HOME/Library/Application Support/nix、Linux では $HOME/.local/share/nix です。

# >>> nix >>>
export NIX_HOME="$HOME/.local/share/nix"
case ":$PATH:" in *":$NIX_HOME/bin:"*) ;; *) export PATH="$NIX_HOME/bin:$PATH" ;; esac
# <<< nix <<<

その後、source ~/.bashrc を実行するか、新しいターミナルを開きます。

このセッションのみ（保存されません）

$env:NIX_HOME = "$env:LOCALAPPDATA\nix"
$env:Path = "$env:NIX_HOME\bin;$env:Path"

export NIX_HOME="${XDG_DATA_HOME:-$HOME/.local/share}/nix"
export PATH="$NIX_HOME/bin:$PATH"

NIX_HOME と PATH を手動で削除する

アンインストーラーで環境変数が元に戻らない場合は、インストーラーが追加した設定を削除し、新しいターミナルを開いてください。Wiki フォルダーはそのまま残ります。

%LOCALAPPDATA%\nix の代わりに、実際のインストール先フォルダーを使用してください。

Windows（GUI）

1. Win+R を押し、sysdm.cpl を実行して、詳細設定 → 環境変数を選択します。
2. ユーザー環境変数で NIX_HOME を選択し、削除をクリックします（値がこの Nix のフォルダーの場合のみ）。
3. ユーザーの Path を選択し、編集をクリックして、%NIX_HOME%\bin（存在する場合は絶対パス ...\nix\bin も）を削除します。
4. すべてのウィンドウで OK をクリックして確定します。

Windows（PowerShell、永続設定）

$nixHome = "$env:LOCALAPPDATA\nix"
$stored = [Environment]::GetEnvironmentVariable("NIX_HOME", "User")
if ($stored -and ($stored -ieq $nixHome)) {
  [Environment]::SetEnvironmentVariable("NIX_HOME", $null, "User")
}
$bin = Join-Path $nixHome "bin"
$p = [Environment]::GetEnvironmentVariable("Path", "User")
if ($p) {
  $kept = $p.Split(";") | Where-Object {
    $t = $_.Trim().Trim('"')
    $t -and $t -ne "%NIX_HOME%\bin" -and $t -ne $bin
  }
  [Environment]::SetEnvironmentVariable("Path", ($kept -join ";"), "User")
}

Linux、macOS、Git Bash

NIX_HOME がこのインストール先フォルダーを指している場合は、~/.bashrc、~/.zshrc、~/.bash_profile、~/.profile のうち存在するファイルから、# >>> nix >>> と # <<< nix <<< の間のブロックを削除します。

その後、source ~/.bashrc を実行するか、新しいターミナルを開きます。

インデックス作成

これは重要なルールです。

たとえばテキストエディターなど、Nix 以外で行った変更は、自動ではインデックスに登録されません。MCP ツールで行った変更は、同じ操作内でインデックスが更新されます。

Nix 以外でノートを編集した後は、nix sync を実行するか、エージェントに sync_index を依頼してください。書き込みのベクトル化に失敗しても、ファイルは Wiki（信頼できる情報源）に残ります。nix sync を実行すればインデックスが修正されます。

CLI

これらはターミナルで実行するコマンドです。nix --help でコマンドグループを確認できます。nix COMANDO --help で、そのコマンドのオプションを確認できます。Wiki は自動ではインデックスに登録されません。インデックスは nix sync の実行時、または MCP ツールによる書き込み時に更新されます。

コマンド	説明
nix	ターミナルでは、インターフェースを開きます。ターミナル以外では、MCP クライアントがサーバーを受け取ります
nix --version	バージョンを表示して終了します
nix init	最初の Wiki と埋め込みモデルを登録します。--wiki はフォルダーを指定します。省略すると、ターミナルで入力を求められます。--name は Wiki に名前を付けます（既定値は Default）。--embedding-model は lulu または spitz を選択します。--force はノートを変更せずに、設定を最初から書き直します
nix sync	Nix の外で Wiki に加えられた変更をインデックスに反映します。--full はすべてを再構築します。--dry-run は表示のみ行います。--json はレポートを出力します。--wiki NOME は 1 つまたは複数の Wiki を選択します。--all はすべてを対象にします
nix status	インデックスが Wiki に追いついているかを表示します。--json、--wiki、--all を指定できます
nix doctor	環境、設定、MCP が実行するコマンド、インデックスを確認します。--json はレポート全体を出力します
nix ui	ブラウザーでインターフェースを開きます。nix init が必要です。--no-browser は URL の表示のみ行います。--port N はポートを固定します
nix run AGENTE	エージェントを起動します。Cursor、VS Code（copilot）、Claude Code（claude）、Codex（codex）、Devin（devin）、またはリスト内のその他のエージェント（Command Code は cmd、Antigravity は agy、Kiro は kiro-cli、GitHub Copilot CLI は copilot、IBM Bob は bob、Qoder は qodercli を呼び出します）。不足している場合は、プロジェクトのフックと MCP をインストールします。プロジェクトの MCP に対応しているのは、Claude Code、Cursor、VS Code、Devin のみです。--no-autowire はこれらのファイルを変更しません。--project PASTA はリポジトリを選択します。Claude Code と Codex では、エージェントが終了するまで、以前のネイティブ履歴を NIX_PREVIOUS_SESSION_HISTORY に保持します
nix wiki list	Wiki、そのフォルダー、既定の Wiki を一覧表示します。--json は一覧を出力します
nix wiki add NOME CAMINHO	別の Wiki を登録します。上限は 100 です
nix wiki rename ANTIGO NOVO	登録名を変更します。フォルダーやインデックスは移動しません
nix wiki remove NOME	Wiki の登録を解除します。既定の Wiki と最後の Wiki は解除できません。ノートのフォルダーはそのまま残ります
nix wiki default NOME	コマンドまたはツールで名前を省略した場合に使用する Wiki を選択します
nix wiki path NOME CAMINHO	Wiki の参照先を別のフォルダーに変更します
nix wiki set NOME CAMPO VALOR	Wiki 固有の設定を保存します。設定項目は include、exclude、follow_symlinks、default_new_note_folder、default_frontmatter、longterm_folder です。リストとオブジェクトは JSON として渡します
nix config list	グローバル項目、有効な値、その値の由来（既定値、データベース、環境変数）を一覧表示します。--json は一覧を出力します
nix config get CAMPO	secao.chave 形式で項目の値を表示します
nix config set CAMPO VALOR	settings.db に項目を保存します。環境変数 NIX_SECAO__CAMPO が設定されている場合は、引き続きデータベースの値より優先されます
nix config unset CAMPO	保存した値を削除し、既定値に戻します
nix config history	最近の変更を一覧表示します。--limit N で件数を変更します
nix config undo [ID]	以前の値に戻します。ID を省略すると、最後の変更を取り消します
nix brain enable --wiki NOME	Mega Brain を有効にし、セッションページを保存する Wiki を選択します。有効状態は保存されます
nix brain status	Mega Brain が有効かどうか、Wiki、現在のプロジェクトのフックの状態を表示します
nix brain hooks install	キャプチャ用フックをインストールします。ターミナルでは、クライアントと適用範囲（アカウント全体またはリポジトリのみ）を尋ねられます。事前確認と確認操作があります。--scope project|global、--agent NOME、--all、--dry-run、--yes を指定すると、質問を省略できます
nix brain hooks remove --scope ESCOPO	指定した適用範囲から Nix のフックを削除します。--agent でクライアントを選択します
nix brain hooks status	エージェントごとに、ファイルと同意の状態が一致しているかを表示します
nix brain handoff create --text "..."	プロジェクトのハンドオフを作成します。セッションがどこで終了したかを記録します。未完了のハンドオフは 1 つだけにできます
nix brain handoff list	プロジェクトのハンドオフを新しい順に一覧表示します
nix brain handoff accept --agent NOME	未完了のハンドオフを 1 回だけ引き受け、テキストを表示します
nix brain handoff cancel	未完了のハンドオフをキャンセルします
nix brain profile list	プロフィールで有効なフレーズを一覧表示します
nix brain profile rebuild	記録された依頼をもとに、言語モデルを使わずにプロフィールを再学習します
nix brain profile apply	有効な項目のページを Wiki に書き直します
nix brain profile review	まだ十分な数のプロジェクトに登場していないトピックを表示します
nix brain profile forget CAMINHO	項目を忘れます。次回の処理で再び追加されることはありません
nix hook、nix banner、nix brain workは内部プロセス用です。ターミナルでの使用には含まれません。

ユースケース

• インターフェースを開く。 インストール後、nixを実行します。コマンドが見つからない場合は、ターミナルを閉じて開き直し、もう一度試してください。wikiがすでに登録されている場合は、nix uiで同じインターフェースを開けます。
• 最初のwikiを登録する。 nix initでフォルダーとモデルを保存します。インストール時にこの確認は行われなくなりました。
• エディターでアイデアを見つける。 NixのMCPを有効にした状態で、エージェントにノートを検索するよう依頼します。エージェントはwikiのインデックスでsearch_notesを使用します。
• エディターを離れずにノートを記録する。 エージェントにノートの作成または更新を依頼します。書き込みはMCPツール経由で行われ、そのノートのインデックスはすぐに更新されます。
• Nix以外で編集した内容をインデックスに反映する。 nix syncを実行します。--dry-runを指定すると、変更内容を確認できます。--fullを指定するとインデックスを再構築します。埋め込みモデルを変更した後は、必ずこれを実行してください。
• 複数のwikiを使う。 nix wiki add Trabalho C:/Notas/Trabalhoで2つ目のwikiを登録します。nix wiki default Trabalhoを実行すると、名前を省略したときにそのwikiが使われます。検索では、1つまたは複数、あるいはすべてのwikiを指定できます。
• エディターが接続できない原因を調べる。 nix doctorでコマンド、設定、インデックスを確認します。
• エージェント間でメモリーを共有する。 nix brain enable --wiki DefaultでMega Brainを有効にします。nix brain hooks install --scope global --allを実行すると、Cursor、VS Code、Claude Code、Codex、Devinがセッションの各イベントでNixを呼び出すようになります。VS Codeにはグローバルファイルがないため、VS Codeでの記録は一部に限られます。
• Claudeで行っていた作業をCodexで続ける。 両方のクライアントでNixのMCPを有効にし、Mega Brainをオンにして、同じプロジェクトフォルダーを使う必要があります。Claudeに、セッションをどこで中断したか記録するよう依頼します。Claudeはbrain_handoff_createを呼び出します。Codexを開き、Claudeで行っていた作業を続けるよう指示します。Codexはエージェントcodexを指定してbrain_handoff_acceptを呼び出し、必要に応じてbrain_queryまたはbrain_read_pageを呼び出します。MCPを使わない場合は、同じテキストをターミナルで開いて受け取ることができます。コマンドはnix brain handoff createとnix brain handoff accept --agent codexです。フックだけの場合、セッション開始時に直近の依頼をまとめたブリーフィングを渡すだけです。
• もう一方のエージェントに伝言を残す。 Mega Brainを有効にすると、brain_message_sendでプロジェクトのキューにメッセージを追加できます。もう一方のエージェントはbrain_message_popでメッセージを一度だけ取得します。
• Mega Brainに保存済みの内容を読む。 brain_queryでMega Brainのwikiと観察記録を検索します。brain_recent_pagesでセッションページの一覧を表示します。brain_read_pageでパスを指定してページを読みます。見つかったテキストは履歴です。
• プロフィールを再学習する。 nix brain profile rebuildで記録済みの依頼を読み直します。nix brain profile listでフレーズを表示します。nix brain profile forget CAMINHOでフレーズを忘れさせます。nix brain profile applyでページをwikiに書き戻します。
• 設定を修正する。 nix config historyで変更内容を確認します。nix config undoで以前の値に戻します。

サーバー

ターミナルでサブコマンドを付けずにnixを実行すると、インターフェースが開きます。MCPクライアントは同じコマンドをターミナルなしで起動し、stdioサーバーを受け取ります。nix --versionはバージョンを表示して終了します。

初期設定

nix initで最初のwikiと埋め込みモデルをsettings.dbに保存します。インストール時にこの手順は行われなくなりました。

• --wiki CAMINHOでフォルダーを指定します。指定しない場合、ターミナルで入力を求められます。
• --name NOMEで最初のwikiに名前を付けます。指定しない場合、名前はDefaultになります。このオプションは作成時にのみ有効です。2つ目以降はnix wiki addで追加します。
• --embedding-model NOMEでモデル（luluまたはspitz）を選択します。指定しない場合、作成時にターミナルで選択を求められます。
• --forceでノートを変更せずに設定を最初から保存し直します。

Wiki

1 つのインストール環境で、1〜100 個の Wiki を管理できます。sync と status で Wiki を省略すると、デフォルトの Wiki が使われます。

• nix wiki list は名前、フォルダー、デフォルトかどうかを表示します。--json を指定すると、同じ一覧を JSON で出力します。
• nix wiki add NOME CAMINHO は別の Wiki を登録します。AAAAMMDDTHHMMSS 形式の名前は拒否されます。
• nix wiki rename ANTIGO NOVO は名前を変更します。インデックスとバックアップの場所は変わりません。検索結果が空になった場合は、nix sync --full --wiki NOVO を実行してください。
• nix wiki default NOME はデフォルトの Wiki を選択します。別の Wiki がデフォルトになるまでは、デフォルトの Wiki を削除できません。最後の Wiki は削除できません。
• nix wiki remove NOME は登録を解除します。ノートのフォルダーは残ります。Mega Brain のページ用 Wiki は、Mega Brain が有効な間は削除できません。
• nix wiki path NOME CAMINHO は、同じ名前の Wiki を別のフォルダーに割り当てます。
• nix wiki set NOME CAMPO VALOR は、その Wiki の設定を保存します。設定可能な項目は include、exclude、follow_symlinks、default_new_note_folder、default_frontmatter、longterm_folder です。リストとオブジェクトは JSON で指定します。グローバル設定には影響しません。

Wiki の名前変更、削除、path、set は、その Wiki の同期が終わるまで待機します。

MCP ツールで wiki を省略すると、デフォルトの Wiki が使われます。検索、一覧、ステータス、同期では、1 つの名前、名前のリスト、または "*"（すべて）を指定できます。書き込みで指定できるのは名前 1 つだけです。

グローバル設定

フィールドはインストール環境の settings.db（NIX_HOME。Python チェックアウトの場合はクローンのフォルダー）に保存されます。nix config set secao.chave valor はフィールドを保存します。リストとオブジェクトは JSON で指定します。

• nix config list はフィールドを表示します。--json を指定すると、形式が切り替わります。
• nix config get secao.chave はフィールドを読み取ります。
• nix config unset secao.chave はフィールドをデフォルト値に戻します。
• nix config history は変更履歴を表示します。--limit N を指定すると、一覧を制限できます（デフォルトは 20）。
• nix config undo は直近の変更を元に戻します。nix config undo ID は履歴の指定した項目を元に戻します。

Mega Brain を使うには、nix brain enable --wiki NOME を実行します。その後、MCP クライアントを再起動すると、brain_* ツールが表示されます。

NIX_SECAO__CAMPO 環境変数は、そのフィールドについてデータベースの値より優先され、nix config とインターフェースでの変更がロックされます。Wiki の登録には、この環境変数は使われません。

インデックス

Nix の外部でノートを編集しても、インデックスは更新されません。必要に応じて nix sync を実行し、同期してください。

• --wiki と --all のどちらも指定しない場合は、デフォルトの Wiki が対象です。
• --wiki NOME は複数回指定できます。--all はすべての Wiki を順番に処理します。両方を同時に指定することはできません。
• --full はインデックス全体を再構築します。モデルを変更した後に使ってください（nix config set index.embedding_model spitz）。
• --dry-run は変更内容を表示するだけです。
• --json を指定すると、レポートを JSON で出力します。同じ指定は nix status と nix doctor にも使えます。

nix status はノート数、チャンク数、最終同期時刻、Wiki がインデックスより新しいかどうかを表示します。nix doctor は環境、設定、MCP が実行するコマンド、各 Wiki のインデックスを確認します。エディターが接続できない場合は、まずこれを実行してください。

インターフェース

nix ui は 127.0.0.1 でブラウザーを開き、ステータス、同期、診断、検索、Mega Brain（パネル、設定、受信トレイ、プロフィール）、クライアント接続、MCP トラフィック、バックアップ、Wiki、設定を表示します。nix init が必要です。Ctrl+C または「終了」ボタンで終了します。--no-browser は URL のみを表示します。--port N はポートを固定します。

Mega Brain

手順については Mega Brain を参照してください。

• nix brain enable --wiki NOME は Mega Brain を有効にし、Wiki を選択します。status は状態を表示します。
• nix brain hooks install --scope project|global はエージェントに依頼します。remove と status でも同じ --scope を使います。
• nix brain handoff create --text "..." はハンドオフを作成します。list、accept --agent NOME、cancel で一連の操作を完了します。
• nix brain profile rebuild は再学習します。list、review、forget CAMINHO、apply で確認と再保存を行います。
• nix run AGENTE は後続の引数を実行ファイルに渡します。--no-autowire はフックも MCP も変更しません。--project PASTA はリポジトリを選択します。

MCP ツール

エージェントはターミナルで nix を実行しません。自然な言葉で依頼すると、エージェントがツールを呼び出します。Wiki のツールは常に利用できます。brain_* ツールが MCP に追加されるのは Mega Brain が有効な場合のみです。nix brain enable の実行後にクライアントを再起動してください。定義は src/nix/core/tools/registry.py にあります。デフォルトの Wiki のノートは nix://note/{+rel_path} というリソースとして表示され、名前付き Wiki の場合は nix://wiki/{name}/note/{+rel_path} として表示されます。現在の一覧用と品質確認用のツール名は list_wikis と wiki_insights です。

ターミナルでのコマンド	エージェントへの依頼内容	ツール
nix sync	インデックスを同期して、Nix の外部で変更された内容を取り込みます	sync_index
nix status	インデックスが古くなっていますか？	index_status
nix wiki list	登録されている Wiki を一覧表示します	list_wikis
nix brain status	このプロジェクトの Mega Brain の状態を教えてください	brain_status
nix brain handoff create	作業を中断した場所を記録します	brain_handoff_create
nix brain handoff list	未完了のハンドオフはありますか？	brain_handoff_list
nix brain handoff accept	別のエージェントで行っていた作業を続けます	brain_handoff_accept
nix brain handoff cancel	ハンドオフをキャンセルします	brain_handoff_cancel

nix、nix init、nix doctor、nix ui、nix run、nix config、その他の nix wiki コマンド、nix brain enable、nix brain hooks、nix brain profile はターミナルで実行します。フックはセッションのイベントごとに自動で実行されます。

これらのツールに相当するコマンドはありません。次のように依頼して使います。

エージェントへの依頼内容	ツール
ノートを検索します	search_notes
ノート、アウトライン、または指定した範囲を開きます	read_note、get_note_outline、read_note_lines
ノートまたはタグを一覧表示します	list_notes、list_all_tags
このノートを参照しているものを教えてください	get_linked_notes
ノート、フロントマター、またはタグを作成、追記、更新します	create_note、append_to_note、update_note、update_frontmatter、manage_tags
ノートまたは添付ファイルを移動します	move_note、move_file
ノートを削除します	delete_note（確認が必要です）
孤立したノート、重複、またはリンクの提案を調べます	wiki_insights
「…」を覚えておいてください	remember
Mega Brain が「…」について保存した内容を教えてください	brain_query
セッションページを読み取るか、最近のページを一覧表示します	brain_read_page、brain_recent_pages
ブリーフィングをお願いします	brain_briefing
セッション中に何があったか教えてください	brain_read_session_observations
ルール、決定事項、またはプロフィールを記録します	brain_write_page、brain_patch_page、brain_delete_page
このページは役に立ちました	brain_feedback
メッセージを送信、一覧表示、取得、またはキャンセルします	brain_message_send、brain_message_list、brain_message_pop、brain_message_cancel

リファレンス

ツール	用途
search_notes	フォルダー、タグ、日付によるフィルターに対応したハイブリッド検索（セマンティック検索＋語彙検索）
read_note	ノート全体を読み込みます。長いノートでは、アウトラインと行単位での読み込みを推奨します
get_note_outline	タイトル、フロントマターのキー、総行数、見出し
read_note_lines	ファイルの行範囲、または見出しの内容を読み込みます（最大400行）
list_notes	インデックス済みのノートを一覧表示します（フォルダー、タグ）
list_all_tags	インデックス済みのタグと件数を表示します。tag フィルターで使用します
get_linked_notes	ウィキリンクをたどります（outgoing、incoming、または both）
create_note	ノートを作成し、すぐにインデックス化します（ライトスルー）
append_to_note	内容を追記して再インデックス化します
update_note	replace には confirm=true が必要です。patch は追記し、prepend は YAML の後に挿入します
update_frontmatter	トップレベルのキーを変更し、YAML の残りの部分を保持します
manage_tags	フロントマターのタグを追加または削除します。本文中のタグには変更を加えません
move_note	.md ノートを移動し、そのノートを指すリンクを書き換えます
move_file	添付ファイル（PDF、画像など）を移動します。.md ノートには move_note を使用します
delete_note	ノートとインデックスを削除します。confirm=true が必要です
sync_index	手動で同期します（full、dry_run）
index_status	Wiki ごとの件数、最終同期日時、遅延状況
wiki_insights	孤立ノート、重複、リンクの提案、または要約
remember	Wiki の longterm_folder に長期的に保持する事実を記録します
list_wikis	名前、パス、デフォルト設定、その Wiki のインデックスが古くなっているかどうか
brain_query	Mega Brain の Wiki とセッションの観察記録を検索します。テキストは履歴です
brain_status	このプロジェクトの Wiki、セッション、未終了のセッション
brain_briefing	プロファイル、提供されたハンドオフ、要約、メッセージを表示します。ハンドオフは消費しません
brain_read_page	相対パスを指定して Mega Brain の Wiki ページを読み込みます
brain_recent_pages	すでに保存されたセッションページを新しい順に一覧表示します
brain_write_page	キュレーション済みページまたはプロファイルページを作成または置換します
brain_patch_page	キュレーション済みページまたはプロファイルページのリテラルな文字列を置換します
brain_delete_page	キュレーション済みページまたはプロファイルページを削除します。confirm=true が必要です
brain_feedback	ページが役立ったかどうかを記録します。ページは変更しません
brain_read_session_observations	セッションの生の観察記録を読み込みます。テキストは履歴です
brain_handoff_create	プロジェクトのハンドオフを開始します。未終了のものは1件のみです
brain_handoff_list	プロジェクトのハンドオフを一覧表示します
brain_handoff_accept	未終了のハンドオフを一度だけ取得します
brain_handoff_cancel	未終了のハンドオフをキャンセルします
brain_message_send	プロジェクトのキューにメッセージを送信します
brain_message_list	保留中および配信済みのメッセージを一覧表示します
brain_message_pop	次の保留中メッセージを一度だけ配信します
brain_message_cancel	まだ保留中のメッセージをキャンセルします

設定

Nix のフォルダー（NIX_HOME。開発用チェックアウトではリポジトリーのフォルダー）にある settings.db に保存されます。相対パスはこのフォルダーを基準に解決されます。グローバルフィールドでは、NIX_SECAO__CAMPO 形式の環境変数がデータベースの値より優先されます（例：NIX_INDEX__EMBEDDING_MODEL）。対応するフィールドは nix config とインターフェースでロックされます。Wiki の登録にはこの変数を使用しません。名前、フォルダー、既定値、設定（include、exclude、フォルダー）は nix wiki で管理します。nix wiki set NOME CAMPO VALOR は設定を保存します。リストとオブジェクトは JSON として入力します。nix wiki path NOME CAMINHO はフォルダーを変更します。nix init は最初の Wiki とモデルを保存します。nix config set secao.chave valor はグローバルフィールドを変更します。リストとオブジェクトは JSON として入力します。nix config undo は以前の値に戻します。

nix ui を実行すると、LLM を使わずに同じ操作をブラウザーで行えます。

• 操作： ステータス（「はじめに」ブロックは、選択した Wiki が同期され、エディターがツールを呼び出すまで表示されます。インデックスが古いという警告は、その同期後にのみ表示されます）、プレビューと進捗状況を確認できる同期（ジョブが完了するまで、ページを再読み込みした場合もボタンは無効になります）、診断。
• Wiki（読み取り専用）： 1 つまたは複数、あるいはすべての Wiki を対象とした検索、ノート（アウトラインと抜粋を含む）、タグ、インサイト。インサイトのページでは、孤立したノート、重複、リンクの提案、要約について説明します。コンテンツの上の帯にある「アクティブな Wiki」セレクターは ?wiki= を使用します。指定がない場合は既定値が使われます。
• Mega Brain： ダッシュボード、Wiki と状態の設定、受信トレイ、プロフィール。プロフィールまたはセッションのページにあるリンクを開くと、Mega Brain で設定されている Wiki が表示されます。
• 連携： Cursor、VS Code、Claude Code、Codex、Devin、その他 19 のクライアントへの接続に使える設定例、MCP トラフィック（クライアントからの呼び出しは .nix/traffic.db に記録されます）。
• メンテナンス： 書き込みのバックアップ（比較とダウンロード）、およびバックアップの復元。インターフェースから Wiki に書き込みを行う唯一の操作で、確認が必要です。Wiki 画面、設定フォーム、履歴もあります。

このコマンドを実行するには nix init が必要です。127.0.0.1 のみで待ち受け、Ctrl+C または「終了」ボタンで終了します。--no-browser は URL のみを表示し、--port はポートを固定します。

キー	既定値	機能
wiki（登録）	nix init で設定する名前 Default	nix wiki で管理する各 Wiki のフォルダー。1～100 件を登録でき、既定値は 1 件です
Wiki の exclude	.trash/**、Templates/**、Privado/**	その Wiki で無視するフォルダー。nix wiki set NOME exclude VALOR で変更します
default_new_note_folder	Inbox	パスにフォルダーが指定されていないノートの保存先
longterm_folder	Nix/Memória	remember ツールの保存先
index.data_dir	.nix/data	インデックスのベースディレクトリー。各 Wiki は .nix/data/<nome> を使用します
logging.file	.nix/logs/nix.log	ログの保存先。log_prompts が有効な場合にのみクエリーが記録されます
brain.enabled	無効	キャプチャーと brain_* ツールを有効にします。MCP クライアントの再起動が必要です

リリースの公開

GitHub のリリースは、vX.Y.Z タグがリモートにプッシュされると自動的に作成されます。.github/workflows/release.yml ワークフローはバージョンを確認し、ruff と mypy を実行して、プラットフォームごとに nix と nix-hook をビルドします（Windows amd64、Linux amd64、Linux arm64、macOS arm64）。その後、checksums.txt とともにファイルを リリース に公開します。

1. pyproject.toml の [project].version を更新します（例：1.2.3）。タグはこの値と一致する必要があります。一致しない場合、ジョブは失敗します。
2. メインブランチにコミットしてプッシュします。
3. タグを作成してプッシュします（プレフィックスの v は必須です）。

git tag v1.2.3
git push origin v1.2.3

4. Actions で Release ワークフローの進行状況を確認します。成功すると、リリースにはプラットフォームごとの nix と nix-hook、プラットフォームごとの .mcpb、checksums.txt、server.json が含まれます。同じジョブで MCP Registry に登録情報が公開されます。タグのソースコード zip には、Nix のインストールと使用に必要なものだけが含まれ、開発用スキル、ドキュメント、テストは含まれません。

このリポジトリでは、site/ のガイドは自動公開されません。

既存のタグのアーティファクトを再公開するには、ワークフローを手動で実行します：Actions → Release → Run workflow を選択し、タグを入力します（例：v1.2.3）。

ドキュメント

• PRD.md — 製品、要件、ビジネスルール
• TDD.md — 技術仕様：コンポーネント、インデックス作成、検索、MCP stdio