A lightweight, fast terminal AI coding agent. Built for speed, designed for simplicity.
中文文档 | Guide | Development | License
AsukaCode is a terminal coding agent built with Bun + TypeScript + OpenTUI. Compatible with any OpenAI-compatible API — supports DeepSeek / Claude / GPT-5 / Qwen / GLM and 20+ models.
PowerShell (Recommended):
irm https://raw.githubusercontent.com/Asuka01124/asukacode/main/scripts/install.ps1 | iexCMD:
curl -o install.ps1 https://raw.githubusercontent.com/Asuka01124/asukacode/main/scripts/install.ps1 && powershell -ExecutionPolicy Bypass -File install.ps1curl -fsSL https://raw.githubusercontent.com/Asuka01124/asukacode/main/scripts/install.sh | bashClone and build from source:
git clone https://github.com/Asuka01124/asukacode
cd asukacode
bun install
bun run compileasukacodeFirst run launches an interactive setup wizard: API key → model selection → base URL.
Config saved to ~/.asukacode/config.json.
- Multi-step tool execution:
model → tool → modelloop - Fullscreen TUI (OpenTUI React) with scrollback, slash commands, sidebar
- Build/Plan mode:
/planfor read-only planning,/buildfor full access,Shift+Tabto toggle - 14 built-in tools: bash / file I/O / search / web / tasks / skills
- MCP support: connect to MCP servers, manage tools via
/mcpcommand - Paste block: large paste (>5 lines) auto-collapses to
[pasted ~N lines]with extmark virtual text - 4-level context compaction: Micro → Snip → Budget → Auto
- Capability-based permission system: risk classification, sub-command rules, shell metacharacter detection, sensitive file protection, MCP tool categorization
- Long-term memory: auto-extract, consolidate, inject per-turn
- Skill system: load domain expertise via
SKILL.md - Incremental System Prompt updates: detect changes, send deltas only
- Multi-session with SQLite persistence +
/resume - Single-binary compile via
bun build --compile
| Command | Action |
|---|---|
/new |
New session |
/resume |
Load history |
/clear |
Clear conversation |
/skill |
Browse skills |
/plan |
Switch to plan mode (read-only) |
/build |
Switch to build mode (full access) |
/compact |
Compact context |
/mcp |
Manage MCP servers |
Shift+Tab |
Toggle build/plan mode |
Ctrl+C ×2 |
Exit |
bun install
bun run ./tui/entry.tsxbun run compile # Current platform
bun run compile:linux-x64 # LinuxMIT
