mcp-win-stdio-git 0.2.3__tar.gz

mcp_win_stdio_git-0.2.3/.gitignore

@@ -0,0 +1,60 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+*.manifest
+*.spec
+api.txt
+pip-log.txt
+pip-delete-this-directory.txt
+pypi api.txt
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+*.mo
+*.pot
+
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+.idea/
+.vscode/
+*.swp
+*.swo
+
+*.log

mcp_win_stdio_git-0.2.3/PKG-INFO

@@ -0,0 +1,118 @@
+Metadata-Version: 2.5
+Name: mcp-win-stdio-git
+Version: 0.2.3
+Summary: Unified Git & GitHub Model Context Protocol (MCP) server for Windows & Claude: 26 tools combining local Git repository management and remote GitHub CLI (gh) operations with hybrid synergy workflows.
+Author: Mohan Kumar Indala
+License-Expression: MIT
+Keywords: actions,ai,claude,gh,git,github,issues,llm,mcp,pull-requests,version-control
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Win32 (MS Windows)
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Version Control :: Git
+Requires-Python: >=3.10
+Requires-Dist: mcp-win-stdio>=0.2.3
+Requires-Dist: mcp>=1.2.0
+Description-Content-Type: text/markdown
+
+# mcp-win-stdio-git
+
+Unified Git & GitHub Model Context Protocol (MCP) server for Windows & Claude Desktop: **26 tools** seamlessly unifying local Git repository management and remote GitHub CLI (`gh`) operations with hybrid synergy workflows.
+
+Part of the **`mcp-win-stdio`** Windows-optimized suite.
+
+---
+
+## 🚀 Features (26 Tools)
+
+- **Local Git Suite (16 Tools)**:
+  - Branching (`git_branch`), staging & commits with identity checks (`git_commit`), token-safe diffs (`git_diff`), commit logs (`git_log`), stashing (`git_stash`), remote sync (`git_sync`), blame (`git_blame`), tags (`git_tag`), regex search (`git_grep`), and config (`git_config`).
+  - Safe file restoration and guarded destructive reset (`git_reset`).
+  - Isolated background workspaces via `git_worktree`.
+  - In-progress merge and rebase conflict detection & resolution (`git_conflict_resolve`).
+  - Multi-repo switching and bookmarking (`repo_overview`, `use_repo`, `list_repos`, `add_repo`).
+- **Remote GitHub CLI Suite (8 Tools)**:
+  - Pull requests (`gh_pr_list`, `gh_pr_view`, `gh_pr_diff`).
+  - Issue tracking (`gh_issue_list`).
+  - CI/CD workflow monitoring (`gh_run_status`).
+  - Gist snippet creation (`gh_gist_create`).
+  - Multi-account awareness and switching (`gh_auth_status`, `gh_switch_account`).
+- **Hybrid Synergy Workflows (2 Tools)**:
+  - `repo_overview`: 360-degree status combining local branch, dirty status, ahead/behind tracking, active open PR, and latest GitHub Actions workflow run.
+  - `pr_quickstart`: Stage -> commit -> push -> open GitHub PR via `gh pr create` in a single tool call.
+  - `issue_start_work`: Fetches GitHub issue details and automatically checks out a linked feature branch `feature/<id>-<slug>`.
+- **Zero-Friction Fallback**:
+  - Works 100% locally if GitHub CLI is not installed or unauthenticated, and provides copy-pasteable `winget` commands to install.
+
+---
+
+## 📋 Prerequisites & Setup
+
+1. **Install Git CLI** (if not installed):
+   ```powershell
+   winget install --id Git.Git -e
+   ```
+
+2. **Install GitHub CLI** (recommended for PRs, Issues, Actions):
+   ```powershell
+   winget install --id GitHub.cli -e
+   ```
+
+3. **Authenticate & Setup Git Credential Helper**:
+   ```powershell
+   gh auth login
+   gh auth setup-git
+   ```
+   > [!IMPORTANT]
+   > `gh auth setup-git` is crucial so your local git push/pull and multi-account switching (`gh_switch_account`) authenticate smoothly.
+
+---
+
+## 📦 Installation
+
+```powershell
+pip install mcp-win-stdio-git
+```
+*(Installing this package automatically installs `mws` CLI orchestrator)*.
+
+---
+
+## 🚀 One-Command Claude Setup
+
+```powershell
+mws setup git
+# or:
+mws add git
+```
+This automatically configures Claude Desktop (`claude_desktop_config.json`) and Claude Code CLI with zero manual JSON editing.
+
+### Manual Configuration
+```json
+"git": {
+  "command": "python",
+  "args": ["-m", "mcp_win_stdio.git"]
+}
+```
+
+---
+
+## 📖 CLI Commands & Interactive Guide
+
+```powershell
+mws git guide      # Complete tool reference & prompt recipes
+mws git doctor     # Verify Git, GitHub CLI, and credential helper status
+mws git setup      # Configure Claude Desktop / Claude Code
+mws git run        # Launch server over stdio
+```
+
+---
+
+## 📜 License
+MIT License. Copyright (c) 2026 Mohan Kumar Indala.

