jarvis

{
  "mcpServers": {
    "jarvis": {
      "command": "jarvis-server"
    }
  }
}

クライアントが PATH 上の jarvis-server を見つけられない場合（GUI アプリはシェルの環境を引き継がないことがよくあります）、which jarvis-server で取得した絶対パスを使用してください。

まず Homebrew バイナリをインストールしてください。このプラグインは jarvis スキルを追加し、インストール済みの jarvis-server を登録できます。

/plugin marketplace add jarvis-intelligence/jarvis-index
/plugin install jarvis@jarvis

スタンドアロンパッケージには SCIP コンバーターと 2 つの Zoekt バイナリが含まれています。Homebrew フォーミュラには setup.sh が含まれていません。jarvis のソースチェックアウトから、リポジトリに必要な言語別インデクサーをインストールしてください：

macOS で Maven を使ってビルドする Java リポジトリでは、brew install bash で最新の Bash もインストールし、同じソースチェックアウトから sh setup.sh --only bash-shim を実行してください。インデクサーを追加した後、再度インデックス化してください。対応するインデクサーがない場合でも、カバレッジがある範囲では Tree-sitter を使って documentSymbols と goToDefinition が動作します。 findReferences、callHierarchy、typeHierarchy は復旧方法を案内します。

semanticSearch は MCP との互換性のために登録されていますが、スタンドアロン配布には含まれていません。ソースビルドの手順を示す Homebrew 固有の利用不可エラーを返します。字句検索とシンボル検索は引き続き利用できます。

スタンドアロンの Homebrew パッケージには、セマンティック検索の依存関係が含まれていません。ソースチェックアウトで、次のコマンドを実行してインストールしてください：

uv run jarvis install-semantic

次に、明示的にインデックス化します：

uv run jarvis index /path/to/repo --semantic

install-semantic は埋め込みモデル（BAAI/bge-m3、約 4.3 GB、初回のみ）も共有 Hugging Face キャッシュ（~/.cache/huggingface/）に事前ダウンロードします。インデックス化するリポジトリはすべて、このモデルを再利用します。ダウンロードが中断された場合、次回の jarvis index で自動的に再試行されます。

インデックス作成 CLI が事前計算済みインデックスを ~/.jarvis に書き込み、stdio ランタイムがそれを読み込みます。この2つは、ほかの契約を共有しません。

• 公開はアトミックに行われます — 再インデックスでは新しいスナップショットを書き込んだ後、os.replace で current ポインターを切り替えます。古いスナップショットを読み取っているクエリは引き続き動作し、ダウンタイムは発生しません。
• ランタイムの処理では書き込みを行いません — すべてのクエリは公開済みのスナップショットを読み取り専用で開きます（mode=ro&immutable=1）。
• パッケージグラフは蓄積せずに再構築します — 再インデックスのたびに、そのリポジトリの出力エッジをすべて消去してから再計算します。

詳しくは、docs/system-architecture.md を参照してください。

jarvis index /path/to/your/repo            # slug defaults to the directory name
jarvis index /path/to/your/repo --slug foo # or pick one explicitly
jarvis index /path/to/your/repo --scheme MyScheme # Swift repo with an ambiguous Xcode scheme
jarvis index /path/to/your/repo --language python # force the language instead of detecting it
jarvis index /path/to/your/repo --no-scip   # skip optional SCIP enrichment; syntax baseline + Zoekt still publish
jarvis index /path/to/your/repo --scip      # re-enable SCIP enrichment (both flags persist per repo)
jarvis list
jarvis status foo
jarvis reindex foo
jarvis forget foo
jarvis watch /path/to/your/repo [--debounce 5.0]  # debounced auto-reindex on file changes (foreground)

• scip-java は Android/Gradle リポジトリのインデックスを作成できません — Gradle プラグインは、AGP に置き換えられる標準ソースセットを前提としているためです（scip-java#177）。自動的に検出され、検索のみのモードに切り替わります。
• Kotlin のインデックス作成には、Kotlin のバージョンを完全に一致させる必要があります — scip-kotlinc は固定された特定のリリース（現在は 2.2.0）に対してコンパイルされています。自動的に検出されます。
• Maven でビルドされた Java リポジトリを macOS で使うには、bash ≥ 4.4 が必要です — brew install bash で解決できます。
• Swift のインデックス作成には scip >= v0.9.0 が必要です — 古いコンバーターは出現箇所の範囲を警告なしに破棄します。jarvis index は、壊れたインデックスを公開しないよう、古い scip の使用を拒否します。

ソース開発用のセマンティックパスには、モデルプレフィックスを追加で上書きする設定があります。 これらはスタンドアロンディストリビューションには影響しません。