list_env_vars
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.
UUID
required
Project UUID.
boolean
default:"False"
Reveal actual values instead of masking them.
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.
UUID
required
Project UUID.
string
required
Env var name (letters, digits, underscore; must not start with a digit).
string
required
Value to store for the variable.
string
Optional human description of what the variable is for.
get_setup_config
Read-only
Get the workspace’s setup commands (install / validate / dev) and their status.
UUID
required
Project UUID.
UUID
required
Workspace UUID.
update_setup_config
Set the workspace’s install / validate / dev commands for setup.
UUID
required
Project UUID.
UUID
required
Workspace UUID.
string
required
Install command, e.g. ‘npm install’.
string
required
Validate command, e.g. ‘npx tsc —noEmit’.
string
default:""
Dev server command, e.g. ‘npm run dev’. Optional.
string
default:""
Dev server URL, e.g. ‘http://localhost:5173’. Optional.
get_setup_preview_status
Read-only
Live status of the workspace dev server (is it listening, preview URL).
UUID
required
Project UUID.
UUID
required
Workspace UUID.
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.
UUID
required
Project UUID.
UUID
required
Workspace UUID.
get_setup_validation_status
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.
UUID
required
Project UUID.
UUID
required
Workspace UUID.