CLI: vyasa session
Usage: vyasa session [OPTIONS] COMMAND [ARGS]...
Manage sessions
┌─ Options ────────────────────────────────────────────────────────────────────┐
│ --help -h Show this message and exit. │
└──────────────────────────────────────────────────────────────────────────────┘
┌─ Commands ───────────────────────────────────────────────────────────────────┐
│ start Start a new session. │
│ end End a session. │
│ refresh Extend session TTL. │
│ status Show active session status. │
│ stats Show session apply-outcome statistics. │
│ list List all sessions with metadata. │
│ note Write an agent-owned work note onto a session (active, ended, or │
│ archived). │
│ kind-vars Record structure-kind path-template variables for a session (e.g. │
│ app=shop, Name=Cart). │
│ park Park a session on a system issue (e.g. verification tool │
│ missing). │
│ resume Clear a parked session so the assistant can be re-invoked. │
│ purge Purge old sessions. │
└──────────────────────────────────────────────────────────────────────────────┘
vyasa session start
Usage: vyasa session start [OPTIONS]
Start a new session.
Eight fields are mandatory: skill, mode, stage, target, intent,
work_style, objective, flow. On a live terminal, missing fields are
asked interactively; when piped (CI/scripts), missing fields fail fast.
The assistant is NOT selected here — launch it later with
`vyasa assistant use`.
┌─ Options ────────────────────────────────────────────────────────────────────┐
│ --skill TEXT Skill alias (ba, sce, etc.) │
│ --mode TEXT Mode ID (writing, │
│ implementing, etc.) │
│ --stage TEXT Stage ID (discovery, design, │
│ etc.) │
│ --target TEXT Target node ID │
│ --intent TEXT Intent ID │
│ --flow TEXT Flow (simple or scoring) │
│ --work-style TEXT Work style ID from the │
│ workflow's work_styles │
│ (required non-interactive) │
│ --interactive,--no-interact… Prompt for missing fields │
│ (default: auto — prompt on a │
│ live terminal, fail fast when │
│ piped) │
│ --dir PATH Project directory │
│ --ttl INTEGER Session TTL in minutes │
│ [default: 120] │
│ --name TEXT Human-readable session name │
│ (default: auto-generated │
│ <node>-<stage>-<intent>, │
│ unique) │
│ --objective TEXT User-owned statement of why │
│ this session runs (shown in │
│ UI) │
│ --help -h Show this message and exit. │
└──────────────────────────────────────────────────────────────────────────────┘
vyasa session end
Usage: vyasa session end [OPTIONS] [SESSION_ID]
End a session.
Pass the session id positionally (e.g. `vyasa session end abc12345`)
or via --session/-s. With no id, the user is prompted to pick from
the list of currently active sessions. The system does NOT auto-detect
an active session — explicit confirmation is required to end a session.
Redesigned Step 24: ending is blocked while a assistant session
is still active (to avoid orphaning the agent subprocess). Use --force
to end anyway.
┌─ Arguments ──────────────────────────────────────────────────────────────────┐
│ session_id [SESSION_ID] Session ID to end │
└──────────────────────────────────────────────────────────────────────────────┘
┌─ Options ────────────────────────────────────────────────────────────────────┐
│ --dir PATH Project directory │
│ --session -s TEXT Session ID to end (alternative to positional) │
│ --force End even if a coding assistant is still active │
│ --help -h Show this message and exit. │
└──────────────────────────────────────────────────────────────────────────────┘
vyasa session refresh
Usage: vyasa session refresh [OPTIONS] SESSION_ID
Extend session TTL.
┌─ Arguments ──────────────────────────────────────────────────────────────────┐
│ * session_id TEXT Session ID to refresh [required] │
└──────────────────────────────────────────────────────────────────────────────┘
┌─ Options ────────────────────────────────────────────────────────────────────┐
│ --ttl INTEGER New TTL in minutes [default: 120] │
│ --dir PATH Project directory │
│ --help -h Show this message and exit. │
└──────────────────────────────────────────────────────────────────────────────┘
vyasa session status
Usage: vyasa session status [OPTIONS]
Show active session status.
Without --session: lists all active sessions. If more than one is
active, prompts the user to pick one (unless exactly one).
With --session: shows detailed status for that specific session.
┌─ Options ────────────────────────────────────────────────────────────────────┐
│ --session -s TEXT Show specific session status (default: list all │
│ active) │
│ --dir PATH Project directory │
│ --interactive Force interactive prompt │
│ --help -h Show this message and exit. │
└──────────────────────────────────────────────────────────────────────────────┘
vyasa session stats
Usage: vyasa session stats [OPTIONS]
Show session apply-outcome statistics.
Default: aggregate across all nodes, with a per-node breakdown.
With --node: bucket-by-bucket session list for that node.
Buckets: applied, rejected, ongoing (active or unapplied), unfinished.
┌─ Options ────────────────────────────────────────────────────────────────────┐
│ --verbose Show detailed per-session stats │
│ --node TEXT Show stats for a specific node ID │
│ --dir PATH Project directory │
│ --help -h Show this message and exit. │
└──────────────────────────────────────────────────────────────────────────────┘
vyasa session list
Usage: vyasa session list [OPTIONS]
List all sessions with metadata.
┌─ Options ────────────────────────────────────────────────────────────────────┐
│ --dir PATH Project directory │
│ --help -h Show this message and exit. │
└──────────────────────────────────────────────────────────────────────────────┘
vyasa session note
Usage: vyasa session note [OPTIONS] SESSION_ID
Write an agent-owned work note onto a session (active, ended, or archived).
┌─ Arguments ──────────────────────────────────────────────────────────────────┐
│ * session_id TEXT Session ID to annotate [required] │
└──────────────────────────────────────────────────────────────────────────────┘
┌─ Options ────────────────────────────────────────────────────────────────────┐
│ * --text -t TEXT Agent-owned work note [required] │
│ --dir PATH Project directory │
│ --help -h Show this message and exit. │
└──────────────────────────────────────────────────────────────────────────────┘
vyasa session kind-vars
Usage: vyasa session kind-vars [OPTIONS] SESSION_ID
Record structure-kind path-template variables for a session (e.g. app=shop,
Name=Cart).
Merges into the session's kind_variables; needed for code kinds whose
structure path uses variables the agent must supply.
┌─ Arguments ──────────────────────────────────────────────────────────────────┐
│ * session_id TEXT Session ID to annotate [required] │
└──────────────────────────────────────────────────────────────────────────────┘
┌─ Options ────────────────────────────────────────────────────────────────────┐
│ --var -v TEXT Path-template variable as key=value (repeatable) │
│ --dir PATH Project directory │
│ --help -h Show this message and exit. │
└──────────────────────────────────────────────────────────────────────────────┘
vyasa session park
Usage: vyasa session park [OPTIONS] SESSION_ID
Park a session on a system issue (e.g. verification tool missing).
The session stays within its TTL; fix the environment, then resume.
┌─ Arguments ──────────────────────────────────────────────────────────────────┐
│ * session_id TEXT Session ID to park [required] │
└──────────────────────────────────────────────────────────────────────────────┘
┌─ Options ────────────────────────────────────────────────────────────────────┐
│ * --reason -r TEXT System issue to fix before resume [required] │
│ --dir PATH Project directory │
│ --help -h Show this message and exit. │
└──────────────────────────────────────────────────────────────────────────────┘
vyasa session resume
Usage: vyasa session resume [OPTIONS] SESSION_ID
Clear a parked session so the assistant can be re-invoked.
┌─ Arguments ──────────────────────────────────────────────────────────────────┐
│ * session_id TEXT Session ID to resume [required] │
└──────────────────────────────────────────────────────────────────────────────┘
┌─ Options ────────────────────────────────────────────────────────────────────┐
│ --dir PATH Project directory │
│ --help -h Show this message and exit. │
└──────────────────────────────────────────────────────────────────────────────┘
vyasa session purge
Usage: vyasa session purge [OPTIONS]
Purge old sessions.
┌─ Options ────────────────────────────────────────────────────────────────────┐
│ --older-than INTEGER Delete sessions older than N days │
│ [default: 7] │
│ --yes Skip confirmation │
│ --dir PATH Project directory │
│ --help -h Show this message and exit. │
└──────────────────────────────────────────────────────────────────────────────┘