Agents¶

Experimental Feature

Agents are currently experimental and under active development. Features and APIs may change.

marimo supports external AI agents that can interact with your codebase through the Agent Client Protocol (ACP). Agents can read and write marimo notebooks, helping you with coding tasks directly from the chat panel.

Supported agents¶

marimo currently supports the following agents:

Claude Code Agent¶

Claude Code Agent that uses your Claude Code CLI subscription to help you with coding tasks.

Installation and login:

# Install
npm install -g @anthropic-ai/claude-code
# Login
claude
# Then type /login

Connection command:

npx stdio-to-ws "npx @zed-industries/claude-code-acp" --port 3017

Gemini Agent¶

Google's Gemini agent offers a limited free tier and login for more advanced features.

See login and authentication instructions in the Gemini CLI documentation.

Connection command:

npx stdio-to-ws "npx @google/gemini-cli --experimental-acp" --port 3019

Connecting to an agent¶

Start the agent server: Run the connection command for your chosen agent in a terminal
Enable the feature flag: Enable the feature flag under the "Lab" section in the settings menu
Open the agent panel: Click the agents icon in marimo's sidebar
Select your agent: Choose the agent from the dropdown menu
Start chatting: The agent can now read and modify your notebooks

Terminal integration

If you have terminal access enabled in marimo, you can run agent connection commands directly from the agent panel using the terminal button.

Custom agents¶

Custom agents

Support for custom agents is coming soon. This will allow you to connect to your own ACP-compatible agents

Troubleshooting¶

Connection issues: Ensure the agent server is running on the correct port before connecting in marimo.

Permission requests: Agents may request permission to read or write files. Review these carefully before approving.

Session limits: Currently, only one session per agent is supported for optimal performance.