Builder
Builder is a highly opinionated terminal coding agent for professional Agentic Engineers, focusing on output quality.
Get started
Everything you need is in the Quicktart Guide - start there.
Features:
- Agentic loop with
shell,ask_question,patchtools. - Native local image/PDF attachment tool (
view_image) for path-based multimodal reading. - Explicit clipboard screenshot paste hotkeys (
Ctrl+V,Ctrl+D) that insert temp image paths into the prompt. - Support for Codex login and OpenAI api keys.
- Compaction, including auto, using native Codex/OpenAI endpoints, or our own custom prompt.
- Compact UI mode for ongoing work, and detailed mode to review thinking, tool calls, prompts, summaries.
- Queueing messages, steering the model (Tab to queue, Enter to steer)
- Asking interactive questions
- Terminal and system notifications for asks/approvals and turn completion
- Config file with model selection, tool config, compact threshold, timeouts.
- Local and global
AGENTS.mdsupport - Session and history persistence and resumption
- Markdown rendering
- Saved prompts
- Syntax highlighting
- Native Web search (for now only OpenAI)
- Calling shell directly via
$ - Premade prompts for review, compaction, init.
- Esc-esc-style editing of messages and history rewrites
- Agent skills support
- Background shells, which enable subagents via headless mode:
builder run - Model verbosity for openai models
- Native terminal scrollback, selection, copy-paste
-
/fastmode - Native code review
What will likely never be implemented
These features are controversial or questionable for model performance, and usually have a better replacement. Here is where this project has to be highly opinionated:
- Native subagent orchestration inside one process; use separate headless Builder instances instead.
- Supported path:
builder run "..."for tmux/background subagent workflows. Agent already does this on its own.
- Supported path:
- Plan mode - the model has native plan capabilities and can always ask questions, rest is just eye candy.
- MCPs - mcps are net negative on model performance, pollute context, and can be replaced with CLI scripts
- Extra UI candy tool calls. Less tools, less burden on the model.
- On the fly changing of toolsets or models. Changing models at runtime hurts model performance and invalidates caches.
- Microcompaction - this invalidates caches and drives costs up with marginal benefits
- Sandboxing - Codex’s sandbox is annoying, doesn’t work with many tools (gradle, java etc), junie’s sandbox can be bypassed, claude code’s sandbox is brittle and can also be bypassed. Frontier models are not so stupid anymore and are trained not to destroy your PC.
- WebFetch tool or similar. Just use jina.ai to fetch urls.
- Fancy summaries, UI, minimal mode, features for “vibe coding”. The philosophy is to build something for professionals (agentic engineers)
- Anthropic, Gemini, Antigravity subscription usage. Not until that becomes legal.
License
Builder is licensed under AGPL-3.0-only. See LICENSE.
IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITINGWILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYSTHE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANYGENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THEUSE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OFDATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRDPARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OFSUCH DAMAGES.