Skip to main content
A project holds your tasks, tools, treatments, and experiments. Most commands work in one project: save it with obss projects use, or pass --project-id on a single command. Choose a project has the full order the CLI follows.

obss 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.

obss 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 obss projects list: organization, projects, project, and projectSource. Notes projectSource is preferred for a project you saved with obss projects use, and fallback when Obss chose one because you saved none or can no longer open the saved one.

obss 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 obss 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.

obss 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 obss projects list: organization, projects, project, and projectSource, which is explicit. Notes Inspecting a project doesn’t change the saved project.

obss 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 obss projects use to switch to it. Reusing an attempt ID for a different name fails with a conflict.

obss 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.

obss 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 the command with --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:

Next steps