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

# Workspace Settings

> Configure one workspace's repository identity, chat defaults, instructions, Git behavior, integrations, monitoring, and stored threads.

Workspace Settings applies to the currently selected repository and project name. The pages below follow the exact sidebar order and link to dedicated feature references where setup details belong.

## Scope

Open settings from a selected workspace. Settings are grouped as **Workspace**, **Integrations**, **Monitor**, and **Data**; they do not change other workspaces unless a linked provider is explicitly account-scoped.

## Workspace

### General

**Workspace → General** controls repository identity and the defaults used by new chats.

| Field                  | Effect                                                                   |
| ---------------------- | ------------------------------------------------------------------------ |
| Project name           | Display name used throughout Aiola; maximum 80 characters                |
| Workspace Location     | Read-only local folder path                                              |
| Workspace Logo         | Image shown for the workspace in the sidebar                             |
| Default Agent          | Agent preselected when workspace chat opens, or **No agent**             |
| Default Provider       | Provider preselected for a new thread                                    |
| Default Model          | Model preselected for a new thread                                       |
| Default Reasoning      | Supported thinking level preselected for a new thread                    |
| Default Context Window | Supported token window preselected for a new thread                      |
| Default Fast Mode      | **On** or **Off**; shown only when the selected model supports fast mode |
| Default Mode           | Permission mode preselected for new threads                              |

The **Danger zone → Delete Workspace → Delete** flow removes the workspace and its agents. Its optional cleanup switches cover local data, analytics, feedback, app logs, API keys, and sourcemaps when those records exist; confirmation requires typing `DELETE`.

### Instructions

**Workspace → Instructions** stores prompts used by actions in this workspace.

| Section         | Controls                                                                                                                           |
| --------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| Dashboard       | Empty-state prompt buttons; edit icons/text, add prompts, or remove prompts                                                        |
| Analysis        | GitHub Issue Analysis, Pull Request Analysis, Bug Report Analysis, Feature Request Analysis, App Logs Analysis, Analytics Analysis |
| Fix & Implement | GitHub Issue Fix, PR Check Fix, Bug Fix, Feature Implementation, App Logs Fix, Indexing Fix                                        |

Hosted-only prompt rows are omitted for GUI Lifetime. See [Custom Instructions](/core-features/custom-instructions) for prompt behavior.

### Git

**Workspace → Git** connects and configures the repository.

| Section    | Controls                                                                                                    |
| ---------- | ----------------------------------------------------------------------------------------------------------- |
| Repository | Current remote or a Git URL to connect                                                                      |
| Activity   | Repository status and recent activity                                                                       |
| Branches   | Branch prefix                                                                                               |
| Worktrees  | Run App Logs, Feedback, and GitHub issue actions in a worktree                                              |
| Automation | Comment after issue fix/analysis, close after fix, comment after PR review, and auto-close duplicate issues |

See [Git and GitHub](/core-features/git-and-github) for repository and automation behavior.

### Tasks

**Workspace → Tasks** sets the **Default run mode** to `Worktree` or `Local` and toggles **Auto-create PR after task completes**. See [Tasks](/core-features/tasks) for task execution and status behavior.

### Environment

**Workspace → Environment** scans every `.env` file inside the workspace. It groups files by folder, masks keys whose names indicate secrets, lets you reveal values, edit/add/delete variables, compare files, rescan, and add exposed files to `.gitignore`.

The **Actions** section stores a `Name` and multiline `Command`; saved actions appear in the local toolbar and can execute any command. See [Environment Variables](/core-features/environment-variables) for the security model.

## Integrations

### API Key

**Integrations → API Key** manages the project key used by Feedback and App Logs. It displays the key hint, last-used time, and creation time, and exposes generation, regeneration, and revocation. See [API Key](/core-features/api-key) before rotating a live integration.

### Integrations

**Integrations → Integrations** connects analytics services: a per-project Stripe restricted key and account-level Google Search Console or Bing Webmaster accounts, followed by per-site mappings. See [Integrations](/core-features/integrations) for prerequisites and disconnect effects.

### MCP Servers

**Integrations → MCP Servers** manages the local, per-workspace MCP bridge and custom servers. Add a named JSON configuration for a `stdio` or `http` server, toggle a server, expand it to discover tools, or delete a non-Aiola server. See [MCP Servers](/core-features/mcp-servers); the always-online remote service is documented separately in [Hosted MCP Server](/core-features/hosted-mcp).

## Monitor

### App Logs

**Monitor → App Logs** configures SDK or raw-HTTP error collection and sourcemaps for this project. See [App Logs](/core-features/app-logs) for the data contract and [Set Up App Logs](/guides/set-up-app-logs) for implementation.

### Feedback

**Monitor → Feedback** builds the Bug Report and Feature Request forms and generates integration code. See [Feedback](/core-features/feedback) and [Set Up Feedback](/guides/set-up-feedback).

### Analytics

**Monitor → Analytics** creates or configures the project's analytics site, tracking domain, exclusions, search/revenue mappings, protection, and data controls. See [Analytics](/core-features/analytics) and [Set Up Analytics](/guides/set-up-analytics).

## Data

### Archived Threads

**Data → Archived Threads** lists archived conversations for this workspace and provides **Unarchive thread**. There is no Central archive. See [Archived Threads](/core-features/archived-threads).

## GUI Lifetime

For GUI Lifetime, the settings sidebar hides **API Key**, **Integrations**, **App Logs**, and **Analytics**. Direct hosted routes are gated, including **Feedback**. The local MCP page remains, but filters out the hosted Aiola entry; arbitrary local `stdio` and `http` servers continue to work.