Tags¶

Tags provide a convenient way to label runs with more memorable names, and can be used in place of run ids in all o‑o commands.

Creating tags¶

To create a new tag, simply provide a tag name with the run id to tag. For instance given the following runs and their ids

$ o-o run --list
cn7gnwiapo example run
ntus965ryy create hello
cxdbx8am38 create world
7it9dmgncy print files

We can tag the "create hello" run

$ o-o tag hello ntus965ryy

This tag can be used in place of a run id with all o‑o commands, such as o-o show

$ o-o show hello
Run ntus965ryynuu7j54njgizi5s1ai3b3ajg4auwbw5oggc (hello)
Creator: Jon Doe <mail@example.com>
Started: Sun, 1 Feb 10:00:00 2026 -0500
Ended:   Sun, 1 Feb 10:02:00 2026 -0500
Command: echo "Hello" > o://output/hello.txt

    create hello

The tag name can also be used in place of run ids when specifying inputs to a new command

$ o-o run --message "print hello" -- cat o://hello/hello.txt
Hello

Listing tags¶

List current tags by simply running o-o tag without arguments or explicitly with --list

$ o-o tag --list
hello

Tagged runs are also marked as such with o-o run --list

$ o-o run --list
cn7gnwiapo example run
ntus965ryy (hello) create hello
cxdbx8am38 create world
7it9dmgncy print files
gekcocrbwn print hello

Tagging when starting runs¶

You can also tag runs during run creation, which is convenient when executing a series of runs without needing to look up the previous step's id. If we return to our multistep example, we can run the pipeline without any run ids

$ o-o run --tag hello --message "create hello" -- \
    'echo "Hello" > o://output/hello.txt'

$ o-o run --tag world --message "create world" -- \
    'echo "World" > o://output/world.txt'

$ o-o run --message "print files" -- \
    'cat o://hello/hello.txt && cat o://world/world.txt'
Hello
World