bootspring session
Session intelligence -- status, snapshots, and health.
Overview
The session command manages session intelligence snapshots. Sessions capture metrics, patterns, and context from your AI-assisted development work. Snapshots are saved automatically via hooks and can be queried or cleaned up manually.
Usage
Loading code block...
Commands
| Command | Description |
|---|---|
status | Show current session status and stats |
list | List all session snapshots |
health | Check session intelligence health |
clean | Remove old session snapshots (keeps latest 10) |
Options
| Option | Description |
|---|---|
--json | Output as JSON |
--limit <n> | Number of sessions to list |
How Sessions Work
- When you start a conversation with an AI assistant, a session is created
- Hook handlers track metrics (tokens, costs, tool calls, timing) during the session
- When the assistant stops, a snapshot is saved to
.bootspring/memory/sessions/ - You can query, compare, and clean up sessions with this command
Storage
Sessions are stored locally in .bootspring/memory/sessions/ as JSON files. No external services are required.
Examples
Loading code block...
Related
bootspring observe- Session observability and intelligencebootspring memory- Cross-session memorybootspring hook- Hook configuration- Session Intelligence Feature Guide - How session intelligence works