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

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