jarvis

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

如果客户端无法在 PATH 中找到 jarvis-server（图形界面应用通常不会继承 shell 的 环境变量），请使用 which jarvis-server 获取其绝对路径。

请先安装 Homebrew 二进制文件。该插件会添加 jarvis 技能，并可注册已安装的 jarvis-server。

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

独立软件包包含 SCIP 转换器和两个 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 会返回恢复 指引。

为兼容 MCP，已注册 semanticSearch，但独立发行版不包含该功能。它会返回一条 特定于 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 运行时读取这些索引。两者之间没有其他约定。

• 发布是原子的——重新索引会写入新快照，然后通过 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，以免发布损坏的索引。

源代码开发中的语义路径还支持额外的模型前缀覆盖； 这些设置不会影响独立发行版。