CLI: Sessions

Sessions record conversations between users and agents. Use valet sessions to list, inspect, follow, and manage sessions for a specific agent. The agent is determined by the -a/--agent flag or the linked agent in the current directory.

List sessions

valet sessions [--agent <agent>] [--org <org>]

$ valet sessions --agent my-agent
=== Sessions
01HXYZ000000000000000001	2026-04-16 10:00 UTC	How do I deploy?
01HXYZ000000000000000002	2026-04-15 16:30 UTC	(untitled)

Show a transcript

valet sessions <id> [--agent <agent>] [-f]

Passing a session ID shows that session's transcript. The -f/--follow flag streams events as they arrive until interrupted with Ctrl+C.

$ valet sessions 01HXYZ000000000000000001 --agent my-agent
[10:00:00] user: How do I deploy?
[10:00:02] assistant: Run "valet deploy".
[10:00:02] tokens: in=1234 out=567

Session info

valet sessions info <id> [--agent <agent>]

Shows the session's title, status, channel, timestamps, and conversation key.

Delete a session

valet sessions delete <id> [--agent <agent>] [--org <org>]

The session and its transcript are removed from the server and no longer appear in valet sessions. This action cannot be undone.