tapes sessions
List captured sessions. Prints the most recent sessions with their full id, turn count, cost, model, and a prompt preview — so other commands (tapes export, tapes search) have something to point at.
Usage
# List sessions from a running API
tapes sessions
# Pipe the newest session id into another command
tapes export $(tapes sessions -q | head -1) --api-target http://127.0.0.1:8081
# Read a database directly, without a running API
tapes sessions --postgres "postgres://tapes:tapes@localhost:5432/tapes?sslmode=disable"Flags
| Flag | Description |
|---|---|
-a, --api-target | tapes API server URL (default: http://localhost:8081) |
--postgres | PostgreSQL connection string for a local in-process API |
-q, --quiet | Output only session IDs, one per line (for piping) |
Session ids accept unambiguous short prefixes in commands like tapes export, so you rarely need the full UUID.