{"id":51026684,"url":"https://github.com/gitstq/devtime-cli","last_synced_at":"2026-06-21T20:02:13.626Z","repository":{"id":361629045,"uuid":"1255186059","full_name":"gitstq/devtime-cli","owner":"gitstq","description":"A powerful command-line time tracking tool for developers - Track time spent on projects and tasks with ease","archived":false,"fork":false,"pushed_at":"2026-05-31T14:18:17.000Z","size":18,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-31T16:12:32.018Z","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-31T14:13:24.000Z","updated_at":"2026-05-31T14:18:02.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/gitstq/devtime-cli","commit_stats":null,"previous_names":["gitstq/devtime-cli"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/gitstq/devtime-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fdevtime-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fdevtime-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fdevtime-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fdevtime-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gitstq","download_url":"https://codeload.github.com/gitstq/devtime-cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fdevtime-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:12.778Z","updated_at":"2026-06-21T20:02:13.612Z","avatar_url":"https://github.com/gitstq.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# ⏱️ DevTime CLI\n\n**A powerful command-line time tracking tool for developers**\n\n[![Python](https://img.shields.io/badge/Python-3.8%2B-blue)](https://www.python.org/)\n[![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)\n[![Platform](https://img.shields.io/badge/Platform-Linux%20%7C%20macOS%20%7C%20Windows-lightgrey)]()\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\nDevTime CLI is a powerful yet simple command-line time tracking tool designed specifically for developers. Track time spent on projects and tasks directly from your terminal without switching contexts or opening heavy GUI applications.\n\n### Why DevTime CLI?\n\n- 🚀 **Stay in Flow**: No context switching - track time without leaving your terminal\n- 💾 **Privacy First**: All data stored locally in SQLite - no cloud, no accounts\n- ⚡ **Lightning Fast**: Built with performance in mind, starts instantly\n- 🎨 **Beautiful Output**: Rich terminal UI with colors, tables, and progress indicators\n- 📤 **Export Freedom**: Export your data to CSV or JSON anytime\n\n## ✨ Core Features\n\n| Feature | Description | Emoji |\n|---------|-------------|-------|\n| **Project Management** | Organize work into multiple projects | 📁 |\n| **Task Tracking** | Track time for individual tasks within projects | 📋 |\n| **Simple Timer** | Start/stop timers with single commands | ⏱️ |\n| **Rich Reports** | View detailed statistics and time analytics | 📊 |\n| **Data Export** | Export to CSV and JSON formats | 📤 |\n| **Local Storage** | SQLite database - your data stays on your machine | 💾 |\n| **Cross-Platform** | Works on Linux, macOS, and Windows | 🖥️ |\n\n## 🚀 Quick Start\n\n### Installation\n\n```bash\n# Install from PyPI (recommended)\npip install devtime-cli\n\n# Or install from source\ngit clone https://github.com/gitstq/devtime-cli.git\ncd devtime-cli\npip install -e .\n```\n\n### Requirements\n\n- Python 3.8 or higher\n- pip package manager\n\n### Basic Usage\n\n```bash\n# Create your first project\ndevtime project create \"My Awesome Project\" --description \"Building something cool\"\n\n# Add tasks to your project\ndevtime task create \"My Awesome Project\" \"Feature Development\"\ndevtime task create \"My Awesome Project\" \"Bug Fixes\"\n\n# Start tracking time\ndevtime start \"My Awesome Project\" \"Feature Development\"\n\n# Check timer status\ndevtime status\n\n# Stop tracking\ndevtime stop\n\n# View reports\ndevtime report projects\ndevtime report tasks\ndevtime report daily\n```\n\n## 📖 Detailed Usage Guide\n\n### Project Commands\n\n```bash\n# Create a new project\ndevtime project create \"Project Name\" --description \"Optional description\"\n\n# List all projects\ndevtime project list\n\n# Delete a project (with confirmation)\ndevtime project delete \"Project Name\"\n```\n\n### Task Commands\n\n```bash\n# Create a task in a project\ndevtime task create \"Project Name\" \"Task Name\" --description \"Optional description\"\n\n# List all tasks (optionally filter by project)\ndevtime task list\ndevtime task list \"Project Name\"\n\n# Delete a task\ndevtime task delete \"Project Name\" \"Task Name\"\n```\n\n### Timer Commands\n\n```bash\n# Start tracking time for a task\ndevtime start \"Project Name\" \"Task Name\" --notes \"Optional notes\"\n\n# Check current timer status\ndevtime status\n\n# Stop the current timer\ndevtime stop\n```\n\n### Report Commands\n\n```bash\n# View time entries with filters\ndevtime report entries --project \"Project Name\" --from 2025-01-01 --to 2025-01-31\n\n# View project statistics\ndevtime report projects\n\n# View task statistics\ndevtime report tasks \"Project Name\"\n\n# View daily statistics\ndevtime report daily --days 30\n```\n\n### Export Commands\n\n```bash\n# Export to CSV\ndevtime export csv ~/timetrack_data.csv --project \"Project Name\"\n\n# Export to JSON\ndevtime export json ~/timetrack_data.json --from 2025-01-01\n```\n\n## 💡 Design Philosophy\n\nDevTime CLI was built with these principles:\n\n1. **Developer-First**: Designed for developers who live in the terminal\n2. **Zero Friction**: Minimal commands to start tracking\n3. **Data Ownership**: Your data stays local, always\n4. **Unix Philosophy**: Do one thing well - track time\n\n## 📦 Development\n\n### Setup Development Environment\n\n```bash\ngit clone https://github.com/gitstq/devtime-cli.git\ncd devtime-cli\npython -m venv venv\nsource venv/bin/activate  # On Windows: venv\\Scripts\\activate\npip install -e .\n```\n\n### Running Tests\n\n```bash\npython -m pytest tests/\n```\n\n## 🤝 Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your changes (`git commit -m 'feat: Add some AmazingFeature'`)\n4. Push to the branch (`git push origin feature/AmazingFeature`)\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\nDevTime CLI 是一款专为开发者设计的强大而简洁的命令行时间追踪工具。无需切换上下文或打开笨重的 GUI 应用，直接在终端中追踪项目和任务的时间消耗。\n\n### 为什么选择 DevTime CLI？\n\n- 🚀 **保持专注**：无需切换上下文 - 在终端内即可完成时间追踪\n- 💾 **隐私优先**：所有数据存储在本地 SQLite 中 - 无云端，无需账户\n- ⚡ **极速启动**：以性能为核心设计，瞬间启动\n- 🎨 **美观输出**：富文本终端界面，支持颜色、表格和进度指示器\n- 📤 **自由导出**：随时将数据导出为 CSV 或 JSON 格式\n\n## ✨ 核心特性\n\n| 特性 | 描述 | 图标 |\n|---------|-------------|-------|\n| **项目管理** | 将工作组织到多个项目中 | 📁 |\n| **任务追踪** | 追踪项目内各个任务的时间 | 📋 |\n| **简单计时器** | 使用单条命令启动/停止计时 | ⏱️ |\n| **丰富报告** | 查看详细的统计和时间分析 | 📊 |\n| **数据导出** | 支持 CSV 和 JSON 格式导出 | 📤 |\n| **本地存储** | SQLite 数据库 - 数据始终保存在您的设备上 | 💾 |\n| **跨平台** | 支持 Linux、macOS 和 Windows | 🖥️ |\n\n## 🚀 快速开始\n\n### 安装\n\n```bash\n# 从 PyPI 安装（推荐）\npip install devtime-cli\n\n# 或从源码安装\ngit clone https://github.com/gitstq/devtime-cli.git\ncd devtime-cli\npip install -e .\n```\n\n### 环境要求\n\n- Python 3.8 或更高版本\n- pip 包管理器\n\n### 基本用法\n\n```bash\n# 创建您的第一个项目\ndevtime project create \"我的项目\" --description \"构建酷炫的东西\"\n\n# 为项目添加任务\ndevtime task create \"我的项目\" \"功能开发\"\ndevtime task create \"我的项目\" \"Bug 修复\"\n\n# 开始追踪时间\ndevtime start \"我的项目\" \"功能开发\"\n\n# 查看计时器状态\ndevtime status\n\n# 停止追踪\ndevtime stop\n\n# 查看报告\ndevtime report projects\ndevtime report tasks\ndevtime report daily\n```\n\n## 📖 详细使用指南\n\n### 项目命令\n\n```bash\n# 创建新项目\ndevtime project create \"项目名称\" --description \"可选描述\"\n\n# 列出所有项目\ndevtime project list\n\n# 删除项目（带确认）\ndevtime project delete \"项目名称\"\n```\n\n### 任务命令\n\n```bash\n# 在项目中创建任务\ndevtime task create \"项目名称\" \"任务名称\" --description \"可选描述\"\n\n# 列出所有任务（可选按项目筛选）\ndevtime task list\ndevtime task list \"项目名称\"\n\n# 删除任务\ndevtime task delete \"项目名称\" \"任务名称\"\n```\n\n### 计时器命令\n\n```bash\n# 开始追踪任务时间\ndevtime start \"项目名称\" \"任务名称\" --notes \"可选备注\"\n\n# 查看当前计时器状态\ndevtime status\n\n# 停止当前计时器\ndevtime stop\n```\n\n### 报告命令\n\n```bash\n# 查看时间条目（带筛选）\ndevtime report entries --project \"项目名称\" --from 2025-01-01 --to 2025-01-31\n\n# 查看项目统计\ndevtime report projects\n\n# 查看任务统计\ndevtime report tasks \"项目名称\"\n\n# 查看每日统计\ndevtime report daily --days 30\n```\n\n### 导出命令\n\n```bash\n# 导出为 CSV\ndevtime export csv ~/timetrack_data.csv --project \"项目名称\"\n\n# 导出为 JSON\ndevtime export json ~/timetrack_data.json --from 2025-01-01\n```\n\n## 💡 设计理念\n\nDevTime CLI 遵循以下原则构建：\n\n1. **开发者优先**：为生活在终端中的开发者设计\n2. **零摩擦**：用最少的命令开始追踪\n3. **数据所有权**：您的数据始终保存在本地\n4. **Unix 哲学**：把一件事做好 - 追踪时间\n\n## 📦 开发\n\n### 设置开发环境\n\n```bash\ngit clone https://github.com/gitstq/devtime-cli.git\ncd devtime-cli\npython -m venv venv\nsource venv/bin/activate  # Windows: venv\\Scripts\\activate\npip install -e .\n```\n\n### 运行测试\n\n```bash\npython -m pytest tests/\n```\n\n## 🤝 贡献指南\n\n欢迎贡献！请随时提交 Pull Request。\n\n1. Fork 本仓库\n2. 创建您的功能分支 (`git checkout -b feature/AmazingFeature`)\n3. 提交您的更改 (`git commit -m 'feat: 添加某个 AmazingFeature'`)\n4. 推送到分支 (`git push origin feature/AmazingFeature`)\n5. 打开 Pull Request\n\n## 📄 开源协议\n\n本项目采用 MIT 协议 - 详情请参见 [LICENSE](LICENSE) 文件。\n\n---\n\n\u003ca name=\"繁體中文\"\u003e\u003c/a\u003e\n# 🇹🇼 繁體中文\n\n## 🎉 專案介紹\n\nDevTime CLI 是一款專為開發者設計的強大而簡潔的命令列時間追蹤工具。無需切換上下文或開啟笨重的 GUI 應用，直接在終端機中追蹤專案和任務的時間消耗。\n\n### 為什麼選擇 DevTime CLI？\n\n- 🚀 **保持專注**：無需切換上下文 - 在終端機內即可完成時間追蹤\n- 💾 **隱私優先**：所有資料儲存在本地 SQLite 中 - 無雲端，無需帳戶\n- ⚡ **極速啟動**：以效能為核心設計，瞬間啟動\n- 🎨 **美觀輸出**：富文字終端機介面，支援顏色、表格和進度指示器\n- 📤 **自由匯出**：隨時將資料匯出為 CSV 或 JSON 格式\n\n## ✨ 核心特性\n\n| 特性 | 描述 | 圖示 |\n|---------|-------------|-------|\n| **專案管理** | 將工作組織到多個專案中 | 📁 |\n| **任務追蹤** | 追蹤專案內各個任務的時間 | 📋 |\n| **簡單計時器** | 使用單條命令啟動/停止計時 | ⏱️ |\n| **豐富報告** | 檢視詳細的統計和時間分析 | 📊 |\n| **資料匯出** | 支援 CSV 和 JSON 格式匯出 | 📤 |\n| **本地儲存** | SQLite 資料庫 - 資料始終儲存在您的裝置上 | 💾 |\n| **跨平台** | 支援 Linux、macOS 和 Windows | 🖥️ |\n\n## 🚀 快速開始\n\n### 安裝\n\n```bash\n# 從 PyPI 安裝（推薦）\npip install devtime-cli\n\n# 或從原始碼安裝\ngit clone https://github.com/gitstq/devtime-cli.git\ncd devtime-cli\npip install -e .\n```\n\n### 環境要求\n\n- Python 3.8 或更高版本\n- pip 套件管理器\n\n### 基本用法\n\n```bash\n# 建立您的第一個專案\ndevtime project create \"我的專案\" --description \"建構酷炫的東西\"\n\n# 為專案新增任務\ndevtime task create \"我的專案\" \"功能開發\"\ndevtime task create \"我的專案\" \"Bug 修復\"\n\n# 開始追蹤時間\ndevtime start \"我的專案\" \"功能開發\"\n\n# 檢視計時器狀態\ndevtime status\n\n# 停止追蹤\ndevtime stop\n\n# 檢視報告\ndevtime report projects\ndevtime report tasks\ndevtime report daily\n```\n\n## 📖 詳細使用指南\n\n### 專案命令\n\n```bash\n# 建立新專案\ndevtime project create \"專案名稱\" --description \"可選描述\"\n\n# 列出所有專案\ndevtime project list\n\n# 刪除專案（帶確認）\ndevtime project delete \"專案名稱\"\n```\n\n### 任務命令\n\n```bash\n# 在專案中建立任務\ndevtime task create \"專案名稱\" \"任務名稱\" --description \"可選描述\"\n\n# 列出所有任務（可選按專案篩選）\ndevtime task list\ndevtime task list \"專案名稱\"\n\n# 刪除任務\ndevtime task delete \"專案名稱\" \"任務名稱\"\n```\n\n### 計時器命令\n\n```bash\n# 開始追蹤任務時間\ndevtime start \"專案名稱\" \"任務名稱\" --notes \"可選備註\"\n\n# 檢視目前計時器狀態\ndevtime status\n\n# 停止目前計時器\ndevtime stop\n```\n\n### 報告命令\n\n```bash\n# 檢視時間條目（帶篩選）\ndevtime report entries --project \"專案名稱\" --from 2025-01-01 --to 2025-01-31\n\n# 檢視專案統計\ndevtime report projects\n\n# 檢視任務統計\ndevtime report tasks \"專案名稱\"\n\n# 檢視每日統計\ndevtime report daily --days 30\n```\n\n### 匯出命令\n\n```bash\n# 匯出為 CSV\ndevtime export csv ~/timetrack_data.csv --project \"專案名稱\"\n\n# 匯出為 JSON\ndevtime export json ~/timetrack_data.json --from 2025-01-01\n```\n\n## 💡 設計理念\n\nDevTime CLI 遵循以下原則建構：\n\n1. **開發者優先**：為生活在終端機中的開發者設計\n2. **零摩擦**：用最少的命令開始追蹤\n3. **資料所有權**：您的資料始終儲存在本地\n4. **Unix 哲學**：把一件事做好 - 追蹤時間\n\n## 📦 開發\n\n### 設定開發環境\n\n```bash\ngit clone https://github.com/gitstq/devtime-cli.git\ncd devtime-cli\npython -m venv venv\nsource venv/bin/activate  # Windows: venv\\Scripts\\activate\npip install -e .\n```\n\n### 執行測試\n\n```bash\npython -m pytest tests/\n```\n\n## 🤝 貢獻指南\n\n歡迎貢獻！請隨時提交 Pull Request。\n\n1. Fork 本倉庫\n2. 建立您的功能分支 (`git checkout -b feature/AmazingFeature`)\n3. 提交您的更改 (`git commit -m 'feat: 新增某個 AmazingFeature'`)\n4. 推送到分支 (`git push origin feature/AmazingFeature`)\n5. 開啟 Pull Request\n\n## 📄 開源協議\n\n本專案採用 MIT 協議 - 詳情請參見 [LICENSE](LICENSE) 檔案。\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgitstq%2Fdevtime-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgitstq%2Fdevtime-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgitstq%2Fdevtime-cli/lists"}