Skip to main content
Most projects never need to manage tags or memory by hand. RELAI attaches tags automatically when it creates agent tests and benchmarks — one recording the agent test’s scope, one grouping related tests — and the optimizer maintains its own memory between runs, tied to those tags. The commands below are for inspecting that state, selecting suites by tag, and adding durable guidance of your own.

​
relai tag

Use relai tag to group agent tests into reusable suites.

​
list

List tags. Use --verbose to include the agent test file locations for each tag.

​
relai memory

Store Markdown guidance RELAI should consider during future generation and optimization. Most memory commands operate on one scope:

​
Read

Prints Markdown memory content, or empty output if no memory exists.

​
Write or append

Use one content source: --text, --file, or --stdin. write replaces memory; append adds to existing memory. Concurrent write and append commands on the same scope run one at a time, so each change is kept. If memory changes while relai optimize is preparing its own update, the optimizer keeps the newer content, skips its update, and reports the skip in its completion summary.

​
Paths and scopes

path prints the filesystem path for one memory file. list prints known memory scopes and paths. Common failures: unknown scope, invalid file path, or missing content option.