็ฎไฝไธญๆ | ็น้ซไธญๆ | English
TermRec ๆฏไธๆฌพๅผบๅคง็็ป็ซฏไผ่ฏๅฝๅถไธๅๆพๅทฅๅ ท๏ผไธไธบๅผๅ่ ใ่ฟ็ปดๅทฅ็จๅธๅๆๆฏ่ฎฒๅธ่ฎพ่ฎกใๅฎๅฏไปฅๅฎๆด่ฎฐๅฝ็ป็ซฏไธญ็ๆๆๆไฝ๏ผๅ ๆฌๅฝไปคใ่พๅบใๆถ้ดๆณ็ญ๏ผๅนถๆฏๆๆบ่ฝๅๆพใๅๆๅๅฏผๅบใ
- ๆไฝๅค็ๅฐ้พ๏ผ่ฐ่ฏๅคๆ้ฎ้ขๆถ๏ผ้พไปฅ่ฟฝๆบฏไนๅ็ๆไฝๆญฅ้ชค
- ๆ็จๅถไฝ็น็๏ผๅถไฝๆๆฏๆ็จๆถ๏ผ้่ฆๆๅจๆชๅพๅ่ฎฐๅฝ
- ๅข้ๅไฝไฝๆ๏ผ้พไปฅๅไบซๅฎๆด็ๆไฝๆต็จ็ปๅข้ๆๅ
- ๅฝไปคๅๅฒๅๆฃ๏ผ็ป็ซฏๅๅฒ่ฎฐๅฝไธๅค็ด่ง๏ผ็ผบไนไธไธๆ
- ๐ ๆบ่ฝๆๆไฟกๆฏ่ฑๆ๏ผ่ชๅจๆฃๆตๅนถ้่ๅฏ็ ใAPIๅฏ้ฅ็ญๆๆๆฐๆฎ
- ๐ ๆทฑๅบฆไผ่ฏๅๆ๏ผ็ป่ฎกๅฝไปค้ข็ใๆง่กๆถ้ดใๆๅ็็ญๆๆ
- ๐ ้ถๅค้จไพ่ต๏ผ็บฏPythonๅฎ็ฐ๏ผๆ ้ๆฐๆฎๅบๆๅค้จๆๅก
- ๐ค ๅคๆ ผๅผๅฏผๅบ๏ผๆฏๆJSONใMarkdownใHTMLใTXTๅ็งๆ ผๅผ
- ๐ ๅฟซ้ๆ็ดข๏ผๅจๅๅฒไผ่ฏไธญๅฟซ้ๅฎไฝๅ ณ้ฎๅฝไปค
| ็นๆง | ๆ่ฟฐ |
|---|---|
| ๐ฌ ไผ่ฏๅฝๅถ | ๅฎๆด่ฎฐๅฝๅฝไปคใ่พๅบใๆถ้ดๆณใๅทฅไฝ็ฎๅฝ |
| ๆฏๆ้ๅบฆ่ฐ่ใๅบ้ดๆญๆพใ่ทณ่ฟๅปถ่ฟ | |
| ๐ ไผ่ฏๅๆ | ๅฝไปค้ข็็ป่ฎกใๆง่กๆถ้ดๅๆใๆๅ็่ฎก็ฎ |
| ๐ ๅฟซ้ๆ็ดข | ๅจๅๅฒไผ่ฏไธญๆ็ดขๅฝไปคๅ่พๅบๅ ๅฎน |
| ๐ค ๅคๆ ผๅผๅฏผๅบ | JSON / Markdown / HTML / TXT |
| ๐ ๆๆๆฐๆฎไฟๆค | ่ชๅจๆฃๆตๅนถ่ฑๆๅฏ็ ใๅฏ้ฅ็ญๆๆไฟกๆฏ |
| ๐พ ่ฝป้ๅญๅจ | JSONๆ ผๅผๅญๅจ๏ผๆไบ็ๆฌๆงๅถๅๅไบซ |
| ๐ฅ๏ธ ่ทจๅนณๅฐๆฏๆ | Windows / macOS / Linux |
- Python: 3.8 ๆๆด้ซ็ๆฌ
- ๆไฝ็ณป็ป: Windows / macOS / Linux
# ๆนๅผไธ๏ผไฝฟ็จ pip ๅฎ่ฃ
pip install termrec
# ๆนๅผไบ๏ผไปๆบ็ ๅฎ่ฃ
git clone https://github.com/gitstq/termrec.git
cd termrec
pip install -e .# ๆฅ็ๅธฎๅฉ
termrec --help
# ๅผๅงๅฝๅถไผ่ฏ
termrec record mysession
# ๅๅบๆๆๅฝๅถ็ไผ่ฏ
termrec list
# ๅๆพไผ่ฏ
termrec play mysession
# ๅๆไผ่ฏ็ป่ฎก
termrec analyze mysession
# ๅฏผๅบไผ่ฏ
termrec export mysession -f markdown -o session.md
# ๆ็ดขไผ่ฏๅ
ๅฎน
termrec search mysession "error"# ๅบๆฌๅฝๅถ
termrec record mysession
# ๆๅฎๅๅงๅฝไปค
termrec record deploy -c "npm run build"
# ๆทปๅ ๆๆไฟกๆฏ่ฟๆปคๆจกๅผ
termrec record secure-session -s "password" -s "api_key" -s "token"
# ๆๅฎ่พๅบๆไปถ
termrec record mysession -o /path/to/session.jsonๅฝๅถ่ฟ็จไธญ๏ผ
- ่พๅ ฅๅฝไปคๅนถๆง่ก๏ผๅทฅๅ ทไผ่ชๅจ่ฎฐๅฝ่พๅบ
- ่พๅ
ฅ
exitๆๆCtrl+D็ปๆๅฝๅถ - ๆ
Ctrl+Cไธญๆญๅฝๅๅฝไปค
# ๅบๆฌๅๆพ
termrec play mysession
# 2ๅ้ๅๆพ
termrec play mysession -s 2.0
# ไป็ฌฌ5ๆกๅฝไปคๅผๅงๆญๆพ
termrec play mysession --start 5
# ๆญๆพ็ฌฌ5ๅฐ็ฌฌ10ๆกๅฝไปค
termrec play mysession --start 5 --end 10
# ่ทณ่ฟๅปถ่ฟๅฟซ้ๆญๆพ
termrec play mysession --no-wait# ๆฅ็ไผ่ฏ็ป่ฎก
termrec analyze mysessionๅๆ็ปๆๅ ๆฌ๏ผ
- ๐ ไผ่ฏๆฅๆๅๆ็ปญๆถ้ด
- ๐ ๅฝไปคๆปๆฐๅๆๅ็
- ๐ ๆๅธธ็จๅฝไปคๆ่ก
- ๐ข ๆง่กๆๆ ข็ๅฝไปค
# ๅฏผๅบไธบ JSON
termrec export mysession -f json
# ๅฏผๅบไธบ Markdown
termrec export mysession -f markdown -o session.md
# ๅฏผๅบไธบ HTML
termrec export mysession -f html -o session.html
# ๅฏผๅบไธบ็บฏๆๆฌ
termrec export mysession -f txt -o session.txt# ๆ็ดขๅ
ๅซ "error" ็ๅฝไปคๅ่พๅบ
termrec search mysession "error"
# ๆ็ดข git ็ธๅ
ณๅฝไปค
termrec search mysession "git"TermRec ็่ฎพ่ฎก้ตๅพชไปฅไธๅๅ๏ผ
- ็ฎๅ่ณไธ๏ผ้ถ้ ็ฝฎๅณๅฏไฝฟ็จ๏ผๆ ธๅฟๅ่ฝๅผ็ฎฑๅณ็จ
- ๆฐๆฎ้ๆ๏ผไฝฟ็จ JSON ๆ ผๅผๅญๅจ๏ผไพฟไบ็ๆฌๆงๅถๅไบๆฌกๅผๅ
- ้็งไผๅ ๏ผๆๆไฟกๆฏ่ชๅจ่ฑๆ๏ผไฟๆค็จๆทๆฐๆฎๅฎๅ จ
- ่ทจๅนณๅฐๅ ผๅฎน๏ผ็บฏ Python ๅฎ็ฐ๏ผๆ ๅนณๅฐไพ่ต
| ็ๆฌ | ๅ่ฝ |
|---|---|
| v1.1 | ๐ผ๏ธ ๆฏๆ GIF/่ง้ขๅฏผๅบ |
| v1.2 | ๐ค AI ๆบ่ฝๅฝไปคๅปบ่ฎฎ |
| v1.3 | โ๏ธ ไบ็ซฏๅๆญฅๆฏๆ |
| v1.4 | ๐ฅ ๅข้ๅไฝๅ่ฝ |
| v1.5 | ๐ฑ Web ๆงๅถๅฐ |
# ๅ
้ไปๅบ
git clone https://github.com/gitstq/termrec.git
cd termrec
# ๅฎ่ฃ
ๅผๅไพ่ต
pip install -e ".[dev]"
# ่ฟ่กๆต่ฏ
python -m pytest tests/ -v
# ไปฃ็ ๆ ผๅผๅ
black src/
isort src/# ๅฎ่ฃ
ๆๅปบๅทฅๅ
ท
pip install build
# ๆๅปบ
python -m build
# ไบง็ฉไฝไบ dist/ ็ฎๅฝๆไปฌๆฌข่ฟๆๆๅฝขๅผ็่ดก็ฎ๏ผ
- Fork ๆฌไปๅบ
- ๅๅปบๅ่ฝๅๆฏ (
git checkout -b feature/amazing-feature) - ๆไบคๆดๆน (
git commit -m 'feat: add amazing feature') - ๆจ้ๅฐๅๆฏ (
git push origin feature/amazing-feature) - ๅๅปบ Pull Request
ๅ็ฐ Bug ๆๆๆฐๅ่ฝๅปบ่ฎฎ๏ผ่ฏท ๅๅปบ Issue
ๆฌ้กน็ฎ้็จ MIT License ๅผๆบๅ่ฎฎใ
Made with โค๏ธ by SOLO Agent
TermRec ๆฏไธๆฌพๅผทๅคง็็ต็ซฏๆ่ฉฑ้่ฃฝ่ๅๆพๅทฅๅ ท๏ผๅฐ็บ้็ผ่ ใ้็ถญๅทฅ็จๅธซๅๆ่ก่ฌๅธซ่จญ่จใๅฎๅฏไปฅๅฎๆด่จ้็ต็ซฏไธญ็ๆๆๆไฝ๏ผๅ ๆฌๅฝไปคใ่ผธๅบใๆ้ๆณ็ญ๏ผไธฆๆฏๆๆบ่ฝๅๆพใๅๆๅๅฏๅบใ
- ๆไฝๅพฉ็คๅฐ้ฃ๏ผ่ชฟ่ฉฆ่ค้ๅ้กๆ๏ผ้ฃไปฅ่ฟฝๆบฏไนๅ็ๆไฝๆญฅ้ฉ
- ๆ็จ่ฃฝไฝ็น็ฃ๏ผ่ฃฝไฝๆ่กๆ็จๆ๏ผ้่ฆๆๅๆชๅๅ่จ้
- ๅ้ๅไฝไฝๆ๏ผ้ฃไปฅๅไบซๅฎๆด็ๆไฝๆต็จ็ตฆๅ้ๆๅก
- ๅฝไปคๆญทๅฒๅๆฃ๏ผ็ต็ซฏๆญทๅฒ่จ้ไธๅค ็ด่ง๏ผ็ผบไนไธไธๆ
- ๐ ๆบ่ฝๆๆไฟกๆฏ่ซๆ๏ผ่ชๅๆชขๆธฌไธฆ้ฑ่ๅฏ็ขผใAPI้้ฐ็ญๆๆๆธๆ
- ๐ ๆทฑๅบฆๆ่ฉฑๅๆ๏ผ็ตฑ่จๅฝไปค้ ป็ใๅท่กๆ้ใๆๅ็็ญๆๆจ
- ๐ ้ถๅค้จไพ่ณด๏ผ็ดPythonๅฏฆ็พ๏ผ็ก้่ณๆๅบซๆๅค้จๆๅ
- ๐ค ๅคๆ ผๅผๅฏๅบ๏ผๆฏๆJSONใMarkdownใHTMLใTXTๅ็จฎๆ ผๅผ
- ๐ ๅฟซ้ๆ็ดข๏ผๅจๆญทๅฒๆ่ฉฑไธญๅฟซ้ๅฎไฝ้้ตๅฝไปค
| ็นๆง | ๆ่ฟฐ |
|---|---|
| ๐ฌ ๆ่ฉฑ้่ฃฝ | ๅฎๆด่จ้ๅฝไปคใ่ผธๅบใๆ้ๆณใๅทฅไฝ็ฎ้ |
| ๆฏๆ้ๅบฆ่ชฟ็ฏใๅ้ๆญๆพใ่ทณ้ๅปถ้ฒ | |
| ๐ ๆ่ฉฑๅๆ | ๅฝไปค้ ป็็ตฑ่จใๅท่กๆ้ๅๆใๆๅ็่จ็ฎ |
| ๐ ๅฟซ้ๆ็ดข | ๅจๆญทๅฒๆ่ฉฑไธญๆ็ดขๅฝไปคๅ่ผธๅบๅ งๅฎน |
| ๐ค ๅคๆ ผๅผๅฏๅบ | JSON / Markdown / HTML / TXT |
| ๐ ๆๆๆธๆไฟ่ญท | ่ชๅๆชขๆธฌไธฆ่ซๆๅฏ็ขผใ้้ฐ็ญๆๆไฟกๆฏ |
| ๐พ ่ผ้ๅญๅฒ | JSONๆ ผๅผๅญๅฒ๏ผๆๆผ็ๆฌๆงๅถๅๅไบซ |
| ๐ฅ๏ธ ่ทจๅนณๅฐๆฏๆ | Windows / macOS / Linux |
- Python: 3.8 ๆๆด้ซ็ๆฌ
- ไฝๆฅญ็ณป็ตฑ: Windows / macOS / Linux
# ๆนๅผไธ๏ผไฝฟ็จ pip ๅฎ่ฃ
pip install termrec
# ๆนๅผไบ๏ผๅพๆบ็ขผๅฎ่ฃ
git clone https://github.com/gitstq/termrec.git
cd termrec
pip install -e .# ๆฅ็ๅนซๅฉ
termrec --help
# ้ๅง้่ฃฝๆ่ฉฑ
termrec record mysession
# ๅๅบๆๆ้่ฃฝ็ๆ่ฉฑ
termrec list
# ๅๆพๆ่ฉฑ
termrec play mysession
# ๅๆๆ่ฉฑ็ตฑ่จ
termrec analyze mysession
# ๅฏๅบๆ่ฉฑ
termrec export mysession -f markdown -o session.md
# ๆ็ดขๆ่ฉฑๅ
งๅฎน
termrec search mysession "error"# ๅบๆฌ้่ฃฝ
termrec record mysession
# ๆๅฎๅๅงๅฝไปค
termrec record deploy -c "npm run build"
# ๆทปๅ ๆๆไฟกๆฏ้ๆฟพๆจกๅผ
termrec record secure-session -s "password" -s "api_key" -s "token"# ๅบๆฌๅๆพ
termrec play mysession
# 2ๅ้ๅๆพ
termrec play mysession -s 2.0
# ๅพ็ฌฌ5ๆขๅฝไปค้ๅงๆญๆพ
termrec play mysession --start 5termrec analyze mysession# ๅฏๅบ็บ JSON
termrec export mysession -f json
# ๅฏๅบ็บ Markdown
termrec export mysession -f markdown -o session.md
# ๅฏๅบ็บ HTML
termrec export mysession -f html -o session.html- ็ฐกๅฎ่ณไธ๏ผ้ถ้ ็ฝฎๅณๅฏไฝฟ็จ๏ผๆ ธๅฟๅ่ฝ้็ฎฑๅณ็จ
- ๆธๆ้ๆ๏ผไฝฟ็จ JSON ๆ ผๅผๅญๅฒ๏ผไพฟๆผ็ๆฌๆงๅถๅไบๆฌก้็ผ
- ้ฑ็งๅชๅ ๏ผๆๆไฟกๆฏ่ชๅ่ซๆ๏ผไฟ่ญท็จๆถๆธๆๅฎๅ จ
- ่ทจๅนณๅฐๅ ผๅฎน๏ผ็ด Python ๅฏฆ็พ๏ผ็กๅนณๅฐไพ่ณด
| ็ๆฌ | ๅ่ฝ |
|---|---|
| v1.1 | ๐ผ๏ธ ๆฏๆ GIF/่ฆ้ ปๅฏๅบ |
| v1.2 | ๐ค AI ๆบ่ฝๅฝไปคๅปบ่ญฐ |
| v1.3 | โ๏ธ ้ฒ็ซฏๅๆญฅๆฏๆ |
| v1.4 | ๐ฅ ๅ้ๅไฝๅ่ฝ |
git clone https://github.com/gitstq/termrec.git
cd termrec
pip install -e ".[dev]"
python -m pytest tests/ -vpip install build
python -m buildๆญก่ฟๆๆๅฝขๅผ็่ฒข็ป๏ผ
- Fork ๆฌๅๅบซ
- ๅตๅปบๅ่ฝๅๆฏ (
git checkout -b feature/amazing-feature) - ๆไบคๆดๆน (
git commit -m 'feat: add amazing feature') - ๆจ้ๅฐๅๆฏ (
git push origin feature/amazing-feature) - ๅตๅปบ Pull Request
ๆฌๅฐๆกๆก็จ MIT License ้ๆบๅ่ญฐใ
Made with โค๏ธ by SOLO Agent
TermRec is a powerful terminal session recording and playback tool designed for developers, DevOps engineers, and technical instructors. It comprehensively records all terminal operations including commands, outputs, timestamps, and more, with support for intelligent playback, analysis, and export.
- Difficult Operation Review: Hard to trace previous steps when debugging complex issues
- Tedious Tutorial Creation: Manual screenshots and notes required for technical tutorials
- Inefficient Team Collaboration: Difficult to share complete workflows with team members
- Scattered Command History: Terminal history lacks context and is not intuitive
- ๐ Intelligent Sensitive Data Masking: Automatically detects and hides passwords, API keys, and other sensitive data
- ๐ Deep Session Analysis: Statistics on command frequency, execution time, success rate, and more
- ๐ Zero External Dependencies: Pure Python implementation, no database or external services needed
- ๐ค Multi-format Export: Supports JSON, Markdown, HTML, and TXT formats
- ๐ Quick Search: Fast locate key commands in historical sessions
| Feature | Description |
|---|---|
| ๐ฌ Session Recording | Complete recording of commands, outputs, timestamps, working directories |
| Speed adjustment, range playback, skip delays | |
| ๐ Session Analysis | Command frequency stats, execution time analysis, success rate calculation |
| ๐ Quick Search | Search commands and outputs in historical sessions |
| ๐ค Multi-format Export | JSON / Markdown / HTML / TXT |
| ๐ Sensitive Data Protection | Auto-detect and mask passwords, keys, and sensitive info |
| ๐พ Lightweight Storage | JSON format storage, easy version control and sharing |
| ๐ฅ๏ธ Cross-platform Support | Windows / macOS / Linux |
- Python: 3.8 or higher
- OS: Windows / macOS / Linux
# Option 1: Install via pip
pip install termrec
# Option 2: Install from source
git clone https://github.com/gitstq/termrec.git
cd termrec
pip install -e .# Show help
termrec --help
# Start recording a session
termrec record mysession
# List all recorded sessions
termrec list
# Play back a session
termrec play mysession
# Analyze session statistics
termrec analyze mysession
# Export a session
termrec export mysession -f markdown -o session.md
# Search within a session
termrec search mysession "error"# Basic recording
termrec record mysession
# Specify initial command
termrec record deploy -c "npm run build"
# Add sensitive data filtering patterns
termrec record secure-session -s "password" -s "api_key" -s "token"
# Specify output file
termrec record mysession -o /path/to/session.jsonDuring recording:
- Enter commands to execute, outputs are automatically recorded
- Type
exitor pressCtrl+Dto end recording - Press
Ctrl+Cto interrupt current command
# Basic playback
termrec play mysession
# 2x speed playback
termrec play mysession -s 2.0
# Start from command #5
termrec play mysession --start 5
# Play commands #5 to #10
termrec play mysession --start 5 --end 10
# Skip delays for fast playback
termrec play mysession --no-waittermrec analyze mysessionAnalysis includes:
- ๐ Session date and duration
- ๐ Total commands and success rate
- ๐ Most used commands ranking
- ๐ข Slowest executing commands
# Export as JSON
termrec export mysession -f json
# Export as Markdown
termrec export mysession -f markdown -o session.md
# Export as HTML
termrec export mysession -f html -o session.html
# Export as plain text
termrec export mysession -f txt -o session.txt# Search for commands and outputs containing "error"
termrec search mysession "error"
# Search for git-related commands
termrec search mysession "git"- Simplicity First: Zero configuration required, core features work out of the box
- Data Transparency: JSON format storage, easy version control and secondary development
- Privacy Priority: Automatic sensitive data masking to protect user data
- Cross-platform Compatibility: Pure Python implementation, no platform dependencies
| Version | Feature |
|---|---|
| v1.1 | ๐ผ๏ธ GIF/Video export support |
| v1.2 | ๐ค AI-powered command suggestions |
| v1.3 | โ๏ธ Cloud sync support |
| v1.4 | ๐ฅ Team collaboration features |
| v1.5 | ๐ฑ Web console |
# Clone repository
git clone https://github.com/gitstq/termrec.git
cd termrec
# Install dev dependencies
pip install -e ".[dev]"
# Run tests
python -m pytest tests/ -v
# Code formatting
black src/
isort src/# Install build tools
pip install build
# Build
python -m build
# Artifacts in dist/ directoryWe welcome all forms of contributions!
- Fork this repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'feat: add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Create a Pull Request
Found a bug or have a feature suggestion? Please create an issue
This project is licensed under the MIT License.
Made with โค๏ธ by SOLO Agent