timetrace-debugger 1.0.3

Time-travel debugging engine for Python

Timetrace Debugger

Timetrace Debugger is a time-travel debugging engine for Python.

It records execution state, tracks variable changes, and allows stepping both backward and forward through program execution.

---

Why Timetrace?

Traditional debuggers only move forward.

Timetrace allows you to:

• Step backward in time
• Inspect past variable states
• Analyze execution history
• Replay saved debugging sessions

---

Features

• Reverse execution stepping
• Execution timeline recording
• Call stack tracking
• Exception capture
• Thread tracing
• Async support
• Conditional breakpoints
• Watchpoints
• Multi-file project support
• CLI-based interactive debugger

---

Installation

pip install timetrace-debugger

---

Quick Start

Run a Python script with time-travel debugging:

timetrace myscript.py

---

CLI Commands

Inside the debugger:

Command	Description
n	Next step
b	Step backward
si	Step into
so	Step over
su	Step out
s	Show stack
break	Set breakpoint
watch	Watch variable
history	Show variable history
q	Quit

---

Save & Replay Sessions

Save execution session:

timetrace myscript.py --save session.json

Replay saved session:

timetrace --replay session.json

---

Requirements

• Python 3.8+

---

License

MIT License
Copyright (c) 2026 Varkala Shashidhar

---

Author

Developed by Varkala Shashidhar