Pilot docs

Quick start

pip install logomesh, set your Sentry token, and reproduce your first crash from the CLI.

Install logomesh, connect Sentry, and reproduce your first production crash — no SDK required in your application.

1. Install

pip install logomesh

Requires Python 3.11+, Docker running locally, and a Sentry auth token with event:read scope. An OpenAI key is optional — pass --no-llm to skip the agent entirely.

2. Configure

export SENTRY_AUTH_TOKEN=sntryu_…
export OPENAI_API_KEY=sk-…   # optional

A .env in your repo root works too.

3. Reproduce

logomesh repro https://sentry.io/organizations/your-org/issues/12345678/

Add --artifact for the compliance JSON, --draft-pr for a GitHub draft PR, or --no-llm for deterministic-only mode.

## logomesh reproduced your crash

### Negative quantity bypasses checkout validation
Crash:     ValueError matched on both sides
Called:    checkout(item_id=1, qty=-5)
Got:       Order created with total -$49.95
Location:  checkout.py, line 42
Verdict:   reproduced · audit file sealed

What you get

  • A failing pytest against your current branch — synthesized from frame locals, not LLM output.
  • Optional sealed audit file with llm_in_evidence_path: false and mappings to SOC2 CC7.3 / CC7.4 and PCI DSS 12.10.5.
  • A clear status when reproduction is not possible — never a false positive.