Documentation Index
Fetch the complete documentation index at: https://docs.bricks.tools/llms.txt
Use this file to discover all available pages before exploring further.
Auto-compile
- Auto-compile — background compile gated on actual input changes (
write_file/edit_filetool hooks plus watchers on subspaces, automation-tests,application.json,compile.ts,app.ts,root.ts); errors surface in a banner with an Ask button that hands the failure to the agent.
Sync
- Sync pills next to the Actions menu show whether the server has new commits or the local clone is ahead. Check for Updates in Actions manually triggers a sync check with a brief outcome flash.
- Update Config dialog — pre-flight refuses to push when the server is ahead, awaits inline auto-compile, and propagates compile errors instead of silently pushing a stale build.
- Non-force Pull — separate Pull / Force Pull buttons. Non-force pull branches at the server’s last commit, lands a 3-way merge on
main, and surfaces conflicts as auto-compile errors instead of failing the pull.
Skills
- Skills installer — install third-party skills from a public GitHub repo (e.g.
vercel-labs/skills) or local folder, with recursive skill detection, multi-select, conflict warnings, and Global / Project scope.
Sessions
- Session archive — right-click Archive replaces immediate Delete in the sidebar. New Settings → Archive tab groups archived sessions by project with per-row Recover and two-step Delete forever.
- Rename projects from the sidebar’s more-menu (writes the new name to
application.json; Enter commits, Escape cancels).
Chat
- Ask Question — the agent can pause and ask 1–4 multiple-choice clarifying questions inline in chat, with a Custom free-text fallback per question.
/compactslash command — manually compact the conversation without waiting for the context limit (the popup hides the entry when the compactor wouldn’t find a useful cut). Supports an optional follow-up prompt.- Custom Instruction now has an explicit Save button (no more blur-triggered autosave). The persisted block is scoped: user wording is treated as a personal rule but prior system-prompt rules win on conflict.
- Main agent recognizes share-app URLs (
control.bricks.tools/#/create-share-app,share.bricks.tools/app/) and hands off to the BRICKS CLI share-app workflow.
Other
- Other performance and stability improvements.
Preview
- Draw mode — annotate the embedded preview with a pen overlay and attach the composite (preview screenshot + strokes) to the chat input.
Chat
- Workspace profile selector in the chat input — project chats display the project’s workspace; main chat lets you switch the active auth profile (with a confirmation step since it rebuilds the agent’s system prompt).
- Long sessions paginate with inline “Show N hidden replies” buttons (fully-rendered window capped to 50 messages).
- Tool-call file content (
write_file/edit_file/read_file) renders as syntax-highlighted code or a unified diff with expand-to-full-size; streaming bodies update token-by-token. - Brand animation plays alongside the elapsed timer while the agent is running.
- Streaming render is rAF-coalesced and historical bubbles short-circuit; new markdown blocks fade and slide in as they arrive.
- Render an image attachment only when the active model supports vision; cap chat image preview (80px) and rendered image (400px) heights.
- Chat input auto-resizes when prompts are set programmatically (Inspect, popped-out preview, history nav, etc.).
Agent
- System notification and sound when an agent run finishes or needs approval and the app is off-focus (toggle in Settings → Agent).
- New
set_session_titletool summarizes the current task into a sidebar-fit title. - Agent loads matching skills when you type
/<skill-name>in chat. - Allow
read_filewith absolute paths inside the project directory. - Auto-recover from
context_length_exceedederrors via on-demand compaction and automatic retry; the context indicator drops immediately after compaction.
Local Devices
- Scan and integrate discovered buttress-servers via “Ask Agent to integrate” (multi-select supported; selection is mutually exclusive with devtools rows).
Settings
- Accent color in Settings → Appearance.
Sidebar and window
- Window background blur supported on the light theme.
- Top bar collapses Diff / Open in editor / Actions / Open Controller to icons on narrow widths so it stays single-line.
- Larger sidebar section title bars; drop the default chat-bubble icon from regular sessions.
- Remember the Controller window position and size.
Models
- Preserve
reasoning_contentforkimi-k2.5/kimi-k2.6via opencode / opencode-go.
Other
- Self-update BRICKS CLI in the background for binary installs (npm/bun-managed installs are not modified).
- React error boundary catches render crashes, reports to Bugsnag, and shows a reload-able fallback.
- Other stability improvements.
Fixes
- Eliminate “Agent is already processing” races during multi-turn runs and queued-input auto-send.
Chat
- Main Chat — project-agnostic agent for general BRICKS workflows. The empty state surfaces a provider setup guide, a Local Devices panel, and an Open BRICKS Controller shortcut. Sidebar splits into Projects and Chat sections.
- Pinned Sessions — starred sessions appear in a dedicated sidebar section.
- Render mermaid diagrams in chat with the BRICKS theme.
Providers
- API key test validation in Settings → Providers for Anthropic, OpenAI /
baseUrl, Google AI Studio, Google Vertex, OpenAI Codex, and custom providers.
Models
- New opencode provider models:
kimi-k2.6anddeepseek-v4-flash/deepseek-v4-pro. Theopencode-godefault is bumped tokimi-k2.6. See models.
Sandbox
- Detect dangerous bash commands and force a permission prompt. See sandbox.
Sidebar and window
- Narrower minimum sidebar width with compact polish; bottom actions moved to the Projects header.
- macOS: reclaim titlebar space in fullscreen.
- Widen the controller drag strip without blocking clicks underneath.
Preview
- Send theme changes to the preview pane.
- Always show the DevTools button on local devices; non-probed devices prompt for a passcode. Local Devices renders as an inline chat panel.
- Disable the inner preview title bar.
- DevTools / CDP screencast is disabled by default.
Settings
- Reuse the chip-style Model / Thinking selectors from the chat input.
- Jump from the ACP indicator to its setting.
Other
- “Open Folder in CTOR” Finder Service for macOS.
- Add a Changelog link to the Help menu.
- Limit Open Project scan to immediate subdirectories.
- Cut
git index.lockcontention from the watcher fan-out during deploy / pull / update. - Other stability improvements.
Fixes
- Clear stale chat when removing a project.
- Constrain the login OTP input to the server’s 5-letters + 4-digits format.
- Don’t navigate input history during IME composition.
- Stop persisting default allowed sandbox domains so future default updates reach existing users.
- Dedupe API error notifications and clear stale messages on session switch.
- Keep Auth0 redirects inside the controller window so login completes in-app.
Models
- New defaults:
openai/gpt-5.5for OpenAI andopenai-codex/gpt-5.5for Codex. See models. gpt-5.3-codex-sparkis now gated to the ChatGPT Pro plan.
Providers
- New Google Agent Platform (Vertex AI) provider.
- Cancel and delete buttons in the provider add/edit form.
- Profile name is derived from the ID token on token login.
Window
- New Pin Window toggle in the Window menu.
- Frameless transparent Controller window with dark background blur.
Sidebar
- Resizable width.
- Newly added projects appear at the top.
- New session button on the collapsed sidebar’s top bar.
Chat
- Native context menu in chat and input fields.
- Banners aligned to chat content width.
- Collapsible prompt preview blocks.
- Custom instructions per agent.
Images
- Image previews in the diff pane.
- New imagegen skill controls.
- Markdown images render relative to the project path.
Sandbox
- Network allowlist now permits Activity Log domains.
- Refresh agent environment when reusing an agent.
Other
- Agent Client Protocol server expanded to support additional agent clients.
- Startup requirements screen for BRICKS CLI, Bun, and Git.
- Refined elevated background and primary text theme colors.
- Hide disabled or uninstalled skills from chat input.
Fixes
- Chat input no longer submits on Enter during IME composition.
- Edited message resend uses the correct model fallback.
- Include all generated and post-install paths when staging an update.
- Resolve missing migration after the CTOR rename.
Initial preview release of CTOR, the new desktop IDE for building BRICKS applications.
Highlights
- AI-agent conversational workflow — build BRICKS applications by chatting with the built-in AI agent. Review file edits and tool calls in the integrated diff view.
- Integrated Controller view — preview and manage your workspace directly from the desktop app, without switching to the web.
- Web Preview CDP bridge — external CDP clients (Chrome DevTools, Playwright,
bricks devtools) can connect to the CTOR preview via a local WebSocket server. Currently available in CTOR only.