The app builder now includes a debug console to help you inspect your app, surface issues, and resolve them with the agent. Open it from the status bar at the bottom of the app builder.

The console has three tabs:

• Errors: Function, build, and frontend errors. Hover a row to add its context to the chat or ask the agent to fix it, or click Fix all to resolve every error at once.
• Logs: Logs emitted by the app or the agent, including function, build, frontend, sandbox, agent, and git events.
• Timeline: A record of function runs with the elapsed time and the success of each, useful for diagnosing performance issues.

The agent has access to the same information available to builders in the debug console. This enables the agent to disagnose and address issues more quickly, and it can write more performant functions.

Multi-instance releases are now supported for apps built in the new app builder, in addition to classic apps and workflows. To enable multi-instance releases, navigate to Settings > Source control > Edit settings and turn on Enable multi-instance releases.

Organizations using Source Control can manage releases of protected apps, classic apps, and workflows across multiple deployment instances. This feature enables you to publish different release versions across instances, making it possible to test a newer version on staging or development instances before promoting to production.

Multi-instance releases work slightly differently for apps and classic apps. Learn more about the difference, or get started with multi-instance releases for apps.

You can now use Plan mode for further control over the actions that the app building agent takes.

1. Click to switch from Build mode to Plan mode and tell the agent what changes you want it to make.
2. The agent creates a comprehensive plan, which is written as a Markdown file in the .plan folder. Click Review to view the file.
3. Review the plan, and switch to the Markdown tab to make any changes. You can also ask the agent to update the plan.
4. When you're ready, click Build plan.

Organization admins can now add shared building context that applies to all apps built with the new app builder. Building context is applied as custom instructions in the system prompt when the user makes any changes via prompting in the Chat tab, similar to the way AGENTS.md files work. Building context is valuable for defining design practices, coding conventions, data usage recommendations, and other guidelines across your organization.

To add shared context, navigate to Settings > Building context. Add your instructions in Markdown format, and click Publish to apply your changes to all apps.

Building context applies to all apps in your organization. If you have Spaces enabled, it applies to all apps in your space.

The app builder now supports multiple chat conversations (threads) working on the same branch rather than a single thread per branch.

A thread is a single chat conversation with the agent in the Chat tab. Threads are intended to help you keep your work organized by task or theme. For example, use one thread for updating your app theme, and another thread for editing a chart on that page. Manage threads from the Chat tab.

A branch is a set of changes to your app, associated with an app preview, and with its own change history. A branch is the unit of work that you publish, and you create a new branch to begin a distinct line of work. For example, create a new branch when you want to change the resources that your app uses, or when you want to overhaul a page. Manage branches from the Change History tab in the navbar.

When using Source Control, branches in the protected app builder map to branches in your external git repository.

For Enterprise organizations that use Source Control to protect apps, you can now use the app builder to check out a branch that you created outside of Retool. This enables you to transition your changes from a local development environment to the app builder. This can be useful for visually validating your changes in the preview canvas.

You can now build apps with more AI models: Claude Sonnet 5, the GPT-5.6 models (Sol, Terra, and Luna), and Claude Fable 5. Choose a model for each thread in the app builder's Chat tab. Admins can set the organization's default app building provider and model in the AI settings.

Claude Sonnet 5 can be used on paid plans with a Retool-managed key or your own key. The GPT-5.6 models and Claude Fable 5 require you to bring your own key, which is available on the Enterprise plan.

You can now upload files to be used as assets in your app through the Chat tab in the app builder. Previously, uploaded files could only be used as context for the agent.

Common use cases for uploaded files as assets include:

• Embedding PDFs.
• Adding a company logo to the app header.
• Presenting images within the app.

You can now trigger workflows from functions in the new app builder. Converting classic apps that trigger workflows is now supported as a result.

To trigger a workflow from your app, open the Chat tab and prompt your agent with the workflow's name.

The triggered workflow is run on behalf of the app's authenticated user.

Classic apps that include custom components and organization-level themes can now be converted to the new app building experience.

To support custom components, the agent investigates the custom component and recreates it in the converted app with as few changes as possible.

To support classic organization-level themes, the agent applies the same style, color, and typography to the app as were represented in the organization-level theme. The agent does not create a new organization-level theme that applies to apps created with the new app builder.