oqoqo projects use, or pass --project-id on a single command. Choose a project has the full order the CLI follows.
oqoqo projects list
List the projects in your organization and mark the current one.get_project_context
Takes only the global flags.
Examples
Notes
In text output,
* marks the current project.
oqoqo projects current
Show the current project and why the CLI chose it.get_project_context
Takes only the global flags.
Examples
oqoqo projects list: organization, projects, project, and projectSource.
Notes
projectSource is preferred for a project you saved with oqoqo projects use, and fallback when Oqoqo chose one because you saved none or can no longer open the saved one.
oqoqo projects use
Save a project for this organization, so later commands use it until you choose another.get_project_context. The plugin saves no project, so pass project_id on each call.
Arguments
Takes only the global flags.
Examples
oqoqo projects list: organization, projects, project, and projectSource.
Notes
A project you can’t open fails with project_not_found and isn’t saved. To run one command in another project, pass --project-id instead.
oqoqo projects inspect
Show one project by its ID.get_project_context
Arguments
Takes only the global flags.
Examples
Read
updatedAt before a rename:
oqoqo projects list: organization, projects, project, and projectSource, which is explicit.
Notes
Inspecting a project doesn’t change the saved project.
oqoqo projects create
Create a project in your organization.manage_project
Flags
Also takes the global flags.
Examples
Notes
The new project doesn’t become the saved project, so run
oqoqo projects use to switch to it. Reusing an attempt ID for a different name fails with a conflict.
oqoqo projects update
Rename a project.manage_project
Arguments
Flags
Also takes the global flags.
Examples
--expected-updated-at, the rename overwrites any change made after you read the project, so always pass it from a script or an AI assistant.
oqoqo projects delete
Permanently delete a project and everything in it.delete_project. With --dry-run: preview_delete_project.
Arguments
Flags
Also takes the global flags.
Examples
Preview the deletion, then delete from a script:
Notes
In a terminal, the CLI shows what the deletion stops and removes, and asks you to confirm. With
--output json, or without a terminal, pass --yes. Custom agents belong to the organization, so the deletion keeps them.
A blocker makes the command fail with project_deletion_blocked, without a prompt:
Related
oqoqo catalog, resources, and uploads
Create tasks, tools, and treatments.
Projects
Create and switch projects in the dashboard.
CLI reference
Global flags, output, exit codes, and conventions.

