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.get_project_context
Takes only the global flags.
Examples
Notes
In text output,
* marks the current project.
obss projects current
Show the current project and why the CLI chose it.get_project_context
Takes only the global flags.
Examples
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.get_project_context. The plugin saves no project, so pass project_id on each call.
Arguments
Takes only the global flags.
Examples
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.get_project_context
Arguments
Takes only the global flags.
Examples
Read
updatedAt before a rename:
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.manage_project
Flags
Also takes the global flags.
Examples
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.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.
obss 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:
