# Slomo

## Docs

- [How Slomo Works: Recorder, Hooks, Storage, and Issues](https://docs.slomo.dev/concepts/how-it-works.md): A walkthrough of Slomo's four components: the in-process recorder, the instrumentation hooks, the append-only JSONL storage layer, and the issue engine.
- [How Slomo Issues Work: Fingerprinting and Classification](https://docs.slomo.dev/concepts/issues.md): How Slomo deduplicates crashes into issues: fingerprinting, automatic category classification, stability tracking, and the open/resolved lifecycle.
- [Sessions and Events: Slomo's Core Data Model Explained](https://docs.slomo.dev/concepts/sessions-and-events.md): How Slomo structures recorded data: one session per process run, one typed event per activity, and how spans link events into a call tree.
- [config.toml — Slomo Recorder Configuration Reference](https://docs.slomo.dev/configuration/config-toml.md): Complete reference for .slomo/config.toml: recording limits, storage retention, redaction rules, and every hook option with its default value.
- [Slomo Environment Variables — SLOMO_* Override Reference](https://docs.slomo.dev/configuration/environment-variables.md): All SLOMO_* environment variables: what each one overrides in config.toml, how boolean values are parsed, and common one-off usage recipes.
- [Slomo Storage Layout — The .slomo/ Directory Guide](https://docs.slomo.dev/configuration/storage-layout.md): A guide to the .slomo/ directory: session files, JSONL event streams, snapshots, the rebuildable SQLite index, and what is safe to delete.
- [Installing Slomo: Requirements, pip, and Integrations](https://docs.slomo.dev/installation.md): Install Slomo via pip, verify the install, and understand the Python 3.12+ requirement and optional integrations for requests, httpx, and SQLAlchemy.
- [Slomo — Black Box Flight Recorder for Python Apps](https://docs.slomo.dev/introduction.md): Slomo captures every function call, crash, SQL query, and HTTP request locally — replay and diagnose bugs from your terminal without a server or account.
- [Exporting recordings: Markdown, HTML, JSON, and CSV](https://docs.slomo.dev/investigating/exporting.md): Turn any recorded session or issue into a shareable file. Four formats: Markdown for tickets, HTML for browsers, JSON for scripts, CSV for spreadsheets.
- [The Slomo investigation workflow: triage to resolve](https://docs.slomo.dev/investigating/issues-workflow.md): The day-to-day debug loop: list grouped crashes, diagnose root causes with slomo doctor, replay the exact execution, then mark issues resolved.
- [Replay: interactively step through a recorded execution](https://docs.slomo.dev/investigating/replay.md): Walk through a recorded execution event by event, rewind to find the bad value, and inspect variable state — all in your terminal after the fact.
- [Searching recordings and live-tailing with timeline](https://docs.slomo.dev/investigating/search-and-timeline.md): Find events across all sessions with full-text search and field filters, or watch a running app in real time with slomo timeline --follow.
- [Quickstart: Record and Replay Your First Python Crash](https://docs.slomo.dev/quickstart.md): Install Slomo, add two lines to your Python app, trigger a crash, and explore the recording with the CLI — all in about five minutes, no account needed.
- [Auto-tracing — Zero-Decorator Function Recording in Slomo](https://docs.slomo.dev/recording/auto-tracing.md): Slomo captures every project function call — enter, args, exit, result, duration, exceptions — automatically via sys.monitoring. No decorators needed.
- [Manual Instrumentation — @track, snapshot(), event()](https://docs.slomo.dev/recording/manual-instrumentation.md): Manual instrumentation in Slomo: @track for function spans, snapshot() for variable capture, and event() for custom domain milestones.
- [Redaction and Privacy — Secrets Never Touch Disk in Slomo](https://docs.slomo.dev/recording/redaction.md): Slomo redacts secrets at capture time. Built-in rules cover passwords, tokens, JWTs, AWS keys, and card numbers. Extend with extra_keys and extra_patterns.
- [Web Frameworks — FastAPI and Flask Integration with Slomo](https://docs.slomo.dev/recording/web-frameworks.md): Integrate Slomo with FastAPI, Flask, or any Python web framework. Auto-tracing captures exceptions before the framework converts them into 500 responses.
- [Workers and Async — Threads, asyncio, Multi-Process Apps](https://docs.slomo.dev/recording/workers-and-async.md): Record background-thread crashes, asyncio failures, and multi-process apps. Forked children get their own session, and issues aggregate across all workers.
- [Slomo CLI: vars, http, and sql — Typed Data Views](https://docs.slomo.dev/reference/cli/data-views.md): Filter a session or issue to just variable snapshots, HTTP request/response pairs, or SQL queries and results with slomo vars, http, and sql.
- [Slomo CLI: doctor — Root-Cause Diagnosis for Issues](https://docs.slomo.dev/reference/cli/doctor.md): Run slomo doctor to get a heuristic root-cause report: category, severity, likely cause, first bad function and variable, and a suggested fix.
- [Slomo CLI: export — Sessions and Issues to Shareable Files](https://docs.slomo.dev/reference/cli/export.md): Export any session or issue to JSON, Markdown, CSV, or HTML for sharing in tickets, pull requests, or with teammates who don't have slomo installed.
- [Slomo CLI: issues, issue show, occurrences, and resolve](https://docs.slomo.dev/reference/cli/issues.md): List deduplicated crash groups, inspect individual issues, view all occurrences and affected sessions, and resolve or reopen issues from the CLI.
- [Slomo CLI: stats and prune — Storage and Retention](https://docs.slomo.dev/reference/cli/maintenance.md): Check session counts, event totals, issue categories, and storage usage with slomo stats, or trim old sessions to a retention limit with slomo prune.
- [Slomo CLI Reference: Commands and Interactive Shell](https://docs.slomo.dev/reference/cli/overview.md): Every slomo command at a glance — sessions, issues, doctor, replay, search, export, and the interactive shell with tab completion.
- [Slomo CLI: replay — Interactive Event-by-Event Playback](https://docs.slomo.dev/reference/cli/replay.md): Step through any recorded session or issue event by event, jump to errors, search payloads, and inspect variable snapshots — all in the terminal.
- [Slomo CLI: search — Full-Text and Field-Filter Search](https://docs.slomo.dev/reference/cli/search.md): Search across all recorded sessions with free-text queries, field=value filters, or any combination — results include event type, session, and a snippet.
- [Slomo CLI: sessions, session show, inspect, and delete](https://docs.slomo.dev/reference/cli/sessions.md): List recorded sessions, view per-session metadata and span trees, and delete individual recordings with the slomo session commands.
- [Slomo CLI: timeline — Chronological Event Feed and Tail](https://docs.slomo.dev/reference/cli/timeline.md): Print a chronological event feed for any session or issue, filter to warnings and errors only, or live-tail a running app with --follow.
- [Slomo Python API Reference — Flight Recorder Functions](https://docs.slomo.dev/reference/python-api.md): Complete public API reference for slomo's seven importable functions: enable, disable, track, snapshot, event, install_hooks, and flush.