Skip to main content
Manage preset tools and their versions.

tai presets create

Create a versioned preset (or an authored agent, when the base tool is an agent). Example: tai presets create greet --base-tool echo --kwargs '{"prefix":"hi"}'

tai presets delete

Delete a preset. Example: tai presets delete my_preset

tai presets get

Get a store-backed preset’s record and active body. Example: tai presets get my_preset

tai presets get-version

Get a specific preset version. Example: tai presets get-version my_preset 3

tai presets list

List the store-backed (versioned) presets. Example: tai presets list

tai presets referees

List the presets that reference this preset (a rename would strand them). Example: tai presets referees my_preset

tai presets rename

Rename a preset — its name is its live tool name, so the tool is rebound. Example: tai presets rename old_name new_name

tai presets rollback

Roll a preset back to a prior version. Example: tai presets rollback my_preset 2

tai presets save-version

Save a new preset version. Omitted fields carry forward; --clear-tags and --extensions '[]' send the explicit clear sentinel. Example: tai presets save-version my_preset --kwargs '{"n":2}' --clear-tags

tai presets set-version-tags

Replace a preset version’s tags (labels only — no rebind). Zero tag arguments clears them to []. Example: tai presets set-version-tags my_preset 2 stable reviewed

tai presets validate

Dry-run a preset draft — report whether it would be accepted as a create (a new name) or a new version (an existing name), without writing anything. Example: tai presets validate greet --base-tool echo --kwargs '{"prefix":"hi"}'

tai presets versions

List a preset’s version history. Example: tai presets versions my_preset