kahliburke/Kaimon.jl

View on GitHub ↗

MCP server giving AI agents full access to Julia's runtime via a live Gate — code execution, introspection, debugging, testing, and semantic search

15 ★1 forksJuliaUpdated 18d ago

What you need to know

Kaimon — a Julia MCP server (49 tools) that acts as a persistent development bridge: execute and manage Julia sessions, introspect types/methods/lowered IR, debug with Infiltrator breakpoints, semantically search code via Qdrant, spawn headless claude agents, and monitor everything in a real-time terminal dashboard.

Install

]app add Kaimon (installs the kaimon command to ~/.julia/bin)
kaimon to launch; first run opens a setup wizard (security mode, API key, port).
From the dashboard: press i in the Config tab to write MCP config for Claude Code, Cursor, VS Code or Gemini CLI; press g to add a Gate snippet to ~/.julia/config/startup.jl.
The gate is a separate lightweight package: ]add KaimonGate (ZMQ + stdlib only); in any REPL ]add KaimonGate; using KaimonGate; KaimonGate.serve().

Usage

  • Connect any Julia process via the Gate to expose domain-specific tools with auto-generated MCP schemas from function signatures.
  • Search code by meaning: search_code (hybrid semantic + lexical) or exact regex via grep_code over the live tree.
  • Track sessions, tool calls, test runs, and results across all connected REPLs in the dashboard.
  • Run tests with pattern filtering and coverage, profile code, and stress-test with concurrent simulated agents.

Key features

  • Persistent REPL execution, restart/shutdown management, and a real TUI dashboard for live monitoring.
  • Introspection (search_methods, type_info, workspace_symbols, macro_expand), lowered IR + typed inspection, formatting, linting.
  • Infiltrator.jl breakpoint debugging (debug_ctrl/debug_eval/debug_exfiltrate/debug_safehouse) and VS Code command execution.
  • Qdrant-based semantic code search (qdrant_index_project / qdrant_sync_index) with natural-language queries.
  • Agent tools spawn and drive headless claude agents (agent_open/send/run/output/status/interrupt/close); MIT license.

Best for

Julia developers who want an agent to execute code in real REPLs, explore internals, search code semantically, and run tests — with a live dashboard view.

Caveats

  • Advanced/infra tools (code_lowered/code_typed, macro_expand, profile_code, lint_package, raw Qdrant admin) are gated off the default surface — enable per project in .kaimon/tools.json.
  • Security modes (strict/relaxed/lax) plus API key and IP allowlists; requires Julia 1.12+.
  • VS Code and headless-claude features depend on the corresponding hosts being available.
Platforms: LocalClients: Claude Code · Cursor · VS Code · Gemini CLI

Reviewed 2026-08-18

Topics

agentaiclaudeclaude-codecursordebuggingdeveloper-toolsgemini-clijuliajulia-langllmmcpmcp-servermodel-context-protocolqdrantreplsemantic-searchtuivscodezmq
Stars
15★
Forks
1
Language
Julia
License
MIT
Created
2026-02-27
Last push
2026-08-18