claude-code-open

Axon is a free, open-source framework that provides a Web IDE, multi-agent blueprint system, and self-evolution capabilities. It exposes its tooling through the MCP (Model Context Protocol) so external agents or orchestrators can communicate with the running Axon instance via standard input/output channels. To use the MCP server, start Axon in a mode that enables the MCP interface (typically via the CLI or a built release/script) and connect your MCP client to the configured stdio channel. The server supports the built-in Maven-like toolbox of 37+ tools, including file operations, code editing primitives, planning and blueprinting, memory and vector-store integrations, and various integration hooks. Once connected, you can request tasks, supply prompts, and choreograph multi-agent workflows with the same MCP protocol used by other compatible servers.

Typical workflow:

• Start Axon with MCP capability enabled (via node CLI or your deployment method).
• Connect an MCP client to the stdio interface defined in the mcp_config (server-name here is axon).
• Use the MCP protocol messages to enumerate tools, request task execution, and handle tool results. You can leverage the Blueprint Multi-Agent System to distribute tasks across workers, while the Self-Evolution feature allows the system to propose and apply code changes during its operation.
• Utilize the 37+ built-in tools (File ops, Execution, Web, Code, Browser automation, Planning, Memory, and Integration) to accomplish complex tasks end-to-end, or plug in additional tools via the MCP integration layer.

Prerequisites:

• Node.js v18 or newer
• npm (comes with Node.js) or pnpm
• Internet access to fetch dependencies

1. Install Node.js (if you don't already have it) from https://nodejs.org

2. Clone the repository and install dependencies:

git clone https://github.com/kill136/claude-code-open.git
cd claude-code-open
npm install

3. Build and run Axon (CLI/Web IDE and MCP-enabled server):

# Build (if applicable)
npm run build

# Run CLI (interactive) or start the MCP-enabled server as needed
npm run start

4. Alternatively, install via npm (globally) if available:

npm install -g axon
# Set API keys and config as needed, then run
axon-web   # for the Web IDE
axon       # for CLI mode

5. If you prefer Docker, follow the Docker section in the README to run the Web IDE or CLI with environment variables set (e.g., ANTHROPIC_API_KEY).

Tips and common considerations:

• Ensure you have a valid API key for your memory/provider integrations (ANTHROPIC_API_KEY, etc.).
• When using MCP, you can locate or configure the MCP endpoint in the mcp_config; the example uses a stdio channel suitable for local orchestration.
• The AXON_CONFIG_DIR defaults to ~/.axon; override with AXON_CONFIG_DIR to persist data elsewhere.
• If you enable Self-Evolution, be mindful of safety and testing; changes may trigger automatic rebuilds and hot-reloads.
• For multi-agent workflows, use the Blueprint system to assign tasks and establish a queue with persistence for reliability.
• If you run in Docker, map the workspace and Axon config directories appropriately and expose the MCP endpoints you intend to use.