From e138ac61b1e97b76866b931feca0eb3baf16b19f Mon Sep 17 00:00:00 2001
From: Polly Labs <pollychen.lab@gmail.com>
Date: Sat, 8 Aug 2026 01:54:10 -0500
Subject: [PATCH] Add CLI version option

---
 README.md                   |  1 +
 src/creator_toolkit/main.py |  8 ++++++++
 tests/test_cli_smoke.py     | 10 ++++++++++
 tests/test_main.py          | 13 +++++++++++++
 4 files changed, 32 insertions(+)

diff --git a/README.md b/README.md
index b9b67b8..908107b 100644
--- a/README.md
+++ b/README.md
@@ -60,6 +60,7 @@ Release notes and verified distribution hashes are available in the
 Generate a title or tags:
 
 ```bash
+creator-toolkit --version
 creator-toolkit title "video editing"
 creator-toolkit tags --count 5
 ```
diff --git a/src/creator_toolkit/main.py b/src/creator_toolkit/main.py
index e6cea89..dde5ff5 100644
--- a/src/creator_toolkit/main.py
+++ b/src/creator_toolkit/main.py
@@ -2,6 +2,7 @@
 import json
 import sys
 from collections.abc import Sequence
+from importlib import metadata
 from pathlib import Path
 from random import Random
 from typing import Any
@@ -20,6 +21,7 @@
 from creator_toolkit.title_generator import generate_title
 
 JSON_SCHEMA_VERSION = 1
+PACKAGE_NAME = "creator-toolkit-cli"
 
 
 class UsageError(ValueError):
@@ -31,6 +33,12 @@ def build_parser() -> argparse.ArgumentParser:
     parser = argparse.ArgumentParser(
         prog="creator-toolkit", description="Tools for creator workflows"
     )
+    parser.add_argument(
+        "--version",
+        action="version",
+        version=f"{PACKAGE_NAME} {metadata.version(PACKAGE_NAME)}",
+        help="show the installed package version and exit",
+    )
     subparsers = parser.add_subparsers(dest="command")
 
     title_parser = subparsers.add_parser("title", help="generate a title from a keyword")
diff --git a/tests/test_cli_smoke.py b/tests/test_cli_smoke.py
index 9b16414..0caf519 100644
--- a/tests/test_cli_smoke.py
+++ b/tests/test_cli_smoke.py
@@ -2,6 +2,7 @@
 import shutil
 import subprocess
 import sys
+from importlib import metadata
 from pathlib import Path
 
 
@@ -34,10 +35,19 @@ def test_installed_cli_help_lists_commands():
 
     assert_success(result)
     assert result.stderr == ""
+    assert "--version" in result.stdout
     for command in ("title", "tags", "rename", "undo"):
         assert command in result.stdout
 
 
+def test_installed_cli_version_reports_package_name_and_version():
+    result = run_cli("--version")
+
+    assert_success(result)
+    assert result.stderr == ""
+    assert result.stdout == f"creator-toolkit-cli {metadata.version('creator-toolkit-cli')}\n"
+
+
 def test_installed_cli_generates_title_and_tags_json():
     title_result = run_cli("title", "creator workflow", "--seed", "2026", "--json")
     assert_success(title_result)
diff --git a/tests/test_main.py b/tests/test_main.py
index 20ff6e0..1a00833 100644
--- a/tests/test_main.py
+++ b/tests/test_main.py
@@ -1,4 +1,7 @@
 import json
+from importlib import metadata
+
+import pytest
 
 from creator_toolkit.main import interactive_menu, main
 
@@ -13,6 +16,16 @@ def test_tags_command(capsys):
     assert len(capsys.readouterr().out.splitlines()) == 2
 
 
+def test_version_command_uses_installed_package_metadata(capsys):
+    with pytest.raises(SystemExit) as exit_info:
+        main(["--version"])
+
+    assert exit_info.value.code == 0
+    assert capsys.readouterr().out == (
+        f"creator-toolkit-cli {metadata.version('creator-toolkit-cli')}\n"
+    )
+
+
 def test_seeded_title_and_tags_commands_are_reproducible(capsys):
     assert main(["title", "creator workflow", "--seed", "2026"]) == 0
     first_title = capsys.readouterr().out