{"id":48828305,"url":"https://github.com/yuuka-dev/task-recorder-cui","last_synced_at":"2026-04-14T19:01:04.913Z","repository":{"id":351297950,"uuid":"1210382913","full_name":"yuuka-dev/task-recorder-cui","owner":"yuuka-dev","description":"日々の時間の使い方を記録して週平均・月平均で可視化するCUIツール (tsk)","archived":false,"fork":false,"pushed_at":"2026-04-14T13:19:12.000Z","size":66,"stargazers_count":0,"open_issues_count":5,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-14T13:29:12.255Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"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/yuuka-dev.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-04-14T11:10:18.000Z","updated_at":"2026-04-14T11:11:09.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/yuuka-dev/task-recorder-cui","commit_stats":null,"previous_names":["yuuka-dev/task-recorder-cui"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/yuuka-dev/task-recorder-cui","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yuuka-dev%2Ftask-recorder-cui","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yuuka-dev%2Ftask-recorder-cui/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yuuka-dev%2Ftask-recorder-cui/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yuuka-dev%2Ftask-recorder-cui/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yuuka-dev","download_url":"https://codeload.github.com/yuuka-dev/task-recorder-cui/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yuuka-dev%2Ftask-recorder-cui/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31810741,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-14T18:05:02.291Z","status":"ssl_error","status_checked_at":"2026-04-14T18:05:01.765Z","response_time":153,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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-04-14T19:01:03.639Z","updated_at":"2026-04-14T19:01:04.908Z","avatar_url":"https://github.com/yuuka-dev.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# task-recorder-cui\n\n[![CI](https://github.com/yuuka-dev/task-recorder-cui/actions/workflows/ci.yml/badge.svg)](https://github.com/yuuka-dev/task-recorder-cui/actions/workflows/ci.yml)\n[![codecov](https://codecov.io/gh/yuuka-dev/task-recorder-cui/branch/main/graph/badge.svg)](https://codecov.io/gh/yuuka-dev/task-recorder-cui)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Python](https://img.shields.io/badge/Python-3.11+-blue.svg)](https://www.python.org/)\n\n\u003e **一言で説明**: 日々の時間の使い方を記録し、週平均・月平均で可視化するCUIツール。タスク管理ではなく「時間記録」に特化しています。\n\n## 概要\n\n### なぜ作ったのか\n\nToggl などのタイムトラッキングツールは多機能ですが、項目が多すぎて続かないことがあります。本ツールは「何を・何時間・いつやったか」を **極限まで削ぎ落としたコマンド** で記録し、週平均・月平均を数字だけで見ることに特化しています。\n\n毎日使うのが苦にならない軽さを最優先に設計しました。\n\n## 主な機能\n\n- `tsk start` / `tsk stop` で時間を記録（ストップウォッチ形式）\n- `tsk add` で事後に手動追加\n- `tsk today` / `tsk week` / `tsk month` で集計を表示\n- カテゴリは自由に追加・アーカイブ可能（初期は `game` / `study` / `dev` の3つ）\n- サブコマンドなしで起動すると階層型インタラクティブメニュー\n\n## 技術スタック\n\n| カテゴリ | 技術 |\n|---|---|\n| 言語 | Python 3.11+ |\n| データストア | SQLite（標準ライブラリ `sqlite3`） |\n| CLI | `argparse` |\n| 出力整形 | `rich` |\n| インタラクティブ選択 | `questionary` |\n| パッケージ管理 | `pyproject.toml` + `pip install -e .` |\n\n## はじめ方\n\n### 前提条件\n\n- Python 3.11 以上\n- 動作確認環境: WSL2 Ubuntu（他のLinux/macOSでも動作するはず）\n\n### セットアップ\n\n```bash\ngit clone https://github.com/yuuka-dev/task-recorder-cui.git\ncd task-recorder-cui\npip install -e \".[dev]\"\n```\n\nインストール後、`tsk` コマンドが使えるようになります。データは `~/.local/share/tsk/records.db` に保存されます。\n\n### テスト / カバレッジ\n\n```bash\npytest                                                  # 全テスト実行\npytest --cov=task_recorder_cui --cov-report=term        # カバレッジ付きで実行\n```\n\ndev 依存関係を更新した場合は `pip install -e \".[dev]\"` を再実行してください。\n\n## 基本的な使い方\n\n### 記録を開始する\n\n```bash\ntsk start dev \"ObatLog Firestore 実装\"\n```\n\n### 記録を停止する\n\n```bash\ntsk stop\n```\n\n### 今日の記録を確認する\n\n```bash\ntsk today\n```\n\n出力例:\n\n```\n2026-04-14 (Tue)\n14:00-15:30  [ゲーム] HOI4 日本プレイ        1h30m\n15:45-17:00  [開発]   task-recorder-cui実装  1h15m\n17:30-18:15  [学習]   ABC B問題              45m\n19:00-       [開発]   ObatLog Firestore      (記録中 32m)\n合計: 4h02m (記録中含む)\nゲーム: 1h30m (37%)\n開発:   1h47m (44%)\n学習:   45m   (19%)\n```\n\n### 事後に手動で追加する\n\n```bash\ntsk add study 45 \"ABC B問題\"\n```\n\n### 週次・月次サマリを見る\n\n```bash\ntsk week   # 直近7日\ntsk month  # 直近30日\n```\n\n### インタラクティブメニュー\n\nサブコマンドなしで起動すると、階層メニューから操作できます。\n\n```bash\ntsk\n```\n\n```\n┌─────────────────────────────────────┐\n│ tsk - task recorder                 │\n├─────────────────────────────────────┤\n│ 現在: [開発] ObatLog実装 (32m経過)  │\n├─────────────────────────────────────┤\n│ ? 操作を選んでください              │\n│   開始                              │\n│   停止                              │\n│   今日の一覧                        │\n│   週集計                            │\n│   月集計                            │\n│   カテゴリ管理                      │\n│   ヘルプ (CLI コマンド一覧)         │\n│   終了                              │\n└─────────────────────────────────────┘\n```\n\n矢印キー + Enter で選択します。Ctrl+C / ESC でいつでも安全に中断できます (記録中のセッションは保持されます)。\n\n## CLIサブコマンド一覧\n\n### 記録系\n\n| コマンド | 説明 |\n|---|---|\n| `tsk start \u003ccategory_key\u003e [\"\u003cdescription\u003e\"]` | 新しいセッションを開始 |\n| `tsk stop` | 記録中のセッションを終了 |\n| `tsk add \u003ccategory_key\u003e \u003cminutes\u003e [\"\u003cdescription\u003e\"]` | 事後に手動で追加 |\n| `tsk now` | 現在記録中のセッションと経過時間を表示 |\n\n### 参照系\n\n| コマンド | 説明 |\n|---|---|\n| `tsk today` | 今日の記録一覧＋カテゴリ別合計 |\n| `tsk week` | 直近7日の日別内訳＋週合計＋平均 |\n| `tsk month` | 直近30日の同様の集計 |\n\n### カテゴリ管理\n\n| コマンド | 説明 |\n|---|---|\n| `tsk cat list` | カテゴリ一覧 |\n| `tsk cat add \u003ckey\u003e \"\u003cdisplay_name\u003e\"` | カテゴリを追加 |\n| `tsk cat remove \u003ckey\u003e` | カテゴリをアーカイブ（物理削除はしない） |\n| `tsk cat restore \u003ckey\u003e` | アーカイブから復帰 |\n| `tsk cat rename \u003ckey\u003e \"\u003cnew_display_name\u003e\"` | 表示名を変更 |\n\n\u003e `key` は ASCII 英小文字・数字・アンダースコアのみ。過去レコードの履歴を壊さないため、削除ではなく **アーカイブ** で運用します。\n\n## スコープ外（やらないこと）\n\nタスク管理、クラウド同期、通知、グラフ描画、ポモドーロ、タグ、優先度機能は意図的に実装しません。時間を記録することだけに集中します。\n\n## ライセンス\n\n[MIT License](./LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyuuka-dev%2Ftask-recorder-cui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyuuka-dev%2Ftask-recorder-cui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyuuka-dev%2Ftask-recorder-cui/lists"}