v1.2.0
Builder 1.2.0
Builder 1.2.0 expands the agent runtime around reusable skills, persistent session goals, safer file editing, and Windows installation. It also tightens several terminal and session-continuity edges that show up during long-running work.
Highlights
Embedded Skills
Builder now ships with generated skills that are seeded into the local Builder data directory and discovered automatically. Skills can be disabled or shadowed by user-provided skills with the same name, and /status shows generated skill state so agents and users can see what guidance is active.
This release also adds the first skill-creation guidance and dogfooding skill + AI-readable docs endpoints, making skill authoring easier to bootstrap from inside Builder itself.
Feed docs as https://opensource.respawn.pro/builder/<page>.md to the agent or mention https://opensource.respawn.pro/builder/llms.txt
Session Goals
Sessions can now carry an explicit goal. Use /goal in the TUI or builder goal from the CLI to show, set, pause, resume, clear, or complete a session goal.
Goal state persists across restarts, goal feedback is written into the transcript as first-class activity, and active goals continue when sessions reopen.
Safer File Editing
Builder now has a first-class edit tool alongside patch for compatibility with non-gpt models. The edit tool supports create, replace, and delete operations with strong matching, text/binary guards, atomic writes, symlink warnings, and structured diff metadata.
Windows Installer
Windows users can install Builder with the new PowerShell installer. It installs into ~/.builder/bin, verifies checksums, can prompt for PATH and dependency setup, handles service stop/restart during updates, and writes uninstall metadata.
Terminal And Session Reliability
Several long-running workflow details are smoother in 1.2.0:
- Ask-question prompts render Markdown correctly.
- Queued messages drain after idle without losing order.
- Compaction notifications ring only when attention is needed.
- Partial file reads with
sedinclude total line-count context. - Shell and RPC cancellation messages are clearer.
- Compaction summaries retry when the model attempts an invalid tool call.
- Worktree session context and transcript transitions are more consistent.
- Mouse wheel input works in project pickers.
Original generated changelog
New Features
- add embedded skills, closes #71
- expose builder caller session id
- add session goals
- add edit tool, closes #101
- add Windows installer closes #188
Bug Fixes
- avoid unbounded generated checks
- keep recovered warning lookup nonfatal
- include generated file modes in integrity hash
- hash generated marker from disk
- recover emptied generated roots
- hash generated root directory mode
- ignore recovered warning probe errors
- sync generated assets after root lock
- avoid nilerr on warning provider errors
- randomize tool spinner phases
- reinject meta context in child sessions
- harden goal runtime flow
- address goal review feedback
- stabilize handoff compaction tests
- stabilize goal review regressions
- resolve goal review followups
- persist goal feedback atomically
- harden goal loop and test cleanup
- address goal followup reviews
- stabilize queued steer scrollback test
- reject noop final during active goal
- mark unrestartable goals suspended
- sudo and output code 5 when builder service restart --if-installed
- clarify canceled shell polling closes #198
- render ask question markdown closes #194
- drain queued messages after idle closes #195
- ring when compaction needs attention closes #192
- add file read line counts closes #197
- skip service restart when manual server runs
- wait for launchd server shutdown before bootstrap
- address pr review findings
- handle tail plus line offsets
- validate file-read parsed args
- notify after queued local compaction drain
- parse negative tail line counts
- prevent tests mutating global config
- isolate tests and reduce suite runtime
- address test isolation review findings
- share git test environment sanitizer
- remove redundant config root seed
- address edit tool review findings
- tighten edit review followups
- preserve edit tool override sources
- align edit diff rendering with patch
- retry handoff summaries after tool-call attempts closes #205
- propagate tool selection conflicts
- skip line count marker for full sed ranges
- require full context fallback match
- address reviewer edge cases
- resolve goal command bugs closes #200
- align goal subprocess busy test closes #200
- harden Windows installer CI and arch detection
- use PowerShell hashing in Windows installer CI
- address Windows installer review findings
- decouple generated skill tests from skill names
- resolve subagent worktree workspace context
- consolidate worktree transition transcript
- disable alternate scroll for ongoing overlays
- ignore stale headless workspace context session
- narrow stale workspace context fallback
- include worktree reminder in auto-compaction sizing
- preserve alternate scroll for detail overlays
- reject stale workspace context sessions
- enable mouse wheel for project pickers
Other
- cleanup readme, add new screenshots, improve img quality
- update docs, add release notes skill
- cover recovered warning activation
- Merge pull request #193 from respawn-app/skills
- Merge pull request #196 from respawn-app/goal
- fix worktree mode prompt
- add launchd restart integration helper
- Merge pull request #199 from respawn-app/fixes-1.2
- Merge pull request #203 from respawn-app/faster-tests
- update prompts for 5.5
- cover edit detail diff headline
- Merge pull request #206 from respawn-app/edit-tool
- Merge pull request #207 from respawn-app/fixes-1.2
- Merge pull request #208 from respawn-app/feat/windows-installer
- update docs and add dogfooding skill
- simplify skill and docs significantly
- decouple TUI surfaces from transcript mode
- eliminate legacy TUI inputs
- bump version to 1.2.0
- add sandboxing guide
- Merge pull request #212 from respawn-app/fixes-1.2-part-3
Docs
- update goal prompts
- update skill creator guidance
- add AI-readable docs endpoints