{"id":51026942,"url":"https://github.com/gitstq/timeflow-cli","last_synced_at":"2026-06-21T20:02:37.260Z","repository":{"id":361205387,"uuid":"1253539175","full_name":"gitstq/timeflow-cli","owner":"gitstq","description":"智能命令行时间追踪工具 | A smart CLI time tracking tool with Pomodoro support","archived":false,"fork":false,"pushed_at":"2026-05-29T15:12:18.000Z","size":21,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-29T17:08:16.114Z","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-29T15:10:11.000Z","updated_at":"2026-05-29T15:12:07.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/gitstq/timeflow-cli","commit_stats":null,"previous_names":["gitstq/timeflow-cli"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/gitstq/timeflow-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Ftimeflow-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Ftimeflow-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Ftimeflow-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Ftimeflow-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gitstq","download_url":"https://codeload.github.com/gitstq/timeflow-cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Ftimeflow-cli/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:37.193Z","updated_at":"2026-06-21T20:02:37.250Z","avatar_url":"https://github.com/gitstq.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🕐 TimeFlow CLI\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003e智能命令行时间追踪工具\u003c/strong\u003e\u003cbr\u003e\n  \u003cstrong\u003eA Smart Command-Line Time Tracking Tool with Pomodoro Support\u003c/strong\u003e\u003cbr\u003e\n  \u003cstrong\u003e智慧型命令列時間追蹤工具\u003c/strong\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"#简体中文\"\u003e简体中文\u003c/a\u003e •\n  \u003ca href=\"#繁體中文\"\u003e繁體中文\u003c/a\u003e •\n  \u003ca href=\"#english\"\u003eEnglish\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Python-3.8+-blue.svg\" alt=\"Python 3.8+\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/License-MIT-green.svg\" alt=\"MIT License\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey.svg\" alt=\"Platform\"\u003e\n\u003c/p\u003e\n\n---\n\n\u003ca name=\"简体中文\"\u003e\u003c/a\u003e\n# 🎉 简体中文\n\n## ✨ 核心特性\n\n- ⏱️ **简单高效的时间追踪** - 一键开始/停止任务计时\n- 🍅 **番茄钟工作法** - 内置25/5分钟专注工作循环\n- 📊 **多维度统计报表** - 日/周/月视图，直观了解时间分配\n- 📁 **项目管理** - 按项目组织任务，清晰分类\n- 🏷️ **智能分类** - 开发、会议、学习等多种预设分类\n- 📤 **灵活导出** - 支持 JSON、CSV、Markdown 格式导出\n- 🎨 **精美终端界面** - 使用 Rich 库打造优雅的命令行体验\n- 💾 **本地数据存储** - SQLite 数据库，数据安全可靠\n\n## 🚀 快速开始\n\n### 安装\n\n```bash\n# 使用 pip 安装\npip install timeflow-cli\n\n# 或使用源码安装\ngit clone https://github.com/gitstq/timeflow-cli.git\ncd timeflow-cli\npip install -e .\n```\n\n### 基础用法\n\n```bash\n# 开始追踪一个任务\ntimeflow start \"编写代码\" --project myapp --category development\n\n# 查看当前状态\ntimeflow status\n\n# 停止追踪\ntimeflow stop\n\n# 查看今日报告\ntimeflow report today\n\n# 查看本周报告\ntimeflow report week\n```\n\n### 🍅 番茄钟模式\n\n```bash\n# 启动番茄钟（25分钟专注 + 5分钟休息）\ntimeflow pomodoro start \"专注工作\" --project study\n\n# 查看番茄钟状态\ntimeflow pomodoro status\n\n# 停止番茄钟\ntimeflow pomodoro stop\n```\n\n## 📖 详细使用指南\n\n### 任务管理\n\n```bash\n# 列出所有任务\ntimeflow task list\n\n# 添加新任务\ntimeflow task add \"学习Python\" --project study --category learning\n\n# 删除任务\ntimeflow task delete 1\n```\n\n### 项目管理\n\n```bash\n# 列出所有项目\ntimeflow project list\n\n# 添加新项目\ntimeflow project add \"个人学习\" --description \"我的学习计划\"\n```\n\n### 数据导出\n\n```bash\n# 导出为 JSON\ntimeflow report export -f json\n\n# 导出为 CSV\ntimeflow report export -f csv -o ~/timeflow.csv\n\n# 导出为 Markdown 报告\ntimeflow report export -f md -s 2025-01-01 -e 2025-01-31\n```\n\n### 查看历史\n\n```bash\n# 查看最近20条记录\ntimeflow history\n\n# 查看特定项目的记录\ntimeflow history --project myapp\n```\n\n## 💡 设计思路\n\nTimeFlow CLI 的设计理念是**简单、专注、高效**。我们相信：\n\n- **最小化干扰** - 命令行工具不会打扰你的工作流\n- **数据所有权** - 所有数据存储在本地，你完全掌控\n- **灵活分类** - 项目和分类系统适应不同工作方式\n- **番茄工作法** - 科学的专注时间管理方法\n\n## 📦 技术栈\n\n- **Python 3.8+** - 现代 Python 语法\n- **Click** - 强大的命令行框架\n- **Rich** - 精美的终端输出\n- **SQLite** - 轻量级本地数据库\n\n## 🤝 贡献指南\n\n欢迎提交 Issue 和 Pull Request！\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) 协议开源。\n\n---\n\n\u003ca name=\"繁體中文\"\u003e\u003c/a\u003e\n# 🎉 繁體中文\n\n## ✨ 核心特性\n\n- ⏱️ **簡單高效的時間追蹤** - 一鍵開始/停止任務計時\n- 🍅 **番茄鐘工作法** - 內置25/5分鐘專注工作循環\n- 📊 **多維度統計報表** - 日/週/月視圖，直觀了解時間分配\n- 📁 **專案管理** - 按專案組織任務，清晰分類\n- 🏷️ **智慧分類** - 開發、會議、學習等多種預設分類\n- 📤 **靈活匯出** - 支援 JSON、CSV、Markdown 格式匯出\n- 🎨 **精美終端介面** - 使用 Rich 庫打造優雅的命令列體驗\n- 💾 **本地資料儲存** - SQLite 資料庫，資料安全可靠\n\n## 🚀 快速開始\n\n### 安裝\n\n```bash\n# 使用 pip 安裝\npip install timeflow-cli\n\n# 或使用原始碼安裝\ngit clone https://github.com/gitstq/timeflow-cli.git\ncd timeflow-cli\npip install -e .\n```\n\n### 基礎用法\n\n```bash\n# 開始追蹤一個任務\ntimeflow start \"編寫程式碼\" --project myapp --category development\n\n# 查看目前狀態\ntimeflow status\n\n# 停止追蹤\ntimeflow stop\n\n# 查看今日報告\ntimeflow report today\n\n# 查看本週報告\ntimeflow report week\n```\n\n### 🍅 番茄鐘模式\n\n```bash\n# 啟動番茄鐘（25分鐘專注 + 5分鐘休息）\ntimeflow pomodoro start \"專注工作\" --project study\n\n# 查看番茄鐘狀態\ntimeflow pomodoro status\n\n# 停止番茄鐘\ntimeflow pomodoro stop\n```\n\n## 📖 詳細使用指南\n\n### 任務管理\n\n```bash\n# 列出所有任務\ntimeflow task list\n\n# 新增新任務\ntimeflow task add \"學習Python\" --project study --category learning\n\n# 刪除任務\ntimeflow task delete 1\n```\n\n### 專案管理\n\n```bash\n# 列出所有專案\ntimeflow project list\n\n# 新增新專案\ntimeflow project add \"個人學習\" --description \"我的學習計畫\"\n```\n\n### 資料匯出\n\n```bash\n# 匯出為 JSON\ntimeflow report export -f json\n\n# 匯出為 CSV\ntimeflow report export -f csv -o ~/timeflow.csv\n\n# 匯出為 Markdown 報告\ntimeflow report export -f md -s 2025-01-01 -e 2025-01-31\n```\n\n### 查看歷史\n\n```bash\n# 查看最近20筆記錄\ntimeflow history\n\n# 查看特定專案的記錄\ntimeflow history --project myapp\n```\n\n## 💡 設計理念\n\nTimeFlow CLI 的設計理念是**簡單、專注、高效**。我們相信：\n\n- **最小化干擾** - 命令列工具不會打擾你的工作流\n- **資料所有權** - 所有資料儲存在本地，你完全掌控\n- **靈活分類** - 專案和分類系統適應不同工作方式\n- **番茄工作法** - 科學的專注時間管理方法\n\n## 📦 技術架構\n\n- **Python 3.8+** - 現代 Python 語法\n- **Click** - 強大的命令列框架\n- **Rich** - 精美的終端輸出\n- **SQLite** - 輕量級本地資料庫\n\n## 🤝 貢獻指南\n\n歡迎提交 Issue 和 Pull Request！\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) 協議開源。\n\n---\n\n\u003ca name=\"english\"\u003e\u003c/a\u003e\n# 🎉 English\n\n## ✨ Core Features\n\n- ⏱️ **Simple \u0026 Efficient Time Tracking** - One-click start/stop task timing\n- 🍅 **Pomodoro Technique** - Built-in 25/5 minute focus work cycles\n- 📊 **Multi-dimensional Reports** - Day/week/month views for time allocation insights\n- 📁 **Project Management** - Organize tasks by projects with clear categorization\n- 🏷️ **Smart Categories** - Development, meetings, learning, and more preset categories\n- 📤 **Flexible Export** - Export to JSON, CSV, and Markdown formats\n- 🎨 **Beautiful Terminal UI** - Elegant command-line experience with Rich library\n- 💾 **Local Data Storage** - SQLite database for secure and reliable data\n\n## 🚀 Quick Start\n\n### Installation\n\n```bash\n# Install via pip\npip install timeflow-cli\n\n# Or install from source\ngit clone https://github.com/gitstq/timeflow-cli.git\ncd timeflow-cli\npip install -e .\n```\n\n### Basic Usage\n\n```bash\n# Start tracking a task\ntimeflow start \"Coding\" --project myapp --category development\n\n# Check current status\ntimeflow status\n\n# Stop tracking\ntimeflow stop\n\n# View today's report\ntimeflow report today\n\n# View weekly report\ntimeflow report week\n```\n\n### 🍅 Pomodoro Mode\n\n```bash\n# Start Pomodoro (25min focus + 5min break)\ntimeflow pomodoro start \"Focus Work\" --project study\n\n# Check Pomodoro status\ntimeflow pomodoro status\n\n# Stop Pomodoro\ntimeflow pomodoro stop\n```\n\n## 📖 Detailed Usage Guide\n\n### Task Management\n\n```bash\n# List all tasks\ntimeflow task list\n\n# Add new task\ntimeflow task add \"Learn Python\" --project study --category learning\n\n# Delete task\ntimeflow task delete 1\n```\n\n### Project Management\n\n```bash\n# List all projects\ntimeflow project list\n\n# Add new project\ntimeflow project add \"Personal Study\" --description \"My learning plan\"\n```\n\n### Data Export\n\n```bash\n# Export as JSON\ntimeflow report export -f json\n\n# Export as CSV\ntimeflow report export -f csv -o ~/timeflow.csv\n\n# Export as Markdown report\ntimeflow report export -f md -s 2025-01-01 -e 2025-01-31\n```\n\n### View History\n\n```bash\n# View recent 20 entries\ntimeflow history\n\n# View entries for specific project\ntimeflow history --project myapp\n```\n\n## 💡 Design Philosophy\n\nTimeFlow CLI is designed with **simplicity, focus, and efficiency** in mind. We believe:\n\n- **Minimal Distraction** - CLI tools won't interrupt your workflow\n- **Data Ownership** - All data stored locally, you have full control\n- **Flexible Categorization** - Project and category system adapts to different workflows\n- **Pomodoro Technique** - Scientific time management for focused work\n\n## 📦 Tech Stack\n\n- **Python 3.8+** - Modern Python syntax\n- **Click** - Powerful CLI framework\n- **Rich** - Beautiful terminal output\n- **SQLite** - Lightweight local database\n\n## 🤝 Contributing\n\nContributions are welcome! Please feel free to submit Issues and Pull Requests.\n\n1. Fork this repository\n2. Create a feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'feat: Add some feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Create a Pull Request\n\n## 📄 License\n\nThis project is licensed under the [MIT](LICENSE) License.\n\n---\n\n\u003cp align=\"center\"\u003e\n  Made with ❤️ by TimeFlow Team\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgitstq%2Ftimeflow-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgitstq%2Ftimeflow-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgitstq%2Ftimeflow-cli/lists"}