UtilitiesWorkspace & Knowledge
Project
Your agent can manage projects — organize work, attach files, and track metadata
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
| Action | Example |
|---|---|
| Create a project | Set up a new workspace for a task or goal |
| Attach files | Upload documents, images, data files to a project |
| Track metadata | Store status, priority, tags, or any key-value data |
| Organize context | Group related files and metadata in one place |
Benefits
| Benefit | Description |
|---|---|
| Structured Context | Files and metadata organized per project, not scattered |
| Agent-Accessible | Your agent can read project files and metadata to inform its work |
| File Attachments | Upload documents, images, data — any file type |
For Developers
Build agents that manage projects and files using the Cue CLI.
Requirements
cueCLI installed and authenticated (cuethen/auth)
List Projects
cue project listCreate 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.pdfSupported 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
| Error | Fix |
|---|---|
| Not authenticated | Run cue then /auth to log in |
| 403 Forbidden | Not authorized to access this project |
| 404 Not Found | Project or file ID incorrect |
| Invalid JSON | Check JSON syntax |