Your agent can create and manage projects to organize work. Projects are containers with metadata and file attachments — a way to group related context together.
Organize the work. Attach the files. Track the progress.

What Your Agent Does with Projects

ActionExample
Create a projectSet up a new workspace for a task or goal
Attach filesUpload documents, images, data files to a project
Track metadataStore status, priority, tags, or any key-value data
Organize contextGroup related files and metadata in one place

Benefits

BenefitDescription
Structured ContextFiles and metadata organized per project, not scattered
Agent-AccessibleYour agent can read project files and metadata to inform its work
File AttachmentsUpload documents, images, data — any file type

For Developers

Build agents that manage projects and files using the Cue CLI.

Requirements

  • cue CLI installed and authenticated (cue then /auth)

List Projects

cue project list

Create a Project

cue project create '{"name":"My Project"}'
cue project create '{"name":"My Project","description":"Project description"}'

Get Project Details

cue project get <project_id>

Update a Project

cue project update <project_id> '{"name":"New Name"}'
cue project update <project_id> '{"description":"Updated description"}'

Delete a Project

cue project delete <project_id>

Update Metadata

Patch key-value metadata on a project:
cue project metadata <project_id> '{"status":"active","priority":"high"}'

Upload a File

cue project file-upload <project_id> ./path/to/file.pdf
Supported types: images (jpg, png, gif, webp), documents (pdf, json, txt, md, csv), archives (zip), media (mp3, mp4, wav).

List Files

cue project file-list <project_id>

Get File Details

cue project file-get <project_id> <file_id>

Delete a File

cue project file-delete <project_id> <file_id>

Troubleshooting

ErrorFix
Not authenticatedRun cue then /auth to log in
403 ForbiddenNot authorized to access this project
404 Not FoundProject or file ID incorrect
Invalid JSONCheck JSON syntax