Added init command

Signed-off-by: Nick Brook <[email protected]>

Author: nrbrook

README.md

@@ -74,7 +74,7 @@ Run `code-recap` from a directory containing git repositories:
 
 ### For Consultants (Optional)
 
-If you work with multiple clients, configure `config/config.yaml` to organize reports by client:
+If you work with multiple clients, create a `config.yaml` to organize reports by client (see [example config](config.example/config.yaml)):
 
 ```yaml
 clients:
@@ -121,13 +121,15 @@ pip install -e .
 
 ### Configuration (Optional)
 
-For multi-client workflows, create a config file:
+For multi-client workflows, create a `config.yaml`:
 
 ```bash
-mkdir -p config && cp -r config.example/* config/
-# Edit config/config.yaml to define your clients
+code-recap init              # Creates template config.yaml
+# Edit config.yaml to define your clients
 ```
 
+Or copy the [full example](config.example/config.yaml) with all options documented.
+
 ---
 
 ## Recommended Models
@@ -275,13 +277,15 @@ code-recap git unarchive my-project --execute
 
 Configuration is **optional**. For basic use, just run the scripts—no config needed.
 
-For customization, copy examples from `config.example/`:
+For customization, create a template config:
 
 ```bash
-cp -r config.example/* config/
+code-recap init    # Creates config.yaml with commented examples
 ```
 
-### Client Configuration (`config/config.yaml`) — Optional
+Or copy the [full example](config.example/config.yaml) with all options documented.
+
+### Client Configuration (`config.yaml`) — Optional
 
 If you're a consultant working with multiple clients, configure project-to-client mapping:
 
@@ -314,7 +318,7 @@ clients:
 - First match wins (order matters in YAML)
 - Unmatched projects go to "Other"
 
-### Exclusion Patterns (`config/excludes.yaml`)
+### Exclusion Patterns (`excludes.yaml`)
 
 Configure files/directories to exclude from line count statistics:
 

scripts/bump-version.sh

@@ -71,17 +71,23 @@ echo "✓ Updated pyproject.toml"
 sed -i '' "s/__version__ = \".*\"/__version__ = \"$NEW_VERSION\"/" src/code_recap/__init__.py
 echo "✓ Updated src/code_recap/__init__.py"
 
+# Update uv.lock
+if command -v uv &> /dev/null; then
+    uv lock --quiet
+    echo "✓ Updated uv.lock"
+fi
+
 # Show changes
 echo ""
 echo "Changes:"
-git diff --color pyproject.toml src/code_recap/__init__.py
+git diff --color pyproject.toml src/code_recap/__init__.py uv.lock
 
 echo ""
 read -p "Commit and tag v$NEW_VERSION? [y/N] " -n 1 -r
 echo
 
 if [[ $REPLY =~ ^[Yy]$ ]]; then
-    git add pyproject.toml src/code_recap/__init__.py
+    git add pyproject.toml src/code_recap/__init__.py uv.lock
     git commit -m "Bump version to $NEW_VERSION"
     git tag -a "v$NEW_VERSION" -m "Release v$NEW_VERSION"
 
@@ -92,8 +98,10 @@ if [[ $REPLY =~ ^[Yy]$ ]]; then
     echo "  git push && git push origin v$NEW_VERSION"
 else
     echo ""
-    echo "Changes staged but not committed. To finish manually:"
-    echo "  git add -A && git commit -m 'Bump version to $NEW_VERSION'"
+    echo "Aborted. Files were modified but not committed."
+    echo "To finish manually:"
+    echo "  git add pyproject.toml src/code_recap/__init__.py uv.lock"
+    echo "  git commit -m 'Bump version to $NEW_VERSION'"
     echo "  git tag -a v$NEW_VERSION -m 'Release v$NEW_VERSION'"
     echo "  git push && git push origin v$NEW_VERSION"
 fi

src/code_recap/cli.py

@@ -76,6 +76,9 @@ def main(argv: Optional[list[str]] = None) -> int:
 
         return git_main(sub_argv)
 
+    elif subcommand in ("init", "config"):
+        return init_config(sub_argv)
+
     elif subcommand == "help":
         if sub_argv:
             # Show help for specific subcommand
@@ -89,6 +92,215 @@ def main(argv: Optional[list[str]] = None) -> int:
         return 1
 
 
+def init_config(argv: list[str]) -> int:
+    """Creates config files and sets up API keys.
+
+    Args:
+        argv: Command-line arguments.
+
+    Returns:
+        Exit code.
+    """
+    import argparse
+    import getpass
+    import os
+    from pathlib import Path
+
+    parser = argparse.ArgumentParser(
+        prog="code-recap init",
+        description="Initialize code-recap configuration and API keys",
+    )
+    parser.add_argument(
+        "-o",
+        "--output",
+        default="config.yaml",
+        help="Config file path (default: config.yaml)",
+    )
+    parser.add_argument(
+        "-f",
+        "--force",
+        action="store_true",
+        help="Overwrite existing files",
+    )
+    parser.add_argument(
+        "--no-keys",
+        action="store_true",
+        help="Skip API key setup",
+    )
+    parser.add_argument(
+        "--keys-only",
+        action="store_true",
+        help="Only set up API keys, skip config.yaml",
+    )
+    args = parser.parse_args(argv)
+
+    output_path = Path(args.output)
+    created_files: list[str] = []
+
+    # Create config.yaml
+    if not args.keys_only:
+        if output_path.exists() and not args.force:
+            print(f"Config file {output_path} already exists (use --force to overwrite)")
+        else:
+            template = '''# Code Recap Configuration
+# See: https://github.com/NRB-Tech/code-recap
+
+# Global context for LLM summaries (optional)
+# global_context: |
+#   Brief description of your work or company for context in summaries.
+
+# Client configuration (optional - for consultants with multiple clients)
+# clients:
+#   "Client Name":
+#     directories:
+#       - "project-*"      # Glob patterns for repo names
+#       - "another-repo"   # Exact match
+#     exclude:
+#       - "*-archive"      # Exclude patterns
+#     context: |
+#       Brief description of work for this client.
+#
+#   "Another Client":
+#     directories:
+#       - "client2-*"
+
+# Assign unmatched repos to a default client (optional)
+# default_client: Personal
+
+# File patterns to exclude from statistics (optional)
+# excludes:
+#   global:
+#     - "*.lock"
+#     - "package-lock.json"
+#     - "*/node_modules/*"
+#     - "*/build/*"
+#     - "*.min.js"
+#   projects:
+#     MyProject:
+#       - "vendor/*"
+
+# HTML report branding (optional)
+# html_report:
+#   company_name: "Your Company"
+#   logo_url: "https://example.com/logo.png"
+#   primary_color: "#2563eb"
+'''
+            output_path.write_text(template)
+            created_files.append(str(output_path))
+
+    # Set up API keys
+    if not args.no_keys:
+        print("\n" + "=" * 50)
+        print("API Key Setup (press Enter to skip any)")
+        print("=" * 50)
+        print("\nGet API keys from:")
+        print("  OpenAI:    https://platform.openai.com/api-keys")
+        print("  Gemini:    https://aistudio.google.com/apikey")
+        print("  Anthropic: https://console.anthropic.com/settings/keys")
+        print()
+
+        keys_dir = Path("keys")
+        keys: dict[str, tuple[str, str]] = {}  # name -> (env_var, key)
+
+        # Prompt for each key
+        for name, env_var, example in [
+            ("OpenAI", "OPENAI_API_KEY", "sk-..."),
+            ("Gemini", "GEMINI_API_KEY", "AI..."),
+            ("Anthropic", "ANTHROPIC_API_KEY", "sk-ant-..."),
+        ]:
+            # Check if already set in environment
+            existing = os.environ.get(env_var)
+            if existing:
+                print(f"{name}: Already set in environment ✓")
+                continue
+
+            try:
+                key = getpass.getpass(f"{name} API key ({example}): ").strip()
+                if key:
+                    keys[name.lower()] = (env_var, key)
+            except (KeyboardInterrupt, EOFError):
+                print("\nSkipping remaining keys...")
+                break
+
+        # Create key files if any keys were entered
+        if keys:
+            keys_dir.mkdir(exist_ok=True)
+
+            for name, (env_var, key) in keys.items():
+                key_file = keys_dir / f"{name}.sh"
+                key_file.write_text(f"#!/bin/bash\nexport {env_var}='{key}'\n")
+                key_file.chmod(0o600)  # Restrict permissions
+                created_files.append(str(key_file))
+
+            # Create all.sh to source all keys
+            all_file = keys_dir / "all.sh"
+            all_content = "#!/bin/bash\n# Source all API keys\n"
+            for name in keys:
+                all_content += f'source "$(dirname "$0")/{name}.sh"\n'
+            all_file.write_text(all_content)
+            all_file.chmod(0o700)
+            created_files.append(str(all_file))
+
+            print(f"\nCreated {len(keys)} key file(s) in {keys_dir}/")
+            print("To load keys: source keys/all.sh")
+
+            # Add keys/ to .gitignore if not already
+            gitignore = Path(".gitignore")
+            if gitignore.exists():
+                content = gitignore.read_text()
+                if "keys/" not in content and "/keys" not in content:
+                    with gitignore.open("a") as f:
+                        f.write("\n# API keys\nkeys/\n")
+                    print("Added keys/ to .gitignore")
+
+    # Summary
+    print("\n" + "=" * 50)
+    if created_files:
+        print("Created files:")
+        for f in created_files:
+            print(f"  ✓ {f}")
+    else:
+        print("No files created.")
+
+    # Get author name for examples
+    author = _get_git_author() or "Your Name"
+
+    # Next steps
+    print("\n" + "=" * 50)
+    print("Try these commands:")
+    print("=" * 50)
+    print(f"""
+# Generate a year-in-review summary
+code-recap summarize 2025 --author "{author}" --html --open
+
+# Quick daily summary for time logging
+code-recap daily --author "{author}"
+
+# Statistics only (no LLM, no API key needed)
+code-recap stats 2025 --author "{author}" --format markdown
+""")
+    print("Documentation: https://github.com/NRB-Tech/code-recap")
+    return 0
+
+
+def _get_git_author() -> str | None:
+    """Gets the git user name from config."""
+    import subprocess
+
+    try:
+        result = subprocess.run(
+            ["git", "config", "user.name"],
+            capture_output=True,
+            text=True,
+            timeout=5,
+        )
+        if result.returncode == 0:
+            return result.stdout.strip()
+    except Exception:
+        pass
+    return None
+
+
 def print_help() -> None:
     """Prints the main help message."""
     from code_recap import __version__
@@ -106,6 +318,7 @@ def print_help() -> None:
   commits              List commits for a specific date
   deploy               Deploy HTML reports (zip, Cloudflare)
   git, repos           Repository utilities (fetch, archive)
+  init                 Create a template config.yaml file
 
 Quick start:
   code-recap summarize 2025 --author "Your Name"