███████╗██╗  ██╗███████╗ ██████╗██╗   ██╗████████╗██████╗  █████╗  ██████╗███████╗
  ██╔════╝╚██╗██╔╝██╔════╝██╔════╝██║   ██║╚══██╔══╝██╔══██╗██╔══██╗██╔════╝██╔════╝
  █████╗   ╚███╔╝ █████╗  ██║     ██║   ██║   ██║   ██████╔╝███████║██║     █████╗  
  ██╔══╝   ██╔██╗ ██╔══╝  ██║     ██║   ██║   ██║   ██╔══██╗██╔══██║██║     ██╔══╝  
  ███████╗██╔╝ ██╗███████╗╚██████╗╚██████╔╝   ██║   ██║  ██║██║  ██║╚██████╗███████╗
  ╚══════╝╚═╝  ╚═╝╚══════╝ ╚═════╝ ╚═════╝    ╚═╝   ╚═╝  ╚═╝╚═╝  ╚═╝ ╚═════╝╚══════╝

ExecuTrace

Record, edit, and replay developer workflows

---

About

ExecuTrace is a Python library and CLI tool that captures developer workflows and replays them reliably.

What it does:

• Records terminal commands from shell history
• Tracks file system changes (create, modify, delete)
• Saves workflows in JSON or XML format
• Replays workflows with multiple execution modes

Why use it:

• Automate repetitive development tasks
• Share procedures with team members
• Create reproducible environment setups
• Document complex workflows reliably
• Ensure consistent deployments

Documentation Website

The full open source docs website (retro 70s style) lives in website/ and can be deployed with GitHub Pages.

• Source: website/index.html
• Hall of Fame data: website/data/contributors.json
• Security Hall of Fame data: website/data/security_hof.json

---

Installation

From PyPI (Global Library)

# Install globally from PyPI
pip install exectrace-workflow

# Verify installation
exectrace --help

From Source (Development)

git clone https://github.com/Stalin-143/ExecuTrace.git
cd ExecuTrace
pip install -e .

---

Quick Usage

# Record
exectrace record my-workflow
# ... run your commands ...
exectrace stop

# Replay
exectrace replay my-workflow --explain

---

License

MIT License - See LICENSE for details.

Security

• Policy: SECURITY.md
• Advisory process: SECURITY_ADVISORY.md