Sessions
Browse, inspect, and export agent session trajectories.
$ dn session <command>Browse, inspect, and export agent session trajectories — the record of what an agent did during a run.
Aliases: ls
$ dn session listShow sessions in your workspace.
Options
--search,--query— Free-text match across title, model, agent, and label values.--origin— Filter by session origin (user,eval,worker). Repeatable. [choices: user, eval, worker]--label—key:valuefilter, repeatable. Same key combines with OR; different keys combine with AND.--include-archived(defaultFalse) — Include archived sessions. Default hides them.--limit(default50) — Maximum results to show.--json(defaultFalse) — Output as JSON.
$ dn session get <session-id>Show session metadata, identity, and rollup usage in a single panel.
For the actual trajectory data (messages, tool calls, observations) use
dn session export.
Options
<session-id>,--session-id(Required) — Session UUID, or a unique prefix (e.g. the 8-char id shown bydn session list).--json(defaultFalse) — Output as JSON.
export
Section titled “export”$ dn session export <session-id>Export the session’s trajectory in a portable format.
By default writes an ATIF v1.7 JSON document to
./session-<id>.<format>.json. Pass --format openai for a Chat
Completions messages array, --format native for a
Dreadnode-native bundle that includes session metadata, transcript
messages, and ClickHouse events, --output - (or --json) to
stream to stdout.
Options
<session-id>,--session-id(Required) — Session UUID, or a unique prefix (e.g. the 8-char id shown bydn session list).--format(defaultatif) — Export format.atif(default),openai, ornative. [choices: atif, openai, native]--output,-o— Output path.-writes to stdout.--include-compacted(defaultFalse) — Include compacted history. Default excludes it.--json(defaultFalse) — Stream the result to stdout as JSON.
archive
Section titled “archive”$ dn session archive <session-id>Archive a session. Idempotent — re-archiving is a no-op.
Options
<session-id>,--session-id(Required) — Session UUID, or a unique prefix (e.g. the 8-char id shown bydn session list).--json(defaultFalse) — Output as JSON.
unarchive
Section titled “unarchive”$ dn session unarchive <session-id>Restore an archived session. Idempotent.
Options
<session-id>,--session-id(Required) — Session UUID, or a unique prefix (e.g. the 8-char id shown bydn session list).--json(defaultFalse) — Output as JSON.
freeze
Section titled “freeze”$ dn session freeze <session-id>Freeze a session. No new messages can be appended; there is no thaw.
Options
<session-id>,--session-id(Required) — Session UUID, or a unique prefix (e.g. the 8-char id shown bydn session list).--yes,-y(defaultFalse) — Skip the confirmation prompt.--json(defaultFalse) — Output as JSON.
$ dn session share <session-id>Share a private session with the workspace. Cannot be undone.
Options
<session-id>,--session-id(Required) — Session UUID, or a unique prefix (e.g. the 8-char id shown bydn session list).--yes,-y(defaultFalse) — Skip the confirmation prompt.--json(defaultFalse) — Output as JSON.
rename
Section titled “rename”$ dn session rename <session-id> <title>Rename a session.
Options
<session-id>,--session-id(Required) — Session UUID, or a unique prefix (e.g. the 8-char id shown bydn session list).<title>,--title(Required) — New session title (max 255 chars).--json(defaultFalse) — Output as JSON.
delete
Section titled “delete”Aliases: rm
$ dn session delete <session-id>Permanently delete a session and its transcript.
Sessions referenced by evaluations cannot be deleted.
Options
<session-id>,--session-id(Required) — Session UUID, or a unique prefix (e.g. the 8-char id shown bydn session list).--yes,-y(defaultFalse) — Skip the confirmation prompt.