mcp_win_stdio_git-0.2.3/README.md

@@ -0,0 +1,94 @@
+# mcp-win-stdio-git
+
+Unified Git & GitHub Model Context Protocol (MCP) server for Windows & Claude Desktop: **26 tools** seamlessly unifying local Git repository management and remote GitHub CLI (`gh`) operations with hybrid synergy workflows.
+
+Part of the **`mcp-win-stdio`** Windows-optimized suite.
+
+---
+
+## 🚀 Features (26 Tools)
+
+- **Local Git Suite (16 Tools)**:
+  - Branching (`git_branch`), staging & commits with identity checks (`git_commit`), token-safe diffs (`git_diff`), commit logs (`git_log`), stashing (`git_stash`), remote sync (`git_sync`), blame (`git_blame`), tags (`git_tag`), regex search (`git_grep`), and config (`git_config`).
+  - Safe file restoration and guarded destructive reset (`git_reset`).
+  - Isolated background workspaces via `git_worktree`.
+  - In-progress merge and rebase conflict detection & resolution (`git_conflict_resolve`).
+  - Multi-repo switching and bookmarking (`repo_overview`, `use_repo`, `list_repos`, `add_repo`).
+- **Remote GitHub CLI Suite (8 Tools)**:
+  - Pull requests (`gh_pr_list`, `gh_pr_view`, `gh_pr_diff`).
+  - Issue tracking (`gh_issue_list`).
+  - CI/CD workflow monitoring (`gh_run_status`).
+  - Gist snippet creation (`gh_gist_create`).
+  - Multi-account awareness and switching (`gh_auth_status`, `gh_switch_account`).
+- **Hybrid Synergy Workflows (2 Tools)**:
+  - `repo_overview`: 360-degree status combining local branch, dirty status, ahead/behind tracking, active open PR, and latest GitHub Actions workflow run.
+  - `pr_quickstart`: Stage -> commit -> push -> open GitHub PR via `gh pr create` in a single tool call.
+  - `issue_start_work`: Fetches GitHub issue details and automatically checks out a linked feature branch `feature/<id>-<slug>`.
+- **Zero-Friction Fallback**:
+  - Works 100% locally if GitHub CLI is not installed or unauthenticated, and provides copy-pasteable `winget` commands to install.
+
+---
+
+## 📋 Prerequisites & Setup
+
+1. **Install Git CLI** (if not installed):
+   ```powershell
+   winget install --id Git.Git -e
+   ```
+
+2. **Install GitHub CLI** (recommended for PRs, Issues, Actions):
+   ```powershell
+   winget install --id GitHub.cli -e
+   ```
+
+3. **Authenticate & Setup Git Credential Helper**:
+   ```powershell
+   gh auth login
+   gh auth setup-git
+   ```
+   > [!IMPORTANT]
+   > `gh auth setup-git` is crucial so your local git push/pull and multi-account switching (`gh_switch_account`) authenticate smoothly.
+
+---
+
+## 📦 Installation
+
+```powershell
+pip install mcp-win-stdio-git
+```
+*(Installing this package automatically installs `mws` CLI orchestrator)*.
+
+---
+
+## 🚀 One-Command Claude Setup
+
+```powershell
+mws setup git
+# or:
+mws add git
+```
+This automatically configures Claude Desktop (`claude_desktop_config.json`) and Claude Code CLI with zero manual JSON editing.
+
+### Manual Configuration
+```json
+"git": {
+  "command": "python",
+  "args": ["-m", "mcp_win_stdio.git"]
+}
+```
+
+---
+
+## 📖 CLI Commands & Interactive Guide
+
+```powershell
+mws git guide      # Complete tool reference & prompt recipes
+mws git doctor     # Verify Git, GitHub CLI, and credential helper status
+mws git setup      # Configure Claude Desktop / Claude Code
+mws git run        # Launch server over stdio
+```
+
+---
+
+## 📜 License
+MIT License. Copyright (c) 2026 Mohan Kumar Indala.

