Axon

March 28, 2026 · View on GitHub

Axon

The 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 powerful 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-code

# 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

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

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

Desktop App (Windows / macOS / Linux)

Download the latest installer from chatbi.site:

Windows: Axon-Setup.exe or Portable .zip
macOS: Axon-Setup.dmg
Linux: Axon-Setup.AppImage

Uninstall

npm uninstall -g axon-code

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*

45+ Built-in Tools

Category	Tools
File ops	Read, Write, Edit, MultiEdit, Glob, Grep
Execution	Bash, Cron (scheduled jobs), background tasks
Web	WebFetch, WebSearch
Code	Jupyter notebooks (edit + write), LSP integration
Browser	Playwright-based full browser automation
Agents	Sub-agents (Explore, Plan, Guide, Monitor, Parallel)
Blueprint	Task decomposition, Lead Agent, Dispatch Workers
Planning	Plan mode, Goal tracking, Task management, TodoWrite
Memory	Long-term memory with embedding vectors, BM25, hybrid search
Integration	MCP protocol, Skills, custom tool creation, self-evolution
Perception	Camera (Eye), Microphone (Ear)
Structured	Structured output, code review submission

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

Proxy options

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

Extending Axon

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/.

For bug reports and feature requests, please open an issue.