list-sessions - SKILL.md Agent Skill

name: list-sessions description: List all running SAGA sessions user-invocable: true disable-model-invocation: true allowed-tools: - Bash

List Sessions

!npx @saga-ai/dashboard sessions list

Process

1. Parse the Result

The command above outputs a JSON array of session objects:

[
  {
    "name": "saga-story-my-story-id-1704067200000",
    "status": "running",
    "outputFile": "/tmp/saga-sessions/saga-story-my-story-id-1704067200000.out"
  }
]

2. Format and Display

If the array is empty, report:

No SAGA sessions are currently running.

If sessions exist, parse each session name to extract:

Story: The story ID extracted from the session name
Started: Calculate elapsed time from the Unix timestamp suffix (milliseconds)

Present in a table format:

## Running Sessions

| Story | Started | Session Name |
|-------|---------|--------------|
| login-flow | 2h 30m ago | saga-story-login-flow-1704067200000 |

To stream logs: `saga sessions logs <session-name>`
To kill session: `saga sessions kill <session-name>`

3. Session Name Parsing

The session name format is: saga-story-<storyId>-<timestamp>

To extract components:

Remove the saga-story- prefix
The last 13 digits (after the final -) are the timestamp (Unix milliseconds)
Everything between the prefix and the timestamp is the storyId

Example: saga-story-auth-login-flow-1704067200000

Remove prefix saga-story- → auth-login-flow-1704067200000
Last 13 digits after final - → timestamp 1704067200000
Remainder → storyId auth-login-flow