Skip to content

A bash script wrapper for interactive commands which records the terminal output (typescript) of each session preserving the entire history. It's useful for command-line AI workflow tools like `gemini-cli` to automatically save the history of each each conversation which is otherwise lost when the session ends.

License

Notifications You must be signed in to change notification settings

acerix/clitsrec

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 

Repository files navigation

Command-Line Interface TypeScript Recorder

A bash script wrapper for interactive commands which records the terminal output (typescript) of each session preserving the entire history. It's useful forcommand-line AI workflow tools like gemini-cli to automatically save the history of each each conversation which is otherwise lost when the session ends.

Installation

curl https://raw.githubusercontent.com/acerix/clitsrec/refs/heads/main/clitsrec.sh > /usr/local/bin/clitsrec
chmod a+x /usr/local/bin/clitsrec

Usage

Run gemini, recording the terminal output for each session to a log file in the users home directory (e.g. ~/.local/share/clitsrec/session-name/script.out).

clitsrec gemini

List the sessions log directories:

ls -l ~/.local/share/clitsrec

Display a session output log as text, with ANSI formatting:

less -R script.out

Replay a session in the terminal:

scriptreplay script.tm script.out

About

A bash script wrapper for interactive commands which records the terminal output (typescript) of each session preserving the entire history. It's useful for command-line AI workflow tools like `gemini-cli` to automatically save the history of each each conversation which is otherwise lost when the session ends.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages