prlt session
Manage the tmux sessions that agents run inside. Attach to watch in real time, peek for a snapshot, or poke to send messages.
Subcommands
| Command | Description |
|---|---|
session list | List all active agent sessions |
session attach | Attach to an agent's tmux session |
session create | Create a new tmux session manually |
session detach | Detach from a session |
session peek | View recent output without attaching |
session poke | Send a message to a running agent |
session health | Check health of all running sessions |
session list
$ prlt session list bezos TKT-001 active 2h 15m musk TKT-003 active 45m
session attach
Drop into an agent's tmux session to see exactly what it's doing. You can watch and interact.
$ prlt session attach bezos # Detach with Ctrl+B then D
session peek
Get a read-only snapshot of an agent's recent output without entering the session.
$ prlt session peek bezos
session poke
Send a message to a running agent. The agent will see it as input in its session.
# Give the agent a hint $ prlt session poke bezos "The test config is in jest.config.ts" # Redirect focus $ prlt session poke musk "Skip the UI, focus on the API endpoints"
Tip
Poking is great for course-correcting agents without stopping their work. Use it to provide hints, fix misunderstandings, or point to specific files.
session health
Check all running sessions for stuck or crashed agents.
$ prlt session health bezos healthy responding musk healthy responding gates unhealthy no output for 30m