clitsrec

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.

README

From the repo.

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

Config for your environment

Replace {MCP_ENDPOINT_URL} with this MCP’s endpoint URL (from its repo or docs above). No API key — you connect directly.

Tool

Config file: ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-server": {
      "url": "{MCP_ENDPOINT_URL}"
    }
  }
}

Paste into mcpServers in the config file. Restart Cursor after saving.