Run AI coding models from one open source desktop workspace.
Basebuild combines native agent chat, tool approvals, MCP, planning, terminals, and source control in a local-first Tauri app. With your consent, it also sends anonymous provider and model usage aggregates to basebuild.net. Those aggregates help build community-powered estimates of real subscription value, including how many useful hours different plans and models actually provide.
Download platform files from the latest GitHub release.
PowerShell:
irm https://raw.githubusercontent.com/basebuild-net/basebuild/main/install.ps1 | iexThe script downloads and opens the NSIS installer. A portable zip is also available on the release page.
AppImage:
curl -fsSL https://raw.githubusercontent.com/basebuild-net/basebuild/main/install.sh | shDebian or Ubuntu:
curl -fL https://github.com/basebuild-net/basebuild/releases/latest/download/Basebuild-linux-x86_64.deb -o /tmp/basebuild.deb && sudo apt install /tmp/basebuild.debDownload the
Basebuild-macos-universal.dmg,
open it, then drag Basebuild.app into Applications.
Or install the latest universal build to ~/Applications from Terminal:
curl -fsSL https://raw.githubusercontent.com/basebuild-net/basebuild/main/install.sh | shOn first launch, macOS may require you to Control-click Basebuild.app, select
Open, then confirm.
Remote install commands execute scripts from the default branch. Review
install.ps1 or install.sh first, or replace
main in the raw URL with a trusted commit SHA.
 |
 |
 |
| Agent workspace | Models and providers | Usage and plan value |
Click a thumbnail for the full-size screenshot.
Basebuild uses an attribution-required license. You may use, improve, and
redistribute it, but you must credit basebuild.net.
See LICENSE for the complete terms.
- Run the model you want. Connect supported providers or an OpenAI-compatible endpoint, then switch provider, model, effort, and permission mode per chat.
- Native agent workspace. Streamed chat, gated tools, MCP servers, project context, terminals, and Git live in one desktop window.
- Parallel subagents and in-app OpenSpec. Fan independent assignments out to child chats within your provider's concurrency limit, and install or update OpenSpec from Settings.
- Community usage estimates. Optional anonymous sync contributes provider, model, token, cost, and timing aggregates to a shared evidence base for comparing plan value and usable hours.
- Planning that survives the chat. Turn ideas into scoped OpenSpec plans, queue isolated worktree runs, and keep portable planning data in project files.
- Local-first by default. Projects, prompts, source code, credentials, and terminal output stay on your machine. Anonymous upload can be disabled in Settings under Privacy.
Usage sync never includes prompts, responses, source code, terminal output, secrets, or credentials. It is controlled by separate local collection and anonymous upload settings.
Basebuild's interface is available in English, Simplified Chinese (简体中文), and Traditional Chinese (繁體中文). Pick a language on the first-run screen or in Settings > Appearance > Language. The default follows your system language: Traditional Chinese for zh-TW, zh-HK, and zh-MO; Simplified Chinese for other Chinese languages; English otherwise. Changes apply immediately, including the tray menu. When the interface is Chinese, the assistant replies in that script unless you write in another language. Code, commands, and file contents keep their original language.
Requires Node.js 20+, stable Rust, and the native C or C++ toolchain for your operating system.
npm install
npm run tauri devPackaging commands and platform prerequisites are in
docs/DEVELOPMENT.md.
Read AGENTS.md before making changes. Architecture, testing,
workflow, and design guides live in docs/agents/. Basebuild's
portable planning skills live in skills/.