Axon

Free & Open Source Axon with Web IDE, Multi-Agent, and Self-Evolution

Website | Live Demo | User Guide | Discord | 中文

_{Watch on YouTube | Download video | Try Live Demo}

Why Axon?

	Official Axon	Axon
Price	$20/month (Max plan required)	Free (bring your own API key)
Interface	Terminal only	Terminal + Web IDE (Monaco editor, file tree, AI-enhanced editing)
Complex tasks	Single agent	Multi-agent Blueprint system (parallel workers, task queue, auto-review)
Customization	Closed source	Fully open source, Self-Evolution (AI modifies its own code)
Deployment	Local only	Local, Docker, Cloud, share via Proxy Server
Integrations	GitHub only	GitHub, Feishu, WeChat, MCP protocol, 37+ tools

Quick Start

# Install globally
npm install -g axon

# Set your API key
export ANTHROPIC_API_KEY="sk-..."  # or on Windows: $env:ANTHROPIC_API_KEY="sk-..."

# CLI mode
axon

# Web IDE mode
axon-web

That's it. Open http://localhost:3456 for the Web IDE.

Other install methods

One-click installer (no Node.js required)

Windows: Download install.bat and double-click.

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/kill136/axon/private_web_ui/install.sh | bash

China mirror:

curl -fsSL https://gitee.com/lubanbbs/axon/raw/private_web_ui/install.sh | bash

Docker

# Web IDE
docker run -it \
  -e ANTHROPIC_API_KEY=your-api-key \
  -p 3456:3456 \
  -v $(pwd):/workspace \
  -v ~/.axon:/root/.axon \
  wbj66/axon node /app/dist/web-cli.js --host 0.0.0.0

# CLI only
docker run -it \
  -e ANTHROPIC_API_KEY=your-api-key \
  -v $(pwd):/workspace \
  -v ~/.axon:/root/.axon \
  wbj66/axon

From source

git clone https://github.com/kill136/axon.git
cd axon
npm install && npm run build
node dist/cli.js        # CLI
node dist/web-cli.js    # Web IDE

Key Features

Web IDE

A full browser-based IDE built with React + Monaco Editor + WebSocket:

• Monaco Editor with multi-tab, syntax highlighting, AI hover tips
• VS Code-style file tree with right-click context menus
• AI-enhanced editing — select code and ask AI, code tour, heatmap decorations
• Real-time streaming of AI responses via WebSocket
• Session management — create, resume, fork, export
• Checkpoint & Rewind — file snapshots and session time-travel

Blueprint Multi-Agent System

Break complex tasks across multiple AI agents working in parallel:

• Smart Planner — decomposes tasks into an execution plan
• Lead Agent — coordinates workers, tracks progress
• Autonomous Workers — independent execution with full tool access
• Task Queue — priority-based scheduling with persistence
• Quality Reviewer — automated review and verification

Self-Evolution

The AI can modify its own source code, run TypeScript compilation checks, and hot-reload:

You: "Add a new tool that queries weather data"
Claude: *writes the tool, compiles, restarts itself, tool is now available*

37+ Built-in Tools

Category	Tools
File ops	Read, Write, Edit, MultiEdit, Glob, Grep
Execution	Bash, background tasks, task output
Web	WebFetch, WebSearch
Code	NotebookEdit, LSP, Tree-sitter parsing
Browser	Playwright-based automation
Planning	Plan mode, Blueprint, sub-agents
Memory	Semantic search, vector store, BM25
Integration	MCP protocol, Skills system
Scheduling	Cron-like daemon, file watching, notifications

More

• Proxy Server — share your API key across devices
• Multi-provider — Anthropic, AWS Bedrock, Google Vertex AI
• Plugin & Hook system — extend with custom logic
• i18n — English and Chinese
• Feishu & WeChat bots — messaging integrations

Configuration

Variable	Description	Default
ANTHROPIC_API_KEY	API key (required)	-
ANTHROPIC_BASE_URL	Custom API endpoint	https://api.anthropic.com
AXON_LANG	Language (en/zh)	auto-detect

MCP Protocol

// .axon/settings.json
{
  "mcpServers": {
    "filesystem": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path"]
    }
  }
}

CLI Reference

axon                          # Interactive mode
axon "Analyze this project"   # With initial prompt
axon -p "Explain this code"   # Print mode (non-interactive)
axon -m opus "Complex task"   # Specify model
axon --resume                 # Resume last session
axon-web                      # Web IDE
axon-web -p 8080 -H 0.0.0.0  # Custom port and host
axon-web --ngrok              # Public tunnel
axon-web --evolve             # Self-evolution mode

Community

• Website: chatbi.site
• Discord: Join us
• X (Twitter): @wangbingjie1989

Contributing

PRs and issues are welcome. See CONTRIBUTING.md for guidelines.

Acknowledgment

This project is inspired by Anthropic's @anthropic-ai/claude-code. It is an independent open-source reimplementation using public APIs. For the official version, see @anthropic-ai/claude-code.

License

MIT

中文版 README