Skip to main content
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

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

  1. Open the record. Under its name, select Add tag, or select its tags if it already has some.
  2. 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.
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

  1. In a list, select up to 100 records.
  2. In the selection bar, select Tag.
  3. 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.
A list with tag chips on each row and the Tags filter open, showing project tags and No tags.A list with tag chips on each row and the Tags filter open, showing project tags and No tags.
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

  1. Open the tags of any record, or Tag in the selection bar.
  2. Hover over the tag and select the edit icon, or type its full name and select Edit ”…”.
  3. 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

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

Next steps