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

# Projects

> `gcai projects` commands.

## `gcai projects list`

List projects

```bash theme={null}
gcai projects list [--limit <number>] [--offset <number>] [--search <value>]
```

| Flag                | Type     | Required | Description                                      |
| ------------------- | -------- | -------- | ------------------------------------------------ |
| `--limit <number>`  | `number` |          | Max items to return (default 100, max 500)       |
| `--offset <number>` | `number` |          | Number of items to skip (default 0)              |
| `--search <value>`  | `string` |          | Case-insensitive substring match on project name |

Wraps `GET /projects` — see [List projects](/api-reference/list-projects) for full parameter semantics.

## `gcai projects create`

Create a project

```bash theme={null}
gcai projects create <name> [--description <value>] [--custom-instructions <value>] [--is-access-controlled]
```

| Flag                            | Type      | Required | Description                                                                                                                                          |
| ------------------------------- | --------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--description <value>`         | `string`  |          | Optional project description                                                                                                                         |
| `--custom-instructions <value>` | `string`  |          | Optional custom instructions for chats in this project                                                                                               |
| `--is-access-controlled`        | `boolean` |          | When true (default), the project is visible only to the creator and explicitly granted users. When false, any member of the organization can see it. |

Wraps `POST /projects` — see [Create a project](/api-reference/create-project) for full parameter semantics.

## `gcai projects get`

Get a project

```bash theme={null}
gcai projects get <id>
```

Wraps `GET /projects/{id}` — see [Get a project](/api-reference/get-project) for full parameter semantics.

## `gcai projects update`

Update a project

```bash theme={null}
gcai projects update <id> [--name <value>] [--description <value>] [--custom-instructions <value>]
```

| Flag                            | Type     | Required | Description                                                              |
| ------------------------------- | -------- | -------- | ------------------------------------------------------------------------ |
| `--name <value>`                | `string` |          | New project name (non-empty after trim)                                  |
| `--description <value>`         | `string` |          | New project description, or null to clear it                             |
| `--custom-instructions <value>` | `string` |          | New custom instructions for chats in this project, or null to clear them |

Wraps `PATCH /projects/{id}` — see [Update a project](/api-reference/update-project) for full parameter semantics.

## `gcai projects delete`

Delete a project

```bash theme={null}
gcai projects delete <id>
```

Wraps `DELETE /projects/{id}` — see [Delete a project](/api-reference/delete-project) for full parameter semantics.

## `gcai projects attach-file`

Attach a file to a project

```bash theme={null}
gcai projects attach-file <id> <file_id>
```

Wraps `POST /projects/{id}/files` — see [Attach a file to a project](/api-reference/attach-file-to-project) for full parameter semantics.

## `gcai projects detach-file`

Detach a file from a project

```bash theme={null}
gcai projects detach-file <id> <fileId>
```

Wraps `DELETE /projects/{id}/files/{fileId}` — see [Detach a file from a project](/api-reference/detach-file-from-project) for full parameter semantics.

## `gcai projects files`

List files on a project

```bash theme={null}
gcai projects files <id> [--limit <number>] [--offset <number>]
```

| Flag                | Type     | Required | Description                                |
| ------------------- | -------- | -------- | ------------------------------------------ |
| `--limit <number>`  | `number` |          | Max items to return (default 100, max 500) |
| `--offset <number>` | `number` |          | Number of items to skip (default 0)        |

Wraps `GET /projects/{id}/files` — see [List files on a project](/api-reference/list-project-files) for full parameter semantics.

## `gcai projects folders`

List folders linked to a project

```bash theme={null}
gcai projects folders <id> [--limit <number>] [--offset <number>]
```

| Flag                | Type     | Required | Description                                |
| ------------------- | -------- | -------- | ------------------------------------------ |
| `--limit <number>`  | `number` |          | Max items to return (default 100, max 500) |
| `--offset <number>` | `number` |          | Number of items to skip (default 0)        |

Wraps `GET /projects/{id}/folders` — see [List folders linked to a project](/api-reference/list-project-folders) for full parameter semantics.

## `gcai projects attach-folder`

Attach a folder to a project

```bash theme={null}
gcai projects attach-folder <id> <folder_id>
```

Wraps `POST /projects/{id}/folders` — see [Attach a folder to a project](/api-reference/attach-folder-to-project) for full parameter semantics.

## `gcai projects detach-folder`

Detach a folder from a project

```bash theme={null}
gcai projects detach-folder <id> <folderId>
```

Wraps `DELETE /projects/{id}/folders/{folderId}` — see [Detach a folder from a project](/api-reference/detach-folder-from-project) for full parameter semantics.

## `gcai projects star`

Star a project

```bash theme={null}
gcai projects star <id>
```

Wraps `POST /projects/{id}/star` — see [Star a project](/api-reference/star-project) for full parameter semantics.

## `gcai projects unstar`

Unstar a project

```bash theme={null}
gcai projects unstar <id>
```

Wraps `DELETE /projects/{id}/star` — see [Unstar a project](/api-reference/unstar-project) for full parameter semantics.

## `gcai projects chats`

List chats in a project

```bash theme={null}
gcai projects chats <id> [--limit <number>] [--offset <number>]
```

| Flag                | Type     | Required | Description                                |
| ------------------- | -------- | -------- | ------------------------------------------ |
| `--limit <number>`  | `number` |          | Max items to return (default 100, max 500) |
| `--offset <number>` | `number` |          | Number of items to skip (default 0)        |

Wraps `GET /projects/{id}/chats` — see [List chats in a project](/api-reference/list-project-chats) for full parameter semantics.

## `gcai projects attach-chat`

File a chat into a project

```bash theme={null}
gcai projects attach-chat <id> <chat_id>
```

Wraps `POST /projects/{id}/chats` — see [File a chat into a project](/api-reference/attach-chat-to-project) for full parameter semantics.