mcp_win_stdio_git-0.2.3/pyproject.toml

@@ -0,0 +1,41 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "mcp-win-stdio-git"
+version = "0.2.3"
+description = "Unified Git & GitHub Model Context Protocol (MCP) server for Windows & Claude: 26 tools combining local Git repository management and remote GitHub CLI (gh) operations with hybrid synergy workflows."
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+authors = [
+    { name = "Mohan Kumar Indala" }
+]
+keywords = ["mcp", "claude", "git", "github", "gh", "version-control", "pull-requests", "issues", "actions", "ai", "llm"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Win32 (MS Windows)",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: Microsoft :: Windows",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Software Development :: Version Control :: Git",
+]
+
+dependencies = [
+    "mcp-win-stdio>=0.2.3",
+    "mcp>=1.2.0",
+]
+
+[project.scripts]
+mcp-win-stdio-git = "mcp_win_stdio.git.cli:main"
+mws-git = "mcp_win_stdio.git.cli:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/mcp_win_stdio"]

mcp_win_stdio_git-0.2.3/src/mcp_win_stdio/git/__init__.py

@@ -0,0 +1,5 @@
+"""
+Git & GitHub MCP Server for mcp-win-stdio.
+"""
+
+__version__ = "0.2.3"

mcp_win_stdio_git-0.2.3/src/mcp_win_stdio/git/__main__.py

@@ -0,0 +1,8 @@
+"""
+Direct module execution for mcp-win-stdio git server.
+"""
+
+from mcp_win_stdio.git.server import mcp
+
+if __name__ == "__main__":
+    mcp.run()

mcp_win_stdio_git-0.2.3/src/mcp_win_stdio/git/cli.py

