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