> ## 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.

# Projects

> List, connect, and initialize projects.

### `initialize_project`

Prepare a newly-connected project: clone the repo, detect the stack, and
stand up its sandbox.

Moves a project from PENDING\_INITIALIZATION toward READY. Runs in the
background and returns immediately — poll list\_projects and read
status\_data.status until it is READY (that's when the project gains the
workspace\_id that start\_task and the setup tools need). Safe to call again
(no-op if the project is already prepared). Requires an admin-level user.

<ParamField path="project_id" type="UUID" required>Project UUID (from list\_projects).</ParamField>
<ParamField path="workspace_id" type="UUID">Workspace UUID if the project already has one; omit for a fresh project.</ParamField>

### `rerun_initialization`

Rerun a failed / needs-action initialization step.

Use when a project's status\_data.status is ERROR or NEEDS\_ACTION after you
have fixed the cause (e.g. set the right install command via
update\_setup\_config). Requires an admin-level user.

<ParamField path="project_id" type="UUID" required>Project UUID.</ParamField>
<ParamField path="initialization_job_id" type="UUID" required>From list\_projects → status\_data.initialization\_job\_id.</ParamField>
<ParamField path="workspace_id" type="UUID">Workspace UUID, if the project has one.</ParamField>

### `list_projects`

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

List the Autonomy projects visible to the authenticated user.

Returns projects grouped by organization. Use this to discover the
project\_id and its workspace\_id needed by the task tools.

<ParamField path="status" type="string">Optional filter, e.g. 'READY' to show only ready projects.</ParamField>

### `list_available_projects`

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

List every repo the org's GitHub App can see, linked or not.

These are the projects you can add with add\_projects. Repos GitHub has
never granted the app won't appear here (install the Autonomy GitHub App on
them first). Requires an admin-level user.

*No parameters.*

### `add_projects`

Add projects to the org's active set (link them for use).

Pass the complete desired set of linked project\_ids — FEI links these and
unlinks the rest. After adding a fresh project, initialize\_project to stand
up its sandbox.

<ParamField path="project_ids" type="array" required>Full set of project UUIDs (from list\_available\_projects) to make visible/usable. This REPLACES the linked set: projects not listed here are unlinked. Requires an admin-level user.</ParamField>