git-alchemist 1.0.0__tar.gz

git_alchemist-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 abduznik
+
+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.

git_alchemist-1.0.0/PKG-INFO

@@ -0,0 +1,99 @@
+Metadata-Version: 2.4
+Name: git-alchemist
+Version: 1.0.0
+Summary: A unified AI stack to optimize, describe, and architect your GitHub repositories.
+Author: abduznik
+License: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: google-genai
+Requires-Dist: rich
+Requires-Dist: python-dotenv
+Requires-Dist: requests
+Dynamic: license-file
+
+# Git-Alchemist ⚗️
+
+**Git-Alchemist ⚗️** is a unified AI-powered CLI tool for automating GitHub repository management. It consolidates multiple technical utilities into a single, intelligent system powered by Google's Gemini 3 and Gemma 3 models.
+
+### 🌐 [Visit the Official Site](https://abduznik.github.io/Git-Alchemist/)
+
+---
+
+## Features
+
+*   **Smart Profile Generator:** Intelligently generates or updates your GitHub Profile README.
+*   **Topic Generator:** Auto-tag your repositories with AI-suggested topics for better discoverability.
+*   **Description Refiner:** Automatically generates repository descriptions by analyzing your README content.
+*   **Issue Drafter:** Translates loose ideas into structured, technical GitHub Issue drafts.
+*   **Architect (Scaffold):** Generates and executes project scaffolding commands in a safe, temporary workspace.
+*   **Fix & Explain:** Apply AI-powered patches to specific files or get concise technical explanations for complex code.
+*   **Gold Score Audit:** Measure your repository's professional quality and health.
+*   **The Sage:** Contextual codebase chat to answer deep technical questions about your code.
+*   **Commit Alchemist:** Automated semantic commit message suggestions from staged changes.
+
+## Model Tiers
+
+Git-Alchemist features a dynamic fallback system to ensure you never hit a quota wall:
+
+*   **Fast Mode (Default):** Utilizes **Gemma 3 (27B)** and **Gemini 3 Flash**. Optimized for speed and high-volume tasks.
+*   **Smart Mode (`--smart`):** Utilizes **Gemini 3 Pro** and **Gemini 2.5 Pro**. Optimized for complex architecture and deep code analysis.
+
+## Installation
+
+1.  **Clone the repository:**
+    ```bash
+    git clone https://github.com/abduznik/Git-Alchemist.git
+    cd Git-Alchemist
+    ```
+
+2.  **Install as a Global Library:**
+    ```bash
+    pip install .
+    ```
+
+3.  **Set up your Environment:**
+    Create a `.env` file in the directory or export it in your shell:
+    ```env
+    GEMINI_API_KEY=your_actual_api_key_here
+    ```
+
+## Usage
+
+Once installed, you can run the `alchemist` command from **any directory**:
+
+```bash
+# Audit a repository
+alchemist audit
+
+# Optimize repository topics
+alchemist topics
+
+# Generate semantic commit messages
+alchemist commit
+
+# Ask the Sage a question
+alchemist sage "How does the audit scoring work?"
+
+# Scaffold a new project (Safe Mode)
+alchemist scaffold "A FastAPI backend with a React frontend" --smart
+```
+
+## Requirements
+
+*   Python 3.10+
+*   GitHub CLI (`gh`) installed and authenticated (`gh auth login`).
+*   A Google Gemini API Key.
+
+## Migration Note
+
+This tool replaces and consolidates the following legacy scripts:
+*   `AI-Gen-Profile`
+*   `AI-Gen-Topics`
+*   `AI-Gen-Description`
+*   `AI-Gen-Issue`
+*   `Ai-Pro-Arch`
+
+---
+*Created by [abduznik](https://github.com/abduznik)*

git_alchemist-1.0.0/README.md

@@ -0,0 +1,84 @@
+# Git-Alchemist ⚗️
+
+**Git-Alchemist ⚗️** is a unified AI-powered CLI tool for automating GitHub repository management. It consolidates multiple technical utilities into a single, intelligent system powered by Google's Gemini 3 and Gemma 3 models.
+
+### 🌐 [Visit the Official Site](https://abduznik.github.io/Git-Alchemist/)
+
+---
+
+## Features
+
+*   **Smart Profile Generator:** Intelligently generates or updates your GitHub Profile README.
+*   **Topic Generator:** Auto-tag your repositories with AI-suggested topics for better discoverability.
+*   **Description Refiner:** Automatically generates repository descriptions by analyzing your README content.
+*   **Issue Drafter:** Translates loose ideas into structured, technical GitHub Issue drafts.
+*   **Architect (Scaffold):** Generates and executes project scaffolding commands in a safe, temporary workspace.
+*   **Fix & Explain:** Apply AI-powered patches to specific files or get concise technical explanations for complex code.
+*   **Gold Score Audit:** Measure your repository's professional quality and health.
+*   **The Sage:** Contextual codebase chat to answer deep technical questions about your code.
+*   **Commit Alchemist:** Automated semantic commit message suggestions from staged changes.
+
+## Model Tiers
+
+Git-Alchemist features a dynamic fallback system to ensure you never hit a quota wall:
+
+*   **Fast Mode (Default):** Utilizes **Gemma 3 (27B)** and **Gemini 3 Flash**. Optimized for speed and high-volume tasks.
+*   **Smart Mode (`--smart`):** Utilizes **Gemini 3 Pro** and **Gemini 2.5 Pro**. Optimized for complex architecture and deep code analysis.
+
+## Installation
+
+1.  **Clone the repository:**
+    ```bash
+    git clone https://github.com/abduznik/Git-Alchemist.git
+    cd Git-Alchemist
+    ```
+
+2.  **Install as a Global Library:**
+    ```bash
+    pip install .
+    ```
+
+3.  **Set up your Environment:**
+    Create a `.env` file in the directory or export it in your shell:
+    ```env
+    GEMINI_API_KEY=your_actual_api_key_here
+    ```
+
+## Usage
+
+Once installed, you can run the `alchemist` command from **any directory**:
+
+```bash
+# Audit a repository
+alchemist audit
+
+# Optimize repository topics
+alchemist topics
+
+# Generate semantic commit messages
+alchemist commit
+
+# Ask the Sage a question
+alchemist sage "How does the audit scoring work?"
+
+# Scaffold a new project (Safe Mode)
+alchemist scaffold "A FastAPI backend with a React frontend" --smart
+```
+
+## Requirements
+
+*   Python 3.10+
+*   GitHub CLI (`gh`) installed and authenticated (`gh auth login`).
+*   A Google Gemini API Key.
+
+## Migration Note
+
+This tool replaces and consolidates the following legacy scripts:
+*   `AI-Gen-Profile`
+*   `AI-Gen-Topics`
+*   `AI-Gen-Description`
+*   `AI-Gen-Issue`
+*   `Ai-Pro-Arch`
+
+---
+*Created by [abduznik](https://github.com/abduznik)*

git_alchemist-1.0.0/git_alchemist.egg-info/PKG-INFO

@@ -0,0 +1,99 @@
+Metadata-Version: 2.4
+Name: git-alchemist
+Version: 1.0.0
+Summary: A unified AI stack to optimize, describe, and architect your GitHub repositories.
+Author: abduznik
+License: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: google-genai
+Requires-Dist: rich
+Requires-Dist: python-dotenv
+Requires-Dist: requests
+Dynamic: license-file
+
+# Git-Alchemist ⚗️
+
+**Git-Alchemist ⚗️** is a unified AI-powered CLI tool for automating GitHub repository management. It consolidates multiple technical utilities into a single, intelligent system powered by Google's Gemini 3 and Gemma 3 models.
+
+### 🌐 [Visit the Official Site](https://abduznik.github.io/Git-Alchemist/)
+
+---
+
+## Features
+
+*   **Smart Profile Generator:** Intelligently generates or updates your GitHub Profile README.
+*   **Topic Generator:** Auto-tag your repositories with AI-suggested topics for better discoverability.
+*   **Description Refiner:** Automatically generates repository descriptions by analyzing your README content.
+*   **Issue Drafter:** Translates loose ideas into structured, technical GitHub Issue drafts.
+*   **Architect (Scaffold):** Generates and executes project scaffolding commands in a safe, temporary workspace.
+*   **Fix & Explain:** Apply AI-powered patches to specific files or get concise technical explanations for complex code.
+*   **Gold Score Audit:** Measure your repository's professional quality and health.
+*   **The Sage:** Contextual codebase chat to answer deep technical questions about your code.
+*   **Commit Alchemist:** Automated semantic commit message suggestions from staged changes.
+
+## Model Tiers
+
+Git-Alchemist features a dynamic fallback system to ensure you never hit a quota wall:
+
+*   **Fast Mode (Default):** Utilizes **Gemma 3 (27B)** and **Gemini 3 Flash**. Optimized for speed and high-volume tasks.
+*   **Smart Mode (`--smart`):** Utilizes **Gemini 3 Pro** and **Gemini 2.5 Pro**. Optimized for complex architecture and deep code analysis.
+
+## Installation
+
+1.  **Clone the repository:**
+    ```bash
+    git clone https://github.com/abduznik/Git-Alchemist.git
+    cd Git-Alchemist
+    ```
+
+2.  **Install as a Global Library:**
+    ```bash
+    pip install .
+    ```
+
+3.  **Set up your Environment:**
+    Create a `.env` file in the directory or export it in your shell:
+    ```env
+    GEMINI_API_KEY=your_actual_api_key_here
+    ```
+
+## Usage
+
+Once installed, you can run the `alchemist` command from **any directory**:
+
+```bash
+# Audit a repository
+alchemist audit
+
+# Optimize repository topics
+alchemist topics
+
+# Generate semantic commit messages
+alchemist commit
+
+# Ask the Sage a question
+alchemist sage "How does the audit scoring work?"
+
+# Scaffold a new project (Safe Mode)
+alchemist scaffold "A FastAPI backend with a React frontend" --smart
+```
+
+## Requirements
+
+*   Python 3.10+
+*   GitHub CLI (`gh`) installed and authenticated (`gh auth login`).
+*   A Google Gemini API Key.
+
+## Migration Note
+
+This tool replaces and consolidates the following legacy scripts:
+*   `AI-Gen-Profile`
+*   `AI-Gen-Topics`
+*   `AI-Gen-Description`
+*   `AI-Gen-Issue`
+*   `Ai-Pro-Arch`
+
+---
+*Created by [abduznik](https://github.com/abduznik)*

git_alchemist-1.0.0/git_alchemist.egg-info/SOURCES.txt

@@ -0,0 +1,20 @@
+LICENSE
+README.md
+pyproject.toml
+git_alchemist.egg-info/PKG-INFO
+git_alchemist.egg-info/SOURCES.txt
+git_alchemist.egg-info/dependency_links.txt
+git_alchemist.egg-info/entry_points.txt
+git_alchemist.egg-info/requires.txt
+git_alchemist.egg-info/top_level.txt
+src/architect.py
+src/audit.py
+src/cli.py
+src/committer.py
+src/core.py
+src/issue_gen.py
+src/profile_gen.py
+src/promote.py
+src/repo_tools.py
+src/sage.py
+src/utils.py

git_alchemist-1.0.0/git_alchemist.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

git_alchemist-1.0.0/git_alchemist.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+alchemist = src.cli:main

git_alchemist-1.0.0/git_alchemist.egg-info/requires.txt

@@ -0,0 +1,4 @@
+google-genai
+rich
+python-dotenv
+requests

git_alchemist-1.0.0/git_alchemist.egg-info/top_level.txt

@@ -0,0 +1 @@
+src

git_alchemist-1.0.0/pyproject.toml

@@ -0,0 +1,25 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "git-alchemist"
+version = "1.0.0"
+description = "A unified AI stack to optimize, describe, and architect your GitHub repositories."
+readme = "README.md"
+authors = [{ name = "abduznik" }]
+license = { text = "MIT" }
+requires-python = ">=3.10"
+dependencies = [
+    "google-genai",
+    "rich",
+    "python-dotenv",
+    "requests"
+]
+
+[project.scripts]
+alchemist = "src.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["src*"]

git_alchemist-1.0.0/setup.cfg

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

git_alchemist-1.0.0/src/architect.py

@@ -0,0 +1,149 @@
+import os
+import json
+import shutil
+import tempfile
+import subprocess
+from rich.console import Console
+from rich.prompt import Confirm
+from .core import generate_content
+from .utils import run_shell
+
+console = Console()
+
+def scaffold_project(instruction, mode="fast"):
+    """
+    Generates shell commands to scaffold a project in a temporary directory.
+    """
+    console.print(f"[cyan]Architecting solution for: {instruction} ({mode} mode)...[/cyan]")
+    
+    # Create temp env
+    temp_dir = tempfile.mkdtemp(prefix="git_alchemist_scaffold_")
+    console.print(f"[gray]Created temporary workspace: {temp_dir}[/gray]")
+    
+    prompt = f"""
+Task: Project Scaffolding.
+User Goal: "{instruction}"
+Operating System: Linux/Unix (Termux)
+Constraint: Return ONLY a JSON object with a single key "commands" containing an array of shell strings.
+The commands should assume they are running INSIDE the project root.
+Example: {{"commands": ["mkdir src", "touch src/main.py", "echo 'print(1)' > src/main.py"]}}
+Do NOT use markdown blocks.
+"""
+
+    result = generate_content(prompt, mode=mode)
+    if not result:
+        shutil.rmtree(temp_dir)
+        return
+
+    try:
+        clean_result = result.replace("```json", "").replace("```", "").strip()
+        data = json.loads(clean_result)
+        commands = data.get("commands", [])
+        
+        console.print("[green]Generated Plan:[/green]")
+        for cmd in commands:
+            console.print(f"  > {cmd}")
+            
+        if Confirm.ask("Execute these commands in the temporary workspace?"):
+            # Execute in temp dir
+            cwd = os.getcwd()
+            os.chdir(temp_dir)
+            try:
+                for cmd in commands:
+                    console.print(f"[cyan]Running:[/cyan] {cmd}")
+                    run_shell(cmd)
+                
+                console.print("[green]Scaffolding complete in temporary workspace.[/green]")
+                console.print(f"[gray]Contents of {temp_dir}:[/gray]")
+                run_shell("ls -R")
+                
+                if Confirm.ask("Keep these files? (Moves them to current directory)"):
+                    # Move files from temp_dir to cwd
+                    # We iterate over items in temp_dir and move them
+                    for item in os.listdir(temp_dir):
+                        s = os.path.join(temp_dir, item)
+                        d = os.path.join(cwd, item)
+                        if os.path.exists(d):
+                            console.print(f"[yellow]Warning:[/yellow] {item} already exists in current directory. Skipping.")
+                        else:
+                            shutil.move(s, d)
+                    console.print("[green]Files moved successfully.[/green]")
+                else:
+                    console.print("[yellow]Discarding workspace.[/yellow]")
+                    
+            except Exception as e:
+                console.print(f"[red]Execution failed:[/red] {e}")
+            finally:
+                os.chdir(cwd)
+        
+    except json.JSONDecodeError:
+        console.print(f"[red]Failed to parse AI response:[/red] {result}")
+    finally:
+        if os.path.exists(temp_dir):
+            shutil.rmtree(temp_dir)
+            console.print("[gray]Temporary workspace cleaned up.[/gray]")
+
+def fix_code(file_path, instruction, mode="fast"):
+    """
+    Reads a file, applies an AI fix, and optionally creates a PR.
+    """
+    if not os.path.exists(file_path):
+        console.print(f"[red]File not found:[/red] {file_path}")
+        return
+
+    console.print(f"[cyan]Reading {file_path} ({mode} mode)...[/cyan]")
+    with open(file_path, "r", encoding="utf-8") as f:
+        content = f.read()
+
+    prompt = f"""
+Task: Fix/Modify Code.
+User Instructions:
+'''
+{instruction}
+'''
+
+Target File Content:
+'''
+{content}
+'''
+
+Goal: Return ONLY the complete, corrected file content based on the User Instructions. Do not use markdown blocks.
+"""
+    
+    console.print(f"[magenta]Consulting Gemini ({mode} mode)...[/magenta]")
+    result = generate_content(prompt, mode=mode)
+    if not result:
+        return
+
+    clean_result = result.replace("```python", "").replace("```", "").strip() # Generic cleanup
+    
+    # Backup
+    backup_path = f"{file_path}.bak"
+    shutil.copy(file_path, backup_path)
+    console.print(f"[gray]Backup created: {backup_path}[/gray]")
+    
+    with open(file_path, "w", encoding="utf-8") as f:
+        f.write(clean_result)
+        
+    console.print(f"[green]File updated.[/green]")
+    
+    if Confirm.ask("Create a PR for this fix?"):
+        # This assumes we are in a git repo
+        try:
+            branch_name = f"fix/ai-{os.urandom(4).hex()}"
+            run_shell(f"git checkout -b {branch_name}")
+            run_shell(f"git add {file_path}")
+            run_shell(f'git commit -m "AI Fix: {instruction}"')
+            run_shell(f"git push -u origin {branch_name}")
+            run_shell(f'gh pr create --title "AI Fix: {instruction}" --body "Automated fix." --web')
+        except Exception as e:
+            console.print(f"[red]PR creation failed:[/red] {e}")
+
+def explain_code(context, mode="fast"):
+    """
+    Explains a concept or code snippet.
+    """
+    prompt = f"Task: Explain Concept/Code. Context: '{context}'. Keep it concise and technical."
+    result = generate_content(prompt, mode=mode)
+    if result:
+        console.print(f"\n[bold white]--- Explanation ---[/bold white]\n{result}\n[bold white]-------------------[/bold white]")

git_alchemist-1.0.0/src/audit.py

@@ -0,0 +1,61 @@
+import os
+import json
+from rich.console import Console
+from rich.table import Table
+from rich.progress import Progress
+from .utils import run_shell, check_gh_auth
+
+console = Console()
+
+def run_audit(user=None, repo_name=None):
+    """
+    Audits a repository for 'Gold Standard' items and returns a score.
+    """
+    username = user or check_gh_auth()
+    if not username:
+        console.print("[red]Not authenticated with gh CLI.[/red]")
+        return
+
+    # Use current directory if no repo specified
+    target_repo = repo_name or run_shell("gh repo view --json name --jq .name", check=False)
+    if not target_repo:
+        console.print("[yellow]Not inside a Git repository. Auditing current directory files only.[/yellow]")
+        repo_data = {}
+    else:
+        console.print(f"[cyan]Auditing Repository:[/cyan] [bold]{username}/{target_repo}[/bold]")
+        repo_data_raw = run_shell(f"gh repo view {username}/{target_repo} --json description,repositoryTopics,licenseInfo", check=False)
+        repo_data = json.loads(repo_data_raw) if repo_data_raw else {}
+
+    checks = {
+        "README.md": {"score": 20, "found": os.path.exists("README.md")},
+        "LICENSE": {"score": 10, "found": bool(repo_data.get("licenseInfo")) or any(os.path.exists(f) for f in ["LICENSE", "LICENSE.md", "LICENSE.txt"])},
+        "CONTRIBUTING.md": {"score": 10, "found": any(os.path.exists(f) for f in ["CONTRIBUTING.md", "CONTRIBUTING"])},
+        "Metadata: Description": {"score": 20, "found": bool(repo_data.get("description"))},
+        "Metadata: Topics": {"score": 20, "found": len(repo_data.get("repositoryTopics", [])) >= 3},
+        "CI/CD: GitHub Actions": {"score": 20, "found": os.path.exists(".github/workflows")},
+    }
+
+    total_score = sum(c["score"] for c in checks.values() if c["found"])
+    
+    # Display Table
+    table = Table(title=f"Repository Audit: {target_repo or 'Local'}", border_style="blue")
+    table.add_column("Criterion", style="cyan")
+    table.add_column("Status", justify="center")
+    table.add_column("Weight", justify="right")
+
+    for name, data in checks.items():
+        status = "[green]GOLD[/green]" if data["found"] else "[red]LEAD[/red]"
+        table.add_row(name, status, f"{data['score']}")
+
+    console.print(table)
+    
+    # Final Score Display
+    color = "green" if total_score >= 80 else "yellow" if total_score >= 50 else "red"
+    console.print(f"\n[bold]Transmutation Score:[/bold] [{color}]{total_score}%[/{color}]")
+    
+    if total_score < 100:
+        console.print(f"\n[italic gray]The Alchemist suggests adding the missing components to reach 100% Gold.[/italic gray]")
+    else:
+        console.print(f"\n[bold yellow]✨ Pure Gold! This repository is optimized for the community.[/bold yellow]")
+
+    return total_score

git_alchemist-1.0.0/src/cli.py

@@ -0,0 +1,84 @@
+import argparse
+import sys
+from rich.console import Console
+from .profile_gen import generate_profile
+from .architect import scaffold_project, fix_code, explain_code
+from .repo_tools import optimize_topics, generate_descriptions
+from .issue_gen import create_issue
+from .audit import run_audit
+from .sage import ask_sage
+from .committer import suggest_commits
+
+console = Console()
+
+def main():
+    parser = argparse.ArgumentParser(description="Git-Alchemist: AI-powered Git Operations")
+    parser.add_argument("--smart", action="store_true", help="Use high-end Gemini Pro models (slower/lower quota)")
+    subparsers = parser.add_subparsers(dest="command", help="Available commands")
+    
+    # Commit Command
+    commit_parser = subparsers.add_parser("commit", help="Generate semantic commit messages from changes")
+
+    # Sage Command
+    sage_parser = subparsers.add_parser("sage", help="Ask the Sage questions about your codebase")
+    sage_parser.add_argument("question", help="The question about your code")
+
+    # Audit Command
+    audit_parser = subparsers.add_parser("audit", help="Check repository 'Gold' status and metadata")
+    audit_parser.add_argument("--repo", help="Specific repository name to audit")
+
+    # Profile Generator Command
+    profile_parser = subparsers.add_parser("profile", help="Generate or update GitHub Profile README")
+    profile_parser.add_argument("--force", action="store_true", help="Force full regeneration")
+    profile_parser.add_argument("--user", help="GitHub username (optional, detects automatically)")
+
+    # Repo Tools
+    topics_parser = subparsers.add_parser("topics", help="Optimize repository topics/tags")
+    topics_parser.add_argument("--user", help="GitHub username")
+
+    describe_parser = subparsers.add_parser("describe", help="Generate missing repository descriptions")
+    describe_parser.add_argument("--user", help="GitHub username")
+
+    # Issue Generator
+    issue_parser = subparsers.add_parser("issue", help="Draft a technical issue from an idea")
+    issue_parser.add_argument("idea", help="The feature or bug idea")
+
+    # Architect Commands
+    scaffold_parser = subparsers.add_parser("scaffold", help="Generate a new project structure (safe mode)")
+    scaffold_parser.add_argument("instruction", help="What to build (e.g., 'A Flask app with Docker')")
+
+    fix_parser = subparsers.add_parser("fix", help="Modify a file using AI")
+    fix_parser.add_argument("file", help="Path to the file to fix")
+    fix_parser.add_argument("instruction", help="What to change")
+
+    explain_parser = subparsers.add_parser("explain", help="Explain code or concepts")
+    explain_parser.add_argument("context", help="The code or concept to explain")
+
+    args = parser.parse_args()
+    mode = "smart" if args.smart else "fast"
+    
+    if args.command == "profile":
+        generate_profile(args.user, args.force, mode=mode)
+    elif args.command == "topics":
+        optimize_topics(args.user, mode=mode)
+    elif args.command == "describe":
+        generate_descriptions(args.user, mode=mode)
+    elif args.command == "issue":
+        create_issue(args.idea, mode=mode)
+    elif args.command == "scaffold":
+        scaffold_project(args.instruction, mode=mode)
+    elif args.command == "fix":
+        fix_code(args.file, args.instruction, mode=mode)
+    elif args.command == "explain":
+        explain_code(args.context, mode=mode)
+    elif args.command == "audit":
+        run_audit(repo_name=args.repo)
+    elif args.command == "sage":
+        ask_sage(args.question, mode=mode)
+    elif args.command == "commit":
+        suggest_commits(mode=mode)
+    else:
+        parser.print_help()
+
+if __name__ == "__main__":
+    main()