oscarpastry/trapsh

trapsh is a command-line tool that records what you type in your terminal and turns it into a clean, reusable script. The idea is that instead of writing a script from scratch, you just do the work normally in your terminal while trapsh runs in the background, and when you are done it hands you a ready-to-use script containing only the commands that worked. The tool filters out noise automatically. If you mistype a command, run something that fails, or repeat the same command twice, trapsh strips those out of the final output. What remains is a standardized bash script file you can run again later or share with someone else. You can also preview what the script will look like before you stop the recording session, and you can pass a flag to save the unfiltered version if you want to see everything including the failed commands. It works with several shells: fish, bash, zsh, and PowerShell. The workflow is three commands: trapsh start to begin recording, run your work normally, then trapsh stop to write the output file. You can choose the output filename or let it default to trapsh_out.sh. Installation is available in two ways. Pre-built binaries for Linux, macOS, and Windows are available on the releases page and require no additional software to run. Alternatively, if you have Rust installed on your machine, you can build and install it from the source code with a single command. After installation, a separate setup step installs the shell hooks that let trapsh observe your session. The README also includes a short debugging section for the common case where the tool is installed but the terminal cannot find it, with fixes for each supported shell.