> ## Documentation Index
> Fetch the complete documentation index at: https://oxy.tech/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Builder Agent, Workspace Management, and Thinking Budget

> New builder copilot agent, multi-workspace deployment modes with member management, and extended thinking toggle

<Icon icon="calendar" iconType="regular" size={16} /> **April 9, 2026**

### New Features

#### Builder Agent

A new builder copilot agent that can read, modify, and iterate on your Oxygen project files through an AI-driven pipeline:

* **Project File Operations** — Reads and writes configuration files, workflows, and semantic definitions within your project
* **SQL Execution** — Runs queries against project databases as part of the build process to validate changes in real time
* **Agentic Pipeline** — Built on the same FSM framework as analytics agents, with full support for suspension, tool use, and result interpretation

<img src="https://mintcdn.com/oxy-internal/zm7JajAmecGGvtqn/changelog/images/2026-04-09/builder-agent.png?fit=max&auto=format&n=zm7JajAmecGGvtqn&q=85&s=33581b1b9d7f2fd6cd9f731b27923079" alt="Builder agent interface with Build mode and Auto-approve option" width="1274" height="978" data-path="changelog/images/2026-04-09/builder-agent.png" />

#### Workspace Management

Oxygen now ships with three distinct deployment modes depending on your setup:

| Mode                    | Command             | Use when                                                                |
| ----------------------- | ------------------- | ----------------------------------------------------------------------- |
| Local machine           | `oxy start`         | Running on your laptop — PostgreSQL auto-managed in Docker              |
| Remote server           | `oxy serve --local` | Deploying to a VM or container with a single fixed workspace            |
| Cloud / multi-workspace | `oxy serve`         | Multi-tenant platform where users manage multiple workspaces via the UI |

* **Multi-Workspace Mode** — Users import repositories from GitHub and switch between workspaces directly from the UI. Requires an external PostgreSQL database and a GitHub App.
* **Local Mode (`--local`)** — Serves one fixed workspace directory with an embedded PostgreSQL instance on disk — no Docker required.
* **Onboarding Flow** — First-time workspace setup is guided through the UI when no projects are detected.

<img src="https://mintcdn.com/oxy-internal/zm7JajAmecGGvtqn/changelog/images/2026-04-09/workspace-management.png?fit=max&auto=format&n=zm7JajAmecGGvtqn&q=85&s=618ecc5f1a28a7520be7959e7614b741" alt="Workspaces management page showing multiple workspace cards" width="1784" height="1748" data-path="changelog/images/2026-04-09/workspace-management.png" />

<img src="https://mintcdn.com/oxy-internal/zm7JajAmecGGvtqn/changelog/images/2026-04-09/workspace-switcher.png?fit=max&auto=format&n=zm7JajAmecGGvtqn&q=85&s=d5a13fed86baae146ec8b22e5773fbf7" alt="Workspace switcher in the sidebar" width="1804" height="788" data-path="changelog/images/2026-04-09/workspace-switcher.png" />

#### Workspace Member Management

Multi-workspace deployments now support role-based access control for workspace members:

* **Owner Role** — Set `OXY_OWNER` to an email address; that user receives the Owner role on login and can promote others to Admin through the UI
* **Invite Members** — Workspace owners can invite members directly from the Members page
* **Role Management** — Manage member roles (Owner, Admin, Member) without touching server configuration

<img src="https://mintcdn.com/oxy-internal/zm7JajAmecGGvtqn/changelog/images/2026-04-09/workspace-members.png?fit=max&auto=format&n=zm7JajAmecGGvtqn&q=85&s=c1a8bb1ed357dd7bcc240bfcf78611f2" alt="Workspace members page with Owner and Member roles" width="1754" height="1848" data-path="changelog/images/2026-04-09/workspace-members.png" />

#### Thinking Budget Toggle

Analytics agents now expose an extended thinking toggle in the UI:

* **Extended Thinking Mode** — Enable to give the agent a larger reasoning budget, improving answer quality for complex or ambiguous analytical questions
* **Per-State Model Overrides** — Configure different LLM models for individual pipeline states in `.agentic.yml` for fine-grained cost and quality control

```yaml theme={null}
states:
  clarifying:
    model: claude-opus-4-6
    max_retries: 10
  solving:
    model: claude-sonnet-4-6
    max_retries: 10
```

<img src="https://mintcdn.com/oxy-internal/zm7JajAmecGGvtqn/changelog/images/2026-04-09/thinking-budget-toggle.png?fit=max&auto=format&n=zm7JajAmecGGvtqn&q=85&s=fd7a3de08da1f730681a2cff6670d5aa" alt="Thinking budget toggle in the agent selector dropdown" width="1262" height="1518" data-path="changelog/images/2026-04-09/thinking-budget-toggle.png" />

***

### Platform Improvements

#### UI/UX Consistency

* **Editable Filters and Ordering** — Filters and sort order in the agentic workflow panel are now fully editable, consistent with measures and dimensions
* **Procedure Graph Fixes** — Resize handle no longer appears before a run starts; running state animation now correctly reflects concurrent loop execution across all branches
* **Unified Loading States** — Consistent skeleton and spinner components across threads, analytics, app-builder, and other pages
* **Color System** — Migrated hardcoded colors to CSS custom properties for consistent theming in both light and dark mode
* **Unified Error Display** — Single `ErrorAlert` component replaces scattered error patterns throughout the app
* **Login Page** — Updated to the latest logo; fixed `or` separator background color inconsistency
* **Favicon** — Updated for better visibility across light and dark browser themes

#### Deployment Documentation

* **Deployment Modes Guide** — Updated deployment docs now clearly distinguish between single-workspace (local) and multi-workspace modes, with step-by-step environment variable setup, variable reference tables, and AWS SSM usage examples
* **GitHub App Integration Guide** — New dedicated guide for setting up a GitHub App for workspace import and Git integration in multi-workspace mode

#### Error Handling

* **Environment Variable Validation** — Missing required environment variables now cause a startup failure with a clear error message instead of silently falling back to empty strings, preventing misconfigured deployments from reaching production undetected