{"id":30119105,"url":"https://github.com/gwendall/superclaude","last_synced_at":"2025-10-10T12:51:04.457Z","repository":{"id":302477560,"uuid":"1005958780","full_name":"gwendall/superclaude","owner":"gwendall","description":"🚀 Give Claude AI superpowers for GitHub workflows. Transform \"fix stuff\" commits into professional messages, generate intelligent changelogs, and get AI code reviews - all with one command.","archived":false,"fork":false,"pushed_at":"2025-06-25T16:08:20.000Z","size":53,"stargazers_count":238,"open_issues_count":1,"forks_count":23,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-09-25T02:58:59.555Z","etag":null,"topics":["ai","anthropic","automation","changelog","claude","code-review","commit-messages","developer-tools","documentation","github","productivity","workflow"],"latest_commit_sha":null,"homepage":"https://superclaude.sh","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gwendall.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-21T07:05:01.000Z","updated_at":"2025-09-24T02:35:44.000Z","dependencies_parsed_at":"2025-07-02T16:19:44.285Z","dependency_job_id":"2dd897d7-e871-461c-8d33-6691f1ef0fe0","html_url":"https://github.com/gwendall/superclaude","commit_stats":null,"previous_names":["gwendall/superclaude"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/gwendall/superclaude","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gwendall%2Fsuperclaude","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gwendall%2Fsuperclaude/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gwendall%2Fsuperclaude/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gwendall%2Fsuperclaude/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gwendall","download_url":"https://codeload.github.com/gwendall/superclaude/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gwendall%2Fsuperclaude/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279003890,"owners_count":26083641,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-10T02:00:06.843Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","anthropic","automation","changelog","claude","code-review","commit-messages","developer-tools","documentation","github","productivity","workflow"],"created_at":"2025-08-10T12:01:57.658Z","updated_at":"2025-10-10T12:51:04.448Z","avatar_url":"https://github.com/gwendall.png","language":"Shell","funding_links":[],"categories":["GitHub Integration"],"sub_categories":[],"readme":"# SuperClaude\n\n[![npm version](https://badge.fury.io/js/superclaude.svg)](https://badge.fury.io/js/superclaude)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n🔮 **Supercharge your GitHub workflow with Claude AI.** Transform your development process with AI-powered commit messages, intelligent changelogs, automated documentation, and code reviews that actually understand your codebase.\n\n## Quick Install\n\n```bash\nnpm install -g superclaude\n```\n\n**Prerequisites:** Node.js 18+, Git, [Claude Code](https://www.anthropic.com/claude-code), and optionally [GitHub CLI](https://cli.github.com/).\n\n## Quick Start\n\n```bash\ncd your-project\nsuperclaude --verify        # Check system dependencies and authentication\nsuperclaude commit          # AI generates perfect commit messages\nsuperclaude changelog       # Creates intelligent project history\nsuperclaude readme          # Writes comprehensive documentation\n```\n\n## Commands\n\n### 🔧 `superclaude --verify`\n**Smart dependency and authentication checking.**\n\nValidates your system setup and authentication status with intelligent caching to avoid repeated checks. Ensures Claude, Git, and GitHub authentication are properly configured.\n\n```bash\nsuperclaude --verify                  # Force full dependency check\n```\n\n**How it works:**\n- Validates Claude Code installation and authentication\n- Checks Git configuration and user setup\n- Verifies GitHub authentication (SSH keys or GitHub CLI)\n- Uses intelligent 24-hour caching to avoid repeated checks\n- Provides detailed feedback on any missing dependencies\n\n### 🤖 `superclaude commit`\n**AI-powered commits that actually make sense.**\n\nAnalyzes your git changes, understands the context, and generates conventional commit messages. No more \"fix stuff\" or \"update files\" - get meaningful commits that tell the story of your code.\n\n```bash\nsuperclaude commit                    # Quick AI commit\nsuperclaude commit --interactive      # Review before committing  \nsuperclaude commit --verbose          # See the AI thinking process\nsuperclaude commit \"Add user context\" # Include additional context\n```\n\n**How it works:**\n- Scans all changed files and understands the modifications\n- Analyzes code patterns to determine commit type (feat/fix/refactor/etc.)\n- Generates conventional commit format with clear descriptions\n- Supports additional context to guide commit message generation\n- Enhanced authentication validation for seamless push operations\n- Automatically stages, commits, and pushes to your current branch\n\n### 📅 `superclaude changelog`\n**Turn raw commit history into readable project stories.**\n\nCreates human-readable changelogs that focus on user impact, not technical noise. Generates daily, weekly, and monthly summaries that actually make sense to stakeholders.\n\n```bash\nsuperclaude changelog                 # Generate intelligent changelog\nsuperclaude changelog --verbose       # See detailed analysis process\n```\n\n**How it works:**\n- Analyzes entire commit history with AI understanding\n- Filters out trivial changes, focuses on meaningful updates  \n- Groups changes by time periods and impact\n- Creates multiple changelog formats (daily/weekly/monthly)\n- Writes in clear, non-technical language\n\n### 📖 `superclaude readme`\n**Professional documentation that writes itself.**\n\nAnalyzes your codebase architecture and creates comprehensive README files with installation guides, usage examples, and feature descriptions.\n\n```bash\nsuperclaude readme                    # Generate project README\n```\n\n**How it works:**\n- Scans project structure and identifies key technologies\n- Analyzes package.json and dependencies\n- Understands code patterns and project purpose\n- Creates professional documentation with examples\n- Includes installation, usage, and contribution guides\n\n### 🔍 `superclaude review`\n**Code reviews that catch what humans miss.**\n\nPerforms deep code analysis for security vulnerabilities, performance issues, and maintainability problems. Provides actionable recommendations for improvement.\n\n```bash\nsuperclaude review                    # Comprehensive code analysis\nsuperclaude review --verbose          # Detailed security assessment\n```\n\n**How it works:**\n- Analyzes entire codebase for patterns and anti-patterns\n- Identifies security vulnerabilities and performance bottlenecks\n- Evaluates code quality and maintainability metrics\n- Provides specific, actionable improvement recommendations\n- Saves detailed review to `docs/code-review.md`\n\n### 📚 `superclaude docs`\n**Technical documentation that developers actually read.**\n\nCreates comprehensive technical guides covering architecture, components, deployment, and troubleshooting.\n\n```bash\nsuperclaude docs                      # Generate technical documentation\n```\n\n**How it works:**\n- Maps project architecture and component relationships\n- Documents data flow and system interactions\n- Creates deployment and configuration guides\n- Includes troubleshooting and debugging information\n- Saves to `docs/technical-docs.md`\n\n### 💡 `superclaude brainstorm`\n**AI-powered feature ideation and improvement suggestions.**\n\nAnalyzes your codebase capabilities and suggests new features, optimizations, and architectural improvements.\n\n```bash\nsuperclaude brainstorm                # Get improvement ideas\n```\n\n**How it works:**\n- Evaluates current codebase capabilities and patterns\n- Identifies optimization opportunities and technical debt\n- Suggests new features based on project direction\n- Recommends architecture evolution strategies\n- Saves ideas to `docs/ideas.md`\n\n### 📝 `superclaude annotate`\n**Add intelligent context to your entire git history.**\n\nAnalyzes every commit in your repository and adds AI-generated notes that explain what each change actually accomplished.\n\n```bash\nsuperclaude annotate                  # Add AI notes to all commits\nsuperclaude annotate --verbose        # See annotation process\n```\n\n**How it works:**\n- Processes each commit's diff and understands changes\n- Generates detailed technical explanations\n- Adds git notes with context and purpose\n- Creates searchable commit history\n- View with `git log --show-notes`\n\n## Project Integration\n\nAdd to your `package.json` for team workflows:\n\n```json\n{\n  \"scripts\": {\n    \"commit\": \"superclaude commit --interactive\",\n    \"release:prep\": \"superclaude changelog \u0026\u0026 superclaude readme\",\n    \"code:review\": \"superclaude review --verbose\",\n    \"docs:update\": \"superclaude docs\"\n  }\n}\n```\n\n## Why SuperClaude?\n\n### 🎯 **Intelligent, Not Automated**\nUnlike simple automation tools, SuperClaude understands your code context. It reads your entire codebase, understands patterns, and generates content that makes sense for your specific project.\n\n### 🚀 **GitHub + Claude = Superpowers** \nCombines Claude's deep reasoning with GitHub workflows. Get AI that understands not just syntax, but intent, architecture, and user impact.\n\n### ⚡ **Saves Hours, Not Minutes**\n- **Commit messages**: From 30 seconds to instant, every time\n- **Changelogs**: From hours of manual work to 2 minutes\n- **Documentation**: From days of writing to comprehensive docs in minutes\n- **Code reviews**: Catch issues before they become problems\n\n### 🧠 **Context-Aware AI**\n- Understands your project's tech stack and patterns\n- Maintains consistency with your existing code style\n- Focuses on user impact, not just technical changes\n- Learns from your codebase structure and conventions\n\n## Examples\n\n### Daily Workflow\n```bash\n# Make some changes\necho \"new feature\" \u003e\u003e src/feature.js\n\n# AI commit with perfect message\nsuperclaude commit\n# ✅ Output: \"feat: add user authentication with JWT tokens\"\n\n# Update documentation automatically  \nsuperclaude readme\n# ✅ Creates professional README with new feature documented\n\n# Prepare for release\nsuperclaude changelog\n# ✅ Generates release notes that stakeholders actually understand\n```\n\n### Team Workflow\n```bash\n# Before standups - get project insights\nsuperclaude brainstorm\n# ✅ \"Here are 8 improvement opportunities based on your codebase...\"\n\n# Before releases - comprehensive preparation\nyarn release:prep\n# ✅ Updated changelog + README + documentation\n\n# Before code reviews - AI pre-screening\nsuperclaude review\n# ✅ \"Found 3 security issues and 5 performance optimizations...\"\n```\n\n## Installation Details\n\n### Prerequisites\nInstall these first:\n```bash\n# Required\nnpm install -g @anthropic-ai/claude-code\n# Then run: claude (and complete authentication)\n\n# Recommended  \nbrew install gh          # GitHub CLI for enhanced workflows\ngh auth login           # Authenticate with GitHub\n```\n\n**System Requirements:** Node.js 18+, Git configured with user info.\n\n### GitHub Authentication Setup\n\nSuperClaude uses intelligent global authentication detection that works across all your repositories. The system automatically validates your GitHub access using either SSH keys or GitHub CLI authentication:\n\n#### 🔐 **SSH Authentication (Recommended)**\nIf your remote uses `git@github.com:...` format:\n```bash\n# Generate SSH key (if you don't have one)\nssh-keygen -t ed25519 -C \"your@email.com\"\n\n# Add public key to GitHub\ncat ~/.ssh/id_ed25519.pub\n# Copy the output and add it at: https://github.com/settings/keys\n\n# Test SSH connection\nssh -T git@github.com\n```\n\n#### 🌐 **HTTPS Authentication**\nIf your remote uses `https://github.com/...` format, you have three options:\n\n**Option 1: GitHub CLI (Recommended)**\n```bash\nbrew install gh\ngh auth login  # Choose SSH when prompted\n```\n\n**Option 2: Switch to SSH**\n```bash\ngit remote set-url origin git@github.com:USERNAME/REPOSITORY.git\n```\n\n**Option 3: Personal Access Token**\n- Create token at [GitHub Settings](https://github.com/settings/tokens)\n- Use token as password when git prompts for credentials\n\n\u003e 💡 **Why SSH is Better:** SSH eliminates password prompts, is more secure, and provides seamless authentication. SuperClaude will automatically detect your setup and guide you through any authentication issues.\n\n## Troubleshooting\n\n### Common Issues\n\n**Command not found**\n```bash\nnpm install -g superclaude\n# Ensure npm global bin is in your PATH\n```\n\n**Claude Code not authenticated**\n```bash\nclaude\n# Follow authentication prompts (Console/Pro/Enterprise)\n```\n\n**Git not configured**\n```bash\ngit config --global user.name \"Your Name\"\ngit config --global user.email \"your@email.com\"\n```\n\n**GitHub CLI issues (optional)**\n```bash\nbrew install gh         # macOS recommended\ngh auth login          # Authenticate with GitHub\n```\n\n### Debug Mode\nUse `--verbose` for detailed output and `--verify` for dependency checking:\n```bash\nsuperclaude commit --verbose          # Shows step-by-step AI reasoning\nsuperclaude --verify                  # Force full system verification\nsuperclaude --verify --verbose        # Detailed dependency diagnostics\n```\n\n### Getting Help\n- Run `superclaude help` for command reference\n- Check [Claude Code docs](https://www.anthropic.com/claude-code)\n- Open issues on [GitHub](https://github.com/your-username/superclaude)\n\n## Contributing\n\n1. Fork the repository\n2. Make your changes  \n3. Use SuperClaude to commit: `superclaude commit --interactive`\n4. Submit a pull request\n\n## License\n\nMIT License - see LICENSE file.\n\n---\n\n**Made with ❤️ and AI** - SuperClaude transforms your development workflow by giving Claude deep understanding of your GitHub projects. ","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgwendall%2Fsuperclaude","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgwendall%2Fsuperclaude","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgwendall%2Fsuperclaude/lists"}