Skip to main content

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.

May 20, 2026
ReleasePreview
v2.24.4

Auto-compile

  • Auto-compile — background compile gated on actual input changes (write_file / edit_file tool 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.
  • /compact slash 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.
May 13, 2026
ReleasePreview
v2.24.3

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_title tool summarizes the current task into a sidebar-fit title.
  • Agent loads matching skills when you type /<skill-name> in chat.
  • Allow read_file with absolute paths inside the project directory.
  • Auto-recover from context_length_exceeded errors 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.
  • 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_content for kimi-k2.5 / kimi-k2.6 via 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.
May 4, 2026
ReleasePreview
v2.24.2

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.6 and deepseek-v4-flash / deepseek-v4-pro. The opencode-go default is bumped to kimi-k2.6. See models.

Sandbox

  • Detect dangerous bash commands and force a permission prompt. See sandbox.
  • 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.lock contention 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.
April 29, 2026
ReleasePreview
v2.24.1

Models

  • New defaults: openai/gpt-5.5 for OpenAI and openai-codex/gpt-5.5 for Codex. See models.
  • gpt-5.3-codex-spark is 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.
  • 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.
April 22, 2026
ReleasePreview
v2.24.0
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.
See the installation guide for downloads.