Skip to content

Named agents

A named agent stores durable state under a group. This lets you return to work later, branch from saved state, or share/import agent state.

Start a named agent

ursa --config config.yaml --name catalyst-assistant --group chemistry

If you omit --group, URSA uses the default group.

List agents

ursa list-agents --group default

Show agent details

ursa show-agent --name catalyst-assistant --group chemistry

Continue work with an agent

ursa --config config.yaml --name catalyst-assistant --group chemistry

Naming guidance

Use names that describe the project or purpose:

literature-review
catalyst-assistant
plan-execute-demo
proposal-helper

Avoid putting secrets, credentials, or sensitive details in agent names.