bootspring observe
Session observability -- metrics, costs, and intelligence analysis.
Overview
The observe command provides real-time session tracking, cost analysis, and AI-powered intelligence insights. It tracks token usage, tool calls, timing, and patterns across sessions.
Usage
Loading code block...
Commands
| Command | Description |
|---|---|
status | Show current session metrics |
sessions | List all tracked sessions |
costs | Show cost tracking and projections |
summary | Show aggregate stats across all sessions |
export | Export all session data as JSON |
on | Enable observer (full mode) |
off | Disable observer |
quiet | Enable quiet mode (tracking without context injection) |
intelligence | Run full intelligence analysis on latest session |
efficiency | Show efficiency score for latest session |
Options
| Option | Description |
|---|---|
--json | Output as JSON |
--session <id> | Target a specific session |
Observer Modes
| Mode | Description |
|---|---|
on | Full tracking + context injection into assistant prompts |
quiet | Tracking only, no context injection |
off | Disabled |
Intelligence Modules
The intelligence subcommand runs 12 analysis modules:
- Efficiency Scorer -- 6-dimension weighted score, 0-100 composite + letter grade
- Session Fingerprint -- 16D feature vector, nearest-centroid classifier, 8 session types
- Context Pressure -- Context window tracking and compaction prediction
- Pattern Detector -- 8 anti-patterns (thrashing, retry storm, context bloat, tool misuse, etc.)
- Drift Detector -- Change point detection via Jensen-Shannon divergence, phase summaries
- Predictive Cost -- EWMA burn rate, linear regression, Monte Carlo 95% CI
- Anomaly Detector -- Modified Z-score, CUSUM, IQR fencing, Grubbs' test
- Time Series -- SMA, trend detection, change points, learning curve fitting
- Session Comparator -- Per-metric comparison, significance testing, weighted Jaccard similarity
- Cost Optimizer -- Waste analysis, model comparison (Opus/Sonnet/Haiku), monthly projection
- Smart Alerts -- Dynamic thresholds, suppression, escalation, rate limiting
- Intelligence Hub -- Module orchestrator, error isolation, insight synthesis
Examples
Loading code block...
Related
bootspring session- Session snapshotsbootspring hook- Hook configuration- Observability Feature Guide - How the observer works