I’ve installed as per the instructions and launched a notebook:
But when I invoke the agent I get
What have I done wrong?
I think you need to start kaimon (the terminal program) in a separate terminal, then check directly with your LLM provider (e.g., the Claude CLI) that it has access to the Kaimon MCP.
Not sure… First of all, there’s no terminal command “kaimon” or “Kaimon”. Also, I’m not sure how to permission the Kaimon MCP in the Claude CLI (I haven’t used MCP before). Do I need to add a custom connector? If so, what’s the remote mcp server url for Kaimon?
if you open a Julia REPL, go to pkg> mode and type app add Kaimon. Once installed, you might need to add ~/.julia/bin to PATH, e.g., export PATH="$HOME/.julia/bin:$PATH" in your ~/.zshrc or ~/.bashrc or similar.
Then launch kaimon from a fresh terminal session and follow the prompts to set it up. Once inside, you can go to pane 6 Config, and select your preferred “MCP client” (e.g., Claude Code), which will set up the MCP for you. Then open a fresh instance of claude from a new terminal, type /mcp, navigate to kaimon, press enter, then navigate to and press authenticate or reconnect.
Some additional details in the Kaimon docs:
- Installation
- Getting started (which also shows how to set up the MCP)
I wonder if it would make sense for kaimon to provide an interface to JETLS. Also, for large projects, building a graph containing the relation between each type and functions of a project.
One option might be to use a feature Kaimon provides: the ability to create extensions delivering custom toolsets. You can find information on how to do this here: Extensions | Kaimon.jl
Feel free to get in touch if you have questions or need support. If these tools became generally useful it could make sense to include them in the base set as well, but this would provide an easy way for you to experiment with your ideas.
i followed the installation instructions and, as i wrote, i have no kaimon command available from the terminal (the terminal command ‘which kaimon’ returns nothing whereas ‘which slate’ returns ~/.julia/environments/v1.12/bin/slate). i can run slate from the terminal which launches kaimonslate with the kaimon extension registered, in which case the agent is unavailable.
alternatively, i can run from julia as per my previous msg, in which case the agent is clickable but generates the error in the previous msg. in neither case do i see a pane labeled Config or anywhere else that allows me to set up an mcp client. perhaps the ui varies by os? i’m on a macbook.
I’ll connect with you via DM to sort things out.
We got things up and running. There was one aspect which caused an issue and it’s my fault.
I had an app in Tachikoma called tachi which was installed automatically via a build.jl file. It seemed to work fine but I recently discovered there is an interaction with the package system causing issues due to a read only directory. I’ve removed this installation in the latest Tachikoma release, but it doesn’t clean it up existing installations. Unfortunately its existence makes other ]app add/update commands fail.
So, if anyone reads this at a later point, you should run ]app rm Tachi which will clean this up. Tachikoma has updated instructions in its README.md and its referenced in the Kaimon docs here: Installation | Kaimon.jl
Just a quick note on Julia 1.13 compatibility:
Kaimon 2.8.3 is released which fixed a couple minor incompatibility issues. Automated tests and initial manual tests all look fine, but if you run into anything, feel free to reach me directly or file an issue on GitHub.