GHCP Advisor

AI-powered git workflow advisory for VS Code, powered by GitHub Copilot.

Features

GHCP Advisor gives you intelligent feedback at every stage of your git workflow:

• /review-staged — Analyzes staged changes for coherence, suggests improvements, recommends a commit message, and warns about unstaged work
• /commit-advice — Evaluates push readiness, provides branch/workflow suggestions, validates commit message format, and tracks quality trends
• /pr-description — Generates a polished PR title and description from your pushed commits
• /code-review — Pre-push code review that catches security vulnerabilities and quality issues
• /resolve-conflicts — AI-guided merge conflict resolution with per-file analysis
• /changelog — Auto-generates a changelog from commits since last tag (Keep a Changelog format)
• /plan-release — Release planning with version bump analysis, AI release notes, and one-click tag/bump actions
• /prepare-pr — Comprehensive PR preparation: title, description, reviewer context, focus areas, and checklist
• /check-docs — Documentation health analysis: scans for undocumented exports, stale docs, and suggests improvements
• /analyze-arch — Architecture analysis: identifies coupling issues, circular dependencies, design patterns, and complexity hotspots

Additional Capabilities

• Conventional Commits Enforcer — Validates and auto-fixes commit messages (integrated into /review-staged and /commit-advice)
• Commit Quality Trend — Scores your recent commit messages (0–100) with recurring issue detection
• Status Bar — Context-aware indicator that detects git events and offers one-click advisory access
• SCM Buttons — One-click actions in chat output (apply commit message, run push, copy changelog, create tag, open PR)
• Language Model Resilience — Automatic retry on empty responses with 1-second delay; fallback chain tries multiple model families (gpt-4o → copilot-chat → gpt-4 → gpt-3.5-turbo)
• Dynamic Model Selection — New "GHCP Advisor: Select Model" command to pick from available Copilot models; ghcp-advisor.preferredModelFamily setting for persistent preference

Usage

Chat Commands

Open GitHub Copilot Chat and type @ghcp-advisor followed by a command:

@ghcp-advisor /review-staged    — Analyze staged changes
@ghcp-advisor /commit-advice    — Post-commit advisory
@ghcp-advisor /pr-description    — Generate PR details
@ghcp-advisor /code-review       — Pre-push code review
@ghcp-advisor /resolve-conflicts — Resolve merge conflicts
@ghcp-advisor /changelog         — Generate changelog
@ghcp-advisor /plan-release      — Plan a release
@ghcp-advisor /prepare-pr        — Prepare PR for review
@ghcp-advisor /check-docs        — Check documentation health
@ghcp-advisor /analyze-arch      — Analyze project architecture

Command Palette

Press Ctrl+Shift+P (or Cmd+Shift+P on macOS) and search "GHCP Advisor":

• GHCP Advisor: Stage Advisory
• GHCP Advisor: Commit Advisory
• GHCP Advisor: Push Advisory
• GHCP Advisor: Code Review
• GHCP Advisor: Conflict Resolution
• GHCP Advisor: Generate Changelog
• GHCP Advisor: Release Planning
• GHCP Advisor: PR Preparation
• GHCP Advisor: Documentation Check
• GHCP Advisor: Architecture Analysis
• GHCP Advisor: Select Model — Configure which Copilot model family to use

Configuration

Settings → Extensions → GHCP Advisor:

• ghcp-advisor.preferredModelFamily — Choose your preferred Copilot model family

  • Default: auto (extension automatically selects the best available model)
  • Options: Run the "Select Model" command to see available model families and choose one
  • Use: Once set, all advisories use your chosen model; if the model becomes unavailable, the extension automatically falls back to other models

• ghcp-advisor.onGitEvent — Control how the extension responds to git activity

  • off — No notifications or automatic actions
  • notify — Show notification toast with a button to open Copilot Chat (default)
  • auto — Automatically open Copilot Chat with the relevant advisory running

Automatic Notifications

GHCP Advisor watches your git activity and offers relevant advisories via notifications when you stage files, create commits, or push branches. Configure behavior in Settings → Extensions → GHCP Advisor (off / notify / auto).

Requirements

• VS Code v1.93.0 or later
• GitHub Copilot extension
• GitHub Copilot Chat extension
• A Git repository open in your workspace