Axon

The open-source AI coding assistant that runs everywhere

Use any model. Extend with plugins. Let AI agents build your project.

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

Watch on YouTube | Download video | Try Live Demo

Axon is a free, open-source AI coding assistant with a built-in Web IDE, multi-agent task system, and self-evolution capabilities. It gives you full control — choose your AI provider, extend functionality through plugins and MCP servers, and even let the AI modify its own source code.

Quick Start

# Install
npm install -g axon

# Set your API key (Anthropic, OpenRouter, DeepSeek, or any OpenAI-compatible provider)
# No API key? Get one at https://api.chatbi.site (Claude Sonnet & Opus, OpenAI-compatible)
export ANTHROPIC_API_KEY="sk-..."

# Terminal mode
axon

# Web IDE mode (opens at http://localhost:3456)
axon-web

Other install methods

Windows: Download install.bat and double-click.

macOS / Linux:

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

China mirror:

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

# 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

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

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

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/kill136/claude-code-open/private_web_ui/uninstall.sh | bash

China mirror:

curl -fsSL https://gitee.com/lubanbbs/claude-code-open/raw/private_web_ui/uninstall.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/kill136/claude-code-open/private_web_ui/uninstall.ps1 | iex

Windows (cmd):

curl -fsSL https://raw.githubusercontent.com/kill136/claude-code-open/private_web_ui/uninstall.bat -o uninstall.bat && uninstall.bat

What makes Axon different

Web IDE

A full browser-based IDE — not just a chat window.

• Monaco Editor with multi-tab, syntax highlighting, and AI-powered hover tips
• File tree with right-click context menus, just like VS Code
• AI-enhanced editing — select code, ask AI, get inline changes
• Real-time streaming via WebSocket
• Session management — create, resume, fork, and export conversations
• Checkpoint & Rewind — snapshot files and time-travel through your session

Multi-Agent Blueprint System

Give Axon a complex task and it breaks it down across multiple AI agents working in parallel.

• Planner decomposes the task into an execution graph
• Lead Agent coordinates workers and tracks progress
• Workers execute independently with full tool access
• Task Queue with priority scheduling and persistence
• Auto-review validates output before marking complete

Self-Evolution

Axon can modify its own source code, compile, and hot-reload — adding new tools and capabilities on the fly.

You: "Add a tool that queries weather data"
Axon: *writes the tool code, compiles TypeScript, restarts, tool is ready*

37+ Built-in Tools

| Category | Tools | |---|---| | File ops | Read, Write, Edit, MultiEdit, Glob, Grep | | Execution | Bash, background tasks, scheduled jobs | | Web | Fetch pages, search the web | | Code | Jupyter notebooks, LSP, Tree-sitter parsing | | Browser | Playwright-based full browser automation | | Planning | Plan mode, Blueprint, sub-agents | | Memory | Long-term memory with semantic search, vector store, BM25 | | Integration | MCP protocol, Skills marketplace, plugins | | Perception | Camera (Eye), Microphone (Ear), Speech (Mouth) |

Extensible by Design

• MCP Protocol — connect any Model Context Protocol server
• Skills — community-contributed prompt-based capabilities (PDF, DOCX, XLSX, PPTX, and more)
• Plugins — write custom JavaScript/TypeScript extensions
• Hooks — pre/post tool execution callbacks
• Custom tools — create tools at runtime that persist across sessions

Works with Any Provider

| Provider | Setup | |---|---| | Anthropic | ANTHROPIC_API_KEY=sk-ant-... | | OpenRouter | ANTHROPIC_BASE_URL=https://openrouter.ai/api/v1 | | AWS Bedrock | CLAUDE_CODE_USE_BEDROCK=1 | | Google Vertex AI | CLAUDE_CODE_USE_VERTEX=1 | | Any OpenAI-compatible | Set ANTHROPIC_BASE_URL to your endpoint |

Proxy Server

Share your API key or Claude subscription with other devices on your network.

# On the host (has the API key)
axon-proxy -k my-secret

# On client machines
export ANTHROPIC_API_KEY="my-secret"
export ANTHROPIC_BASE_URL="http://<host-ip>:8082"
axon

| Flag | Default | Description | |---|---|---| | -k, --proxy-key | auto-generated | Key clients use to authenticate | | -p, --port | 8082 | Port to listen on | | -H, --host | 0.0.0.0 | Bind address | | --anthropic-key | auto-detect | Override Anthropic API key | | --auth-token | auto-detect | Override OAuth access token | | --target | https://api.anthropic.com | Upstream API URL |

The proxy auto-detects credentials: ANTHROPIC_API_KEY env var > ~/.axon/.credentials.json (OAuth).

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 | | AXON_CONFIG_DIR | Config/data directory | ~/.axon |

MCP Servers

Add external tool servers in .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
• Live Demo: voicegpt.site
• Discord: Join us
• X (Twitter): @wangbingjie1989

Contributing

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

Building a Skill or Plugin

The fastest way to extend Axon is to write a Skill (a prompt file with structured instructions) or a Plugin (a JS/TS module with lifecycle hooks). Both are auto-loaded from ~/.axon/skills/ and ~/.axon/plugins/.

Sponsors

Axon is free and open-source. Sponsorships keep development going. See sponsor tiers →

Founding Sponsors

• Jack Darcy — jack@jackdarcy.com.au

Your name/logo here — become a sponsor

License

Axon is dual-licensed:

• Open Source — AGPL-3.0. Free for personal use, academic research, and open-source projects. If you modify Axon or use it to provide a network service, you must release your complete source code under AGPL-3.0.
• Commercial — For proprietary/c