Julie Plugin

This repo installs Julie, a Rust code intelligence MCP server, into six AI coding harnesses, with one install path per harness. Julie gives AI coding agents LSP-quality search, navigation, and refactoring across 36 programming languages.

You need Node.js 22.5 or newer; the launcher is a Node script. Nothing else to install: the archive carries the semantic sidecar. Julie extracts the binaries on the first launch, starts its machine service, and indexes your codebase. Later sessions load the cached index and update only the changed files.

For the tools, capabilities, and supported languages, see the Julie repository.

Optional: Web Research

The /web-research skill needs browser39. Download the release for your platform from the browser39 releases page. All other Julie features work without it.

Installation

Every harness runs the same command: node <plugin-root>/hooks/run.cjs. The launcher extracts the archive for your platform and starts julie-server. Its launch directory does not select a workspace.

Claude Code

/plugin marketplace add anortham/julie-plugin
/plugin install julie@julie-plugin

Add --scope project to the install command to share the plugin with your team through version control.

For a local checkout: claude plugin install /path/to/julie-plugin, or claude --plugin-dir /path/to/julie-plugin to load it without an install.

The plugin registers a SessionStart and SubagentStart hook. The hook prints JULIE_AGENT_INSTRUCTIONS.md, the same routing text the MCP server sends as its instructions. Set JULIE_SESSION_HOOKS=0 to turn the hook off.

Codex

codex plugin marketplace add anortham/julie-plugin
codex plugin add julie@julie-plugin

Codex reads the root plugin.json, mcp.json, skills/, and hooks/hooks.json. Run codex, open /hooks, and trust the two Julie hooks. The plugin registers Julie's stdio server; no separate config.toml entry is needed.

Antigravity

agy plugin install https://github.com/anortham/julie-plugin

Antigravity reads the root plugin.json, mcp_config.json, and skills/. The plugin registers Julie's stdio server; no separate global MCP entry is needed.

OpenCode

git clone https://github.com/anortham/julie-plugin.git
cd julie-plugin
node bin/install-opencode.cjs

The installer links the skills into ~/.config/opencode/skills/ and prints an opencode.json block. Paste the block into ~/.config/opencode/opencode.json (global) or <repo>/opencode.json (project):

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "julie": {
      "type": "local",
      "command": ["node", "/absolute/path/to/julie-plugin/hooks/run.cjs"],
      "enabled": true
    }
  }
}

OpenCode expects command as an array. The env key is environment, not env.

Run node bin/install-opencode.cjs --uninstall to remove the skill links.

Hermes

Clone the repo, then add this block to ~/.hermes/config.yaml:

mcp_servers:
  julie:
    command: node
    args: [/absolute/path/to/julie-plugin/hooks/run.cjs]

Cursor

Clone the repo, then add this block to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project):

{
  "mcpServers": {
    "julie": {
      "command": "node",
      "args": ["/absolute/path/to/julie-plugin/hooks/run.cjs"]
    }
  }
}

Workspace targeting

The launcher only forwards MCP traffic. Its working directory and JULIE_WORKSPACE do not select a checkout. Call manage_workspace(operation="open", path="/absolute/project"), then pass the returned ID as workspace on every search, navigation, and editing call. Other manage_workspace operations use workspace_id; global list and status need neither selector.

What the Plugin Provides

• MCP server with the Julie tools (fast_search, fast_refs, get_symbols, get_context, deep_dive, call_path, blast_radius, edit_file, manage_workspace, patterns)
• Skills: /editing, /explore-area, /impact-analysis, /search-debug, /dead-code-audit, /web-research
• Session hook for Claude Code and Codex that prints JULIE_AGENT_INSTRUCTIONS.md

Supported Platforms

Project Structure

This repo packages pre-built binaries and plugin metadata. Julie's source code lives at anortham/julie.

plugin.json                  Root manifest: Agent Plugins schema (Codex) and Antigravity read it
mcp.json                     Agent Plugins MCP declaration
mcp_config.json              Antigravity MCP declaration
.claude-plugin/
  plugin.json                Claude Code manifest (mcpServers, hooks)
  marketplace.json           Claude Code marketplace entry
.codex-plugin/
  plugin.json                Codex compatibility manifest (skills, hooks)
.agents/plugins/
  marketplace.json           Codex marketplace entry
hooks/
  run.cjs                    Node.js launcher: platform detection, extraction, and exec
  hooks.json                 SessionStart and SubagentStart hooks (Claude Code and Codex)
  session-start.cjs          Prints JULIE_AGENT_INSTRUCTIONS.md as additional context
bin/
  archives/                  Compressed platform binaries with the semantic sidecar (committed)
  install-opencode.cjs       Links skills into OpenCode and prints the opencode.json block
skills/                      Skill directories copied from anortham/julie at the release tag
JULIE_AGENT_INSTRUCTIONS.md  Routing text copied from anortham/julie at the release tag
package.json                 Plugin identity and version

Extracted binaries (bin/aarch64-apple-darwin/, bin/x86_64-*/) are gitignored. Only the archives in bin/archives/ are tracked. run.cjs extracts them on the first launch and again when the archive is newer.

More Information

• Julie source repo: full source, documentation, and development
• Architecture docs: detailed design
• Search flow: how search works

License

MIT. See LICENSE.