Skip to main content
A project holds your tasks, tools, treatments, and experiments. Most commands work in one project: save it with 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.
Plugin (MCP) tool: get_project_context Takes only the global flags. Examples
Result fields Notes In text output, * marks the current project.

oqoqo projects current

Show the current project and why the CLI chose it.
Plugin (MCP) tool: get_project_context Takes only the global flags. Examples
Result fields The same fields as 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.
Plugin (MCP) tool: get_project_context. The plugin saves no project, so pass project_id on each call. Arguments Takes only the global flags. Examples
Result fields The same fields as 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.
Plugin (MCP) tool: get_project_context Arguments Takes only the global flags. Examples Read updatedAt before a rename:
Result fields The same fields as 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.
Plugin (MCP) tool: manage_project Flags Also takes the global flags. Examples
Result fields 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.
Plugin (MCP) tool: manage_project Arguments Flags Also takes the global flags. Examples
Notes Without --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.
Plugin (MCP) tool: delete_project. With --dry-run: preview_delete_project.
This stops the project’s running experiments, then deletes its tasks, files, machines, tools, treatments, agent settings, experiments, schedules, runs, Evals, and Insights. You can’t undo it, so run --dry-run first to preview what it removes.
Arguments Flags Also takes the global flags. Examples Preview the deletion, then delete from a script:
Result fields 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:

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.