Sessions
Reference for coven sessions, attach, summon, archive, and sacrifice commands.
1 min read
Coven records project-scoped harness work as sessions. Use coven sessions to browse recent work and choose session actions without copying ids.
coven sessionsFor status meanings and archive semantics, see Session Lifecycle.
Listing modes
| Command | Output |
|---|---|
coven sessions | Interactive browser in a terminal; table output when piped. |
coven sessions --all | Includes archived sessions. |
coven sessions --manage | Forces the interactive session browser. |
coven sessions --plain | Forces a plain table for scripts and copying. |
coven sessions --json | Prints a JSON sessions array for clients such as CastCodes. |
Use --json for integrations and --plain for shell scripts or support snippets.
Attach
Replay and follow a session:
coven attach <session-id>For live daemon sessions, attach can also forward input to the running harness.
Archive
Hide completed work from the active list while preserving events:
coven archive <session-id>Archive is reversible. It refuses live-session deletion semantics and keeps the event log.
Summon
Restore an archived session, then attach:
coven summon <session-id>Use coven sessions --all when you need to find archived session ids.
Sacrifice
Permanently delete a non-running session and its event log:
coven sacrifice <session-id> --yesSacrifice is destructive. It requires --yes and refuses running sessions.
Related
- Run for creating sessions.
- Daemon lifecycle for live-session daemon behavior.
- Recovery and upgrades for stale sockets and orphaned sessions.
Last updated on