Session Commands

scc sessions

List recent sessions (team-scoped by default).

scc sessions [OPTIONS]

Aliases: scc session, scc session list

Options:

Option	Description
-n, --limit N	Number of sessions to show (default: 10)
-t, --team TEAM	Filter by team
--all	Show sessions for all teams (ignore active team)
-s, --select	Interactive picker to select a session
--json	Output as JSON
--pretty	Pretty-print JSON (implies —json)

Examples:

# List recent sessions for the active team
scc sessions

# Show more sessions
scc sessions --limit 20

# Interactive session picker (team-scoped)
scc sessions --select

# Show all teams
scc sessions --all

# Filter by a specific team
scc sessions --team backend

# Output as JSON
scc sessions --json

Output includes:

• Session name
• Workspace path
• Last used time
• Team profile

---

scc container

List SCC-managed Docker containers (alias of scc list).

scc container [--interactive]

Examples:

# List containers
scc container

# Interactive container picker
scc container --interactive

---

scc context

Manage work contexts (team + workspace associations).

Work contexts track which team profile you used with which workspace, enabling quick resume without re-selecting.

scc context clear

Clear stored work contexts.

scc context clear [OPTIONS]

Options:

Option	Description
-y, --yes	Skip confirmation prompt

Examples:

# Clear with confirmation
scc context clear

# Clear without confirmation
scc context clear --yes

When to clear contexts:

• After switching teams
• When context associations are incorrect
• Before starting fresh with new setup

---

scc sessions prune

Clean up old session history.

scc sessions prune [OPTIONS]

Options:

Option	Description
--older-than DURATION	Prune sessions older than duration (e.g., 30d, 12h, 1w)
--keep N	Keep most recent N sessions per team (default: 20)
--team TEAM	Prune within specific team only
--all	Prune across all teams
-n, --dry-run	Preview what would be removed
-y, --yes	Skip confirmation prompt

Examples:

# Preview what would be pruned (default: 30d, keep 20)
scc sessions prune --dry-run

# Prune sessions older than 7 days
scc sessions prune --older-than 7d

# Keep only last 10 sessions per team
scc sessions prune --keep 10

# Prune without confirmation
scc sessions prune --yes

Default behavior:

• Prunes sessions older than 30 days
• Keeps the 20 most recent sessions per team
• Safe operation — you can always recreate sessions