# Projects - Obss

Set up
Projects
Create, switch, rename, and delete projects from the dashboard, the CLI, or the plugin.
A project holds your tasks, tools, treatments, and experiments, and every member can open it. Model providers, Obss AI feature models, and the run balance belong to the organization, so all projects share them. Choosing a project is step 1 of the
setup checklist
.
There’s no project settings page: use the project switcher in the dashboard header, the CLI, or the plugin. The switcher has
New project
at the bottom, a search box once you have more than seven projects, and an edit button on each row that opens
Rename project
.
Create a project
Dashboard
CLI
Plugin (MCP)
Open the project switcher in the dashboard header.
Select
New project
.
In
Create project
, enter a
Name
and select
Create project
.
obss
projects
create
--name
"Checkout agents"
--mutation-attempt-id
4c1e2f0a-create-checkout
Retry with the same
--mutation-attempt-id
to avoid creating a second project (
obss projects create
).
Ask your AI assistant to create the project. It calls
Create or rename a project
(
manage_project
).
Create an Obss project named "Checkout agents".
Switch projects
The dashboard and the CLI each remember a current project. The plugin has no current project, so each tool call names its project.
Dashboard
CLI
Plugin (MCP)
Select a project in the project switcher. The
Manage
pages, experiments, and Ask Obss use it.
obss
projects
list
obss
projects
use
prj_7d20e6b4
obss
projects
current
projects use
remembers the project for later commands. To use another project for one command, pass
--project-id
(
obss projects use
).
Your AI assistant calls
Get the organization and its projects
(
get_project_context
), then names the project in each call.
Rename a project
Dashboard
CLI
Plugin (MCP)
Open the project switcher.
Select the edit button on the project row.
In
Rename project
, edit
Project name
(80 characters or fewer) and select
Save changes
.
obss
projects
update
prj_7d20e6b4
--name
"Checkout agents (Q3)"
To avoid overwriting someone else’s change, pass
--expected-updated-at
with the value from
obss projects inspect
. If the project changed since then, the rename fails (
obss projects update
).
Ask your AI assistant to rename the project. It calls
Create or rename a project
(
manage_project
).
Delete a project
Deleting a project permanently removes everything in it: tasks, files, machines, tools, treatments, experiments, schedules, runs, and their Evals and Insights results. Obss first stops running experiments, and the stopped runs don’t count against your run balance.
You can’t undo a deletion, and you can’t delete the organization’s only project.
Dashboard
CLI
Plugin (MCP)
Open the project switcher.
Select the edit button on the project row.
In
Rename project
, select
Delete project
.
Type the project name to confirm, then select
Delete project
.
Preview what the deletion stops and removes, and any blockers:
obss
projects
delete
prj_7d20e6b4
--dry-run
Then delete it. In a terminal, the CLI asks you to confirm. With
--output json
or outside a terminal, pass
--yes
.
obss
projects
delete
prj_7d20e6b4
Ask your AI assistant to preview the deletion first. It calls
Preview project deletion
(
preview_delete_project
), then
Permanently delete a project
(
delete_project
) after you approve it.
From the CLI and the plugin
Task
CLI
Plugin (MCP)
List projects and show the current one
obss projects list
get_project_context
Read one project
obss projects inspect
get_project_context
Remember a project for later commands
obss projects use
Not needed: each call names its project
Create a project
obss projects create
manage_project
Rename a project
obss projects update
manage_project
Preview a deletion
obss projects delete --dry-run
preview_delete_project
Delete a project
obss projects delete
delete_project
Next steps
Model providers
Step 2: connect the models your agents use.
Set up your organization
See every setup step.
obss projects
Look up every projects command and flag.
Organization
Model providers
Powered by
This documentation is built and hosted on Mintlify, a developer documentation platform