{"id":51026854,"url":"https://github.com/gitstq/cmdmind","last_synced_at":"2026-06-21T20:02:26.733Z","repository":{"id":357297987,"uuid":"1236309392","full_name":"gitstq/cmdmind","owner":"gitstq","description":"🧠 AI-Powered Terminal Command Intelligence - Smart command history management with semantic search","archived":false,"fork":false,"pushed_at":"2026-05-12T06:17:19.000Z","size":28,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-12T08:25:44.646Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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.md","changelog":null,"contributing":null,"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-05-12T06:14:53.000Z","updated_at":"2026-05-12T06:17:23.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/gitstq/cmdmind","commit_stats":null,"previous_names":["gitstq/cmdmind"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/gitstq/cmdmind","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fcmdmind","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fcmdmind/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fcmdmind/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fcmdmind/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gitstq","download_url":"https://codeload.github.com/gitstq/cmdmind/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fcmdmind/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":[],"created_at":"2026-06-21T20:02:25.817Z","updated_at":"2026-06-21T20:02:26.727Z","avatar_url":"https://github.com/gitstq.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# 🧠 CmdMind\n\n**AI-Powered Terminal Command Intelligence**\n\n**智能终端命令历史管理工具**\n\n[![Python](https://img.shields.io/badge/Python-3.10%2B-blue?logo=python\u0026logoColor=white)](https://www.python.org/)\n[![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)\n[![GitHub Stars](https://img.shields.io/github/stars/gitstq/cmdmind?style=social)](https://github.com/gitstq/cmdmind/stargazers)\n\n[English](#english) | [简体中文](#简体中文) | [繁體中文](#繁體中文)\n\n\u003c/div\u003e\n\n---\n\n\u003ca name=\"english\"\u003e\u003c/a\u003e\n## 🇺🇸 English\n\n### 🎉 Introduction\n\n**CmdMind** is an intelligent terminal command history management tool that revolutionizes how you interact with your command line. Unlike traditional history tools that only store commands, CmdMind understands your commands semantically and helps you find, organize, and reuse them efficiently.\n\n**Key Pain Points Solved:**\n- 🔍 **Can't find that command** you ran last week? Semantic search finds it by description\n- 📊 **No insights** into your command patterns? Get detailed analytics and productivity scores\n- 🏷️ **Messy history**? Auto-categorization keeps everything organized\n- 💡 **Forget complex commands**? Save favorites and templates for quick access\n\n### ✨ Core Features\n\n| Feature | Description |\n|---------|-------------|\n| 🧠 **Semantic Search** | Search commands using natural language - \"find docker commands\" or \"list files\" |\n| 📊 **Smart Analytics** | Visualize your command patterns, peak productivity hours, and category distribution |\n| 🏷️ **Auto-Categorization** | Commands automatically classified into Git, Docker, NPM, Python, and 15+ categories |\n| ⭐ **Favorites System** | Mark frequently used commands for instant access |\n| 🔍 **Fuzzy Matching** | Find commands even with typos or partial matches |\n| 💾 **Local-First** | All data stored locally in SQLite - no cloud required |\n| 🎨 **Beautiful TUI** | Interactive terminal interface built with Textual |\n| 📈 **Productivity Score** | Track your command-line proficiency over time |\n\n### 🚀 Quick Start\n\n#### Requirements\n- Python 3.10 or higher\n- pip (Python package manager)\n\n#### Installation\n\n```bash\n# Install from PyPI (recommended)\npip install cmdmind\n\n# Or install from source\ngit clone https://github.com/gitstq/cmdmind.git\ncd cmdmind\npip install -e .\n```\n\n#### Basic Usage\n\n```bash\n# Launch interactive TUI\ncmdmind tui\n\n# Add a command\ncmdmind add \"docker ps -a\"\n\n# Search commands\ncmdmind search \"git\"\n\n# List recent commands\ncmdmind list\n\n# View statistics\ncmdmind stats\n\n# Get help\ncmdmind --help\n```\n\n### 📖 Detailed Usage Guide\n\n#### Interactive TUI Mode\n\nLaunch the beautiful terminal interface:\n\n```bash\ncmdmind tui\n```\n\n**Keyboard Shortcuts:**\n| Key | Action |\n|-----|--------|\n| `s` | Focus search |\n| `r` | Refresh list |\n| `f` | Toggle favorite |\n| `d` | Delete command |\n| `Enter` | Copy to clipboard |\n| `q` | Quit |\n\n#### Command Line Interface\n\n```bash\n# Add with metadata\ncmdmind add \"npm run build\" --shell bash --desc \"Build the project\"\n\n# Search with filters\ncmdmind search \"docker\" --category docker --limit 20\n\n# View command details\ncmdmind show 42\n\n# Export history\ncmdmind export --output history.json\n\n# Clear all history\ncmdmind clear --force\n```\n\n### 💡 Design Philosophy\n\nCmdMind was built with these principles:\n\n1. **Privacy First**: All data stays on your machine\n2. **Speed Matters**: SQLite + FTS5 for instant search\n3. **Developer Friendly**: CLI-first with optional TUI\n4. **Extensible**: Modular architecture for easy customization\n\n### 📦 Deployment\n\nCmdMind is a pure Python package with no external services required:\n\n```bash\n# Development\npip install -e \".[dev]\"\n\n# Run tests\npytest tests/\n\n# Build package\npython -m build\n```\n\n### 🤝 Contributing\n\nWe welcome contributions! Please see our contributing guidelines:\n\n1. Fork the repository\n2. Create a feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit changes (`git commit -m 'feat: add amazing feature'`)\n4. Push to branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n### 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n---\n\n\u003ca name=\"简体中文\"\u003e\u003c/a\u003e\n## 🇨🇳 简体中文\n\n### 🎉 项目介绍\n\n**CmdMind** 是一款智能终端命令历史管理工具，彻底改变您与命令行的交互方式。传统历史工具只能存储命令，而 CmdMind 能够语义化理解您的命令，帮助您高效查找、组织和复用它们。\n\n**解决的核心痛点：**\n- 🔍 **找不到上周执行过的命令？** 语义搜索通过描述即可找到\n- 📊 **不了解自己的命令模式？** 获取详细的分析和生产力评分\n- 🏷️ **历史记录混乱？** 自动分类让一切井井有条\n- 💡 **忘记复杂命令？** 收藏夹和模板系统快速访问\n\n### ✨ 核心特性\n\n| 特性 | 描述 |\n|------|------|\n| 🧠 **语义搜索** | 使用自然语言搜索命令 - \"查找docker命令\" 或 \"列出文件\" |\n| 📊 **智能分析** | 可视化命令模式、高峰工作时段和类别分布 |\n| 🏷️ **自动分类** | 命令自动归类到 Git、Docker、NPM、Python 等15+类别 |\n| ⭐ **收藏系统** | 标记常用命令，即时访问 |\n| 🔍 **模糊匹配** | 即使有拼写错误或部分匹配也能找到命令 |\n| 💾 **本地优先** | 所有数据存储在本地 SQLite - 无需云端 |\n| 🎨 **精美TUI** | 基于 Textual 构建的交互式终端界面 |\n| 📈 **生产力评分** | 追踪您的命令行熟练度提升 |\n\n### 🚀 快速开始\n\n#### 环境要求\n- Python 3.10 或更高版本\n- pip (Python 包管理器)\n\n#### 安装方式\n\n```bash\n# 从 PyPI 安装（推荐）\npip install cmdmind\n\n# 或从源码安装\ngit clone https://github.com/gitstq/cmdmind.git\ncd cmdmind\npip install -e .\n```\n\n#### 基本使用\n\n```bash\n# 启动交互式TUI界面\ncmdmind tui\n\n# 添加命令\ncmdmind add \"docker ps -a\"\n\n# 搜索命令\ncmdmind search \"git\"\n\n# 列出最近命令\ncmdmind list\n\n# 查看统计\ncmdmind stats\n\n# 获取帮助\ncmdmind --help\n```\n\n### 📖 详细使用指南\n\n#### 交互式TUI模式\n\n启动精美的终端界面：\n\n```bash\ncmdmind tui\n```\n\n**快捷键：**\n| 按键 | 操作 |\n|------|------|\n| `s` | 聚焦搜索 |\n| `r` | 刷新列表 |\n| `f` | 切换收藏 |\n| `d` | 删除命令 |\n| `Enter` | 复制到剪贴板 |\n| `q` | 退出 |\n\n#### 命令行界面\n\n```bash\n# 添加带元数据的命令\ncmdmind add \"npm run build\" --shell bash --desc \"构建项目\"\n\n# 带过滤条件的搜索\ncmdmind search \"docker\" --category docker --limit 20\n\n# 查看命令详情\ncmdmind show 42\n\n# 导出历史记录\ncmdmind export --output history.json\n\n# 清空所有历史\ncmdmind clear --force\n```\n\n### 💡 设计理念\n\nCmdMind 基于以下原则构建：\n\n1. **隐私优先**：所有数据保留在本地\n2. **速度至上**：SQLite + FTS5 实现即时搜索\n3. **开发者友好**：CLI优先，可选TUI\n4. **可扩展**：模块化架构，易于定制\n\n### 📦 部署指南\n\nCmdMind 是纯 Python 包，无需外部服务：\n\n```bash\n# 开发环境\npip install -e \".[dev]\"\n\n# 运行测试\npytest tests/\n\n# 构建包\npython -m build\n```\n\n### 🤝 贡献指南\n\n欢迎贡献代码！请遵循以下步骤：\n\n1. Fork 本仓库\n2. 创建功能分支 (`git checkout -b feature/amazing-feature`)\n3. 提交更改 (`git commit -m 'feat: 添加新功能'`)\n4. 推送到分支 (`git push origin feature/amazing-feature`)\n5. 提交 Pull Request\n\n### 📄 开源协议\n\n本项目采用 MIT 协议开源 - 详见 [LICENSE](LICENSE) 文件。\n\n---\n\n\u003ca name=\"繁體中文\"\u003e\u003c/a\u003e\n## 🇹🇼 繁體中文\n\n### 🎉 專案介紹\n\n**CmdMind** 是一款智慧型終端命令歷史管理工具，徹底改變您與命令列的互動方式。傳統歷史工具只能儲存命令，而 CmdMind 能夠語意化理解您的命令，幫助您高效查找、組織和複用它們。\n\n**解決的核心痛點：**\n- 🔍 **找不到上週執行過的命令？** 語意搜尋透過描述即可找到\n- 📊 **不了解自己的命令模式？** 取得詳細的分析和生產力評分\n- 🏷️ **歷史記錄混亂？** 自動分類讓一切井然有序\n- 💡 **忘記複雜命令？** 收藏夾和範本系統快速存取\n\n### ✨ 核心特性\n\n| 特性 | 描述 |\n|------|------|\n| 🧠 **語意搜尋** | 使用自然語言搜尋命令 - 「尋找docker命令」或「列出檔案」 |\n| 📊 **智慧分析** | 視覺化命令模式、高峰工作時段和類別分佈 |\n| 🏷️ **自動分類** | 命令自動歸類到 Git、Docker、NPM、Python 等15+類別 |\n| ⭐ **收藏系統** | 標記常用命令，即時存取 |\n| 🔍 **模糊匹配** | 即使有拼寫錯誤或部分匹配也能找到命令 |\n| 💾 **本地優先** | 所有資料儲存在本地 SQLite - 無需雲端 |\n| 🎨 **精美TUI** | 基於 Textual 建構的互動式終端介面 |\n| 📈 **生產力評分** | 追蹤您的命令列熟練度提升 |\n\n### 🚀 快速開始\n\n#### 環境要求\n- Python 3.10 或更高版本\n- pip (Python 套件管理器)\n\n#### 安裝方式\n\n```bash\n# 從 PyPI 安裝（推薦）\npip install cmdmind\n\n# 或從原始碼安裝\ngit clone https://github.com/gitstq/cmdmind.git\ncd cmdmind\npip install -e .\n```\n\n#### 基本使用\n\n```bash\n# 啟動互動式TUI介面\ncmdmind tui\n\n# 新增命令\ncmdmind add \"docker ps -a\"\n\n# 搜尋命令\ncmdmind search \"git\"\n\n# 列出最近命令\ncmdmind list\n\n# 查看統計\ncmdmind stats\n\n# 取得說明\ncmdmind --help\n```\n\n### 📖 詳細使用指南\n\n#### 互動式TUI模式\n\n啟動精美的終端介面：\n\n```bash\ncmdmind tui\n```\n\n**快速鍵：**\n| 按鍵 | 操作 |\n|------|------|\n| `s` | 聚焦搜尋 |\n| `r` | 重新整理列表 |\n| `f` | 切換收藏 |\n| `d` | 刪除命令 |\n| `Enter` | 複製到剪貼簿 |\n| `q` | 離開 |\n\n#### 命令列介面\n\n```bash\n# 新增帶元資料的命令\ncmdmind add \"npm run build\" --shell bash --desc \"建置專案\"\n\n# 帶過濾條件的搜尋\ncmdmind search \"docker\" --category docker --limit 20\n\n# 查看命令詳情\ncmdmind show 42\n\n# 匯出歷史記錄\ncmdmind export --output history.json\n\n# 清空所有歷史\ncmdmind clear --force\n```\n\n### 💡 設計理念\n\nCmdMind 基於以下原則建構：\n\n1. **隱私優先**：所有資料保留在本地\n2. **速度至上**：SQLite + FTS5 實現即時搜尋\n3. **開發者友善**：CLI優先，可選TUI\n4. **可擴展**：模組化架構，易於客製化\n\n### 📦 部署指南\n\nCmdMind 是純 Python 套件，無需外部服務：\n\n```bash\n# 開發環境\npip install -e \".[dev]\"\n\n# 執行測試\npytest tests/\n\n# 建置套件\npython -m build\n```\n\n### 🤝 貢獻指南\n\n歡迎貢獻程式碼！請遵循以下步驟：\n\n1. Fork 本儲存庫\n2. 建立功能分支 (`git checkout -b feature/amazing-feature`)\n3. 提交變更 (`git commit -m 'feat: 新增功能'`)\n4. 推送到分支 (`git push origin feature/amazing-feature`)\n5. 提交 Pull Request\n\n### 📄 開源授權\n\n本專案採用 MIT 授權條款開源 - 詳見 [LICENSE](LICENSE) 檔案。\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**Made with ❤️ by the CmdMind Team**\n\n[⬆ Back to Top](#cmdmind)\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgitstq%2Fcmdmind","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgitstq%2Fcmdmind","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgitstq%2Fcmdmind/lists"}