evolve session - Evolve

Sessions come from managed-agent SDK runs. They are separate from evaluation jobs and trials.

evolve session list
evolve session show "$SESSION_ID"

Set $SESSION_ID to an ID from the list. These commands inspect recorded sessions; they do not start an agent. To create a session, follow the agent SDK manual.

Filter the list

evolve session list --state ended --tag-prefix qa- --scope org

Option	Meaning
`--scope <my\|shared\|org>`	Records to list. Default `my`.
`--state <live\|ended>`	Select live or ended sessions.
`--agent <name>`	Select one agent harness.
`--tag-prefix <prefix>`	Select tags beginning with this text.

Shared list options also apply: --limit, --cursor, --columns, --quiet, --no-trunc, --no-headers. The creator can share by unlisted link or email.

evolve session share "$SESSION_ID" --link
evolve session share "$SESSION_ID" --email colleague@example.com
evolve session shares "$SESSION_ID"

Option for `share` and `unshare`	Meaning
`--link`	Enable or disable the unlisted link.
`--email <address>`	Add or remove access for this address. Repeatable.

Supply at least one. Email sharing sends the recipient a link. A session share includes the session, transcript, and trace file.

Remove access

evolve session unshare "$SESSION_ID" --link
evolve session unshare "$SESSION_ID" --email colleague@example.com

Revoking a link disables it. A later link share creates a new link. Global options and ID prefixes apply. sessions is an alias of session.

⌘I