axon-code

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*

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

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.

Sponsors

Axon is free to use. Sponsorships keep development going. See sponsor tiers →

Founding Sponsors

• Jack Darcy — [e-mail]

Your name/logo here — become a sponsor

   

License

Axon is proprietary software. Free for personal use. For commercial or enterprise use, please contact [e-mail].

中文版 README