← Back to Skills Marketplace
derick001

Terminal Session Replay

by Derick · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
355
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install terminal-session-replay
Description
Record and replay terminal sessions for debugging, documentation, or sharing procedures with teammates.
Usage Guidance
This skill appears to do what it claims: record and replay terminal sessions locally. Before installing or using it, consider the following: (1) recordings capture everything you type/see (including passwords and secrets) — avoid recording sensitive sessions or securely delete/encrypt recordings afterward; (2) session files are stored by default in ~/.terminal-sessions — check and restrict filesystem permissions and add that path to backups/.gitignore if needed; (3) the tool invokes the system 'script' and 'scriptreplay' binaries — ensure those are the expected system utilities (not maliciously replaced on your PATH); (4) you can review scripts/main.py (provided) and run the tool in a sandbox/container if you want to test in isolation; (5) no network exfiltration or external credentials are requested by the skill, but treat recordings as sensitive data and manage accordingly.
Capability Analysis
Type: OpenClaw Skill Name: terminal-session-replay Version: 1.0.0 The skill provides terminal session recording and replay functionality by wrapping the 'script' and 'scriptreplay' utilities. It is classified as suspicious due to an arbitrary file write vulnerability in the 'export' command within 'scripts/main.py', where the output file path is not validated, potentially allowing an attacker to overwrite sensitive files via prompt injection. While the tool implements robust path traversal checks for session names and uses secure subprocess calls, the lack of sanitization on the export destination is a high-risk vulnerability. No evidence of intentional malicious intent or data exfiltration was found.
Capability Assessment
Purpose & Capability
Name/description match the implementation: the tool wraps the standard 'script' family of utilities and provides record/replay/export/list/delete functionality. Declared required binaries (python3, script) make sense.
Instruction Scope
Runtime instructions and the Python code operate locally on ~/.terminal-sessions and call only local commands (script, scriptreplay, cat). Important privacy note: recording captures everything typed and displayed in the terminal (including secrets/passwords), which is expected for this purpose but should be highlighted to users.
Install Mechanism
Instruction-only skill with bundled Python script; there is no install spec that downloads external artifacts. No network fetches or archive extraction in the provided files.
Credentials
No environment variables, credentials, or unrelated config paths are requested. The tool stores session files under the user's home directory (~/.terminal-sessions) which is proportional to its function.
Persistence & Privilege
The skill is not marked always:true, does not request elevated or cross-skill config changes, and only persists files in its own sessions directory.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install terminal-session-replay
  3. After installation, invoke the skill by name or use /terminal-session-replay
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of terminal-session-replay. - Record terminal sessions with a simple command, capturing commands, outputs, and timing. - Replay sessions with original timing or adjust playback speed. - Export recorded sessions to markdown for documentation. - Manage sessions: list, view metadata, and delete recordings. - Add titles, descriptions, and tags to sessions for easier organization. - Requires Python 3 and the `script` binary (Linux/macOS).
Metadata
Slug terminal-session-replay
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Terminal Session Replay?

Record and replay terminal sessions for debugging, documentation, or sharing procedures with teammates. It is an AI Agent Skill for Claude Code / OpenClaw, with 355 downloads so far.

How do I install Terminal Session Replay?

Run "/install terminal-session-replay" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Terminal Session Replay free?

Yes, Terminal Session Replay is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Terminal Session Replay support?

Terminal Session Replay is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Terminal Session Replay?

It is built and maintained by Derick (@derick001); the current version is v1.0.0.

💬 Comments