task-recorder-cui 1.0.0__tar.gz

task_recorder_cui-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Yumeno Yuuka
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

task_recorder_cui-1.0.0/PKG-INFO

@@ -0,0 +1,207 @@
+Metadata-Version: 2.4
+Name: task-recorder-cui
+Version: 1.0.0
+Summary: Minimal, no-friction CUI time tracker with weekly and monthly summaries
+Author: Yumeno Yuuka
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/yuuka-dev/task-recorder-cui
+Project-URL: Repository, https://github.com/yuuka-dev/task-recorder-cui
+Project-URL: Issues, https://github.com/yuuka-dev/task-recorder-cui/issues
+Keywords: time-tracking,cli,productivity,sqlite
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Office/Business :: Scheduling
+Classifier: Topic :: Utilities
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: rich
+Requires-Dist: questionary
+Provides-Extra: dev
+Requires-Dist: ruff; extra == "dev"
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: jupyterlab; extra == "dev"
+Requires-Dist: pandas; extra == "dev"
+Dynamic: license-file
+
+# task-recorder-cui
+
+[![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)
+[![codecov](https://codecov.io/gh/yuuka-dev/task-recorder-cui/branch/main/graph/badge.svg)](https://codecov.io/gh/yuuka-dev/task-recorder-cui)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python](https://img.shields.io/badge/Python-3.11+-blue.svg)](https://www.python.org/)
+
+> **一言で説明**: 日々の時間の使い方を記録し、週平均・月平均で可視化するCUIツール。タスク管理ではなく「時間記録」に特化しています。
+
+## 概要
+
+### なぜ作ったのか
+
+Toggl などのタイムトラッキングツールは多機能ですが、項目が多すぎて続かないことがあります。本ツールは「何を・何時間・いつやったか」を **極限まで削ぎ落としたコマンド** で記録し、週平均・月平均を数字だけで見ることに特化しています。
+
+毎日使うのが苦にならない軽さを最優先に設計しました。
+
+## 主な機能
+
+- `tsk start` / `tsk stop` で時間を記録（ストップウォッチ形式）
+- `tsk add` で事後に手動追加
+- `tsk today` / `tsk week` / `tsk month` で集計を表示
+- カテゴリは自由に追加・アーカイブ可能（初期は `game` / `study` / `dev` の3つ）
+- サブコマンドなしで起動すると階層型インタラクティブメニュー
+
+## 技術スタック
+
+| カテゴリ | 技術 |
+|---|---|
+| 言語 | Python 3.11+ |
+| データストア | SQLite（標準ライブラリ `sqlite3`） |
+| CLI | `argparse` |
+| 出力整形 | `rich` |
+| インタラクティブ選択 | `questionary` |
+| パッケージ管理 | `pyproject.toml` + `pip install -e .` |
+
+## はじめ方
+
+### 前提条件
+
+- Python 3.11 以上
+- 動作確認環境: WSL2 Ubuntu（他のLinux/macOSでも動作するはず）
+
+### セットアップ
+
+```bash
+git clone https://github.com/yuuka-dev/task-recorder-cui.git
+cd task-recorder-cui
+pip install -e ".[dev]"
+```
+
+インストール後、`tsk` コマンドが使えるようになります。データは `~/.local/share/tsk/records.db` に保存されます。
+
+### テスト / カバレッジ
+
+```bash
+pytest                                                  # 全テスト実行
+pytest --cov=task_recorder_cui --cov-report=term        # カバレッジ付きで実行
+```
+
+dev 依存関係を更新した場合は `pip install -e ".[dev]"` を再実行してください。
+
+## 基本的な使い方
+
+### 記録を開始する
+
+```bash
+tsk start dev "ObatLog Firestore 実装"
+```
+
+### 記録を停止する
+
+```bash
+tsk stop
+```
+
+### 今日の記録を確認する
+
+```bash
+tsk today
+```
+
+出力例:
+
+```
+2026-04-14 (Tue)
+14:00-15:30  [ゲーム] HOI4 日本プレイ        1h30m
+15:45-17:00  [開発]   task-recorder-cui実装  1h15m
+17:30-18:15  [学習]   ABC B問題              45m
+19:00-       [開発]   ObatLog Firestore      (記録中 32m)
+合計: 4h02m (記録中含む)
+ゲーム: 1h30m (37%)
+開発:   1h47m (44%)
+学習:   45m   (19%)
+```
+
+### 事後に手動で追加する
+
+```bash
+tsk add study 45 "ABC B問題"
+```
+
+### 週次・月次サマリを見る
+
+```bash
+tsk week   # 直近7日
+tsk month  # 直近30日
+```
+
+### インタラクティブメニュー
+
+サブコマンドなしで起動すると、階層メニューから操作できます。
+
+```bash
+tsk
+```
+
+```
+┌─────────────────────────────────────┐
+│ tsk - task recorder                 │
+├─────────────────────────────────────┤
+│ 現在: [開発] ObatLog実装 (32m経過)  │
+├─────────────────────────────────────┤
+│ ? 操作を選んでください              │
+│   開始                              │
+│   停止                              │
+│   今日の一覧                        │
+│   週集計                            │
+│   月集計                            │
+│   カテゴリ管理                      │
+│   ヘルプ (CLI コマンド一覧)         │
+│   終了                              │
+└─────────────────────────────────────┘
+```
+
+矢印キー + Enter で選択します。Ctrl+C / ESC でいつでも安全に中断できます (記録中のセッションは保持されます)。
+
+## CLIサブコマンド一覧
+
+### 記録系
+
+| コマンド | 説明 |
+|---|---|
+| `tsk start <category_key> ["<description>"]` | 新しいセッションを開始 |
+| `tsk stop` | 記録中のセッションを終了 |
+| `tsk add <category_key> <minutes> ["<description>"]` | 事後に手動で追加 |
+| `tsk now` | 現在記録中のセッションと経過時間を表示 |
+
+### 参照系
+
+| コマンド | 説明 |
+|---|---|
+| `tsk today` | 今日の記録一覧＋カテゴリ別合計 |
+| `tsk week` | 直近7日の日別内訳＋週合計＋平均 |
+| `tsk month` | 直近30日の同様の集計 |
+
+### カテゴリ管理
+
+| コマンド | 説明 |
+|---|---|
+| `tsk cat list` | カテゴリ一覧 |
+| `tsk cat add <key> "<display_name>"` | カテゴリを追加 |
+| `tsk cat remove <key>` | カテゴリをアーカイブ（物理削除はしない） |
+| `tsk cat restore <key>` | アーカイブから復帰 |
+| `tsk cat rename <key> "<new_display_name>"` | 表示名を変更 |
+
+> `key` は ASCII 英小文字・数字・アンダースコアのみ。過去レコードの履歴を壊さないため、削除ではなく **アーカイブ** で運用します。
+
+## スコープ外（やらないこと）
+
+タスク管理、クラウド同期、通知、グラフ描画、ポモドーロ、タグ、優先度機能は意図的に実装しません。時間を記録することだけに集中します。
+
+## ライセンス
+
+[MIT License](./LICENSE)

task_recorder_cui-1.0.0/README.md

@@ -0,0 +1,175 @@
+# task-recorder-cui
+
+[![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)
+[![codecov](https://codecov.io/gh/yuuka-dev/task-recorder-cui/branch/main/graph/badge.svg)](https://codecov.io/gh/yuuka-dev/task-recorder-cui)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python](https://img.shields.io/badge/Python-3.11+-blue.svg)](https://www.python.org/)
+
+> **一言で説明**: 日々の時間の使い方を記録し、週平均・月平均で可視化するCUIツール。タスク管理ではなく「時間記録」に特化しています。
+
+## 概要
+
+### なぜ作ったのか
+
+Toggl などのタイムトラッキングツールは多機能ですが、項目が多すぎて続かないことがあります。本ツールは「何を・何時間・いつやったか」を **極限まで削ぎ落としたコマンド** で記録し、週平均・月平均を数字だけで見ることに特化しています。
+
+毎日使うのが苦にならない軽さを最優先に設計しました。
+
+## 主な機能
+
+- `tsk start` / `tsk stop` で時間を記録（ストップウォッチ形式）
+- `tsk add` で事後に手動追加
+- `tsk today` / `tsk week` / `tsk month` で集計を表示
+- カテゴリは自由に追加・アーカイブ可能（初期は `game` / `study` / `dev` の3つ）
+- サブコマンドなしで起動すると階層型インタラクティブメニュー
+
+## 技術スタック
+
+| カテゴリ | 技術 |
+|---|---|
+| 言語 | Python 3.11+ |
+| データストア | SQLite（標準ライブラリ `sqlite3`） |
+| CLI | `argparse` |
+| 出力整形 | `rich` |
+| インタラクティブ選択 | `questionary` |
+| パッケージ管理 | `pyproject.toml` + `pip install -e .` |
+
+## はじめ方
+
+### 前提条件
+
+- Python 3.11 以上
+- 動作確認環境: WSL2 Ubuntu（他のLinux/macOSでも動作するはず）
+
+### セットアップ
+
+```bash
+git clone https://github.com/yuuka-dev/task-recorder-cui.git
+cd task-recorder-cui
+pip install -e ".[dev]"
+```
+
+インストール後、`tsk` コマンドが使えるようになります。データは `~/.local/share/tsk/records.db` に保存されます。
+
+### テスト / カバレッジ
+
+```bash
+pytest                                                  # 全テスト実行
+pytest --cov=task_recorder_cui --cov-report=term        # カバレッジ付きで実行
+```
+
+dev 依存関係を更新した場合は `pip install -e ".[dev]"` を再実行してください。
+
+## 基本的な使い方
+
+### 記録を開始する
+
+```bash
+tsk start dev "ObatLog Firestore 実装"
+```
+
+### 記録を停止する
+
+```bash
+tsk stop
+```
+
+### 今日の記録を確認する
+
+```bash
+tsk today
+```
+
+出力例:
+
+```
+2026-04-14 (Tue)
+14:00-15:30  [ゲーム] HOI4 日本プレイ        1h30m
+15:45-17:00  [開発]   task-recorder-cui実装  1h15m
+17:30-18:15  [学習]   ABC B問題              45m
+19:00-       [開発]   ObatLog Firestore      (記録中 32m)
+合計: 4h02m (記録中含む)
+ゲーム: 1h30m (37%)
+開発:   1h47m (44%)
+学習:   45m   (19%)
+```
+
+### 事後に手動で追加する
+
+```bash
+tsk add study 45 "ABC B問題"
+```
+
+### 週次・月次サマリを見る
+
+```bash
+tsk week   # 直近7日
+tsk month  # 直近30日
+```
+
+### インタラクティブメニュー
+
+サブコマンドなしで起動すると、階層メニューから操作できます。
+
+```bash
+tsk
+```
+
+```
+┌─────────────────────────────────────┐
+│ tsk - task recorder                 │
+├─────────────────────────────────────┤
+│ 現在: [開発] ObatLog実装 (32m経過)  │
+├─────────────────────────────────────┤
+│ ? 操作を選んでください              │
+│   開始                              │
+│   停止                              │
+│   今日の一覧                        │
+│   週集計                            │
+│   月集計                            │
+│   カテゴリ管理                      │
+│   ヘルプ (CLI コマンド一覧)         │
+│   終了                              │
+└─────────────────────────────────────┘
+```
+
+矢印キー + Enter で選択します。Ctrl+C / ESC でいつでも安全に中断できます (記録中のセッションは保持されます)。
+
+## CLIサブコマンド一覧
+
+### 記録系
+
+| コマンド | 説明 |
+|---|---|
+| `tsk start <category_key> ["<description>"]` | 新しいセッションを開始 |
+| `tsk stop` | 記録中のセッションを終了 |
+| `tsk add <category_key> <minutes> ["<description>"]` | 事後に手動で追加 |
+| `tsk now` | 現在記録中のセッションと経過時間を表示 |
+
+### 参照系
+
+| コマンド | 説明 |
+|---|---|
+| `tsk today` | 今日の記録一覧＋カテゴリ別合計 |
+| `tsk week` | 直近7日の日別内訳＋週合計＋平均 |
+| `tsk month` | 直近30日の同様の集計 |
+
+### カテゴリ管理
+
+| コマンド | 説明 |
+|---|---|
+| `tsk cat list` | カテゴリ一覧 |
+| `tsk cat add <key> "<display_name>"` | カテゴリを追加 |
+| `tsk cat remove <key>` | カテゴリをアーカイブ（物理削除はしない） |
+| `tsk cat restore <key>` | アーカイブから復帰 |
+| `tsk cat rename <key> "<new_display_name>"` | 表示名を変更 |
+
+> `key` は ASCII 英小文字・数字・アンダースコアのみ。過去レコードの履歴を壊さないため、削除ではなく **アーカイブ** で運用します。
+
+## スコープ外（やらないこと）
+
+タスク管理、クラウド同期、通知、グラフ描画、ポモドーロ、タグ、優先度機能は意図的に実装しません。時間を記録することだけに集中します。
+
+## ライセンス
+
+[MIT License](./LICENSE)

task_recorder_cui-1.0.0/pyproject.toml

@@ -0,0 +1,100 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "task-recorder-cui"
+version = "1.0.0"
+description = "Minimal, no-friction CUI time tracker with weekly and monthly summaries"
+readme = "README.md"
+requires-python = ">=3.11"
+license = "MIT"
+authors = [
+    { name = "Yumeno Yuuka" },
+]
+keywords = ["time-tracking", "cli", "productivity", "sqlite"]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Environment :: Console",
+    "Intended Audience :: End Users/Desktop",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Office/Business :: Scheduling",
+    "Topic :: Utilities",
+]
+dependencies = [
+    "rich",
+    "questionary",
+]
+
+[project.optional-dependencies]
+dev = [
+    "ruff",
+    "pytest",
+    "pytest-cov",
+    "jupyterlab",
+    "pandas",
+]
+
+[project.urls]
+Homepage = "https://github.com/yuuka-dev/task-recorder-cui"
+Repository = "https://github.com/yuuka-dev/task-recorder-cui"
+Issues = "https://github.com/yuuka-dev/task-recorder-cui/issues"
+
+[project.scripts]
+tsk = "task_recorder_cui.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py311"
+indent-width = 4
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I", "N", "UP", "B", "C4", "SIM", "D"]
+ignore = [
+    "D100",  # Missing docstring in public module
+    "D101",  # Missing docstring in public class
+    "D203",  # 1 blank line required before class docstring (D211と競合)
+    "D213",  # Multi-line docstring summary should start at the second line (D212と競合)
+    # 日本語docstring方針との相性が悪いルール群
+    "D400",  # First line should end with a period (日本語の "。" は対象外)
+    "D401",  # First line should be in imperative mood (英語前提)
+    "D403",  # First word of first line should be properly capitalized (英語前提)
+    "D415",  # First line should end with ., ?, ! (日本語の "。" は対象外)
+]
+fixable = ["ALL"]
+
+[tool.ruff.lint.per-file-ignores]
+# テスト関数名は日本語を許容し、名前自体が自己説明的なのでdocstring強制しない
+"tests/**.py" = ["N802", "D102", "D103"]
+# 空の __init__.py は単なるパッケージマーカー
+"**/__init__.py" = ["D104"]
+
+[tool.ruff.lint.isort]
+section-order = ["future", "standard-library", "third-party", "first-party", "local-folder"]
+known-first-party = ["task_recorder_cui"]
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+skip-magic-trailing-comma = false
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-ra -q"
+
+[tool.coverage.run]
+source = ["task_recorder_cui"]
+branch = true
+
+[tool.coverage.report]
+exclude_lines = [
+    "pragma: no cover",
+    "if __name__ == .__main__.:",
+    "raise NotImplementedError",
+]

task_recorder_cui-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

task_recorder_cui-1.0.0/src/task_recorder_cui/__init__.py

@@ -0,0 +1,3 @@
+"""task-recorder-cui: 時間記録のためのCUIツール。"""
+
+__version__ = "1.0.0"

task_recorder_cui-1.0.0/src/task_recorder_cui/__main__.py

@@ -0,0 +1,5 @@
+"""`python -m task_recorder_cui` 用エントリ。"""
+
+from task_recorder_cui.cli import main
+
+raise SystemExit(main())

task_recorder_cui-1.0.0/src/task_recorder_cui/cli.py

@@ -0,0 +1,162 @@
+"""argparse ベースの CLI エントリポイント。
+
+本モジュールはサブコマンドの受け口 (parser) と main ディスパッチャを持つ。
+記録系 (start/stop/now/add)、参照系 (today/week/month/range/all)、カテゴリ管理
+(cat ...) は commands/ 配下の実装に dispatch する。インタラクティブメニューは
+`menu.run()` に dispatch する。
+"""
+
+import argparse
+
+from task_recorder_cui import __version__
+from task_recorder_cui.commands import add as add_cmd
+from task_recorder_cui.commands import all as all_cmd
+from task_recorder_cui.commands import cat as cat_cmd
+from task_recorder_cui.commands import month as month_cmd
+from task_recorder_cui.commands import now as now_cmd
+from task_recorder_cui.commands import range as range_cmd
+from task_recorder_cui.commands import start as start_cmd
+from task_recorder_cui.commands import stop as stop_cmd
+from task_recorder_cui.commands import today as today_cmd
+from task_recorder_cui.commands import week as week_cmd
+
+
+def build_parser() -> argparse.ArgumentParser:
+    """tsk の引数パーサを構築する。
+
+    Returns:
+        サブコマンドを含む設定済み ArgumentParser。
+
+    """
+    parser = argparse.ArgumentParser(
+        prog="tsk",
+        description="日々の時間の使い方を記録して、週平均・月平均で可視化するCUIツール",
+    )
+    parser.add_argument(
+        "--version",
+        action="version",
+        version=f"tsk {__version__}",
+    )
+
+    sub = parser.add_subparsers(dest="command", metavar="<command>")
+
+    # --- 記録系 ---
+    p_start = sub.add_parser("start", help="新しいセッションを開始")
+    p_start.add_argument("category_key", help="カテゴリキー (例: game, study, dev)")
+    p_start.add_argument("description", nargs="?", default=None, help="活動内容 (任意)")
+
+    sub.add_parser("stop", help="記録中のセッションを終了")
+
+    p_add = sub.add_parser("add", help="事後に手動で追加")
+    p_add.add_argument("category_key", help="カテゴリキー")
+    p_add.add_argument("minutes", type=int, help="記録する分数")
+    p_add.add_argument("description", nargs="?", default=None, help="活動内容 (任意)")
+
+    sub.add_parser("now", help="記録中のセッションを表示")
+
+    # --- 参照系 ---
+    sub.add_parser("today", help="今日の記録一覧")
+    p_week = sub.add_parser("week", help="直近7日 (default) または今週 (--calendar)")
+    p_week.add_argument(
+        "--calendar",
+        action="store_true",
+        help="月曜〜今日の今週集計にする",
+    )
+    p_month = sub.add_parser("month", help="直近30日 (default) または今月 (--calendar)")
+    p_month.add_argument(
+        "--calendar",
+        action="store_true",
+        help="今月1日〜今日の集計にする",
+    )
+    p_range = sub.add_parser("range", help="任意期間の集計")
+    p_range.add_argument("--from", dest="from_date", required=True, help="開始日 YYYY-MM-DD")
+    p_range.add_argument(
+        "--to", dest="to_date", required=True, help="終了日 YYYY-MM-DD (inclusive)"
+    )
+    sub.add_parser("all", help="全累計")
+
+    # --- カテゴリ管理 ---
+    p_cat = sub.add_parser("cat", help="カテゴリ管理")
+    cat_sub = p_cat.add_subparsers(dest="cat_action", metavar="<action>", required=True)
+
+    p_cat_list = cat_sub.add_parser("list", help="カテゴリ一覧")
+    list_filter = p_cat_list.add_mutually_exclusive_group()
+    list_filter.add_argument(
+        "--active", action="store_true", help="archived でないカテゴリだけ表示"
+    )
+    list_filter.add_argument("--archived", action="store_true", help="archived のカテゴリだけ表示")
+
+    p_cat_add = cat_sub.add_parser(
+        "add", help="カテゴリを追加 (archived同名があれば復帰+表示名上書き)"
+    )
+    p_cat_add.add_argument("key", help="新しいカテゴリキー")
+    p_cat_add.add_argument("display_name", help="表示名")
+    p_cat_remove = cat_sub.add_parser("remove", help="カテゴリをアーカイブ")
+    p_cat_remove.add_argument("key", help="アーカイブするカテゴリキー")
+    p_cat_restore = cat_sub.add_parser("restore", help="アーカイブから復帰")
+    p_cat_restore.add_argument("key", help="復帰させるカテゴリキー")
+    p_cat_rename = cat_sub.add_parser("rename", help="表示名を変更")
+    p_cat_rename.add_argument("key", help="変更するカテゴリキー")
+    p_cat_rename.add_argument("new_display_name", help="新しい表示名")
+
+    return parser
+
+
+def main(argv: list[str] | None = None) -> int:
+    """CLI エントリポイント。
+
+    Args:
+        argv: 引数リスト。Noneの場合は sys.argv[1:] が使われる。
+
+    Returns:
+        終了コード (0: 成功)。
+
+    Raises:
+        SystemExit: --help / --version 表示時、または usage error 時に
+            argparse が送出する。正常終了は code=0、usage error は code=2。
+
+    """
+    parser = build_parser()
+    args = parser.parse_args(argv)
+
+    if args.command is None:
+        from task_recorder_cui.menu import run as menu_run
+
+        return menu_run()
+
+    # --- 記録系 (Phase 3) ---
+    if args.command == "start":
+        return start_cmd.run(args.category_key, args.description)
+    if args.command == "stop":
+        return stop_cmd.run()
+    if args.command == "now":
+        return now_cmd.run()
+    if args.command == "add":
+        return add_cmd.run(args.category_key, args.minutes, args.description)
+
+    # --- 参照系 (Phase 4) ---
+    if args.command == "today":
+        return today_cmd.run()
+    if args.command == "week":
+        return week_cmd.run(calendar=args.calendar)
+    if args.command == "month":
+        return month_cmd.run(calendar=args.calendar)
+    if args.command == "range":
+        return range_cmd.run(args.from_date, args.to_date)
+    if args.command == "all":
+        return all_cmd.run()
+
+    # --- カテゴリ管理 (Phase 5) ---
+    if args.command == "cat":
+        if args.cat_action == "list":
+            return cat_cmd.list_categories(active_only=args.active, archived_only=args.archived)
+        if args.cat_action == "add":
+            return cat_cmd.add_category(args.key, args.display_name)
+        if args.cat_action == "remove":
+            return cat_cmd.remove_category(args.key)
+        if args.cat_action == "restore":
+            return cat_cmd.restore_category(args.key)
+        if args.cat_action == "rename":
+            return cat_cmd.rename_category(args.key, args.new_display_name)
+
+    return 0