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

# Setup

> Configure commands, environment variables, and validation.

### `list_env_vars`

<Icon icon="eye" /> Read-only

List a project's environment variables (direct config — no setup agent).

Includes vars requested by auto-detect (pending) and vars with stored values.
Values are masked unless show\_values=true; use has\_stored\_value to tell a
masked value apart from an unset pending var. Use this to see what env the
project needs, then set\_env\_var to fill it in.

<ParamField path="project_id" type="UUID" required>Project UUID.</ParamField>
<ParamField path="show_values" type="boolean" default="False">Reveal actual values instead of masking them.</ParamField>

### `set_env_var`

Create or update a project environment variable directly (upserts by name).

This is the direct-config path: the user's own AI sets env from the local
repo/.env it already has, rather than puppeteering Autonomy's setup agent.

<ParamField path="project_id" type="UUID" required>Project UUID.</ParamField>
<ParamField path="name" type="string" required>Env var name (letters, digits, underscore; must not start with a digit).</ParamField>
<ParamField path="value" type="string" required>Value to store for the variable.</ParamField>
<ParamField path="description" type="string">Optional human description of what the variable is for.</ParamField>

### `get_setup_config`

<Icon icon="eye" /> Read-only

Get the workspace's setup commands (install / validate / dev) and their status.

<ParamField path="project_id" type="UUID" required>Project UUID.</ParamField>
<ParamField path="workspace_id" type="UUID" required>Workspace UUID.</ParamField>

### `update_setup_config`

Set the workspace's install / validate / dev commands for setup.

<ParamField path="project_id" type="UUID" required>Project UUID.</ParamField>
<ParamField path="workspace_id" type="UUID" required>Workspace UUID.</ParamField>
<ParamField path="install_command" type="string" required>Install command, e.g. 'npm install'.</ParamField>
<ParamField path="validate_command" type="string" required>Validate command, e.g. 'npx tsc --noEmit'.</ParamField>
<ParamField path="dev_command" type="string" default="">Dev server command, e.g. 'npm run dev'. Optional.</ParamField>
<ParamField path="dev_url" type="string" default="">Dev server URL, e.g. '[http://localhost:5173](http://localhost:5173)'. Optional.</ParamField>

### `get_setup_preview_status`

<Icon icon="eye" /> Read-only

Live status of the workspace dev server (is it listening, preview URL).

<ParamField path="project_id" type="UUID" required>Project UUID.</ParamField>
<ParamField path="workspace_id" type="UUID" required>Workspace UUID.</ParamField>

### `run_setup_validation`

Validate the project's configured setup in a fresh sandbox.

Runs the workspace's saved install + validate commands (set via
update\_setup\_config) on a clean sandbox to confirm they work. Runs in the
background (install takes minutes) — returns immediately with state=running;
poll get\_setup\_validation\_status until state is completed/error. Only the
saved commands run — no arbitrary execution.

<ParamField path="project_id" type="UUID" required>Project UUID.</ParamField>
<ParamField path="workspace_id" type="UUID" required>Workspace UUID.</ParamField>

### `get_setup_validation_status`

<Icon icon="eye" /> Read-only

Poll the result of run\_setup\_validation.

Returns state (idle/running/completed/error) and, when completed,
success + install\_success + validate\_success + per-step results. Read the
steps' output to see why install/validate failed.

<ParamField path="project_id" type="UUID" required>Project UUID.</ParamField>
<ParamField path="workspace_id" type="UUID" required>Workspace UUID.</ParamField>