# Tags - Obss

Run experiments
Tags
Put your own labels on tasks, files, machines, tools, treatments, and experiments, then find and select records by tag in every list.
A tag is a label, such as
needs-review
or
release-11
, that you put on records in your project to find and group them, for example all the tasks of one release. Tags never change what a record does or how a run uses it, and they’re private to your project: a
public experiment link
doesn’t show them.
Each tag has a stable ID that starts with
tag_
and stays the same when you rename the tag.
What can have tags
Records
Where
Tasks
Manage → Tasks
Files
and
Machines (Environments)
Manage → Files
,
Manage → Machines (Environments)
Skills
,
MCP servers
,
CLIs
, and
SDKs
Manage → Tools
Treatments (Toolsets)
Manage → Treatments (Toolsets)
Experiments
All experiments
Agents, runs, frictions, and projects don’t have tags. A tag goes on the record, not on a version: a new version of a task or skill keeps its tags, and changing tags doesn’t make a new version.
Add and remove tags
Dashboard
CLI
Plugin (MCP)
Open the record. Under its name, select
Add tag
, or select its tags if it already has some.
Type a name, then choose a tag from the list or select
Create ”…”
to make a new one.
Obss saves each choice at once. To remove a tag, choose it again to clear its check.
obss
tags
add
needs-review
regression
--to
tsk_3a91c7e2,exp_8f2c41d0
obss
tags
remove
regression
--from
tsk_3a91c7e2
If the project doesn’t have a tag with that name, the command creates it. You can run each command more than once, and the result stays the same. See
obss tags add
.
Ask your AI assistant to tag the records. The assistant calls
Add or remove tags on records
(
update_tags
).
Tag every checkout task in this Obss project with release-11.
A tag belongs to one project, and any record in it can use the tag. Letter case doesn’t matter:
Flaky
and
flaky
are the same tag, and Obss keeps the first spelling.
Tag many records at once
In a list, select up to 100 records.
In the selection bar, select
Tag
.
Choose the tags to add. A tag that only some records have shows as partly selected: choose it once to add it to all of them, and again to remove it from all of them.
Find records by tag
Lists show up to two tags on each record and a count for the rest. Hover over the count to see them all. The
Tags
filter appears once the project has a tag:
Choose one or more tags to see records that have any of them.
Choose
No tags
to see records that have no tags.
Choose tags and
No tags
together to see both.
The filter is part of the page link, so you can bookmark it or send it to a teammate. The task list in
New experiment
has the same filter, so you can
select all the tasks
of a release or an area at once. In the CLI,
obss catalog list
and
obss experiments list
filter by tag the same way, and so do
inspect_catalog
and
list_experiments
in the plugin.
Rename or delete a tag
Open the tags of any record, or
Tag
in the selection bar.
Hover over the tag and select the edit icon, or type its full name and select
Edit ”…”
.
In
Edit tag
, type a new
Name
and select
Save changes
, or select
Delete tag
.
A rename applies to every record with the tag. The new name can’t match another tag in the project, in any letter case.
Delete tag
removes the tag from every record and from the project, and you can’t undo it. The dashboard shows how many records have the tag and asks you to confirm. The records stay.
Deleting a task, tool, treatment, or experiment doesn’t delete its tags from the project.
Names and limits
Rule
Limit
Name length
1 to 40 characters
Characters
Any character except a comma or a control character. A name can’t look like a tag ID (
tag_…
).
Spaces
Obss trims spaces at the start and end, and changes two or more spaces to one.
Tags on one record
20
Tags in one change or filter
20
Tags in one project
500
Records in one change
100
A change that goes over a limit changes nothing, and the dashboard, the CLI, and the plugin tell you which limit it went over.
From the CLI and the plugin
The CLI and the plugin take a tag’s name (in any letter case) or its
tag_
ID, and a record’s ID, such as
tsk_
or
exp_
.
Task
CLI
Plugin (MCP)
List tags
obss tags list
list_tags
Add tags
obss tags add
update_tags
Remove tags
obss tags remove
update_tags
Rename a tag
obss tags rename
rename_tag
Delete a tag
obss tags delete
delete_tag
Find records by tag
obss catalog list --tag
,
obss experiments list --tag
inspect_catalog
,
list_experiments
Next steps
Launch an experiment
Select tasks by tag when you launch.
obss tags
Every flag for the tags commands.
Schedules
Matrix and runs
Powered by
This documentation is built and hosted on Mintlify, a developer documentation platform