@@ -0,0 +1,134 @@
+"""
+CLI entry point for mcp-win-stdio-git.
+"""
+
+import argparse
+import os
+from pathlib import Path
+import shutil
+import subprocess
+import sys
+
+# Ensure Windows console uses UTF-8 without crashing on cp1252
+if sys.platform == "win32":
+    try:
+        sys.stdout.reconfigure(encoding="utf-8", errors="replace")
+        sys.stderr.reconfigure(encoding="utf-8", errors="replace")
+    except Exception:
+        pass
+
+from mcp_win_stdio.git import __version__
+from mcp_win_stdio.git.server import mcp, is_git_installed, is_gh_installed
+
+
+def cmd_run(args: argparse.Namespace) -> None:
+    """Run Git & GitHub MCP server over stdio."""
+    mcp.run()
+
+
+def cmd_doctor(args: argparse.Namespace) -> None:
+    """Run diagnostic checks on Git, GitHub CLI, author identity, and authentication."""
+    print(f"\n=== mcp-win-stdio-git Doctor Diagnostic (v{__version__}) ===\n")
+    print(f"[OK] Python Runtime: {sys.version.split()[0]} ({sys.executable})")
+
+    # 1. Git CLI Check
+    git_bin = shutil.which("git")
+    if git_bin:
+        try:
+            ver = subprocess.run(["git", "--version"], capture_output=True, text=True, check=True).stdout.strip()
+            print(f"[OK] Git CLI: {ver} ({git_bin})")
+        except Exception:
+            print(f"[OK] Git CLI: Found at {git_bin}")
+
+        # Git Config
+        name = subprocess.run(["git", "config", "user.name"], capture_output=True, text=True).stdout.strip()
+        email = subprocess.run(["git", "config", "user.email"], capture_output=True, text=True).stdout.strip()
+        if name and email:
+            print(f"[OK] Git Identity: {name} <{email}>")
+        else:
+            print(f"[WARN] Git Identity: Not configured (missing user.name or user.email)")
+            print(f"       -> Run: git config --global user.name \"Your Name\"")
+            print(f"       -> Run: git config --global user.email \"you@example.com\"")
+    else:
+        print(f"[FAIL] Git CLI: Not found on PATH")
+        print(f"       -> Install Git: winget install --id Git.Git -e")
+        if sys.stdin.isatty():
+            install = input("       Would you like to install Git now via winget? [Y/n]: ").strip().lower()
+            if install not in ("n", "no"):
+                subprocess.run(["winget", "install", "--id", "Git.Git", "-e"])
+
+    # 2. GitHub CLI Check
+    gh_bin = shutil.which("gh")
+    if gh_bin:
+        try:
+            ver_line = subprocess.run(["gh", "--version"], capture_output=True, text=True, check=True).stdout.splitlines()[0]
+            print(f"[OK] GitHub CLI: {ver_line} ({gh_bin})")
+        except Exception:
+            print(f"[OK] GitHub CLI: Found at {gh_bin}")
+
+        # GitHub Auth status
+        auth_res = subprocess.run(["gh", "auth", "status"], capture_output=True, text=True, encoding="utf-8", errors="replace")
+        auth_out = auth_res.stderr or auth_res.stdout
+        if "Logged in to" in auth_out:
+            first_account = [ln.strip() for ln in auth_out.splitlines() if "Logged in to" in ln]
+            account_str = first_account[0] if first_account else "Active"
+            account_str = account_str.replace("✓", "").replace("✓", "").strip()
+            print(f"[OK] GitHub Auth: Logged in ({account_str})")
+
+            # Check Git credential helper integration
+            helper_res = subprocess.run(["git", "config", "--get-all", "credential.helper"], capture_output=True, text=True).stdout
+            if "gh" in helper_res:
+                print(f"[OK] Git Credential Helper: Linked to gh (account switching active)")
+            else:
+                print(f"[WARN] Git Credential Helper: Not linked to GitHub CLI.")
+                print(f"       -> Run: gh auth setup-git")
+                print(f"       (Required for git commands & account switching to use gh authentication)")
+        else:
+            print(f"[INFO] GitHub Auth: Not logged in")
+            print(f"       -> Step 1: gh auth login")
+            print(f"       -> Step 2: gh auth setup-git  (essential for git commands & account switching)")
+    else:
+        print(f"[INFO] GitHub CLI: Not found on PATH (enables PR, Issue, and Actions tools)")
+        print(f"       -> Step 1: winget install --id GitHub.cli -e")
+        print(f"       -> Step 2: gh auth login")
+        print(f"       -> Step 3: gh auth setup-git  (essential for git commands & account switching)")
+        if sys.stdin.isatty():
+            install = input("       Would you like to install GitHub CLI now via winget? [y/N]: ").strip().lower()
+            if install in ("y", "yes"):
+                subprocess.run(["winget", "install", "--id", "GitHub.cli", "-e"])
+
+    print("\nDiagnostic complete.\n")
+
+
+def cmd_guide(args: argparse.Namespace) -> None:
+    """Print Git MCP guide and prompt recipes."""
+    from mcp_win_stdio.git.guide import print_git_guide
+    print_git_guide()
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(
+        prog="mcp-win-stdio-git",
+        description="Unified Git & GitHub MCP Server CLI (Local Git + Remote GitHub CLI)",
+    )
+    parser.add_argument("--version", "-v", action="version", version=f"%(prog)s {__version__}")
+    subparsers = parser.add_subparsers(dest="command", help="Command to execute")
+
+    sub_guide = subparsers.add_parser("guide", help="View usage guide, tool references, and prompts")
+    sub_guide.set_defaults(func=cmd_guide)
+
+    sub_doctor = subparsers.add_parser("doctor", help="Check Git & GitHub CLI health, identity, and auth")
+    sub_doctor.set_defaults(func=cmd_doctor)
+
+    sub_run = subparsers.add_parser("run", help="Run Git & GitHub MCP server over stdio")
+    sub_run.set_defaults(func=cmd_run)
+
+    args = parser.parse_args()
+    if hasattr(args, "func"):
+        args.func(args)
+    else:
+        cmd_run(args)
+
+
+if __name__ == "__main__":
+    main()

