feat: add --version/-v flag to CLI

codebase_rag/cli.py

@@ -1,4 +1,5 @@
 import asyncio
+from importlib.metadata import version as get_version
 from pathlib import Path
 
 import typer
@@ -34,6 +35,15 @@
 )
 
 
+def _version_callback(value: bool) -> None:
+    if value:
+        app_context.console.print(
+            cs.CLI_MSG_VERSION.format(version=get_version("code-graph-rag")),
+            highlight=False,
+        )
+        raise typer.Exit()
+
+
 def validate_models_early() -> None:
     try:
         orchestrator_config = settings.active_orchestrator_config
@@ -58,6 +68,14 @@ def _update_and_validate_models(orchestrator: str | None, cypher: str | None) ->
 
 @app.callback()
 def _global_options(
+    version: bool | None = typer.Option(
+        None,
+        "--version",
+        "-v",
+        help=ch.HELP_VERSION,
+        callback=_version_callback,
+        is_eager=True,
+    ),
     quiet: bool = typer.Option(
         False,
         "--quiet",

codebase_rag/cli_help.py

@@ -50,6 +50,7 @@ class CLICommandName(StrEnum):
 HELP_REPO_PATH_INDEX = "Path to the target repository to index."
 HELP_REPO_PATH_OPTIMIZE = "Path to the repository to optimize"
 HELP_REPO_PATH_WATCH = "Path to the repository to watch."
+HELP_VERSION = "Show the version and exit."
 
 HELP_UPDATE_GRAPH = "Update the knowledge graph by parsing the repository"
 HELP_CLEAN_DB = "Clean the database before updating (use when adding first repo)"

codebase_rag/constants.py

@@ -234,6 +234,7 @@ class GoogleProviderType(StrEnum):
 CLI_MSG_EXPORTING_DATA = "Exporting graph data..."
 CLI_MSG_OPTIMIZATION_TERMINATED = "\nOptimization session terminated by user."
 CLI_MSG_MCP_TERMINATED = "\nMCP server terminated by user."
+CLI_MSG_VERSION = "code-graph-rag version {version}"
 CLI_MSG_HINT_TARGET_REPO = (
     "\nHint: Make sure TARGET_REPO_PATH environment variable is set."
 )

codebase_rag/tests/test_cli_smoke.py

@@ -1,9 +1,12 @@
 import subprocess
 import sys
+from importlib.metadata import version as get_version
 from pathlib import Path
 
 import pytest
 
+from codebase_rag import constants as cs
+
 
 def test_help_command_works() -> None:
     repo_root = Path(__file__).parent.parent.parent
@@ -32,3 +35,26 @@ def test_import_cli_module() -> None:
         assert hasattr(cli, "app"), "CLI module missing app attribute"
     except ImportError as e:
         pytest.fail(f"Failed to import cli module: {e}")
+
+
+def test_version_flag() -> None:
+    repo_root = Path(__file__).parent.parent.parent
+
+    for flag in ["--version", "-v"]:
+        result = subprocess.run(
+            [sys.executable, "-m", "codebase_rag.cli", flag],
+            check=False,
+            cwd=repo_root,
+            capture_output=True,
+            text=True,
+            timeout=30,
+        )
+
+        assert result.returncode == 0, (
+            f"{flag} exited with code {result.returncode}: {result.stderr}"
+        )
+        expected = cs.CLI_MSG_VERSION.format(version=get_version("code-graph-rag"))
+        assert result.stdout.strip() == expected, (
+            f"{flag} output did not match expected format: {repr(result.stdout)}"
+        )
+        assert result.stderr == "", f"Unexpected stderr for {flag}: {result.stderr}"