Docs
GETTING STARTED
What HalfBuilder is, how it works, and how to use it without guessing.
In 60 seconds
What it is: A local Electron IDE with an agent bound to your file + terminal + workspace law.
What it's not: A browser chatbot, a plugin with no context, or a "toy assistant."
Core Model (the three truths)
- Active file is truth. The open tab is the working source of truth.
- Terminal is evidence. Output isn't optional context—it's required.
- Workspace is sovereign. The agent cannot step outside your root folder.
Safety model
- The agent proposes actions in a structured format
- You control what gets applied
- Boundaries prevent "wandering writes"
- Rate limits + verification protect accounts