mcp_win_stdio_git-0.2.3/src/mcp_win_stdio/git/guide.py

@@ -0,0 +1,150 @@
+"""
+Usage guide, prerequisites, and prompt recipes for Git & GitHub MCP server (mcp-win-stdio-git).
+"""
+
+import shutil
+import subprocess
+import sys
+
+# Ensure Windows console uses UTF-8 without crashing on cp1252
+if sys.platform == "win32":
+    try:
+        sys.stdout.reconfigure(encoding="utf-8", errors="replace")
+        sys.stderr.reconfigure(encoding="utf-8", errors="replace")
+    except Exception:
+        pass
+
+
+def get_git_prerequisites_status() -> dict:
+    """Check current status of git, gh, and git credential helper."""
+    git_bin = shutil.which("git")
+    gh_bin = shutil.which("gh")
+    gh_logged_in = False
+    gh_account = None
+    cred_helper_linked = False
+
+    if gh_bin:
+        try:
+            res = subprocess.run(["gh", "auth", "status"], capture_output=True, text=True, encoding="utf-8", errors="replace")
+            out = res.stderr or res.stdout
+            if "Logged in to" in out:
+                gh_logged_in = True
+                for ln in out.splitlines():
+                    if "Logged in to" in ln:
+                        gh_account = ln.replace("✓", "").replace("✓", "").strip()
+                        break
+        except Exception:
+            pass
+
+    if git_bin and gh_bin:
+        try:
+            helper_res = subprocess.run(["git", "config", "--get-all", "credential.helper"], capture_output=True, text=True)
+            if "gh" in helper_res.stdout:
+                cred_helper_linked = True
+        except Exception:
+            pass
+
+    return {
+        "git_installed": bool(git_bin),
+        "gh_installed": bool(gh_bin),
+        "gh_logged_in": gh_logged_in,
+        "gh_account": gh_account,
+        "cred_helper_linked": cred_helper_linked,
+    }
+
+
+def print_git_guide() -> None:
+    status = get_git_prerequisites_status()
+
+    print("=" * 80)
+    print("      Unified Git & GitHub MCP Server (mcp-win-stdio-git)")
+    print("=" * 80)
+
+    print("\nPREREQUISITES & ENVIRONMENT STATUS:")
+    print("-" * 80)
+    if status["git_installed"]:
+        print("  [OK] Git CLI: Installed")
+    else:
+        print("  [!]  Git CLI: NOT FOUND")
+        print("       -> Run: winget install --id Git.Git -e")
+
+    if status["gh_installed"]:
+        print("  [OK] GitHub CLI (gh): Installed")
+        if status["gh_logged_in"]:
+            print(f"  [OK] GitHub Auth: Logged in ({status['gh_account'] or 'Active'})")
+            if status["cred_helper_linked"]:
+                print("  [OK] Git Credential Helper: Linked to gh (account switching active)")
+            else:
+                print("  [!]  Git Credential Helper: Not linked to gh")
+                print("       -> Run: gh auth setup-git")
+                print("          (Required so git commands & account switching use gh authentication)")
+        else:
+            print("  [!]  GitHub Auth: Not logged in")
+            print("       -> Step 1: gh auth login")
+            print("       -> Step 2: gh auth setup-git  (essential for git operations & account switching)")
+    else:
+        print("  [!]  GitHub CLI (gh): NOT FOUND (Required for PRs, issues, gists & CI runs)")
+        print("       -> Step 1: winget install --id GitHub.cli -e")
+        print("       -> Step 2: gh auth login")
+        print("       -> Step 3: gh auth setup-git  (essential for git operations & account switching)")
+
+    print("\nSETUP INSTRUCTIONS FOR NEW USERS:")
+    print("-" * 80)
+    print("  1. If Git or gh is not installed, install them using winget:")
+    print("     winget install --id Git.Git -e")
+    print("     winget install --id GitHub.cli -e")
+    print("\n  2. Authenticate GitHub CLI:")
+    print("     gh auth login")
+    print("\n  3. Configure Git to use GitHub CLI credentials (CRUCIAL):")
+    print("     gh auth setup-git")
+    print("     * Why this is needed: Configures git credential.helper = '!gh auth git-credential'.")
+    print("       Without this, local git push/pull and multi-account switching ('gh auth switch')")
+    print("       will fail or fallback to outdated Windows credentials.")
+    print("\n  4. Register with Claude Desktop or Claude Code CLI:")
+    print("     mws add git")
+
+    print("\nAVAILABLE TOOLS (26 Tools):")
+    print("-" * 80)
+    print(" Local Git Operations:")
+    print("   * repo_overview        : 360-degree repo overview: branch, dirty state, PR, latest CI")
+    print("   * use_repo             : Switch active repository workspace bookmark")
+    print("   * list_repos           : List registered repository workspaces")
+    print("   * add_repo             : Bookmark a repository path for multi-project workflows")
+    print("   * git_status           : Structured status: staged, unstaged, untracked files")
+    print("   * git_diff             : Token-safe diff (unstaged, staged index, branch comparisons)")
+    print("   * git_log              : Structured commit history with hash, author, date, message")
+    print("   * git_commit           : Stage and commit files with clean commit messages")
+    print("   * git_branch           : List, create, switch, or safely delete branches")
+    print("   * git_stash            : Stash changes: save, pop, list, drop")
+    print("   * git_sync             : Fetch, pull, push with upstream tracking")
+    print("   * git_blame            : Token-safe file blame with line range filtering")
+    print("   * git_reset            : Safe file restore or commit reset (soft or guarded hard)")
+    print("   * git_tag              : List, create, or delete Git tags")
+    print("   * git_grep             : Fast regex search across tracked files")
+    print("   * git_worktree         : Isolated branch workspaces: list, add, remove, prune")
+    print("   * git_config           : Inspect or configure git settings (user.name, user.email)")
+    print("   * git_conflict_resolve : Detect merge/rebase conflicts, abort, or continue")
+    print("\n Remote GitHub Operations (via gh CLI):")
+    print("   * gh_auth_status       : Check GitHub CLI authentication status and accounts")
+    print("   * gh_switch_account    : Switch active GitHub account (personal vs work)")
+    print("   * gh_pr_list           : List pull requests with state filters")
+    print("   * gh_pr_view           : Deep view of PR: reviews, CI checks, mergeable state")
+    print("   * gh_pr_diff           : View token-capped remote PR diff")
+    print("   * gh_issue_list        : List repository issues with label/state filters")
+    print("   * gh_run_status        : Inspect recent GitHub Actions workflow runs")
+    print("   * gh_gist_create       : Share code snippets via GitHub Gists")
+    print("\n Hybrid Synergy Workflows:")
+    print("   * pr_quickstart        : Stage -> Commit -> Push -> Create PR via 'gh pr create'")
+    print("   * issue_start_work     : Fetch issue from GitHub -> Checkout feature branch locally")
+
+    print("\nPROMPT RECIPES FOR CLAUDE:")
+    print("-" * 80)
+    print("  1. 'Give me a 360-degree overview of the current repo, open PRs, and recent CI runs using repo_overview.'")
+    print("  2. 'Pick up issue #12, check its details, and create a local branch using issue_start_work.'")
+    print("  3. 'Stage all modified files, commit with message \"feat: new feature\", push, and open a PR with pr_quickstart.'")
+    print("  4. 'Switch active GitHub account to my work account using gh_switch_account.'")
+    print("=" * 80 + "\n")
+
+
+if __name__ == "__main__":
+    print_git_guide()