{"id":51026563,"url":"https://github.com/gitstq/agentscribe","last_synced_at":"2026-06-21T20:02:03.739Z","repository":{"id":364828354,"uuid":"1269367574","full_name":"gitstq/agentscribe","owner":"gitstq","description":"📊 AI编码代理会话记录与智能分析工具 - Record, analyze and visualize AI coding agent sessions (Claude Code, Cursor, Windsurf, Copilot) 💻","archived":false,"fork":false,"pushed_at":"2026-06-14T16:19:53.000Z","size":100,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-14T18:13:21.284Z","etag":null,"topics":["ai","analytics","claude-code","cli","code-analysis","cursor","developer-tools","productivity","python","session-recorder"],"latest_commit_sha":null,"homepage":"https://github.com/gitstq/agentscribe","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gitstq.png","metadata":{"files":{"readme":"README.en.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-14T16:17:21.000Z","updated_at":"2026-06-14T16:20:00.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/gitstq/agentscribe","commit_stats":null,"previous_names":["gitstq/agentscribe"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/gitstq/agentscribe","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fagentscribe","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fagentscribe/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fagentscribe/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fagentscribe/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gitstq","download_url":"https://codeload.github.com/gitstq/agentscribe/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fagentscribe/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34623906,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-21T02:00:05.568Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","analytics","claude-code","cli","code-analysis","cursor","developer-tools","productivity","python","session-recorder"],"created_at":"2026-06-21T20:02:03.080Z","updated_at":"2026-06-21T20:02:03.728Z","avatar_url":"https://github.com/gitstq.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 📊 AgentScribe\n\n\u003e **AI Coding Agent Session Recorder \u0026 Analytics Tool**\n\u003e Record, analyze and visualize AI coding agent sessions (Claude Code, Cursor, Windsurf, Copilot)\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"agentscribe_logo.jpg\" alt=\"AgentScribe Logo\" width=\"300\" style=\"border-radius: 16px;\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/gitstq/agentscribe\"\u003e\u003cimg src=\"https://img.shields.io/github/stars/gitstq/agentscribe?style=flat-square\u0026logo=github\" alt=\"GitHub Stars\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/gitstq/agentscribe/blob/main/LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/github/license/gitstq/agentscribe?style=flat-square\" alt=\"MIT License\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://www.python.org/downloads/\"\u003e\u003cimg src=\"https://img.shields.io/badge/python-3.10%2B-blue?style=flat-square\u0026logo=python\" alt=\"Python 3.10+\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/gitstq/agentscribe/releases\"\u003e\u003cimg src=\"https://img.shields.io/github/v/release/gitstq/agentscribe?style=flat-square\" alt=\"Latest Release\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/gitstq/agentscribe/issues\"\u003e\u003cimg src=\"https://img.shields.io/github/issues/gitstq/agentscribe?style=flat-square\" alt=\"Issues\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n## 🎉 Introduction\n\n**AgentScribe** is a **session recording and analytics tool** designed for AI coding agents. It records, replays, and analyzes your interactions with AI coding agents (such as Claude Code, Cursor, Windsurf, GitHub Copilot, Codex, and more), helping you to:\n\n- 📈 **Understand Agent Behavior** - Track decision processes and tool calls in every session\n- 💰 **Optimize Token Costs** - Count token consumption, estimate usage costs\n- 🔍 **Retrospective Sessions** - Quickly search and replay past coding sessions\n- 📊 **Generate Analytics Reports** - Output beautiful HTML visualization reports\n- 🧠 **Discover Usage Patterns** - Identify high-frequency tool calls and coding patterns\n\n\u003e **Design Philosophy:** Local-first, data privacy paramount. All session data is stored in your local SQLite database — no network required, no data leakage risk.\n\n---\n\n## ✨ Key Features\n\n| Feature | Description |\n|---------|-------------|\n| 🎬 **Session Recording** | Interactively record complete AI coding agent sessions including user messages, AI responses, and tool calls |\n| 📋 **Session List** | Browse historical sessions by time, agent, model, and more |\n| 🔍 **Detail View** | Dive into each message's content, token consumption, and tool call details |\n| 📊 **Global Statistics** | Aggregate token, cost, and duration statistics across all sessions |\n| 📈 **HTML Reports** | Generate beautiful interactive HTML analytics reports for sharing and archiving |\n| 💾 **Data Export** | Export sessions in JSON and Markdown formats |\n| 🤖 **Multi-Agent Support** | Compatible with Claude Code, Cursor, Windsurf, GitHub Copilot, Codex and more |\n| 🖥️ **Interactive Dashboard** | Built-in interactive CLI dashboard for one-stop session management |\n| 🏷️ **Tag System** | Add custom tags to sessions for easy categorization and retrieval |\n| 🧹 **Data Management** | Session deletion and batch cleanup functionality |\n\n---\n\n## 🚀 Quick Start\n\n### Prerequisites\n\n- Python 3.10+\n- pip (Python package manager)\n\n### One-Click Install\n\n```bash\n# Option 1: pip install (recommended)\npip install agentscribe\n\n# Option 2: Install from source\ngit clone https://github.com/gitstq/agentscribe.git\ncd agentscribe\npip install -e .\n\n# Option 3: Use install script\nchmod +x scripts/install.sh\n./scripts/install.sh\n```\n\n### Verify Installation\n\n```bash\nagentscribe --version\nagentscribe --help\n```\n\n---\n\n## 📖 Usage Guide\n\n### 📋 List Sessions\n\n```bash\n# List recent 20 sessions\nagentscribe list\n\n# Filter by specific agent\nagentscribe list --agent claude-code\n\n# JSON format output\nagentscribe list --json\n```\n\n### 🎬 Record a New Session\n\n```bash\n# Interactive recording\nagentscribe record\n\n# Specify agent and model\nagentscribe record --agent cursor --model gpt-4o --project /path/to/project\n\n# Add tags\nagentscribe record --tag frontend --tag refactor\n```\n\n### 🔍 View Session Details\n\n```bash\n# View specific session details\nagentscribe view session_20260614_1a2b3c4d\n\n# JSON format output\nagentscribe view session_20260614_1a2b3c4d --json\n```\n\n### 📊 View Statistics\n\n```bash\n# View global statistics\nagentscribe stats\n```\n\n### 📈 Generate Report\n\n```bash\n# Generate HTML analytics report\nagentscribe report\n\n# Specify output path and auto-open\nagentscribe report --output ./report.html --open\n```\n\n### 💾 Export Session\n\n```bash\n# Export as JSON\nagentscribe export session_20260614_1a2b3c4d\n\n# Export as Markdown\nagentscribe export session_20260614_1a2b3c4d --format markdown\n```\n\n### 🗑️ Delete Session\n\n```bash\nagentscribe delete session_20260614_1a2b3c4d\n```\n\n### 🖥️ Interactive Dashboard\n\n```bash\n# Start interactive mode\nagentscribe dashboard\n```\n\n---\n\n## 💡 Design Philosophy \u0026 Roadmap\n\n### Design Principles\n\n1. **Local-First** - All data stored in local SQLite, no network required, privacy secure\n2. **CLI Native** - Powerful command-line interface suitable for developer daily workflow\n3. **Modular Architecture** - Storage, analysis, and reporting modules are independent and extensible\n4. **Open Formats** - Support JSON/Markdown/HTML multiple data export formats\n\n### Architecture\n\n```\nagentscribe/\n├── agentscribe/          # Core package\n│   ├── cli.py            # CLI entry point (Click framework)\n│   ├── storage.py        # SQLite storage engine\n│   ├── analyzer.py       # Analysis engine (cost/pattern/stats)\n│   ├── reporter.py       # HTML report generator\n│   ├── models.py         # Data models\n│   ├── config.py         # Configuration management\n│   └── utils.py          # Utility functions\n├── tests/                # Unit tests\n├── scripts/              # Install scripts\n├── setup.py              # Build configuration\n└── requirements.txt      # Dependency management\n```\n\n### Roadmap\n\n- **v0.2.0** - Automatic agent session sniffing (no manual recording)\n- **v0.3.0** - Cross-session pattern recognition and smart suggestions\n- **v0.4.0** - Multi-user/team collaboration support\n- **v0.5.0** - Web visualization dashboard\n- **v1.0.0** - Stable release, plugin ecosystem\n\n---\n\n## 📦 Build \u0026 Deploy\n\n### Build Distribution Package\n\n```bash\n# Install build tools\npip install build\n\n# Build source and wheel packages\npython -m build\n\n# Artifacts in dist/\nls dist/\n```\n\n### Run Tests\n\n```bash\n# Install test dependencies\npip install pytest flake8\n\n# Run all tests\npytest tests/ -v\n\n# Run code linting\nflake8 agentscribe/\n```\n\n---\n\n## 🤝 Contributing\n\nContributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details.\n\n- 🐛 **Report Bugs** - [Create an Issue](https://github.com/gitstq/agentscribe/issues/new?template=bug_report.md)\n- 💡 **Feature Requests** - [Submit a Feature Request](https://github.com/gitstq/agentscribe/issues/new?template=feature_request.md)\n- 📝 **Improve Docs** - Help us improve documentation quality\n- 🔧 **Submit Code** - Submit a Pull Request to fix issues or add features\n\n---\n\n## 📄 License\n\nThis project is open-sourced under the [MIT License](LICENSE).\n\n---\n\n\u003cp align=\"center\"\u003e\n  \u003cb\u003eAgentScribe\u003c/b\u003e — Make every AI coding agent interaction traceable 🚀\n  \u003cbr\u003e\n  \u003ca href=\"https://github.com/gitstq/agentscribe\"\u003eGitHub\u003c/a\u003e ·\n  \u003ca href=\"https://github.com/gitstq/agentscribe/issues\"\u003eIssues\u003c/a\u003e ·\n  \u003ca href=\"https://github.com/gitstq/agentscribe/releases\"\u003eReleases\u003c/a\u003e\n\u003c/p\u003e","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgitstq%2Fagentscribe","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgitstq%2Fagentscribe","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgitstq%2Fagentscribe/lists"}