WaspCode is a powerful, open-source AI coding agent that lives in your terminal. It combines the intelligence of large language models with deep codebase understanding to help you write, debug, refactor, and ship code faster than ever before.
Think of it as having a senior developer pair programming with you 24/7 — one that never gets tired, knows every file in your project, and can execute changes instantly.
Welcome Screen — Beautiful ASCII art logo with clear navigation
AI Chat Interface — Natural language coding assistance
Code Actions — Intelligent suggestions and automated refactoring
Settings Panel — Full customization of models and preferences
WaspCode represents a fundamental shift in how developers interact with AI:
| 🖥️ Terminal-First | Seamlessly integrated into your existing workflow. No context switching, no browser tabs — just pure productivity in your natural habitat. |
| 🔓 Provider Agnostic | Zero vendor lock-in. Choose from Claude, OpenAI, Google, or our curated 14-model collection. You stay in control as the AI landscape evolves. |
| 🧠 Deep Understanding | Built-in LSP support and semantic code analysis. WaspCode doesn't just chat — it understands your codebase like a senior engineer. |
| 🔧 Open Architecture | 100% open source with client/server design. The TUI is just one interface — imagine controlling your agent from a mobile app while it runs on your workstation. |
# npm (recommended)
npm install -g waspcode-ai
# yarn
yarn global add waspcode-ai
# pnpm
pnpm add -g waspcode-ai
# bun
bun install -g waspcode-aiwaspcodeThat's it. WaspCode automatically guides you through initial setup.
| 🔧 Build Agent | 📋 Plan Agent (Read-Only) |
|---|---|
|
Full-access development companion:
|
Safe exploration and analysis:
|
Complex multi-step tasks handled automatically:
- Deep codebase searches with semantic understanding
- Cross-file analysis and dependencies
- Multi-step refactoring operations
Invoke with @general in any conversation.
WaspCode provides 14 production-grade models through our unified Custom Models provider. No external API keys required — everything works immediately.
Our recommended choice for general coding tasks. Features 128K context window, fast responses, and excellent accuracy.
| Model | Context | Best For |
|---|---|---|
custom/qwen3-coder-plus |
128K | Default — General coding, tool calls |
custom/qwen3-coder-flash |
128K | Speed — Ultra-fast completions |
| Model | Context | Best For |
|---|---|---|
custom/claude-opus-4.5 |
200K | Complex analysis — Reasoning, vision, tools |
custom/claude-sonnet-4.5 |
200K | Balanced power — Reasoning with attachments |
custom/claude-haiku-4.5 |
200K | Speed & efficiency — Fast, capable responses |
custom/gpt-5.2 |
128K | Latest GPT — Reasoning and vision |
custom/kimi-k2-thinking |
128K | Deep reasoning — Chain-of-thought analysis |
| Model | Context | Best For |
|---|---|---|
custom/kimi-k2-0905 |
256K | Massive contexts — MoE architecture |
custom/kimi-k2.5 |
128K | Long documents — Large codebases |
custom/gemini-3-pro |
2M | Huge contexts — Up to 2 million tokens |
custom/gemini-3-flash |
1M | Fast long context — 1M with vision |
| Model | Context | Best For |
|---|---|---|
custom/sonar-pro |
128K | Research — Reasoning and search |
custom/sonar |
128K | Quick research — Fast capabilities |
custom/grok-4.1-fast |
128K | Real-time — X integration, fast |
💡 Pro Tip: Use
@model <name>in chat to switch models instantly. Tryclaude-opus-4.5for complex refactors,gemini-3-profor huge codebases, orkimi-k2-thinkingfor deep reasoning.
Prefer a GUI? WaspCode Desktop is available:
| Platform | Download |
|---|---|
| macOS (Apple Silicon) | waspcode-desktop-darwin-aarch64.dmg |
| macOS (Intel) | waspcode-desktop-darwin-x64.dmg |
| Windows | waspcode-desktop-windows-x64.exe |
| Linux | .deb, .rpm, or AppImage |
Package Managers:
# macOS
brew install --cask waspcode-desktop
# Windows
scoop bucket add extras
scoop install extras/waspcode-desktop→ Download from GitHub Releases
| Variable | Description |
|---|---|
WASPCODE_INSTALL_DIR |
Custom installation directory |
WASPCODE_API_KEY |
Your AI provider API key |
XDG_BIN_DIR |
XDG-compliant binary path |
$WASPCODE_INSTALL_DIR$XDG_BIN_DIR$HOME/bin$HOME/.waspcode/bin(default)
- Getting Started — First steps and setup
- Configuration — Advanced customization
- Agents — Master Build, Plan, and General agents
- Models — Complete model reference
- API Reference — Integration guide
We welcome contributions! Please read our Contributing Guide.
Priority Areas:
- 🌍 Internationalization
- 🐛 Bug reports and fixes
- ✨ Feature development
- 📚 Documentation
- GitHub Discussions — Questions and ideas
- GitHub Issues — Bug reports
MIT License — see LICENSE for details.
Crafted with 💜 by eres45
An open source AI coding agent for the terminal
⭐ Star this project if you find it useful!