gcai files CLI commands

`gcai files upload`

Upload a file

gcai files upload <file> [--folder-id <value>] [--project-id <value>] [--scope <my-files|organization>]

Flag	Type	Description
`--folder-id <value>`	`string`	Target folder ID. Defaults to the user’s “My Files” folder. Mutually exclusive with `project_id` and `scope`.
`--project-id <value>`	`string`	Upload the file into a project. The file is placed in the project’s upload folder and linked to the project. Mutually exclusive with `folder_id` and `scope`.
`--scope <my-files\|organization>`	`my-files \| organization`	Upload to the root of a meta-collection (“my-files” or “organization”). Mutually exclusive with `folder_id` and `project_id`. `shared-with-me` is not valid for upload.

Wraps POST /files — see Upload a file for full parameter semantics.

Search files

gcai files search <q> [--scope <my-files|shared-with-me|organization>] [--project-id <value>]

Flag	Type	Required	Description
`--scope <my-files\|shared-with-me\|organization>`	`my-files \| shared-with-me \| organization`		Optional scope filter (user-scoped keys only). When omitted, searches all files the user can read. Mutually exclusive with `project_id`.
`--project-id <value>`	`string`		Optional project filter. Constrains the search to files linked to this project. Mutually exclusive with `scope`.

Wraps GET /files — see Search files for full parameter semantics.

Get file status

gcai files get <id>

Wraps GET /files/{id} — see Get file status for full parameter semantics.

Move a file

gcai files move <id> --folder-id <value>

Flag	Type	Required	Description
`--folder-id <value>`	`string`	yes	Target folder ID to move the file to. Pass null to move to the root.

Wraps PATCH /files/{id} — see Move a file for full parameter semantics.