{"repo":"devinvenable/bottrace","free":true,"listed":false,"github":"https://github.com/devinvenable/bottrace","clone":"git clone https://github.com/devinvenable/bottrace.git","description":"Headless CLI debugging controller for Python — built for humans and LLM agents","language":"Python","stars":13,"topics":["cli","debugging","llm-agents","python","tracing"],"license":"MIT","category":"ai-agents","readme_excerpt":"bottrace A headless CLI debugging controller for Python. Designed for both humans and LLM agents. Installation Quick Start Core Concept bottrace is not a debugger. It's a debugging controller. It wraps Python's sys.settrace() and related primitives to emit structured, machine-parseable output. This lets you understand runtime behavior without setting breakpoints or adding print statements. Key principle: Runtime execution is authoritative. Symbol names and static analysis are secondary to observed call paths. Commands bottrace run Execute a Python script with optional tracing and debugging controls. Options Tracing Options Flag Description ------ ------------- --calls Emit CALL/RETURN events for each function --call-counts Show aggregated call frequency summary (Note: Misses C → Python calls) --no-comprehensions Suppress comprehension/genexpr call events --max-depth N Limit trace depth to N levels Filtering Options Flag Description ------ ------------- --include PREFIX Only trace files under this path (repeatable) --exclude PREFIX Exclude files under this path (repeatable) By default, bottrace traces only your project code (script's directory), not site-packages or stdlib. Exception Options Flag Description ------ ------------- --on-exception snapshot On uncaught exception, dump stack trace --locals Include local variables in exception snapshot Bounding Options Flag Description ------ ------------- --timeout N Kill execution after N seconds (exit code 124) --max-events N Stop","default_branch":null,"files":null,"tree":[],"storefront":"/r/devinvenable","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/devinvenable/bottrace/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}