Repository: hesreallyhim/awesome-claude-code Branch: main Commit: fd330b1625d2 Files: 260 Total size: 4.2 MB Directory structure: gitextract_qi3ecgdm/ ├── .github/ │ ├── ISSUE_TEMPLATE/ │ │ ├── recommend-resource.yml │ │ └── repository-enhancement.yml │ ├── PULL_REQUEST_TEMPLATE.md │ └── workflows/ │ ├── README.md │ ├── check-repo-health.yml │ ├── ci.yml │ ├── close-resource-pr.yml │ ├── close-resource-prs.yml │ ├── handle-resource-submission-commands.yml │ ├── notify-on-merge.yml │ ├── submission-enforcement-v2.yml │ ├── submission-enforcement.yml │ ├── update-github-release-data.yml │ ├── update-repo-ticker.yml │ ├── validate-links.yml │ └── validate-new-issue.yml ├── .gitignore ├── .pre-commit-config.yaml ├── .python-version ├── LICENSE ├── Makefile ├── README.md ├── README_ALTERNATIVES/ │ ├── README_AWESOME.md │ ├── README_CLASSIC.md │ ├── README_EXTRA.md │ ├── README_FLAT_ALL_AZ.md │ ├── README_FLAT_ALL_CREATED.md │ ├── README_FLAT_ALL_RELEASES.md │ ├── README_FLAT_ALL_UPDATED.md │ ├── README_FLAT_CLAUDE-MD_AZ.md │ ├── README_FLAT_CLAUDE-MD_CREATED.md │ ├── README_FLAT_CLAUDE-MD_RELEASES.md │ ├── README_FLAT_CLAUDE-MD_UPDATED.md │ ├── README_FLAT_CLIENTS_AZ.md │ ├── README_FLAT_CLIENTS_CREATED.md │ ├── README_FLAT_CLIENTS_RELEASES.md │ ├── README_FLAT_CLIENTS_UPDATED.md │ ├── README_FLAT_COMMANDS_AZ.md │ ├── README_FLAT_COMMANDS_CREATED.md │ ├── README_FLAT_COMMANDS_RELEASES.md │ ├── README_FLAT_COMMANDS_UPDATED.md │ ├── README_FLAT_DOCS_AZ.md │ ├── README_FLAT_DOCS_CREATED.md │ ├── README_FLAT_DOCS_RELEASES.md │ ├── README_FLAT_DOCS_UPDATED.md │ ├── README_FLAT_HOOKS_AZ.md │ ├── README_FLAT_HOOKS_CREATED.md │ ├── README_FLAT_HOOKS_RELEASES.md │ ├── README_FLAT_HOOKS_UPDATED.md │ ├── README_FLAT_SKILLS_AZ.md │ ├── README_FLAT_SKILLS_CREATED.md │ ├── README_FLAT_SKILLS_RELEASES.md │ ├── README_FLAT_SKILLS_UPDATED.md │ ├── README_FLAT_STATUSLINE_AZ.md │ ├── README_FLAT_STATUSLINE_CREATED.md │ ├── README_FLAT_STATUSLINE_RELEASES.md │ ├── README_FLAT_STATUSLINE_UPDATED.md │ ├── README_FLAT_STYLES_AZ.md │ ├── README_FLAT_STYLES_CREATED.md │ ├── README_FLAT_STYLES_RELEASES.md │ ├── README_FLAT_STYLES_UPDATED.md │ ├── README_FLAT_TOOLING_AZ.md │ ├── README_FLAT_TOOLING_CREATED.md │ ├── README_FLAT_TOOLING_RELEASES.md │ ├── README_FLAT_TOOLING_UPDATED.md │ ├── README_FLAT_WORKFLOWS_AZ.md │ ├── README_FLAT_WORKFLOWS_CREATED.md │ ├── README_FLAT_WORKFLOWS_RELEASES.md │ └── README_FLAT_WORKFLOWS_UPDATED.md ├── THE_RESOURCES_TABLE.csv ├── acc-config.yaml ├── data/ │ ├── repo-ticker-previous.csv │ └── repo-ticker.csv ├── docs/ │ ├── CODE_OF_CONDUCT.md │ ├── CONTRIBUTING.md │ ├── COOLDOWN.md │ ├── HOW_IT_LOOKS.md │ ├── HOW_IT_WORKS.md │ ├── README-GENERATION.md │ ├── REPO_TICKER.md │ ├── SECURITY.md │ ├── TESTING.md │ └── development/ │ ├── cooldown-enforcement.md │ ├── do-not-forget.md │ ├── path-resolution-migration-plan.md │ ├── path-resolution-strategy.final.md │ ├── summary-rendering-cheatsheet.md │ ├── tech-debt.md │ ├── toc-anchor-generation.md │ └── vintage-manual-animation-style-guide.md ├── pyproject.toml ├── resources/ │ ├── README.md │ ├── claude.md-files/ │ │ ├── AI-IntelliJ-Plugin/ │ │ │ └── CLAUDE.md │ │ ├── AVS-Vibe-Developer-Guide/ │ │ │ └── CLAUDE.md │ │ ├── AWS-MCP-Server/ │ │ │ └── CLAUDE.md │ │ ├── Basic-Memory/ │ │ │ └── CLAUDE.md │ │ ├── Comm/ │ │ │ └── CLAUDE.md │ │ ├── Course-Builder/ │ │ │ └── CLAUDE.md │ │ ├── Cursor-Tools/ │ │ │ └── CLAUDE.md │ │ ├── DroidconKotlin/ │ │ │ └── CLAUDE.md │ │ ├── EDSL/ │ │ │ └── CLAUDE.md │ │ ├── Giselle/ │ │ │ └── CLAUDE.md │ │ ├── Guitar/ │ │ │ └── CLAUDE.md │ │ ├── JSBeeb/ │ │ │ └── CLAUDE.md │ │ ├── Lamoom-Python/ │ │ │ └── CLAUDE.md │ │ ├── LangGraphJS/ │ │ │ └── CLAUDE.md │ │ ├── Network-Chronicles/ │ │ │ └── CLAUDE.md │ │ ├── Note-Companion/ │ │ │ └── CLAUDE.md │ │ ├── Pareto-Mac/ │ │ │ └── CLAUDE.md │ │ ├── Perplexity-MCP/ │ │ │ └── CLAUDE.md │ │ ├── SG-Cars-Trends-Backend/ │ │ │ └── CLAUDE.md │ │ ├── SPy/ │ │ │ └── CLAUDE.md │ │ ├── TPL/ │ │ │ └── CLAUDE.md │ │ └── claude-code-mcp-enhanced/ │ │ └── CLAUDE.md │ ├── official-documentation/ │ │ ├── Anthropic-Quickstarts/ │ │ │ └── CLAUDE.md │ │ └── Claude-Code-GitHub-Actions/ │ │ ├── ci-failure-auto-fix.yml │ │ ├── claude.yml │ │ ├── issue-deduplication.yml │ │ ├── issue-triage.yml │ │ ├── manual-code-analysis.yml │ │ ├── pr-review-comprehensive.yml │ │ ├── pr-review-filtered-authors.yml │ │ └── pr-review-filtered-paths.yml │ ├── slash-commands/ │ │ ├── act/ │ │ │ └── act.md │ │ ├── add-to-changelog/ │ │ │ └── add-to-changelog.md │ │ ├── clean/ │ │ │ └── clean.md │ │ ├── commit/ │ │ │ └── commit.md │ │ ├── context-prime/ │ │ │ └── context-prime.md │ │ ├── create-hook/ │ │ │ └── create-hook.md │ │ ├── create-jtbd/ │ │ │ └── create-jtbd.md │ │ ├── create-pr/ │ │ │ └── create-pr.md │ │ ├── create-prd/ │ │ │ └── create-prd.md │ │ ├── create-prp/ │ │ │ └── create-prp.md │ │ ├── create-pull-request/ │ │ │ └── create-pull-request.md │ │ ├── create-worktrees/ │ │ │ └── create-worktrees.md │ │ ├── fix-github-issue/ │ │ │ └── fix-github-issue.md │ │ ├── husky/ │ │ │ └── husky.md │ │ ├── initref/ │ │ │ └── initref.md │ │ ├── load-llms-txt/ │ │ │ └── load-llms-txt.md │ │ ├── optimize/ │ │ │ └── optimize.md │ │ ├── pr-review/ │ │ │ └── pr-review.md │ │ ├── release/ │ │ │ └── release.md │ │ ├── testing_plan_integration/ │ │ │ └── testing_plan_integration.md │ │ ├── todo/ │ │ │ └── todo.md │ │ ├── update-branch-name/ │ │ │ └── update-branch-name.md │ │ └── update-docs/ │ │ └── update-docs.md │ └── workflows-knowledge-guides/ │ ├── Blogging-Platform-Instructions/ │ │ └── view_commands.md │ └── Design-Review-Workflow/ │ ├── README.md │ ├── design-principles-example.md │ ├── design-review-agent.md │ ├── design-review-claude-md-snippet.md │ └── design-review-slash-command.md ├── scripts/ │ ├── README.md │ ├── __init__.py │ ├── archive/ │ │ ├── README.md │ │ └── __init__.py │ ├── badges/ │ │ ├── BADGE_AUTOMATION_SETUP.md │ │ ├── __init__.py │ │ ├── badge_notification.py │ │ └── badge_notification_core.py │ ├── categories/ │ │ ├── __init__.py │ │ ├── add_category.py │ │ └── category_utils.py │ ├── graphics/ │ │ ├── __init__.py │ │ └── generate_logo_svgs.py │ ├── ids/ │ │ ├── __init__.py │ │ ├── generate_resource_id.py │ │ └── resource_id.py │ ├── maintenance/ │ │ ├── __init__.py │ │ ├── check_repo_health.py │ │ └── update_github_release_data.py │ ├── py.typed │ ├── readme/ │ │ ├── __init__.py │ │ ├── generate_readme.py │ │ ├── generators/ │ │ │ ├── __init__.py │ │ │ ├── awesome.py │ │ │ ├── base.py │ │ │ ├── flat.py │ │ │ ├── minimal.py │ │ │ └── visual.py │ │ ├── helpers/ │ │ │ ├── __init__.py │ │ │ ├── generate_toc_assets.py │ │ │ ├── readme_assets.py │ │ │ ├── readme_config.py │ │ │ ├── readme_paths.py │ │ │ └── readme_utils.py │ │ ├── markup/ │ │ │ ├── __init__.py │ │ │ ├── awesome.py │ │ │ ├── flat.py │ │ │ ├── minimal.py │ │ │ ├── shared.py │ │ │ └── visual.py │ │ └── svg_templates/ │ │ ├── __init__.py │ │ ├── badges.py │ │ ├── dividers.py │ │ ├── headers.py │ │ ├── py.typed │ │ └── toc.py │ ├── resources/ │ │ ├── __init__.py │ │ ├── create_resource_pr.py │ │ ├── detect_informal_submission.py │ │ ├── download_resources.py │ │ ├── parse_issue_form.py │ │ ├── resource_utils.py │ │ └── sort_resources.py │ ├── testing/ │ │ ├── __init__.py │ │ ├── test_regenerate_cycle.py │ │ └── validate_toc_anchors.py │ ├── ticker/ │ │ ├── __init__.py │ │ ├── fetch_repo_ticker_data.py │ │ └── generate_ticker_svg.py │ ├── utils/ │ │ ├── __init__.py │ │ ├── git_utils.py │ │ ├── github_utils.py │ │ └── repo_root.py │ └── validation/ │ ├── __init__.py │ ├── validate_links.py │ └── validate_single_resource.py ├── templates/ │ ├── README_AWESOME.template.md │ ├── README_CLASSIC.template.md │ ├── README_EXTRA.template.md │ ├── announcements.yaml │ ├── categories.yaml │ ├── footer.template.md │ └── resource-overrides.yaml ├── tests/ │ ├── conftest.py │ ├── fixtures/ │ │ ├── expected_toc_anchors.txt │ │ ├── github-html/ │ │ │ ├── awesome-root.html │ │ │ ├── classic-non-root.html │ │ │ ├── extra-non-root.html │ │ │ └── flat-non-root.html │ │ └── informal_issues/ │ │ ├── informal_recommendation_medium_confidence.json │ │ ├── informal_structured_high_confidence.json │ │ ├── proper_template_with_labels_a.json │ │ └── proper_template_with_labels_b.json │ ├── temp-verify-override-autolock.temp.py │ ├── test_asset_path_resolution.py │ ├── test_badge_notification_validation.py │ ├── test_category_utils.py │ ├── test_detect_informal_submission.py │ ├── test_fetch_repo_ticker_data.py │ ├── test_flat_list_generator.py │ ├── test_generate_readme.py │ ├── test_generate_ticker_svg.py │ ├── test_git_utils.py │ ├── test_github_utils.py │ ├── test_readme_alternative_outputs.py │ ├── test_readme_config_path.py │ ├── test_readme_generators_minimal_visual.py │ ├── test_resource_utils.py │ ├── test_sort_resources.py │ ├── test_style_selector_paths.py │ ├── test_toc_anchor_validation.py │ ├── test_validate_links.py │ └── test_validate_single_resource.py └── tools/ ├── __init__.py └── readme_tree/ ├── README.md ├── __init__.py ├── config.yaml └── update_readme_tree.py ================================================ FILE CONTENTS ================================================ ================================================ FILE: .github/ISSUE_TEMPLATE/recommend-resource.yml ================================================ name: 🚀 Recommend New Resource description: Recommend a new resource to be featured in Awesome Claude Code title: "[Resource]: WRITE THE NAME OF YOUR RESOURCE HERE" labels: ["resource-submission", "pending-validation"] body: - type: markdown attributes: value: | ## Welcome! Thank you for recommending a resource to Awesome Claude Code! This form will guide you through the recommendation process. Please make sure that you have already reviewed the [CONTRIBUTING](https://github.com/hesreallyhim/awesome-claude-code/blob/main/docs/CONTRIBUTING.md) document as well as the [CODE_OF_CONDUCT](https://github.com/hesreallyhim/awesome-claude-code/blob/main/docs/CODE_OF_CONDUCT.md), and that you agree to abide by the terms. Be really, really sure. **WARNING: A strict spam-deterrent system has been put in place. Failure to comply with the simple requirements stated in the [CONTRIBUTING](https://github.com/hesreallyhim/awesome-claude-code/blob/main/docs/CONTRIBUTING.md) document will result in intreasingly severe penalties.** **Resource Guidelines:** - Issues must be submitted by human users using the github.com UI. The system does not allow resource submissions via the `gh` CLI or other programmatic means. Doing so violates the Code of Conduct and submissions will be automatically closed. - Ensure that you have actually visited this repo before and reviewed the entries on the list. Recommendations must be unique from existing resources, and should be of an equally high caliber. - Avoid submitting resources that violate the Claude Code Usage Policy,or the licensing rights of other independent developers. - Recommendations will be closely scrutinized for security and potential risk. - Although most recommendations are submitted by the authors, you may submit any resource that you love. - The system does not allow resource submissions via the `gh` CLI. - Resources must be at least one week old. **Tips and Tricks for a Speedy Review:** - Please provide clear installation AND uninstallation instructions for any installable resources. - If your resource requires me to execute a bash script, you **must** provide me with a clearly annotated/commented version in which everything is documented clearly. I _can_ read Bash, but it hurts my eyes after a while. - Short examples or demos are tremendously helpful in the review process. If I can see it in action before I think about running it, you're way ahead of the curve. - If your resource requires elevated access or "--dangerously-skip-permissions", please make sure the user is aware of this(!) - If your resource involves making ANY network requests except to the Anthropic API, you **must** state that here. - Offering an auto-update functionality for a library may be a very nice convenience for people. (Similarly, `npx @latest`). However, this is also a known threat vector and will be viewed with caution. - If you are claiming that a resource improves Claude's capacity to perform some particular action, these claims must be backed by evidence. It's your job to provide the evidence, not mine. - Try to submit _focused_ resources that differentiate your project from others, not general-purpose marketplaces. - Avoid submitting complex systems that require long onboarding or extensive training in a particular methodology. **Ask Claude for a Candid Review:** When I review your recommendation, I will ask my assistant Claude Code to perform a review (this is to assist me - I do not base my judgment on this review alone.) You can find the type of prompt in `.claude/commands/evaluate-repository.md`. I recommend that you run this evaluation yourself ahead of time. Also, ask yourself: "Could Opus build this in one session?" After submission, our automated system will validate whether your Issue is well-formed with respect to the requirements of the template, and post the results as a comment. (This is merely a formality and does not constitute a review.) Once your recommendation has been validated, you've done your job - the project has been recommended. I do my best to review recommendations. That summarizes the extent of my obligation. If I raise any further questions about your project, it's usually because I'm interested in it, and want to understand it better. Don't make any changes solely on the basis of my feedback. - type: input id: display_name attributes: label: Display Name description: The name of the resource as it will appear in the list placeholder: "e.g., My Awesome Tool, /my-command, claude-helper" validations: required: true - type: dropdown id: category attributes: label: Category description: Select the primary category for your resource (note that I'm currenlty lumping most things called "plugins" under "Agent Skills" until I figure out a better classification system). options: - Agent Skills - Workflows & Knowledge Guides - Tooling - Status Lines - Hooks - Output Styles - Slash-Commands - CLAUDE.md Files - Alternative Clients - Official Documentation validations: required: true - type: dropdown id: subcategory attributes: label: Sub-Category description: Select a sub-category if applicable (based on your category choice above) options: - General - "Workflows & Knowledge Guides: Ralph Wiggum" - "Tooling: IDE Integrations" - "Tooling: Usage Monitors" - "Tooling: Orchestrators" - "Tooling: Config Managers" - "Slash-Commands: Version Control & Git" - "Slash-Commands: Code Analysis & Testing" - "Slash-Commands: Context Loading & Priming" - "Slash-Commands: Documentation & Changelogs" - "Slash-Commands: CI / Deployment" - "Slash-Commands: Project & Task Management" - "Slash-Commands: Miscellaneous" - "CLAUDE.md Files: Language-Specific" - "CLAUDE.md Files: Domain-Specific" - "CLAUDE.md Files: Project Scaffolding & MCP" validations: required: false - type: input id: primary_link attributes: label: Primary Link description: The main URL for your resource (must start with https://). If you have a GitHub repo and a website, _use the GitHub repo_. placeholder: "https://github.com/username/repository" validations: required: true - type: input id: author_name attributes: label: Author Name description: "The author's name, alias, or GitHub username. (You may submit public/open-source resources that you do not own.)" placeholder: "Jane Doe or janedoe" validations: required: true - type: input id: author_link attributes: label: Author Link description: "Link to author's GitHub profile or personal website" placeholder: "https://github.com/janedoe" validations: required: true - type: dropdown id: license attributes: label: License description: Select the license for your resource (or choose 'Other' to specify something unlisted). options: - MIT - Apache-2.0 - GPL-3.0 - BSD-3-Clause - ISC - MPL-2.0 - AGPL-3.0 - Unlicense - CC0-1.0 - CC-BY-4.0 - CC-BY-SA-4.0 - "©" - Other (specify below) - No License / Not Specified validations: required: true - type: input id: license_other attributes: label: Other License description: If you selected "Other" above, please specify the license placeholder: "e.g., BSD-2-Clause, Proprietary" validations: required: false - type: textarea id: description attributes: label: Description description: "A brief description of your resource (1-3 sentences maximum, no emojis) - follow the list's style - be descriptive, not promotional - do not address the reader" placeholder: "Describe what your resource does and its key features..." validations: required: true - type: markdown attributes: value: | The following three fields are encouraged for all users. If you are recommending a plugin, skill, collection, framework, etc., then these are **mandatory**. - type: textarea id: validate_claims attributes: label: Validate Claims description: "If you are submitting a complicated resource that gives Claude Code super-powers, suggest a low-friction way for me, or anyone, to prove it to themselves that what you're claiming is true. If you are submitting a plugin, skill, framework, or similar, this field is mandatory." placeholder: "e.g., install this Skill and ask Claude how many times the letter 'r' appears in your codebase" validations: required: false - type: textarea id: validate_claim_part_2 attributes: label: Specific Task(s) description: "Tell me at least one specific task I should give to Claude Code to demonstrate the value of your resource." placeholder: "e.g., install this Skill and give Claude a counting task." validations: required: false - type: textarea id: validate_claims_part_3 attributes: label: Specific Prompt(s) description: "Tell me what to say to Claude Code when I give it the task above. The more I have to figure things out for myself, the more likely it is that I will miss the unique value of your resource. So you are advised to be as specific as possible." placeholder: "Ask Claude how many times the letter 'r' appears in your codebase" validations: required: false - type: textarea id: additional_comments attributes: label: Additional Comments description: "Optional - Any additional information you'd like to share about your resource (not processed during validation)" placeholder: "e.g., context about why you created this, special features, acknowledgments, etc." validations: required: false - type: checkboxes id: checklist attributes: label: Recommendation Checklist description: Please confirm the following options: - label: "I have checked that this resource hasn't already been submitted" required: true - label: It has been over one week since the first public commit to the repo I am recommending required: true - label: All provided links are working and publicly accessible required: true - label: I do NOT have any other open issues in this repository required: true - label: I am primarily composed of human-y stuff and not electrical circuits required: true - type: markdown attributes: value: | ## What happens next? 1. **Automated Validation**: Our bot will validate the well-formed-ness of this Issue and let you know if anything needs to be fixed 2. **Review**: If validation passes, you should go back to working on your library - your recommendation has been received. It will be reviewed at the discretion of the maintainer. 3. **Approval**: If approved, a PR will be automatically created with your resource 4. **Notification**: You'll be notified when your resource is added Thank you for contributing to Awesome Claude Code. I have ================================================ FILE: .github/ISSUE_TEMPLATE/repository-enhancement.yml ================================================ name: 💡 Repository Enhancement description: Suggest an improvement to the repository structure, categories, or processes title: "[Enhancement]: " labels: ["enhancement"] assignees: [] body: - type: markdown attributes: value: | ## Repository Enhancement Suggestion Use this form to suggest improvements to Awesome Claude Code itself (not for submitting resources). - type: dropdown id: enhancement_type attributes: label: Enhancement Type description: What kind of improvement are you suggesting? options: - New category or subcategory - Repository structure - Submission process - Documentation - Automation/workflows - Other validations: required: true - type: textarea id: description attributes: label: Description description: Describe your enhancement suggestion in detail placeholder: "Explain what you'd like to see improved and why..." validations: required: true - type: textarea id: benefit attributes: label: Expected Benefit description: How will this enhancement help the community? placeholder: "This would help users by..." validations: required: true - type: textarea id: implementation attributes: label: Possible Implementation description: If you have ideas on how to implement this, please share placeholder: "One way to implement this could be..." validations: required: false - type: checkboxes id: checklist attributes: label: Checklist options: - label: I've checked that this enhancement hasn't already been suggested required: true - label: This enhancement would improve the repository for the community required: true ================================================ FILE: .github/PULL_REQUEST_TEMPLATE.md ================================================ # Pull Request If you want to submit a resource for recommendation for Awesome Claude Code, please use the [resource recommendation issue form](https://github.com/hesreallyhim/awesome-claude-code/issues/new?template=recommen-resource.yml) and don't open a PR. It's fairly uncommon for anyone to open a PR to this repo, even the maintainer. However, if you've noticed a technical problem/bug or a documentation problem, then this may be appropriate. Otherwise, in general, only the bots get to make PRs. ## Type of Contribution - [ ] **New Resource** - Adding a new resource to the list [ONLY THE BOT MAY DO THIS] - [ ] **Update Resource** - Updating existing resource information (e.g., broken link, license info) - [ ] **Repository Improvement** - Improving the repository itself (not adding resources) [Use [this issue template](https://github.com/hesreallyhim/awesome-claude-code/issues/new?template=repository-enhancement.yml) to suggest general improvements] --- ## For New Resources ### Resource Information - **Display Name**: - **Category**: - **Sub-Category** (if applicable): - **Primary Link**: - **Author Name**: - **Author Link**: - **License** (if known): ### Description ### Automated Notification - [ ] This is a GitHub-hosted resource and will receive an automatic notification issue when merged --- ## For Resource Updates ### What Changed? - **Resource Name**: - **Change Type**: - **Details**: --- ## For Repository Improvements ### Description of Changes ### Checklist for Repository Changes - [ ] Changes follow existing code style - [ ] Updated relevant documentation - [ ] Tested changes locally - [ ] Pre-commit hooks pass --- ## Additional Notes ## Questions? - See [CONTRIBUTING.md](../docs/CONTRIBUTING.md) for detailed contribution guidelines ================================================ FILE: .github/workflows/README.md ================================================ # GitHub Workflows This directory contains GitHub Action workflows for repository maintenance, resource submission handling, and health monitoring. --- ## Workflow: Validate New Issue **File:** `.github/workflows/validate-new-issue.yml` ### Purpose Handles all new issues opened in the repository with two mutually exclusive jobs: 1. **validate-resource**: Validates properly-submitted resource recommendations (issues with `resource-submission` label) 2. **detect-informal**: Detects informal submissions that bypassed the issue template (issues without the label) ### Trigger - `issues.opened` - New issue created - `issues.reopened` - Issue reopened - `issues.edited` - Issue body edited ### Job 1: Validate Resource Submission Runs when an issue has the `resource-submission` label (applied automatically by the issue template). **Behavior:** - Parses the issue body using `scripts/resources/parse_issue_form.py` - Validates all required fields (display name, category, URLs, etc.) - Checks for duplicate resources in `THE_RESOURCES_TABLE.csv` - Validates URL accessibility - Posts validation results as a comment - Updates labels: `validation-passed` or `validation-failed` - Notifies maintainer when changes are made after `/request-changes` ### Job 2: Detect Informal Submission Runs when a **new** issue does NOT have the `resource-submission` label. **Purpose:** Catches users who try to recommend resources without using the official template. **Detection Signals:** | Signal Type | Examples | Weight | |-------------|----------|--------| | Template field labels | `Display Name:`, `Category:`, `Primary Link:` | Very strong (+0.7 for 3+) | | Submission language | "recommend", "submit", "please add" | Strong (+0.3 each) | | Resource mentions | "plugin", "skill", "hook", "slash command" | Medium (+0.15 each) | | GitHub URLs | `github.com/user/repo` | Medium (+0.15) | | License mentions | MIT, Apache, GPL | Medium (+0.15) | | Bug/question language | "bug", "error", "how do I" | Negative (-0.2 each) | **Two-Tier Response:** | Confidence | Action | |------------|--------| | ≥ 0.6 (High) | Add `needs-template` label, post warning, **auto-close** | | 0.4 - 0.6 (Medium) | Add `needs-template` label, post gentle warning, **leave open** | | < 0.4 (Low) | No action | ### Local Usage ```bash # Test informal submission detection ISSUE_TITLE="Check out my plugin" ISSUE_BODY="I made this tool at github.com/user/repo" \ python -m scripts.resources.detect_informal_submission ``` ### Related Scripts - `scripts/resources/parse_issue_form.py` - Parses and validates issue form data - `scripts/resources/detect_informal_submission.py` - Detects informal submissions --- ## Workflow: Handle Resource Submission Commands **File:** `.github/workflows/handle-resource-submission-commands.yml` ### Purpose Processes maintainer commands on resource submission issues. ### Commands | Command | Description | Requirements | |---------|-------------|--------------| | `/approve` | Creates PR to add resource to CSV | Issue must have `validation-passed` label | | `/reject [reason]` | Closes issue as rejected | Maintainer permission | | `/request-changes [message]` | Requests changes from submitter | Maintainer permission | ### Trigger - `issue_comment.created` on issues with `resource-submission` label - Only processes comments from OWNER, MEMBER, or COLLABORATOR --- ## Workflow: Update GitHub Release Data **File:** `.github/workflows/update-github-release-data.yml` ### Purpose Updates `THE_RESOURCES_TABLE.csv` with: - Latest commit date on the default branch (Last Modified) - Latest GitHub Release date (Latest Release) - Latest GitHub Release version (Release Version) ### Schedule - Runs automatically every day at **3:00 AM UTC** - Can be triggered manually via the GitHub Actions UI ### Local Usage ```bash python -m scripts.maintenance.update_github_release_data ``` #### Options ```bash python -m scripts.maintenance.update_github_release_data --help ``` - `--csv-file`: Path to CSV file (default: THE_RESOURCES_TABLE.csv) - `--max`: Process at most N resources - `--dry-run`: Print updates without writing changes ## Workflow: Check Repository Health **File:** `.github/workflows/check-repo-health.yml` ### Purpose Ensures that active GitHub repositories in the resource list are still maintained and responsive by checking: - Number of open issues - Date of last push or PR merge (last updated) ### Behavior The workflow will **fail** if any repository: - Has not been updated in over **6 months** AND - Has more than **2 open issues** Deleted or private repositories are logged as warnings but do not cause the workflow to fail. ### Schedule - Runs automatically every **Monday at 9:00 AM UTC** - Can be triggered manually via the GitHub Actions UI ### Local Usage You can run the health check locally using: ```bash make check-repo-health ``` Or directly with Python: ```bash python3 -m scripts.maintenance.check_repo_health ``` #### Options ```bash python3 -m scripts.maintenance.check_repo_health --help ``` - `--csv-file`: Path to CSV file (default: THE_RESOURCES_TABLE.csv) - `--months`: Months threshold for outdated repos (default: 6) - `--issues`: Open issues threshold (default: 2) ### Example Output ``` INFO: Reading repository list from THE_RESOURCES_TABLE.csv INFO: Checking owner/repo (Resource Name) INFO: ============================================================ INFO: Summary: INFO: Total active GitHub repositories checked: 50 INFO: Deleted/unavailable repositories: 2 INFO: Problematic repositories: 0 INFO: ============================================================ INFO: ✅ HEALTH CHECK PASSED INFO: All active repositories are healthy! ``` ### Environment Variables - `GITHUB_TOKEN`: GitHub personal access token or Actions token (recommended to avoid rate limiting) The GitHub Actions workflow automatically uses the `GITHUB_TOKEN` secret provided by GitHub Actions. ================================================ FILE: .github/workflows/check-repo-health.yml ================================================ name: Check Repository Health # This workflow checks the health of active GitHub repositories listed in THE_RESOURCES_TABLE.csv. # It verifies that repositories are still active and maintained by checking: # - Number of open issues # - Date of last push or PR merge # # The workflow will fail if any repository: # - Has not been updated in over 6 months AND # - Has more than 2 open issues # # Deleted repositories are logged but do not cause the workflow to fail. on: schedule: # Run weekly on Monday at 9:00 AM UTC - cron: '0 9 * * 1' workflow_dispatch: # Allow manual triggering env: GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} PYTHONPATH: ${{ github.workspace }} permissions: contents: read jobs: check-repo-health: runs-on: ubuntu-latest steps: - name: Checkout repository uses: actions/checkout@v4 - name: Set up Python uses: actions/setup-python@v5 with: python-version: '3.11' - name: Install dependencies run: | python3 -m pip install --upgrade pip python3 -m pip install -e ".[dev]" - name: Run repository health check run: | python3 -m scripts.maintenance.check_repo_health ================================================ FILE: .github/workflows/ci.yml ================================================ name: CI on: push: pull_request: workflow_dispatch: inputs: docs_tree_check: description: "Fail CI if README tree is out of date" type: boolean default: true docs_tree_debug: description: "Print diff/context on mismatch" type: boolean default: false jobs: ci: runs-on: ubuntu-latest env: CI: true # Defaults for push/PR DOCS_TREE_CHECK: "1" DOCS_TREE_DEBUG: "0" PYTHONPATH: ${{ github.workspace }} steps: - uses: actions/checkout@v4 - uses: actions/setup-python@v5 with: python-version: "3.11" - run: | python -m pip install --upgrade pip python -m pip install -e ".[dev]" - name: Run CI checks run: make ci env: # Override defaults only for workflow_dispatch DOCS_TREE_CHECK: ${{ github.event_name == 'workflow_dispatch' && (inputs.docs_tree_check && '1' || '0') || '1' }} DOCS_TREE_DEBUG: ${{ github.event_name == 'workflow_dispatch' && (inputs.docs_tree_debug && '1' || '0') || '0' }} ================================================ FILE: .github/workflows/close-resource-pr.yml ================================================ name: Close Resource Submission PRs on: pull_request_target: types: [opened] jobs: detect-and-close: name: Detect Resource Submission PR runs-on: ubuntu-latest # Skip PRs from bots (GitHub Actions bot, Dependabot, etc.) if: github.event.pull_request.user.type != 'Bot' permissions: pull-requests: write steps: - name: Check if PR is a resource submission id: detect uses: actions/github-script@v7 with: script: | const title = context.payload.pull_request.title || ''; const body = context.payload.pull_request.body || ''; const combined = `${title}\n${body}`.toLowerCase(); // ── High-signal title patterns ────────────────────────── const highSignalTitlePatterns = [ // "Add [resource]: My Tool" or "Add [resource]: My Tool to Hooks" /^add\s*\[resource\]\s*:/i, // "[Resource]: My Tool" /^\[resource\]\s*:/i, // "Add to
" (common PR title for list additions) /^add\s+.+\s+to\s+(slash.?commands?|hooks?|claude\.?md|tooling|skills?|agent|mcp|plugins?|workflows?|status.?lines?)/i, ]; let titleHighSignal = false; for (const pattern of highSignalTitlePatterns) { if (pattern.test(title)) { titleHighSignal = true; console.log(`High-signal title match: ${pattern}`); break; } } // ── Body phrase patterns (medium signal) ──────────────── const bodyPhrases = [ /add(ing)?\s+(a\s+)?(new\s+)?resource/i, /submit(ting)?\s+(a\s+)?resource/i, /resource\s+(submission|recommendation)/i, /please\s+add\s+(this|my)/i, /adding\s+.+\s+to\s+the\s+(list|awesome\s+list)/i, /new\s+entry\s+(for|in)\s+/i, /recommend(ing)?\s+(this|a)\s+(tool|resource|project)/i, ]; let bodyMatchCount = 0; for (const pattern of bodyPhrases) { if (pattern.test(combined)) { bodyMatchCount++; console.log(`Body phrase match: ${pattern}`); } } // ── CSV / README file changes (very high signal) ──────── // Check if the PR touches THE_RESOURCES_TABLE.csv or README.md const files = await github.rest.pulls.listFiles({ owner: context.repo.owner, repo: context.repo.repo, pull_number: context.payload.pull_request.number, per_page: 50, }); let touchesResourceFiles = false; for (const file of files.data) { if ( file.filename === 'THE_RESOURCES_TABLE.csv' || file.filename === 'README.md' || file.filename.startsWith('README_ALTERNATIVES/') ) { touchesResourceFiles = true; console.log(`Touches resource file: ${file.filename}`); break; } } // ── Decision logic ────────────────────────────────────── // High-signal title alone is enough // Body phrases + resource file changes is enough // 2+ body phrase matches is enough const isResourceSubmission = titleHighSignal || (bodyMatchCount >= 1 && touchesResourceFiles) || bodyMatchCount >= 2; console.log(`Title high signal: ${titleHighSignal}`); console.log(`Body match count: ${bodyMatchCount}`); console.log(`Touches resource files: ${touchesResourceFiles}`); console.log(`Is resource submission: ${isResourceSubmission}`); core.setOutput('is_resource_submission', isResourceSubmission.toString()); - name: Post comment and close PR if: steps.detect.outputs.is_resource_submission == 'true' uses: actions/github-script@v7 with: script: | const pr_number = context.payload.pull_request.number; const owner = context.repo.owner; const repo = context.repo.repo; const templateUrl = `https://github.com/${owner}/${repo}/issues/new?template=recommend-resource.yml`; const contributingUrl = `https://github.com/${owner}/${repo}/blob/main/docs/CONTRIBUTING.md`; const body = [ '## ⚠️ Resource submissions are not accepted via pull request', '', 'Thank you for your interest in contributing to Awesome Claude Code!', '', 'However, resource recommendations **must** be submitted through our issue template, not as a pull request. The entire resource pipeline — validation, review, and merging — is managed by automation. Even the maintainer does not use PRs to add entries to the list.', '', '**To submit your resource correctly:**', '', `1. 📖 Read the [CONTRIBUTING.md](${contributingUrl}) document`, `2. 📝 [Submit your resource using the official template](${templateUrl})`, '3. ✅ The bot will validate your submission automatically', '4. 👀 A maintainer will review it once validation passes', '', 'If this PR is **not** a resource submission (e.g., it\'s a bug fix or improvement), please comment below and we\'ll reopen it.', '', '---', '*This PR has been automatically closed.*', ].join('\n'); await github.rest.issues.createComment({ owner, repo, issue_number: pr_number, body, }); await github.rest.pulls.update({ owner, repo, pull_number: pr_number, state: 'closed', }); await github.rest.issues.addLabels({ owner, repo, issue_number: pr_number, labels: ['needs-template'], }); ================================================ FILE: .github/workflows/close-resource-prs.yml ================================================ name: Close Resource Submission PRs on: pull_request_target: types: [opened] jobs: detect-and-close: name: Classify and Close Resource PRs runs-on: ubuntu-latest if: github.event.pull_request.user.type != 'Bot' permissions: pull-requests: write steps: - name: Get changed files id: files uses: actions/github-script@v7 with: script: | const files = await github.rest.pulls.listFiles({ owner: context.repo.owner, repo: context.repo.repo, pull_number: context.payload.pull_request.number, per_page: 50, }); return files.data.map(f => f.filename).join('\n'); result-encoding: string - name: Classify PR with Claude id: classify env: ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }} PR_TITLE: ${{ github.event.pull_request.title }} PR_BODY: ${{ github.event.pull_request.body }} PR_FILES: ${{ steps.files.outputs.result }} run: | # Use jq to safely construct JSON (handles all escaping) PAYLOAD=$(jq -n \ --arg title "$PR_TITLE" \ --arg body "${PR_BODY:0:2000}" \ --arg files "$PR_FILES" \ '{ model: "claude-haiku-4-5-20251001", max_tokens: 50, system: "You classify GitHub pull requests for the awesome-claude-code repository (a curated awesome-list of tools, skills, hooks, and resources for the coding agent Claude Code).\n\nA \"resource submission\" is any PR that attempts to add, recommend, or promote a tool, project, library, skill, MCP server, hook, workflow, guide, or ANY resource whatsoever to the list. This includes any PR that edit THE_RESOURCES_TABLE.csv.\n\nA \"not resource submission\" is a PR that fixes bugs, improves CI/workflows, corrects typos, updates documentation about the repo itself (not adding a new external resource), refactors code, or makes other repository maintenance changes.\n\nRespond with ONLY a JSON object, no markdown fences: {\"classification\": \"resource_submission\" | \"not_resource_submission\", \"confidence\": \"high\" | \"low\"}", messages: [ { role: "user", content: ("PR Title: " + $title + "\n\nPR Body:\n" + $body + "\n\nChanged files:\n" + $files) } ] }') RESPONSE=$(curl -sf https://api.anthropic.com/v1/messages \ -H "content-type: application/json" \ -H "x-api-key: $ANTHROPIC_API_KEY" \ -H "anthropic-version: 2023-06-01" \ -d "$PAYLOAD") || { echo "API call failed" echo "classification=error" >> "$GITHUB_OUTPUT" echo "confidence=none" >> "$GITHUB_OUTPUT" exit 0 } # Extract Claude's text response, then parse the JSON within it TEXT=$(echo "$RESPONSE" | jq -r '.content[0].text') echo "Claude response: $TEXT" CLASSIFICATION=$(echo "$TEXT" | jq -r '.classification // "error"') CONFIDENCE=$(echo "$TEXT" | jq -r '.confidence // "low"') echo "Classification: $CLASSIFICATION" echo "Confidence: $CONFIDENCE" echo "classification=$CLASSIFICATION" >> "$GITHUB_OUTPUT" echo "confidence=$CONFIDENCE" >> "$GITHUB_OUTPUT" - name: Post comment and close PR if: steps.classify.outputs.classification == 'resource_submission' uses: actions/github-script@v7 with: script: | const pr_number = context.payload.pull_request.number; const owner = context.repo.owner; const repo = context.repo.repo; const templateUrl = `https://github.com/${owner}/${repo}/issues/new?template=recommend-resource.yml`; const contributingUrl = `https://github.com/${owner}/${repo}/blob/main/docs/CONTRIBUTING.md`; const body = [ '## ⚠️ Resource recommendations are not accepted via pull request', '', 'Thank you for your interest in contributing to Awesome Claude Code!', '', 'However, resource recommendations **must** be submitted through our issue template, not as a pull request. The entire resource pipeline — validation, review, and merging — is managed by automatioEven the maintainer does not use PRs to add entries to the list.', '', '**To submit your resource correctly:**', '', `1. 📖 Read the [CONTRIBUTING.md](${contributingUrl}) document`, `2. 📝 [Submit your resource using the official template](${templateUrl})`, '3. ✅ The bot will validate your submission automatically', '4. 👀 A maintainer will review it once validation passes', '', 'If this PR is **not** a resource submission (e.g., it\'s a bug fix or improvement), please comment below and we\'ll reopen it.', '', '---', '*This PR was automatically closed.*', ].join('\n'); await github.rest.issues.createComment({ owner, repo, issue_number: pr_number, body, }); await github.rest.pulls.update({ owner, repo, pull_number: pr_number, state: 'closed', }); await github.rest.issues.addLabels({ owner, repo, issue_number: pr_number, labels: ['needs-template'], }); - name: Flag low-confidence non-resource PR for review if: steps.classify.outputs.classification == 'not_resource_submission' && steps.classify.outputs.confidence == 'low' uses: actions/github-script@v7 with: script: | await github.rest.issues.addLabels({ owner: context.repo.owner, repo: context.repo.repo, issue_number: context.payload.pull_request.number, labels: ['needs-review'], }); ================================================ FILE: .github/workflows/handle-resource-submission-commands.yml ================================================ name: Handle Resource Submission Commands on: issue_comment: types: [created] jobs: process-commands: # Only run when: # 1. Comment is on an issue (not a PR) # 2. Issue has resource-submission label # 3. Commenter has write permissions (maintainer/owner) # 4. Comment contains one of the commands: /approve, /reject, /request-changes if: | github.event.issue.pull_request == null && contains(github.event.issue.labels.*.name, 'resource-submission') && (github.event.comment.author_association == 'OWNER' || github.event.comment.author_association == 'MEMBER' || github.event.comment.author_association == 'COLLABORATOR') && (contains(github.event.comment.body, '/approve') || contains(github.event.comment.body, '/reject') || contains(github.event.comment.body, '/request-changes')) runs-on: ubuntu-latest permissions: contents: write issues: write pull-requests: write steps: - name: Checkout repository uses: actions/checkout@v4 with: token: ${{ secrets.GITHUB_TOKEN }} fetch-depth: 0 - name: Set up Python uses: actions/setup-python@v5 with: python-version: '3.11' - name: Install dependencies run: | python -m pip install --upgrade pip pip install PyYAML requests PyGithub python-dotenv - name: Configure Git run: | git config user.name "github-actions[bot]" git config user.email "github-actions[bot]@users.noreply.github.com" - name: React to approval comment if: contains(github.event.comment.body, '/approve') && contains(github.event.issue.labels.*.name, 'validation-passed') uses: actions/github-script@v7 with: script: | await github.rest.reactions.createForIssueComment({ owner: context.repo.owner, repo: context.repo.repo, comment_id: context.payload.comment.id, content: 'rocket' }); - name: Parse issue and create PR id: create_pr if: contains(github.event.comment.body, '/approve') && contains(github.event.issue.labels.*.name, 'validation-passed') env: ISSUE_BODY: ${{ github.event.issue.body }} ISSUE_NUMBER: ${{ github.event.issue.number }} ISSUE_TITLE: ${{ github.event.issue.title }} GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} PYTHONPATH: ${{ github.workspace }} run: | # TODO: Consider emitting issue parsing output via GITHUB_OUTPUT to avoid temp files. # First parse the issue to get resource data python -m scripts.resources.parse_issue_form > resource_data.json # Create the PR with the resource python -m scripts.resources.create_resource_pr \ --issue-number $ISSUE_NUMBER \ --resource-data resource_data.json - name: Comment on issue with results if: contains(github.event.comment.body, '/approve') && contains(github.event.issue.labels.*.name, 'validation-passed') uses: actions/github-script@v7 env: CREATE_PR_SUCCESS: ${{ steps.create_pr.outputs.success }} PR_URL: ${{ steps.create_pr.outputs.pr_url }} with: script: | const pr_url = process.env.PR_URL || null; const success = (process.env.CREATE_PR_SUCCESS || '').toLowerCase() === 'true'; const issue_number = context.issue.number; let comment_body = '## ✅ Resource Approved!\n\n'; if (success && pr_url && pr_url !== 'null') { comment_body += `🎉 A pull request has been created with your resource: ${pr_url}\n\n`; comment_body += 'The PR will be merged shortly, and you\'ll be notified when your resource is live.\n\n'; comment_body += 'Thank you for contributing to Awesome Claude Code!'; // Add approved label await github.rest.issues.addLabels({ owner: context.repo.owner, repo: context.repo.repo, issue_number: issue_number, labels: ['approved', 'pr-created'] }); // Close the issue await github.rest.issues.update({ owner: context.repo.owner, repo: context.repo.repo, issue_number: issue_number, state: 'closed', state_reason: 'completed' }); } else { comment_body += '❌ There was an error creating the pull request.\n\n'; comment_body += 'Please check the workflow logs for details.'; // Add error label await github.rest.issues.addLabels({ owner: context.repo.owner, repo: context.repo.repo, issue_number: issue_number, labels: ['error-creating-pr'] }); } await github.rest.issues.createComment({ owner: context.repo.owner, repo: context.repo.repo, issue_number: issue_number, body: comment_body }); - name: Handle rejection if: contains(github.event.comment.body, '/reject') uses: actions/github-script@v7 with: script: | const comment = context.payload.comment.body; const issue_number = context.issue.number; // Extract rejection reason const reasonMatch = comment.match(/\/reject\s+(.*)/); const reason = reasonMatch ? reasonMatch[1] : 'No reason provided'; // Add rejection comment await github.rest.issues.createComment({ owner: context.repo.owner, repo: context.repo.repo, issue_number: issue_number, body: `## ❌ Submission Rejected\n\n**Reason:** ${reason}\n\n` }); // Update labels and close await github.rest.issues.addLabels({ owner: context.repo.owner, repo: context.repo.repo, issue_number: issue_number, labels: ['rejected'] }); await github.rest.issues.update({ owner: context.repo.owner, repo: context.repo.repo, issue_number: issue_number, state: 'closed', state_reason: 'not_planned' }); - name: React to request changes command if: contains(github.event.comment.body, '/request-changes') uses: actions/github-script@v7 with: script: | await github.rest.reactions.createForIssueComment({ owner: context.repo.owner, repo: context.repo.repo, comment_id: context.payload.comment.id, content: 'eyes' }); - name: Handle request changes if: contains(github.event.comment.body, '/request-changes') uses: actions/github-script@v7 with: script: | const comment = context.payload.comment.body; const issue_number = context.issue.number; // Extract requested changes const changesMatch = comment.match(/\/request-changes\s+(.*)/s); const changes = changesMatch ? changesMatch[1] : 'Please review the submission requirements.'; // Add comment with maintainer mention const maintainer = context.payload.comment.user.login; await github.rest.issues.createComment({ owner: context.repo.owner, repo: context.repo.repo, issue_number: issue_number, body: `## 🔄 Changes Requested by @${maintainer}\n\n${changes}\n\nPlease edit your issue to address these points. The validation will run again automatically after you make changes.` }); // Update labels await github.rest.issues.addLabels({ owner: context.repo.owner, repo: context.repo.repo, issue_number: issue_number, labels: ['changes-requested'] }); - name: Cleanup temporary files if: always() run: | rm -f pr_result.json resource_data.json ================================================ FILE: .github/workflows/notify-on-merge.yml ================================================ name: Send Badge Notification on Resource PR Merge on: pull_request: types: [closed] branches: [main] jobs: notify-if-resource-pr: # Only run when: # 1. PR was merged (not just closed) # 2. PR was created by github-actions bot (automated resource PR) # 3. PR does NOT have the 'do-not-disturb' label (allows skipping notifications) if: | github.event.pull_request.merged == true && github.event.pull_request.user.login == 'github-actions[bot]' && !contains(github.event.pull_request.labels.*.name, 'do-not-disturb') runs-on: ubuntu-latest permissions: contents: read issues: write steps: - name: Checkout repository uses: actions/checkout@v4 with: # Checkout the merged commit ref: ${{ github.event.pull_request.merge_commit_sha }} - name: Set up Python uses: actions/setup-python@v5 with: python-version: '3.11' - name: Install dependencies run: | pip install PyGithub python-dotenv - name: Extract resource information from PR id: extract_resource uses: actions/github-script@v7 env: PR_BODY: ${{ github.event.pull_request.body }} PR_TITLE: ${{ github.event.pull_request.title }} with: script: | const pr_body = process.env.PR_BODY || ''; const pr_title = process.env.PR_TITLE || ''; // Look for GitHub URL in PR body // PRs created by approve-resource-submission.yml typically have format: // "Adds new resource: [Resource Name](URL)" const urlMatch = pr_body.match(/\*\*Primary Link\*\*:\s*(https:\/\/github\.com\/[^\s\)]+)/i) || pr_body.match(/Primary Link:\s*(https:\/\/github\.com\/[^\s\)]+)/i) || pr_body.match(/\[.*?\]\((https:\/\/github\.com\/[^\)]+)\)/); // Extract resource name from PR title or body const nameMatch = pr_title.match(/Add[s]?\s+(?:new\s+)?resource:\s*(.+)/i) || pr_body.match(/\*\*Display Name\*\*:\s*(.+)/i) || pr_body.match(/Display Name:\s*(.+)/i); if (urlMatch && urlMatch[1]) { const github_url = urlMatch[1].trim(); const resource_name = nameMatch ? nameMatch[1].trim() : ''; console.log(`Found GitHub repository: ${github_url}`); console.log(`Resource name: ${resource_name || 'Not specified'}`); // Set outputs for next steps core.setOutput('github_url', github_url); core.setOutput('resource_name', resource_name); core.setOutput('is_github_repo', 'true'); } else { console.log('No GitHub repository URL found in PR - skipping notification'); core.setOutput('is_github_repo', 'false'); } - name: Send badge notification if: steps.extract_resource.outputs.is_github_repo == 'true' env: AWESOME_CC_PAT_PUBLIC_REPO: ${{ secrets.AWESOME_CC_PAT_PUBLIC_REPO }} REPOSITORY_URL: ${{ steps.extract_resource.outputs.github_url }} RESOURCE_NAME: ${{ steps.extract_resource.outputs.resource_name }} DESCRIPTION: "" # Will use default description PYTHONPATH: ${{ github.workspace }} run: | echo "Sending notification to: $REPOSITORY_URL" python -m scripts.badges.badge_notification || { echo "⚠️ Failed to send notification, but continuing workflow" echo "This might happen if:" echo "- The repository has issues disabled" echo "- The repository is private" echo "- We've already sent a notification" exit 0 } - name: Log notification result if: always() uses: actions/github-script@v7 with: script: | const is_github_repo = '${{ steps.extract_resource.outputs.is_github_repo }}'; const github_url = '${{ steps.extract_resource.outputs.github_url }}'; const resource_name = '${{ steps.extract_resource.outputs.resource_name }}'; if (is_github_repo === 'true') { console.log('✅ Notification workflow completed for:'); console.log(` Repository: ${github_url}`); console.log(` Resource: ${resource_name || 'Unknown'}`); } else { console.log('ℹ️ No notification sent - resource is not a GitHub repository'); } ================================================ FILE: .github/workflows/submission-enforcement-v2.yml ================================================ name: Submission Enforcement # Unified workflow: cooldown enforcement for issues, Claude-powered PR # classification, and validation dispatch for clean issue submissions. # # Triggers: # issues opened/reopened → cooldown check → if clean → validate # issues edited → skip cooldown → validate directly # PR opened/reopened → classify with Claude → if resource submission → cooldown violation # # Cooldown state stored in a private ops repo as cooldown-state.json. # Requires ACC_OPS secret (fine-grained PAT) with: # - awesome-claude-code-ops: Contents read/write # - awesome-claude-code: Issues + Pull requests read/write # because we use a single token for BOTH repos in the enforcement step. on: issues: types: [opened, reopened, edited] pull_request_target: types: [opened, reopened] workflow_dispatch: concurrency: group: >- cooldown-${{ github.event.pull_request.user.login || github.event.issue.user.login || 'unknown' }} cancel-in-progress: false env: OPS_OWNER: hesreallyhim OPS_REPO: awesome-claude-code-ops OPS_PATH: cooldown-state.json jobs: enforce-cooldown: runs-on: ubuntu-latest if: github.event.action != 'edited' outputs: allowed: ${{ steps.enforce.outputs.allowed }} repo_url: ${{ steps.enforce.outputs.repo_url }} cooldown_level: ${{ steps.enforce.outputs.cooldown_level }} permissions: # These are for GITHUB_TOKEN only; our step uses ACC_OPS PAT explicitly. issues: write pull-requests: write steps: - name: identify-repo id: identify-repo uses: actions/github-script@v7 with: script: | const isPR = context.eventName === 'pull_request_target'; const author = isPR ? context.payload.pull_request.user.login : context.payload.issue.user.login; const body = isPR ? (context.payload.pull_request.body || '') : (context.payload.issue.body || ''); function extractUrls(text) { const pattern = /https?:\/\/github\.com\/([^\/\s]+)\/([^\/\s#?")\]]+)/gi; const results = []; for (const match of text.matchAll(pattern)) { const owner = match[1]; const repo = match[2] .replace(/\.git$/i, '') .replace(/[.,;:!?]+$/, ''); if (!owner || !repo) continue; results.push({ owner, repo, url: `https://github.com/${owner}/${repo}`, }); } return results; } function firstAuthorMatch(urls, authorLogin) { const authorLower = (authorLogin || '').toLowerCase(); const match = urls.find(u => u.owner.toLowerCase() === authorLower); return match ? match.url : ''; } let repoUrl = ''; const urls = extractUrls(body); if (!isPR) { const linkLine = body.match(/^\s*\*\*Link:\*\*\s*(.+)\s*$/im); if (linkLine) { const templateUrls = extractUrls(linkLine[1]); repoUrl = firstAuthorMatch(templateUrls, author); } } if (!repoUrl) { repoUrl = firstAuthorMatch(urls, author); } core.setOutput('repo_url', repoUrl); console.log(repoUrl ? `Repo URL identified: ${repoUrl}` : 'No matching repo URL identified.'); - name: Get PR changed files id: files if: github.event_name == 'pull_request_target' uses: actions/github-script@v7 with: script: | const files = await github.rest.pulls.listFiles({ owner: context.repo.owner, repo: context.repo.repo, pull_number: context.payload.pull_request.number, per_page: 50, }); return files.data.map(f => f.filename).join('\n'); result-encoding: string - name: Classify PR with Claude id: classify if: github.event_name == 'pull_request_target' env: ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }} PR_TITLE: ${{ github.event.pull_request.title }} PR_BODY: ${{ github.event.pull_request.body }} PR_FILES: ${{ steps.files.outputs.result }} run: | PAYLOAD=$(jq -n \ --arg title "$PR_TITLE" \ --arg body "${PR_BODY:0:2000}" \ --arg files "$PR_FILES" \ '{ model: "claude-haiku-4-5-20251001", max_tokens: 50, system: "You classify GitHub pull requests for the awesome-claude-code repository (a curated awesome-list of tools, skills, hooks, and resources for Claude Code by Anthropic).\n\nA \"resource submission\" is any PR that attempts to add, recommend, or promote a tool, project, library, skill, MCP server, hook, workflow, guide, or similar resource to the list. This includes PRs that edit README.md or a resources CSV to insert a new entry.\n\nA \"not resource submission\" is a PR that fixes bugs, improves CI/workflows, corrects typos, updates documentation about the repo itself (not adding a new external resource), refactors code, or makes other repository maintenance changes.\n\nRespond with ONLY a JSON object, no markdown fences: {\"classification\": \"resource_submission\" | \"not_resource_submission\", \"confidence\": \"high\" | \"low\"}", messages: [ { role: "user", content: ("PR Title: " + $title + "\n\nPR Body:\n" + $body + "\n\nChanged files:\n" + $files) }, { role: "assistant", content: "{" } ] }') RESPONSE=$(curl -sf https://api.anthropic.com/v1/messages \ -H "content-type: application/json" \ -H "x-api-key: $ANTHROPIC_API_KEY" \ -H "anthropic-version: 2023-06-01" \ -d "$PAYLOAD") || { echo "API call failed" echo "classification=error" >> "$GITHUB_OUTPUT" echo "confidence=none" >> "$GITHUB_OUTPUT" exit 0 } RAW=$(echo "$RESPONSE" | jq -r '.content[0].text') TEXT="{${RAW}" TEXT=$(echo "$TEXT" | sed 's/^```json//;s/^```//;s/```$//' | tr -d '\n') echo "Claude response: $TEXT" CLASSIFICATION=$(echo "$TEXT" | jq -r '.classification // "error"') CONFIDENCE=$(echo "$TEXT" | jq -r '.confidence // "low"') echo "Classification: $CLASSIFICATION" echo "Confidence: $CONFIDENCE" echo "classification=$CLASSIFICATION" >> "$GITHUB_OUTPUT" echo "confidence=$CONFIDENCE" >> "$GITHUB_OUTPUT" - name: Enforce cooldown rules id: enforce uses: actions/github-script@v7 env: OPS_OWNER: ${{ env.OPS_OWNER }} OPS_REPO: ${{ env.OPS_REPO }} OPS_PATH: ${{ env.OPS_PATH }} ISSUE_BODY: ${{ github.event.issue.body || '' }} REPO_URL: ${{ steps.identify-repo.outputs.repo_url || '' }} PR_CLASSIFICATION: ${{ steps.classify.outputs.classification || '' }} PR_CONFIDENCE: ${{ steps.classify.outputs.confidence || '' }} with: # Single-token approach: this step uses the PAT for BOTH repos. github-token: ${{ secrets.ACC_OPS }} script: | const opsOwner = process.env.OPS_OWNER; const opsRepo = process.env.OPS_REPO; const opsPath = process.env.OPS_PATH; const isPR = context.eventName === 'pull_request_target'; const repo = context.repo; const now = new Date(); const repoUrl = process.env.REPO_URL || ''; const author = isPR ? context.payload.pull_request.user.login : context.payload.issue.user.login; const number = isPR ? context.payload.pull_request.number : context.payload.issue.number; core.setOutput('repo_url', ''); core.setOutput('cooldown_level', ''); // ---- PR: skip bots ---- if (isPR && context.payload.pull_request.user.type === 'Bot') { console.log(`Skipping bot PR by ${author}`); core.setOutput('allowed', 'false'); return; } // ---- PR: classification gate ---- if (isPR) { const classification = process.env.PR_CLASSIFICATION; const confidence = process.env.PR_CONFIDENCE; if (classification === 'error') { console.log('Classification failed — fail open.'); core.setOutput('allowed', 'false'); return; } if (classification !== 'resource_submission') { if (confidence === 'low') { await github.rest.issues.addLabels({ ...repo, issue_number: number, labels: ['needs-review'], }); } console.log( `PR #${number} classified as ${classification} (${confidence}) — no enforcement needed.` ); core.setOutput('allowed', 'false'); return; } console.log(`PR #${number} classified as resource_submission — enforcing.`); } // ---- Issue: excused label bypass ---- if (!isPR) { const labels = context.payload.issue.labels.map(l => l.name); if (labels.includes('excused')) { console.log(`Issue #${number} has excused label — skipping.`); core.setOutput('allowed', 'true'); return; } } // ---- Load cooldown state from ops repo ---- let state = {}; let fileSha = null; try { const { data } = await github.rest.repos.getContent({ owner: opsOwner, repo: opsRepo, path: opsPath }); state = JSON.parse(Buffer.from(data.content, 'base64').toString()); fileSha = data.sha; console.log(`Loaded state (sha: ${fileSha})`); } catch (e) { if (e.status === 404) { console.log('No state file found. Starting fresh.'); } else { console.log(`Error loading state: ${e.message}. Starting fresh.`); } } const userState = state[author] || null; let stateChanged = false; function recordViolation(reason) { const level = userState ? userState.cooldown_level : 0; if (level >= 2) { // 3rd+ violation: permanent ban state[author] = { active_until: '9999-01-01T00:00:00Z', cooldown_level: level + 1, banned: true, last_violation: now.toISOString(), last_reason: reason }; } else { // 1st violation: 7 days; 2nd violation: 14 days const days = level === 0 ? 7 : 14; const activeUntil = new Date(now.getTime() + days * 24 * 60 * 60 * 1000); state[author] = { active_until: activeUntil.toISOString(), cooldown_level: level + 1, last_violation: now.toISOString(), last_reason: reason }; } stateChanged = true; } async function closeWithComment(comment) { await github.rest.issues.createComment({ ...repo, issue_number: number, body: comment }); if (isPR) { await github.rest.pulls.update({ ...repo, pull_number: number, state: 'closed' }); } else { await github.rest.issues.update({ ...repo, issue_number: number, state: 'closed', state_reason: 'not_planned' }); } } function formatRemaining(activeUntilISO) { const remaining = new Date(activeUntilISO) - now; const days = Math.ceil(remaining / (1000 * 60 * 60 * 24)); if (days <= 0) return 'less than a day'; if (days === 1) return '1 day'; return `${days} days`; } async function saveAndExit( allowed, selectedRepoUrl = '', selectedCooldownLevel = '' ) { core.setOutput('allowed', allowed); core.setOutput('repo_url', selectedRepoUrl || ''); core.setOutput('cooldown_level', selectedCooldownLevel || ''); if (!stateChanged) return; const content = Buffer.from(JSON.stringify(state, null, 2)).toString('base64'); const commitMsg = `cooldown: ${author} — ` + (state[author]?.last_reason || 'clean') + ` (#${number})`; try { const params = { owner: opsOwner, repo: opsRepo, path: opsPath, message: commitMsg, content }; if (fileSha) params.sha = fileSha; await github.rest.repos.createOrUpdateFileContents(params); console.log(`State saved: ${commitMsg}`); } catch (e) { if (e.status === 409) { console.log( `Conflict writing state (409). Violation for ${author} will be caught on next submission.` ); } else { console.log(`Error saving state: ${e.message}`); } } } // ========================================================== // PR PATH: resource submission via PR is always a violation // ========================================================== if (isPR) { if (userState && userState.banned === true) { recordViolation('submitted-as-pr'); } else if (userState && new Date(userState.active_until) > now) { recordViolation('submitted-as-pr-during-cooldown'); } else { recordViolation('submitted-as-pr'); } const updated = state[author]; const templateUrl = `https://github.com/${repo.owner}/${repo.repo}` + `/issues/new?template=recommend-resource.yml`; const contributingUrl = `https://github.com/${repo.owner}/${repo.repo}` + `/blob/main/docs/CONTRIBUTING.md`; let cooldownNote = ''; if (updated.banned) { cooldownNote = '\n\n⚠️ Due to repeated violations, this account has been ' + 'permanently restricted from submitting recommendations.'; } else { cooldownNote = `\n\nA cooldown of **${formatRemaining(updated.active_until)}** ` + `has been applied to this account.`; } await closeWithComment( `## ⚠️ Resource submissions are not accepted via pull request\n\n` + `Resource recommendations **must** be submitted through the ` + `issue template, not as a pull request. The entire resource ` + `pipeline — validation, review, and merging — is managed by ` + `automation.\n\n` + `**To submit your resource correctly:**\n` + `1. 📖 Read [CONTRIBUTING.md](${contributingUrl})\n` + `2. 📝 [Submit using the official template](${templateUrl})\n\n` + `If this PR is **not** a resource submission (e.g., a bug fix ` + `or improvement), please comment below and we'll reopen it.` + cooldownNote + `\n\n---\n*This PR was automatically closed.*` ); await github.rest.issues.addLabels({ ...repo, issue_number: number, labels: ['needs-template'], }); console.log( `VIOLATION (PR): ${author} — closed #${number}, level → ${updated.cooldown_level}` ); await saveAndExit('false', repoUrl, String(updated.cooldown_level)); return; } // ========================================================== // ISSUE PATH: cooldown and violation checks // ========================================================== const issueBody = process.env.ISSUE_BODY || ''; const labels = context.payload.issue.labels.map(l => l.name); // CHECK 1: Permanent ban if (userState && userState.banned === true) { await closeWithComment( `This account has been permanently restricted from ` + `submitting recommendations due to repeated violations. ` + `If you believe this is in error, please open a discussion ` + `or contact the maintainer.` ); console.log(`BANNED: ${author} — rejected #${number}`); await saveAndExit('false', repoUrl, String(userState.cooldown_level || '')); return; } // CHECK 2: Active cooldown if (userState) { const activeUntil = new Date(userState.active_until); if (activeUntil > now) { const prevLevel = userState.cooldown_level; recordViolation('submitted-during-cooldown'); const updated = state[author]; const waitTime = updated.banned ? 'This restriction is now permanent.' : `Please wait at least **${formatRemaining(updated.active_until)}** before opening any more submissions.`; await closeWithComment( `A cooldown period is currently in effect for your account. ` + `Submitting during an active cooldown extends the restriction.\n\n` + `${waitTime}\n\n` + `Please review the [CONTRIBUTING guidelines](https://github.com/hesreallyhim/awesome-claude-code/blob/main/docs/CONTRIBUTING.md) ` + `and [pinned issues](https://github.com/${repo.owner}/${repo.repo}/issues) ` + `before your next submission.` ); console.log( `COOLDOWN: ${author} — rejected #${number}, level ${prevLevel} → ${updated.cooldown_level}` ); await saveAndExit('false', repoUrl, String(updated.cooldown_level)); return; } console.log(`${author}: cooldown expired. Checking for violations.`); } // CHECK 3: Missing "resource-submission" label (not via form) if (!labels.includes('resource-submission')) { recordViolation('missing-resource-submission-label'); const updated = state[author]; await closeWithComment( `This submission was not made through the required web form. ` + `As noted in [CONTRIBUTING.md](https://github.com/hesreallyhim/awesome-claude-code/blob/main/docs/CONTRIBUTING.md), ` + `recommendations must be submitted using the ` + `[web form](https://github.com/${repo.owner}/${repo.repo}/issues/new?template=recommend-resource.yml).\n\n` + `A cooldown of **${formatRemaining(updated.active_until)}** has been applied. ` + `Please use the web form for your next submission.` ); console.log( `VIOLATION (no label): ${author} — rejected #${number}, level → ${updated.cooldown_level}` ); await saveAndExit('false', repoUrl, String(updated.cooldown_level)); return; } // CHECK 4: Repo less than 1 week old const repoUrlPattern = /https?:\/\/github\.com\/([^\/\s]+)\/([^\/\s#?"]+)/g; const repoMatches = [...issueBody.matchAll(repoUrlPattern)]; if (repoMatches.length > 0) { const [, repoOwner, rawRepoName] = repoMatches[0]; const repoName = rawRepoName.replace(/\.git$/, ''); try { const repoData = await github.rest.repos.get({ owner: repoOwner, repo: repoName }); const created = new Date(repoData.data.created_at); const ageDays = (now - created) / (1000 * 60 * 60 * 24); if (ageDays < 7) { recordViolation('repo-too-young'); const updated = state[author]; const readyDate = new Date(created); readyDate.setDate(readyDate.getDate() + 7); const readyStr = readyDate.toLocaleDateString('en-US', { month: 'long', day: 'numeric', year: 'numeric' }); await closeWithComment( `Thanks for the recommendation! This repository is less than a week old. ` + `We ask that projects have some time in the wild before being recommended — ` + `you're welcome to re-submit after **${readyStr}**.\n\n` + `A cooldown of **${formatRemaining(updated.active_until)}** has been applied.` ); console.log( `VIOLATION (repo age): ${author} — rejected #${number}, ` + `${repoOwner}/${repoName} is ${ageDays.toFixed(1)}d old, level → ${updated.cooldown_level}` ); await saveAndExit('false', repoUrl, String(updated.cooldown_level)); return; } } catch (e) { console.log(`Skipping repo age check for ${repoOwner}/${repoName}: ${e.message}`); } } else { console.log('No GitHub URL in issue body. Skipping repo age check.'); } console.log(`CLEAN: ${author} — issue #${number} allowed through.`); await saveAndExit('true'); dispatch-intake: needs: enforce-cooldown if: | needs.enforce-cooldown.result == 'success' && needs.enforce-cooldown.outputs.repo_url != '' && needs.enforce-cooldown.outputs.cooldown_level == '1' runs-on: ubuntu-latest steps: - name: Dispatch intake env: DISPATCH_URL: ${{ secrets.SC_DISPATCH_URL }} DISPATCH_TOKEN: ${{ secrets.SC_DISPATCH_TOKEN }} REPO_URL: ${{ needs.enforce-cooldown.outputs.repo_url }} SOURCE_URL: ${{ format('https://github.com/{0}/actions/runs/{1}', github.repository, github.run_id) }} run: | set -euo pipefail payload="$(jq -nc \ --arg event_type "event_registered" \ --arg repo_url "${REPO_URL}" \ --arg source_url "${SOURCE_URL}" \ '{event_type:$event_type, client_payload:{repo_url:$repo_url, source_url:$source_url}}')" curl -fsS -X POST "${DISPATCH_URL}" \ -H "Authorization: Bearer ${DISPATCH_TOKEN}" \ -H "Accept: application/vnd.github+json" \ -H "X-GitHub-Api-Version: 2022-11-28" \ -d "${payload}" >/dev/null validate: needs: enforce-cooldown if: | always() && github.event_name == 'issues' && ( github.event.action == 'edited' || needs.enforce-cooldown.outputs.allowed == 'true' ) uses: ./.github/workflows/validate-new-issue.yml ================================================ FILE: .github/workflows/submission-enforcement.yml ================================================ name: Submission Enforcement # Unified workflow: cooldown enforcement for issues, Claude-powered PR # classification, and validation dispatch for clean issue submissions. # # Triggers: # issues opened/reopened → cooldown check → if clean → validate # issues edited → skip cooldown → validate directly # PR opened/reopened → classify with Claude → if resource submission → cooldown violation # # Cooldown state stored in a private ops repo as cooldown-state.json. # Requires ACC_OPS secret (fine-grained PAT) with: # - awesome-claude-code-ops: Contents read/write # - awesome-claude-code: Issues + Pull requests read/write # because we use a single token for BOTH repos in the enforcement step. on: issues: types: [opened, reopened, edited] pull_request_target: types: [opened, reopened] concurrency: group: >- cooldown-${{ github.event.pull_request.user.login || github.event.issue.user.login || 'unknown' }} cancel-in-progress: false env: OPS_OWNER: hesreallyhim OPS_REPO: awesome-claude-code-ops OPS_PATH: cooldown-state.json jobs: enforce-cooldown: runs-on: ubuntu-latest if: github.event.action != 'edited' outputs: allowed: ${{ steps.enforce.outputs.allowed }} repo_url: ${{ steps.enforce.outputs.repo_url }} cooldown_level: ${{ steps.enforce.outputs.cooldown_level }} permissions: # These are for GITHUB_TOKEN only; our step uses ACC_OPS PAT explicitly. issues: write pull-requests: write steps: - name: identify-repo id: identify-repo uses: actions/github-script@v7 with: script: | const isPR = context.eventName === 'pull_request_target'; const author = isPR ? context.payload.pull_request.user.login : context.payload.issue.user.login; const body = isPR ? (context.payload.pull_request.body || '') : (context.payload.issue.body || ''); function extractUrls(text) { const pattern = /https?:\/\/github\.com\/([^\/\s]+)\/([^\/\s#?")\]]+)/gi; const results = []; for (const match of text.matchAll(pattern)) { const owner = match[1]; const repo = match[2] .replace(/\.git$/i, '') .replace(/[.,;:!?]+$/, ''); if (!owner || !repo) continue; results.push({ owner, repo, url: `https://github.com/${owner}/${repo}`, }); } return results; } function firstAuthorMatch(urls, authorLogin) { const authorLower = (authorLogin || '').toLowerCase(); const match = urls.find(u => u.owner.toLowerCase() === authorLower); return match ? match.url : ''; } let repoUrl = ''; const urls = extractUrls(body); if (!isPR) { const linkLine = body.match(/^\s*\*\*Link:\*\*\s*(.+)\s*$/im); if (linkLine) { const templateUrls = extractUrls(linkLine[1]); repoUrl = firstAuthorMatch(templateUrls, author); } } if (!repoUrl) { repoUrl = firstAuthorMatch(urls, author); } core.setOutput('repo_url', repoUrl); console.log(repoUrl ? `Repo URL identified: ${repoUrl}` : 'No matching repo URL identified.'); - name: Get PR changed files id: files if: github.event_name == 'pull_request_target' uses: actions/github-script@v7 with: script: | const files = await github.rest.pulls.listFiles({ owner: context.repo.owner, repo: context.repo.repo, pull_number: context.payload.pull_request.number, per_page: 50, }); return files.data.map(f => f.filename).join('\n'); result-encoding: string - name: Classify PR with Claude id: classify if: github.event_name == 'pull_request_target' env: ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }} PR_TITLE: ${{ github.event.pull_request.title }} PR_BODY: ${{ github.event.pull_request.body }} PR_FILES: ${{ steps.files.outputs.result }} run: | PAYLOAD=$(jq -n \ --arg title "$PR_TITLE" \ --arg body "${PR_BODY:0:2000}" \ --arg files "$PR_FILES" \ '{ model: "claude-haiku-4-5-20251001", max_tokens: 50, system: "You classify GitHub pull requests for the awesome-claude-code repository (a curated awesome-list of tools, skills, hooks, and resources for Claude Code by Anthropic).\n\nA \"resource submission\" is any PR that attempts to add, recommend, or promote a tool, project, library, skill, MCP server, hook, workflow, guide, or similar resource to the list. This includes PRs that edit README.md or a resources CSV to insert a new entry.\n\nA \"not resource submission\" is a PR that fixes bugs, improves CI/workflows, corrects typos, updates documentation about the repo itself (not adding a new external resource), refactors code, or makes other repository maintenance changes.\n\nRespond with ONLY a JSON object, no markdown fences: {\"classification\": \"resource_submission\" | \"not_resource_submission\", \"confidence\": \"high\" | \"low\"}", messages: [ { role: "user", content: ("PR Title: " + $title + "\n\nPR Body:\n" + $body + "\n\nChanged files:\n" + $files) }, { role: "assistant", content: "{" } ] }') RESPONSE=$(curl -sf https://api.anthropic.com/v1/messages \ -H "content-type: application/json" \ -H "x-api-key: $ANTHROPIC_API_KEY" \ -H "anthropic-version: 2023-06-01" \ -d "$PAYLOAD") || { echo "API call failed" echo "classification=error" >> "$GITHUB_OUTPUT" echo "confidence=none" >> "$GITHUB_OUTPUT" exit 0 } RAW=$(echo "$RESPONSE" | jq -r '.content[0].text') TEXT="{${RAW}" TEXT=$(echo "$TEXT" | sed 's/^```json//;s/^```//;s/```$//' | tr -d '\n') echo "Claude response: $TEXT" CLASSIFICATION=$(echo "$TEXT" | jq -r '.classification // "error"') CONFIDENCE=$(echo "$TEXT" | jq -r '.confidence // "low"') echo "Classification: $CLASSIFICATION" echo "Confidence: $CONFIDENCE" echo "classification=$CLASSIFICATION" >> "$GITHUB_OUTPUT" echo "confidence=$CONFIDENCE" >> "$GITHUB_OUTPUT" - name: Enforce cooldown rules id: enforce uses: actions/github-script@v7 env: OPS_OWNER: ${{ env.OPS_OWNER }} OPS_REPO: ${{ env.OPS_REPO }} OPS_PATH: ${{ env.OPS_PATH }} ISSUE_BODY: ${{ github.event.issue.body || '' }} REPO_URL: ${{ steps.identify-repo.outputs.repo_url || '' }} PR_CLASSIFICATION: ${{ steps.classify.outputs.classification || '' }} PR_CONFIDENCE: ${{ steps.classify.outputs.confidence || '' }} with: # Single-token approach: this step uses the PAT for BOTH repos. github-token: ${{ secrets.ACC_OPS }} script: | const opsOwner = process.env.OPS_OWNER; const opsRepo = process.env.OPS_REPO; const opsPath = process.env.OPS_PATH; const isPR = context.eventName === 'pull_request_target'; const repo = context.repo; const now = new Date(); const repoUrl = process.env.REPO_URL || ''; const author = isPR ? context.payload.pull_request.user.login : context.payload.issue.user.login; const number = isPR ? context.payload.pull_request.number : context.payload.issue.number; core.setOutput('repo_url', ''); core.setOutput('cooldown_level', ''); // ---- PR: skip bots ---- if (isPR && context.payload.pull_request.user.type === 'Bot') { console.log(`Skipping bot PR by ${author}`); core.setOutput('allowed', 'false'); return; } // ---- PR: classification gate ---- if (isPR) { const classification = process.env.PR_CLASSIFICATION; const confidence = process.env.PR_CONFIDENCE; if (classification === 'error') { console.log('Classification failed — fail open.'); core.setOutput('allowed', 'false'); return; } if (classification !== 'resource_submission') { if (confidence === 'low') { await github.rest.issues.addLabels({ ...repo, issue_number: number, labels: ['needs-review'], }); } console.log( `PR #${number} classified as ${classification} (${confidence}) — no enforcement needed.` ); core.setOutput('allowed', 'false'); return; } console.log(`PR #${number} classified as resource_submission — enforcing.`); } // ---- Issue: excused label bypass ---- if (!isPR) { const labels = context.payload.issue.labels.map(l => l.name); if (labels.includes('excused')) { console.log(`Issue #${number} has excused label — skipping.`); core.setOutput('allowed', 'true'); return; } } // ---- Load cooldown state from ops repo ---- let state = {}; let fileSha = null; try { const { data } = await github.rest.repos.getContent({ owner: opsOwner, repo: opsRepo, path: opsPath }); state = JSON.parse(Buffer.from(data.content, 'base64').toString()); fileSha = data.sha; console.log(`Loaded state (sha: ${fileSha})`); } catch (e) { if (e.status === 404) { console.log('No state file found. Starting fresh.'); } else { console.log(`Error loading state: ${e.message}. Starting fresh.`); } } const userState = state[author] || null; let stateChanged = false; function recordViolation(reason) { const level = userState ? userState.cooldown_level : 0; if (level >= 6) { state[author] = { active_until: '9999-01-01T00:00:00Z', cooldown_level: 6, banned: true, last_violation: now.toISOString(), last_reason: reason }; } else { const hours = 24 * Math.pow(2, level); const activeUntil = new Date(now.getTime() + hours * 60 * 60 * 1000); state[author] = { active_until: activeUntil.toISOString(), cooldown_level: level + 1, last_violation: now.toISOString(), last_reason: reason }; } stateChanged = true; } async function closeWithComment(comment) { await github.rest.issues.createComment({ ...repo, issue_number: number, body: comment }); if (isPR) { await github.rest.pulls.update({ ...repo, pull_number: number, state: 'closed' }); } else { await github.rest.issues.update({ ...repo, issue_number: number, state: 'closed', state_reason: 'not_planned' }); } } function formatRemaining(activeUntilISO) { const remaining = new Date(activeUntilISO) - now; const days = Math.ceil(remaining / (1000 * 60 * 60 * 24)); if (days <= 0) return 'less than a day'; if (days === 1) return '1 day'; return `${days} days`; } async function saveAndExit( allowed, selectedRepoUrl = '', selectedCooldownLevel = '' ) { core.setOutput('allowed', allowed); core.setOutput('repo_url', selectedRepoUrl || ''); core.setOutput('cooldown_level', selectedCooldownLevel || ''); if (!stateChanged) return; const content = Buffer.from(JSON.stringify(state, null, 2)).toString('base64'); const commitMsg = `cooldown: ${author} — ` + (state[author]?.last_reason || 'clean') + ` (#${number})`; try { const params = { owner: opsOwner, repo: opsRepo, path: opsPath, message: commitMsg, content }; if (fileSha) params.sha = fileSha; await github.rest.repos.createOrUpdateFileContents(params); console.log(`State saved: ${commitMsg}`); } catch (e) { if (e.status === 409) { console.log( `Conflict writing state (409). Violation for ${author} will be caught on next submission.` ); } else { console.log(`Error saving state: ${e.message}`); } } } // ========================================================== // PR PATH: resource submission via PR is always a violation // ========================================================== if (isPR) { if (userState && userState.banned === true) { recordViolation('submitted-as-pr'); } else if (userState && new Date(userState.active_until) > now) { recordViolation('submitted-as-pr-during-cooldown'); } else { recordViolation('submitted-as-pr'); } const updated = state[author]; const templateUrl = `https://github.com/${repo.owner}/${repo.repo}` + `/issues/new?template=recommend-resource.yml`; const contributingUrl = `https://github.com/${repo.owner}/${repo.repo}` + `/blob/main/docs/CONTRIBUTING.md`; let cooldownNote = ''; if (updated.banned) { cooldownNote = '\n\n⚠️ Due to repeated violations, this account has been ' + 'permanently restricted from submitting recommendations.'; } else { cooldownNote = `\n\nA cooldown of **${formatRemaining(updated.active_until)}** ` + `has been applied to this account.`; } await closeWithComment( `## ⚠️ Resource submissions are not accepted via pull request\n\n` + `Resource recommendations **must** be submitted through the ` + `issue template, not as a pull request. The entire resource ` + `pipeline — validation, review, and merging — is managed by ` + `automation.\n\n` + `**To submit your resource correctly:**\n` + `1. 📖 Read [CONTRIBUTING.md](${contributingUrl})\n` + `2. 📝 [Submit using the official template](${templateUrl})\n\n` + `If this PR is **not** a resource submission (e.g., a bug fix ` + `or improvement), please comment below and we'll reopen it.` + cooldownNote + `\n\n---\n*This PR was automatically closed.*` ); await github.rest.issues.addLabels({ ...repo, issue_number: number, labels: ['needs-template'], }); console.log( `VIOLATION (PR): ${author} — closed #${number}, level → ${updated.cooldown_level}` ); await saveAndExit('false', repoUrl, String(updated.cooldown_level)); return; } // ========================================================== // ISSUE PATH: cooldown and violation checks // ========================================================== const issueBody = process.env.ISSUE_BODY || ''; const labels = context.payload.issue.labels.map(l => l.name); // CHECK 1: Permanent ban if (userState && userState.banned === true) { await closeWithComment( `This account has been permanently restricted from ` + `submitting recommendations due to repeated violations. ` + `If you believe this is in error, please open a discussion ` + `or contact the maintainer.` ); console.log(`BANNED: ${author} — rejected #${number}`); await saveAndExit('false', repoUrl, String(userState.cooldown_level || '')); return; } // CHECK 2: Active cooldown if (userState) { const activeUntil = new Date(userState.active_until); if (activeUntil > now) { const prevLevel = userState.cooldown_level; recordViolation('submitted-during-cooldown'); const updated = state[author]; const waitTime = updated.banned ? 'This restriction is now permanent.' : `Please wait at least **${formatRemaining(updated.active_until)}** before opening any more submissions.`; await closeWithComment( `A cooldown period is currently in effect for your account. ` + `Submitting during an active cooldown extends the restriction.\n\n` + `${waitTime}\n\n` + `Please review the [CONTRIBUTING guidelines](https://github.com/hesreallyhim/awesome-claude-code/blob/main/docs/CONTRIBUTING.md) ` + `and [pinned issues](https://github.com/${repo.owner}/${repo.repo}/issues) ` + `before your next submission.` ); console.log( `COOLDOWN: ${author} — rejected #${number}, level ${prevLevel} → ${updated.cooldown_level}` ); await saveAndExit('false', repoUrl, String(updated.cooldown_level)); return; } console.log(`${author}: cooldown expired. Checking for violations.`); } // CHECK 3: Missing "resource-submission" label (not via form) if (!labels.includes('resource-submission')) { recordViolation('missing-resource-submission-label'); const updated = state[author]; await closeWithComment( `This submission was not made through the required web form. ` + `As noted in [CONTRIBUTING.md](https://github.com/hesreallyhim/awesome-claude-code/blob/main/docs/CONTRIBUTING.md), ` + `recommendations must be submitted using the ` + `[web form](https://github.com/${repo.owner}/${repo.repo}/issues/new?template=recommend-resource.yml).\n\n` + `A cooldown of **${formatRemaining(updated.active_until)}** has been applied. ` + `Please use the web form for your next submission.` ); console.log( `VIOLATION (no label): ${author} — rejected #${number}, level → ${updated.cooldown_level}` ); await saveAndExit('false', repoUrl, String(updated.cooldown_level)); return; } // CHECK 4: Repo less than 1 week old const repoUrlPattern = /https?:\/\/github\.com\/([^\/\s]+)\/([^\/\s#?"]+)/g; const repoMatches = [...issueBody.matchAll(repoUrlPattern)]; if (repoMatches.length > 0) { const [, repoOwner, rawRepoName] = repoMatches[0]; const repoName = rawRepoName.replace(/\.git$/, ''); try { const repoData = await github.rest.repos.get({ owner: repoOwner, repo: repoName }); const created = new Date(repoData.data.created_at); const ageDays = (now - created) / (1000 * 60 * 60 * 24); if (ageDays < 7) { recordViolation('repo-too-young'); const updated = state[author]; const readyDate = new Date(created); readyDate.setDate(readyDate.getDate() + 7); const readyStr = readyDate.toLocaleDateString('en-US', { month: 'long', day: 'numeric', year: 'numeric' }); await closeWithComment( `Thanks for the recommendation! This repository is less than a week old. ` + `We ask that projects have some time in the wild before being recommended — ` + `you're welcome to re-submit after **${readyStr}**.\n\n` + `A cooldown of **${formatRemaining(updated.active_until)}** has been applied.` ); console.log( `VIOLATION (repo age): ${author} — rejected #${number}, ` + `${repoOwner}/${repoName} is ${ageDays.toFixed(1)}d old, level → ${updated.cooldown_level}` ); await saveAndExit('false', repoUrl, String(updated.cooldown_level)); return; } } catch (e) { console.log(`Skipping repo age check for ${repoOwner}/${repoName}: ${e.message}`); } } else { console.log('No GitHub URL in issue body. Skipping repo age check.'); } console.log(`CLEAN: ${author} — issue #${number} allowed through.`); await saveAndExit('true'); dispatch-intake: needs: enforce-cooldown if: | needs.enforce-cooldown.result == 'success' && needs.enforce-cooldown.outputs.repo_url != '' && needs.enforce-cooldown.outputs.cooldown_level == '1' runs-on: ubuntu-latest steps: - name: Dispatch intake env: DISPATCH_URL: ${{ secrets.SC_DISPATCH_URL }} DISPATCH_TOKEN: ${{ secrets.SC_DISPATCH_TOKEN }} REPO_URL: ${{ needs.enforce-cooldown.outputs.repo_url }} SOURCE_URL: ${{ format('https://github.com/{0}/actions/runs/{1}', github.repository, github.run_id) }} run: | set -euo pipefail payload="$(jq -nc \ --arg event_type "event_registered" \ --arg repo_url "${REPO_URL}" \ --arg source_url "${SOURCE_URL}" \ '{event_type:$event_type, client_payload:{repo_url:$repo_url, source_url:$source_url}}')" curl -fsS -X POST "${DISPATCH_URL}" \ -H "Authorization: Bearer ${DISPATCH_TOKEN}" \ -H "Accept: application/vnd.github+json" \ -H "X-GitHub-Api-Version: 2022-11-28" \ -d "${payload}" >/dev/null validate: needs: enforce-cooldown if: | always() && github.event_name == 'issues' && ( github.event.action == 'edited' || needs.enforce-cooldown.outputs.allowed == 'true' ) uses: ./.github/workflows/validate-new-issue.yml ================================================ FILE: .github/workflows/update-github-release-data.yml ================================================ name: Update GitHub Release Data on: schedule: # Run daily at 3:00 AM UTC - cron: '0 3 * * *' workflow_dispatch: env: GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} PYTHONPATH: ${{ github.workspace }} permissions: contents: write jobs: update-github-release-data: runs-on: ubuntu-latest steps: - name: Checkout repository uses: actions/checkout@v4 - name: Set up Python uses: actions/setup-python@v5 with: python-version: '3.11' - name: Install dependencies run: | python -m pip install --upgrade pip python -m pip install -e ".[dev]" - name: Update GitHub release data run: | python -m scripts.maintenance.update_github_release_data - name: Commit and push if changed run: | git config --local user.email "github-actions[bot]@users.noreply.github.com" git config --local user.name "github-actions[bot]" git add THE_RESOURCES_TABLE.csv git diff --quiet && git diff --staged --quiet || (git commit -m "chore: update GitHub release data [skip ci]" && git push) ================================================ FILE: .github/workflows/update-repo-ticker.yml ================================================ name: Update Repo Ticker Data on: schedule: # Run every 6 hours - cron: '0 */6 * * *' workflow_dispatch: # Allow manual trigger for testing permissions: contents: write env: PYTHONPATH: ${{ github.workspace }} jobs: update-ticker: runs-on: ubuntu-latest steps: - name: Checkout repository uses: actions/checkout@v4 - name: Set up Python uses: actions/setup-python@v5 with: python-version: '3.11' - name: Install dependencies run: | python -m pip install --upgrade pip pip install requests - name: Backup previous day's data run: | if [ -f data/repo-ticker.csv ]; then cp data/repo-ticker.csv data/repo-ticker-previous.csv echo "✓ Backed up previous data" else echo "⚠ No previous data to backup (first run)" fi - name: Fetch GitHub repo data env: GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} run: | python -m scripts.ticker.fetch_repo_ticker_data - name: Generate ticker SVGs env: GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} run: | python -m scripts.ticker.generate_ticker_svg - name: Commit and push if changed run: | git config --local user.email "github-actions[bot]@users.noreply.github.com" git config --local user.name "github-actions[bot]" git add data/repo-ticker.csv data/repo-ticker-previous.csv assets/repo-ticker.svg assets/repo-ticker-light.svg assets/repo-ticker-awesome.svg git diff --quiet && git diff --staged --quiet || (git commit -m "chore: update repo ticker data and SVGs [skip ci]" && git push) ================================================ FILE: .github/workflows/validate-links.yml ================================================ name: Validate Links on: schedule: # Run daily at 2:00 AM UTC - cron: '0 2 * * *' workflow_dispatch: # Allow manual triggering env: GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} permissions: contents: read issues: write jobs: validate-links: runs-on: ubuntu-latest steps: - name: Checkout repository uses: actions/checkout@v4 - name: Track Github API Usage uses: hesreallyhim/github-api-usage-monitor@v1 with: diagnostics: true - name: Set up Python uses: actions/setup-python@v5 with: python-version: '3.11' - name: Install dependencies run: make install - name: Run link validation id: validate env: PYTHONPATH: ${{ github.workspace }} run: | make validate-github has_broken_links=$(python -c "import json; data=json.load(open('validation_results.json')); print('true' if data['newly_broken'] else 'false')") echo "has_broken_links=${has_broken_links}" >> "$GITHUB_OUTPUT" - name: Upload validation results if: always() uses: actions/upload-artifact@v4 with: name: validation-results path: | validation_results.json THE_RESOURCES_TABLE.csv - name: Check for existing issue if: steps.validate.outputs.has_broken_links == 'true' id: check_issue uses: actions/github-script@v7 with: script: | const issues = await github.rest.issues.listForRepo({ owner: context.repo.owner, repo: context.repo.repo, state: 'open', labels: 'broken-links' }); const today = new Date().toISOString().split('T')[0]; const existingIssue = issues.data.find(issue => issue.title.includes('Broken Links Report') && issue.title.includes(today) ); core.setOutput('issue_number', existingIssue ? existingIssue.number : ''); - name: Create or update issue if: steps.validate.outputs.has_broken_links == 'true' uses: actions/github-script@v7 with: script: | const fs = require('fs'); const results = JSON.parse(fs.readFileSync('validation_results.json', 'utf8')); const today = new Date().toISOString().split('T')[0]; let issueBody = `## 🔗 Broken Links Report\n\n`; issueBody += `This automated scan found **${results.newly_broken_links.length}** new broken link(s) in the repository.\n\n`; issueBody += `### Broken Links:\n\n`; for (const link of results.newly_broken_links) { issueBody += `- **${link.name}**\n`; issueBody += ` - URL: ${link.url}\n`; } issueBody += `### Summary\n\n`; issueBody += `- Broken links: ${results.newly_broken_links.length}\n`; issueBody += `- Scan completed: ${results.timestamp}\n\n`; issueBody += `---\n`; issueBody += `*This issue was automatically created by the [link validation workflow](${context.serverUrl}/${context.repo.owner}/${context.repo.repo}/actions/workflows/validate-links.yml).*`; const existingIssueNumber = Number("${{ steps.check_issue.outputs.issue_number }}") || 0; if (existingIssueNumber) { await github.rest.issues.update({ owner: context.repo.owner, repo: context.repo.repo, issue_number: existingIssueNumber, body: issueBody }); console.log(`Updated existing issue #${existingIssueNumber}`); } else { const issue = await github.rest.issues.create({ owner: context.repo.owner, repo: context.repo.repo, title: `🚨 Broken Links Report - ${today}`, body: issueBody, labels: ['broken-links', 'automated'] }); console.log(`Created new issue #${issue.data.number}`); } - name: Close old broken link issues if: steps.validate.outputs.has_broken_links == 'false' uses: actions/github-script@v7 with: script: | const issues = await github.rest.issues.listForRepo({ owner: context.repo.owner, repo: context.repo.repo, state: 'open', labels: 'broken-links' }); for (const issue of issues.data) { await github.rest.issues.update({ owner: context.repo.owner, repo: context.repo.repo, issue_number: issue.number, state: 'closed', state_reason: 'completed' }); await github.rest.issues.createComment({ owner: context.repo.owner, repo: context.repo.repo, issue_number: issue.number, body: '✅ All links are now working! Closing this issue.' }); console.log(`Closed issue #${issue.number}`); } ================================================ FILE: .github/workflows/validate-new-issue.yml ================================================ name: Validate New Issue on: workflow_call: # Called by submission-enforcement.yml after cooldown clears, # or directly on issue edits. The enforcement workflow handles # missing-label and informal submission detection, so this # workflow only validates properly-submitted resources. jobs: validate-resource: name: Validate Resource Submission # Only run on issues with the resource-submission label if: contains(github.event.issue.labels.*.name, 'resource-submission') runs-on: ubuntu-latest permissions: issues: write contents: read steps: - name: Checkout repository uses: actions/checkout@v4 with: sparse-checkout: | scripts/ templates/ THE_RESOURCES_TABLE.csv pyproject.toml - name: Set up Python uses: actions/setup-python@v5 with: python-version: '3.11' - name: Install dependencies run: | python -m pip install --upgrade pip pip install PyGithub PyYAML requests python-dotenv - name: Parse and validate submission id: validate env: ISSUE_BODY: ${{ github.event.issue.body }} ISSUE_NUMBER: ${{ github.event.issue.number }} GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} PYTHONPATH: ${{ github.workspace }} run: | python -m scripts.resources.parse_issue_form --validate 2>&1 | tail -n 1 > validation_result.json if grep -q '"valid": true' validation_result.json; then echo "Validation passed!" else echo "Validation failed!" fi echo "=== Validation Result ===" python -m json.tool validation_result.json || cat validation_result.json - name: Remove old validation comments uses: actions/github-script@v7 with: script: | const issue_number = context.issue.number; const owner = context.repo.owner; const repo = context.repo.repo; const comments = await github.rest.issues.listComments({ owner, repo, issue_number, }); for (const comment of comments.data) { if (comment.user.type === 'Bot' && comment.body.includes('## 🤖 Validation Results')) { await github.rest.issues.deleteComment({ owner, repo, comment_id: comment.id, }); } } - name: Post validation results uses: actions/github-script@v7 with: script: | const fs = require('fs'); const validation_result = JSON.parse(fs.readFileSync('validation_result.json', 'utf8')); let comment_body = '## 🤖 Validation Results\n\n'; if (validation_result.valid) { comment_body += '✅ **All validation checks passed!**\n\n'; comment_body += 'Your submission is ready for review by a maintainer.\n\n'; comment_body += '### Validated Data:\n'; comment_body += '```json\n'; comment_body += JSON.stringify(validation_result.data, null, 2); comment_body += '\n```\n'; } else { comment_body += '❌ **Validation failed**\n\n'; comment_body += 'Please fix the following issues and edit your submission:\n\n'; for (const error of validation_result.errors) { comment_body += `- ❗ ${error}\n`; } if (validation_result.warnings && validation_result.warnings.length > 0) { comment_body += '\n### Warnings:\n'; for (const warning of validation_result.warnings) { comment_body += `- ⚠️ ${warning}\n`; } } comment_body += '\n**Note:** You can edit your issue to fix these problems, and validation will run again automatically.'; } comment_body += '\n\n---\n'; comment_body += 'This comment is automatically updated when you edit the issue.'; await github.rest.issues.createComment({ owner: context.repo.owner, repo: context.repo.repo, issue_number: context.issue.number, body: comment_body }); - name: Update issue labels uses: actions/github-script@v7 with: script: | const fs = require('fs'); const issue_number = context.issue.number; const owner = context.repo.owner; const repo = context.repo.repo; const validation_result = JSON.parse(fs.readFileSync('validation_result.json', 'utf8')); const validation_passed = validation_result.valid; const { data: issue } = await github.rest.issues.get({ owner, repo, issue_number, }); let labels = issue.labels.map(label => label.name); labels = labels.filter(label => label !== 'validation-passed' && label !== 'validation-failed' && label !== 'pending-validation' ); if (validation_passed && labels.includes('changes-requested')) { labels = labels.filter(label => label !== 'changes-requested'); } if (validation_passed) { labels.push('validation-passed'); } else { labels.push('validation-failed'); } await github.rest.issues.setLabels({ owner, repo, issue_number, labels, }); - name: Notify maintainer if changes were made if: github.event.action == 'edited' && contains(github.event.issue.labels.*.name, 'changes-requested') uses: actions/github-script@v7 with: script: | const fs = require('fs'); const validation_result = JSON.parse(fs.readFileSync('validation_result.json', 'utf8')); const issue_number = context.issue.number; const current_validation_status = validation_result.valid; const comments = await github.rest.issues.listComments({ owner: context.repo.owner, repo: context.repo.repo, issue_number: issue_number, per_page: 100 }); let maintainer = null; let changesRequestedTime = null; for (let i = comments.data.length - 1; i >= 0; i--) { const comment = comments.data[i]; const match = comment.body.match(/## 🔄 Changes Requested by @(\w+)/); if (match) { maintainer = match[1]; changesRequestedTime = new Date(comment.created_at); break; } } if (!maintainer) return; let lastNotificationTime = null; let lastNotifiedStatus = null; let hasNotifiedAfterRequest = false; for (const comment of comments.data) { if (comment.body.includes('## 📝 Issue Updated') && comment.user.type === 'Bot') { const commentTime = new Date(comment.created_at); if (commentTime > changesRequestedTime) { hasNotifiedAfterRequest = true; const metaMatch = comment.body.match(//); if (metaMatch) { lastNotifiedStatus = metaMatch[1] === 'true'; } if (!lastNotificationTime || commentTime > lastNotificationTime) { lastNotificationTime = commentTime; } } } } let shouldNotify = false; let notificationReason = ''; if (!hasNotifiedAfterRequest) { shouldNotify = true; notificationReason = 'first edit after changes requested'; } else if (lastNotifiedStatus !== null && lastNotifiedStatus !== current_validation_status) { shouldNotify = true; notificationReason = 'validation status changed'; } if (shouldNotify) { let notification_body = `## 📝 Issue Updated\n\n`; notification_body += `@${maintainer} - The submitter has edited their issue in response to your requested changes.\n\n`; if (current_validation_status) { notification_body += `✅ **The updated submission now passes all validation checks!**\n\n`; notification_body += `You may want to review the changes and consider approving the submission.`; } else { notification_body += `❌ **The submission still has validation errors.**\n\n`; notification_body += `The submitter may need additional guidance to fix the remaining issues.`; } notification_body += `\n\n`; await github.rest.issues.createComment({ owner: context.repo.owner, repo: context.repo.repo, issue_number: issue_number, body: notification_body }); console.log(`Notification sent (reason: ${notificationReason})`); } else { console.log('Skipping notification - no significant changes detected'); } - name: Cleanup if: always() run: | rm -f validation_result.json ================================================ FILE: .gitignore ================================================ .myob/ .mypy_cache/ .ruff_cache/ __pycache__/ .pytest_cache/ .claude/ CLAUDE.md !resources/**/CLAUDE.md .DS_Store venv/ .env .pr_template_content.md *.egg-info/ .coverage .vscode/ marketplace/ coverage.xml !.claude/ .claude/* !.claude/commands/ .claude/commands/* !.claude/commands/evaluate-repository.md ================================================ FILE: .pre-commit-config.yaml ================================================ # See https://pre-commit.com for more information # See https://pre-commit.com/hooks.html for more hooks repos: - repo: https://github.com/pre-commit/pre-commit-hooks rev: v5.0.0 hooks: - id: check-added-large-files - id: check-case-conflict - id: check-merge-conflict - id: check-yaml - id: check-json - id: detect-private-key - id: end-of-file-fixer - id: mixed-line-ending - repo: https://github.com/astral-sh/ruff-pre-commit rev: v0.12.2 hooks: # Run the linter - id: ruff types_or: [python, pyi, jupyter] args: [--fix] # Run the formatter - id: ruff-format types_or: [python, pyi, jupyter] - repo: local hooks: - id: make-test name: run make test entry: make test language: system types: [python] pass_filenames: false always_run: true - id: check-readme-generated name: check README.md is generated from CSV entry: bash -c 'make generate && git diff --exit-code README.md' language: system files: 'resource-metadata\.csv|README\.md' pass_filenames: false description: Ensures README.md is generated from CSV data ================================================ FILE: .python-version ================================================ 3.11 ================================================ FILE: LICENSE ================================================ Awesome Claude Code © 2025 by hesreallyhim is licensed under Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International. To view a copy of this license, visit https://creativecommons.org/licenses/by-nc-nd/4.0/ ================================================ FILE: Makefile ================================================ # Makefile for awesome-claude-code resource management # Use venv python locally, system python in CI/CD ifeq ($(CI),true) PYTHON := python3 else PYTHON := venv/bin/python3 endif SCRIPTS_DIR := ./scripts .PHONY: help validate validate-single validate-toc test coverage generate generate-toc-assets test-regenerate test-regenerate-no-cleanup test-regenerate-allow-diff test-regenerate-cycle docs-tree docs-tree-check download-resources add_resource add-category sort format format-check generate-resource-id mypy ci clean clean-all help: @echo "Available commands:" @echo " make add-category - Add a new category to the repository" @echo " make validate - Validate all links in the resource CSV" @echo " make validate-single URL= - Validate a single resource URL" @echo " make validate-toc - Validate TOC anchors against GitHub HTML" @echo " make test - Run validation tests on test CSV" @echo " make coverage - Run pytest with coverage reports" @echo " make mypy - Run mypy type checks" @echo " make format - Check and fix code formatting with ruff" @echo " make format-check - Check code formatting without fixing" @echo " make ci - Run format-check, mypy, and tests" @echo " make generate - Generate README.md from CSV data, and create SVG badges" @echo " make generate-toc-assets - Regenerate subcategory TOC SVGs (after adding subcategories)" @echo " make test-regenerate - Regenerate READMEs after deletion and fail if diff" @echo " make generate-resource-id - Interactive resource ID generator" @echo " make download-resources - Download active resources from GitHub" @echo " make sort - Sort resources by category, sub-category, and name" @echo " make clean - Remove caches and test artifacts" @echo " make clean-all - Remove caches and test artifacts, plus venv/" @echo " make test-regenerate-no-cleanup - Keep outputs on failure for inspection" @echo " make test-regenerate-allow-diff - Allow diffs after regeneration" @echo " make test-regenerate-cycle - Full root/style-order regeneration cycle test" @echo " make docs-tree - Update README-GENERATION file tree" @echo " make docs-tree-check - Fail if README-GENERATION tree is out of date" @echo "" @echo "Options:" @echo " make add-category - Interactive mode to add a new category" @echo " make add-category ARGS='--name \"My Category\" --prefix mycat --icon 🎯'" @echo " make validate-github - Run validation in GitHub Action mode (JSON output)" @echo " make validate MAX_LINKS=N - Limit validation to N links" @echo " make download-resources CATEGORY='Category Name' - Download specific category" @echo " make download-resources LICENSE='MIT' - Download resources with specific license" @echo " make download-resources MAX_DOWNLOADS=N - Limit downloads to N resources" @echo " make download-resources HOSTED_DIR='path' - Custom hosted directory path" @echo "" @echo "Environment Variables:" @echo " GITHUB_TOKEN - Set to avoid GitHub API rate limiting (export GITHUB_TOKEN=...)" # Validate all links in the CSV (v2 with override support) validate: @echo "Validating links in THE_RESOURCES_TABLE.csv (with override support)..." @if [ -n "$(MAX_LINKS)" ]; then \ echo "Limiting validation to $(MAX_LINKS) links"; \ $(PYTHON) -m scripts.validation.validate_links --max-links $(MAX_LINKS); \ else \ $(PYTHON) -m scripts.validation.validate_links; \ fi # Run validation in GitHub Action mode validate-github: $(PYTHON) -m scripts.validation.validate_links --github-action # Validate a single resource URL validate-single: @if [ -z "$(URL)" ]; then \ echo "Error: Please provide a URL to validate"; \ echo "Usage: make validate-single URL=https://example.com/resource"; \ exit 1; \ fi @$(PYTHON) -m scripts.validation.validate_single_resource "$(URL)" $(if $(SECONDARY),--secondary "$(SECONDARY)") $(if $(NAME),--name "$(NAME)") # Validate TOC anchors against GitHub HTML (requires .claude/root-readme-html-article-body.html) validate-toc: @echo "Validating TOC anchors against GitHub HTML..." @$(PYTHON) -m scripts.testing.validate_toc_anchors # Run all tests using pytest test: @echo "Running all tests..." @$(PYTHON) -m pytest tests/ -v # Run tests with coverage reporting coverage: @echo "Running tests with coverage..." @$(PYTHON) -m pytest tests/ --cov=scripts --cov-report=term-missing --cov-report=html --cov-report=xml # Run mypy type checks mypy: @echo "Running mypy..." @$(PYTHON) -m mypy scripts tests # Format code with ruff (check and fix) format: @echo "Checking and fixing code formatting with ruff..." @$(PYTHON) -m ruff check scripts/ tests/ --fix || true @$(PYTHON) -m ruff format scripts/ tests/ @echo "✅ Code formatting complete!" # Check code formatting without fixing format-check: @echo "Checking code formatting..." @$(PYTHON) -m ruff check scripts/ tests/ @$(PYTHON) -m ruff format scripts/ tests/ --check @if $(PYTHON) -m ruff check scripts/ tests/ --quiet && $(PYTHON) -m ruff format scripts/ tests/ --check --quiet; then \ echo "✅ Code formatting check passed!"; \ else \ echo "❌ Code formatting issues found. Run 'make format' to fix."; \ exit 1; \ fi # Run CI checks locally ci: format-check mypy test docs-tree-check # Remove caches and test artifacts clean: @echo "Cleaning caches and test artifacts..." @find . -type d -name "__pycache__" -prune -exec rm -rf {} + @find . -type f -name "*.pyc" -delete @rm -rf .pytest_cache .mypy_cache .ruff_cache .coverage coverage.xml htmlcov @rm -rf .eggs *.egg-info build dist .tox .nox @echo "✅ Clean complete." # Remove caches, test artifacts, and virtual environment clean-all: clean @echo "Removing venv/..." @rm -rf venv @echo "✅ Clean-all complete." # Sort resources by category, sub-category, and name sort: @echo "Sorting resources in THE_RESOURCES_TABLE.csv..." $(PYTHON) -m scripts.resources.sort_resources # Regenerate subcategory TOC SVGs from categories.yaml generate-toc-assets: @echo "Regenerating subcategory TOC SVGs..." $(PYTHON) -m scripts.readme.helpers.generate_toc_assets # Generate README.md from CSV data using template system generate: sort @echo "Generating README.md from CSV data using template system..." $(PYTHON) -m scripts.readme.generate_readme # Regenerate READMEs from a clean tree and ensure outputs do not change test-regenerate: @if [ "$${ALLOW_DIRTY:-0}" -ne 1 ] && [ -n "$$(git status --porcelain)" ]; then \ echo "Error: working tree must be clean for test-regenerate"; \ exit 1; \ fi @echo "Note: If the local date changes during this run (near midnight), regenerated READMEs may differ." @backup_dir=$$(mktemp -d 2>/dev/null || mktemp -d -t acc-readme-backup); \ keep_outputs="$${KEEP_README_OUTPUTS:-0}"; \ allow_diff="$${ALLOW_DIFF:-0}"; \ restore() { \ if [ -f "$$backup_dir/README.md" ]; then \ cp "$$backup_dir/README.md" README.md; \ else \ rm -f README.md; \ fi; \ if [ -d "$$backup_dir/README_ALTERNATIVES" ]; then \ rm -rf README_ALTERNATIVES; \ cp -R "$$backup_dir/README_ALTERNATIVES" README_ALTERNATIVES; \ else \ rm -rf README_ALTERNATIVES; \ fi; \ }; \ if [ -f README.md ]; then cp README.md "$$backup_dir/README.md"; fi; \ if [ -d README_ALTERNATIVES ]; then cp -R README_ALTERNATIVES "$$backup_dir/"; fi; \ echo "Removing README outputs..."; \ rm -f README.md; \ rm -rf README_ALTERNATIVES; \ if ! $(MAKE) generate; then \ echo "Error: README generation failed; restoring outputs"; \ if [ "$$keep_outputs" -eq 1 ]; then \ echo "Keeping outputs for inspection (backup at $$backup_dir)"; \ else \ echo "Tip: Run 'make test-regenerate-no-cleanup' to inspect the generated outputs without restoring."; \ restore; \ rm -rf "$$backup_dir"; \ fi; \ exit 1; \ fi; \ failure=""; \ if [ ! -f README.md ]; then \ failure="README.md not regenerated"; \ elif [ ! -d README_ALTERNATIVES ] || [ -z "$$(ls -A README_ALTERNATIVES 2>/dev/null)" ]; then \ failure="README_ALTERNATIVES is empty after regeneration"; \ elif [ -n "$$(git status --porcelain)" ]; then \ if [ "$$allow_diff" -eq 1 ]; then \ echo "Diff allowed; skipping clean-tree enforcement."; \ else \ failure="working tree is dirty after regeneration; make generate may be out of sync"; \ fi; \ fi; \ if [ -n "$$failure" ]; then \ echo "Error: $$failure"; \ if [ "$$keep_outputs" -eq 1 ]; then \ echo "Keeping outputs for inspection (backup at $$backup_dir)"; \ else \ echo "Tip: Run 'make test-regenerate-no-cleanup' to inspect the generated outputs without restoring."; \ restore; \ rm -rf "$$backup_dir"; \ fi; \ exit 1; \ fi; \ rm -rf "$$backup_dir"; \ echo "✅ Regeneration produced a clean working tree." # Run test-regenerate but keep outputs on failure for inspection test-regenerate-no-cleanup: @KEEP_README_OUTPUTS=1 $(MAKE) test-regenerate # Run test-regenerate but allow diffs and dirty tree test-regenerate-allow-diff: @ALLOW_DIRTY=1 ALLOW_DIFF=1 $(MAKE) test-regenerate # Full regeneration cycle test (root style + selector order changes) test-regenerate-cycle: @$(PYTHON) -m scripts.testing.test_regenerate_cycle # Update README-GENERATION tree block docs-tree: @$(PYTHON) -m tools.readme_tree.update_readme_tree # Verify README-GENERATION tree block is up to date # defaults DOCS_TREE_CHECK ?= 1 DOCS_TREE_DEBUG ?= 0 DOCS_TREE_FLAGS := ifeq ($(DOCS_TREE_CHECK),1) DOCS_TREE_FLAGS += --check endif ifeq ($(DOCS_TREE_DEBUG),1) DOCS_TREE_FLAGS += --debug endif docs-tree-check: @$(PYTHON) -m tools.readme_tree.update_readme_tree $(DOCS_TREE_FLAGS) # Download resources from GitHub download-resources: @echo "Downloading resources from GitHub..." @ARGS=""; \ if [ -n "$(CATEGORY)" ]; then ARGS="$$ARGS --category '$(CATEGORY)'"; fi; \ if [ -n "$(LICENSE)" ]; then ARGS="$$ARGS --license '$(LICENSE)'"; fi; \ if [ -n "$(MAX_DOWNLOADS)" ]; then ARGS="$$ARGS --max-downloads $(MAX_DOWNLOADS)"; fi; \ if [ -n "$(OUTPUT_DIR)" ]; then ARGS="$$ARGS --output-dir '$(OUTPUT_DIR)'"; fi; \ if [ -n "$(HOSTED_DIR)" ]; then ARGS="$$ARGS --hosted-dir '$(HOSTED_DIR)'"; fi; \ eval $(PYTHON) -m scripts.resources.download_resources $$ARGS # Interactive resource ID generator generate-resource-id: @$(PYTHON) -m scripts.ids.generate_resource_id # Install required Python packages install: @echo "Installing required Python packages..." @$(PYTHON) -m pip install --upgrade pip @$(PYTHON) -m pip install -e ".[dev]" @echo "Installation complete!" # Add a new category to the repository add-category: @echo "Starting category addition tool..." @$(PYTHON) -m scripts.categories.add_category $(ARGS) ================================================ FILE: README.md ================================================

Pick Your Style:

Awesome Extra Classic Flat

Awesome Claude Code

# Awesome Claude Code [![Awesome](https://awesome.re/badge.svg)](https://awesome.re) > A selectively curated list of skills, agents, plugins, hooks, and other amazing tools for enhancing your [Claude Code](https://docs.anthropic.com/en/docs/claude-code) workflow.
Featured Claude Code Projects
## Latest Additions - [Claude Scientific Skills](https://github.com/K-Dense-AI/claude-scientific-skills) by [K-Dense](https://github.com/K-Dense-AI/) - "A set of ready-to-use Agent Skills for research, science, engineering, analysis, finance and writing." That's their description - modest, simple. That's how you can tell this is really one of the best skills repos on GitHub. If you've ever thought about getting a PhD... just read all of these documents instead. Also I think it IS an AI agent or something? Awesome. - [parry](https://github.com/vaporif/parry) by [Dmytro Onypko](https://github.com/vaporif) - Prompt injection scanner for Claude Code hooks. Scans tool inputs and outputs for injection attacks, secrets, and data exfiltration attempts. [NOTE: Early development phase but worth a look.]. - [Dippy](https://github.com/ldayton/Dippy) by [Lily Dayton](https://github.com/ldayton) - Auto-approve safe bash commands using AST-based parsing, while prompting for destructive operations. Solves permission fatigue without disabling safety. Supports Claude Code, Gemini CLI, and Cursor. - [sudocode](https://github.com/sudocode-ai/sudocode) by [ssh-randy](https://github.com/ssh-randy) - Lightweight agent orchestration dev tool that lives in your repo. Integrates with various specification frameworks. It's giving Jira. - [claude-tmux](https://github.com/nielsgroen/claude-tmux) by [Niels Groeneveld](https://github.com/nielsgroen) - Manage Claude Code within tmux. A tmux popup of all your Claude Code instances, enabling quick switching, status monitoring, session lifecycle management, with git worktree and pull request support. - [claude-esp](https://github.com/phiat/claude-esp) by [phiat](https://github.com/phiat) - Go-based TUI that streams Claude Code's hidden output (thinking, tool calls, subagents) to a separate terminal. Watch multiple sessions simultaneously, filter by content type, and track background tasks. Ideal for debugging or understanding what Claude is doing under the hood without interrupting your main session. ## Contents - [Agent Skills 🤖](#agent-skills-) - [General](#general) - [Workflows & Knowledge Guides 🧠](#workflows--knowledge-guides-) - [General](#general-1) - [Ralph Wiggum](#ralph-wiggum) - [Tooling 🧰](#tooling-) - [General](#general-2) - [IDE Integrations](#ide-integrations) - [Usage Monitors](#usage-monitors) - [Orchestrators](#orchestrators) - [Config Managers](#config-managers) - [Status Lines 📊](#status-lines-) - [General](#general-3) - [Hooks 🪝](#hooks-) - [General](#general-4) - [Slash-Commands 🔪](#slash-commands-) - [General](#general-5) - [Version Control & Git](#version-control--git) - [Code Analysis & Testing](#code-analysis--testing) - [Context Loading & Priming](#context-loading--priming) - [Documentation & Changelogs](#documentation--changelogs) - [CI / Deployment](#ci--deployment) - [Project & Task Management](#project--task-management) - [Miscellaneous](#miscellaneous) - [CLAUDE.md Files 📂](#claudemd-files-) - [Language-Specific](#language-specific) - [Domain-Specific](#domain-specific) - [Project Scaffolding & MCP](#project-scaffolding--mcp) - [Alternative Clients 📱](#alternative-clients-) - [General](#general-6) - [Official Documentation 🏛️](#official-documentation-%EF%B8%8F) - [General](#general-7) ## Agent Skills 🤖 > Agent skills are model-controlled configurations (files, scripts, resources, etc.) that enable Claude Code to perform specialized tasks requiring specific knowledge or capabilities. ### General - [AgentSys](https://github.com/avifenesh/agentsys) by [avifenesh](https://github.com/avifenesh) - Workflow automation system for Claude with a group of useful plugins, agents, and skills. Automates task-to-production workflows, PR management, code cleanup, performance investigation, drift detection, and multi-agent code review. Includes [agnix](https://github.com/avifenesh/agnix) for linting agent configurations. Built on thousands of lines of code with thousands of tests. Uses deterministic detection (regex, AST) with LLM judgment for efficiency. Used on many production systems. - [AI Agent, AI Spy](https://youtu.be/0ANECpNdt-4) by [Whittaker & Tiwari](https://signalfoundation.org/) - Members from the Signal Foundation with some really great tips and tricks on how to turn your operating system into an instrument of total surveillance, and why some companies are doing this really awesome thing. [warning: YouTube link]. - [Book Factory](https://github.com/robertguss/claude-skills) by [Robert Guss](https://github.com/robertguss) - A comprehensive pipeline of Skills that replicates traditional publishing infrastructure for nonfiction book creation using specialized Claude skills. - [cc-devops-skills](https://github.com/akin-ozer/cc-devops-skills) by [akin-ozer](https://github.com/akin-ozer) - Immensely detailed set of skills for DevOps Engineers (or anyone who has to deploy code, really). Works with validations, generators, shell scripts and CLI tools to create high quality IaC code for about any platform you've ever struggled painfully to work with. Worth downloading even just as a source of documentation. - [Claude Code Agents](https://github.com/undeadlist/claude-code-agents) by [Paul - UndeadList](https://github.com/undeadlist) - Comprehensive E2E development workflow with helpful Claude Code subagent prompts for solo devs. Run multiple auditors in parallel, automate fix cycles with micro-checkpoint protocols, and do browser-based QA. Includes strict protocols to prevent AI going rogue. - [Claude Codex Settings](https://github.com/fcakyon/claude-codex-settings) by [fatih akyon](https://github.com/fcakyon) - A well-organized, well-written set of plugins covering core developer activities, such as working with common cloud platforms like GitHub, Azure, MongoDB, and popular services such as Tavily, Playwright, and more. Clear, not overly-opinionated, and compatible with a few other providers. - [Claude Mountaineering Skills](https://github.com/dreamiurg/claude-mountaineering-skills) by [Dmytro Gaivoronsky](https://github.com/dreamiurg) - Claude Code skill that automates mountain route research for North American peaks. Aggregates data from 10+ mountaineering sources like Mountaineers.org, PeakBagger.com and SummitPost.com to generate detailed route beta reports with weather, avalanche conditions, and trip reports. - [Claude Scientific Skills](https://github.com/K-Dense-AI/claude-scientific-skills) by [K-Dense](https://github.com/K-Dense-AI/) - "A set of ready-to-use Agent Skills for research, science, engineering, analysis, finance and writing." That's their description - modest, simple. That's how you can tell this is really one of the best skills repos on GitHub. If you've ever thought about getting a PhD... just read all of these documents instead. Also I think it IS an AI agent or something? Awesome. - [Codex Skill](https://github.com/skills-directory/skill-codex) by [klaudworks](https://github.com/klaudworks) - Enables users to prompt codex from claude code. Unlike the raw codex mcp server, this skill infers parameters such as model, reasoning effort, sandboxing from your prompt or asks you to specify them. It also simplifies continuing prior codex sessions so that codex can continue with the prior context. - [Compound Engineering Plugin](https://github.com/EveryInc/compound-engineering-plugin) by [EveryInc](https://github.com/EveryInc) - A very pragmatic set of well-designed agents, skills, and commands, built around a discipline of turning past mistakes and errors into lessons and opportunities for future growth and improvement. Good documentation. - [Context Engineering Kit](https://github.com/NeoLabHQ/context-engineering-kit) by [Vlad Goncharov](https://github.com/LeoVS09) - Hand-crafted collection of advanced context engineering techniques and patterns with minimal token footprint focused on improving agent result quality. - [Everything Claude Code](https://github.com/affaan-m/everything-claude-code) by [Affaan Mustafa](https://github.com/affaan-m/) - Top-notch, well-written resources covering "just about everything" from core engineering domains. What's nice about this "everything-" store is most of the resources have significant standalone value and unlike some all-encompassing frameworks, although you can opt in to the author's own specific workflow patterns if you choose, the individual resources offer exemplary patterns in (just about) every Claude Code feature you can find (apologies to the Output Styles devotees). - [Fullstack Dev Skills](https://github.com/jeffallan/claude-skills) by [jeffallan](https://github.com/jeffallan) - A comprehensive Claude Code plugin with 65 specialized skills covering full-stack development across a wide range of specific frameworks. Features 9 project workflow commands for Jira/Confluence integration and, notably, an interesting approach to context engineering via a `/common-ground` command that surfaces Claude's hidden assumptions about your project. This is a smart thing to do. - [read-only-postgres](https://github.com/jawwadfirdousi/agent-skills) by [jawwadfirdousi](https://github.com/jawwadfirdousi) - Read-only PostgreSQL query skill for Claude Code. Executes SELECT/SHOW/EXPLAIN/WITH queries across configured databases with strict validation, timeouts, and row limits. Supports multiple connections with descriptions for database selection. - [Superpowers](https://github.com/obra/superpowers) by [Jesse Vincent](https://github.com/obra) - A strong bundle of core competencies for software engineering, with good coverage of a large portion of the SDLC - from planning, reviewing, testing, debugging... Well written, well organized, and adaptable. The author refers to them as "superpowers", but many of them are just consolidating engineering best practices - which sometimes does feel like a superpower when working with Claude Code. - [Trail of Bits Security Skills](https://github.com/trailofbits/skills) by [Trail of Bits](https://github.com/trailofbits) - A very professional collection of over a dozen security-focused skills for code auditing and vulnerability detection. Includes skills for static analysis with CodeQL and Semgrep, variant analysis across codebases, fix verification, and differential code review. - [TÂCHES Claude Code Resources](https://github.com/glittercowboy/taches-cc-resources) by [TÂCHES](https://github.com/glittercowboy) - A well-balanced, "down-to-Earth" set of sub agents, skills, and commands, that are well-organized, easy to read, and a healthy focus on "meta"-skills/agents, like "skill-auditor", hook creation, etc. - the kind of things you can adapt to your workflow, and not the other way around. - [Web Assets Generator Skill](https://github.com/alonw0/web-asset-generator) by [Alon Wolenitz](https://github.com/alonw0) - Easily generate web assets from Claude Code including favicons, app icons (PWA), and social media meta images (Open Graph) for Facebook, Twitter, WhatsApp, and LinkedIn. Handles image resizing, text-to-image generation, emojis, and provides proper HTML meta tags.
## Workflows & Knowledge Guides 🧠 > A workflow is a tightly coupled set of Claude Code-native resources that facilitate specific projects ### General - [AB Method](https://github.com/ayoubben18/ab-method) by [Ayoub Bensalah](https://github.com/ayoubben18) - A principled, spec-driven workflow that transforms large problems into focused, incremental missions using Claude Code's specialized sub agents. Includes slash-commands, sub agents, and specialized workflows designed for specific parts of the SDLC. - [Agentic Workflow Patterns](https://github.com/ThibautMelen/agentic-workflow-patterns) by [ThibautMelen](https://github.com/ThibautMelen) - A comprehensive and well-documented collection of agentic patterns from Anthropic docs, with colorful Mermaid diagrams and code examples for each pattern. Covers Subagent Orchestration, Progressive Skills, Parallel Tool Calling, Master-Clone Architecture, Wizard Workflows, and more. Also compatible with other providers. - [Blogging Platform Instructions](https://github.com/cloudartisan/cloudartisan.github.io/tree/main/.claude/commands) by [cloudartisan](https://github.com/cloudartisan) - Provides a well-structured set of commands for publishing and maintaining a blogging platform, including commands for creating posts, managing categories, and handling media files. - [Claude Code Documentation Mirror](https://github.com/ericbuess/claude-code-docs) by [Eric Buess](https://github.com/ericbuess) - A mirror of the Anthropic © PBC documentation pages for Claude Code, updated every few hours. Can come in handy when trying to stay on top of the ever-expanding feature-set of Dr. Claw D. Code, Ph.D. - [Claude Code Handbook](https://nikiforovall.blog/claude-code-rules/) by [nikiforovall](https://github.com/nikiforovall) - Collection of best practices, tips, and techniques for Claude Code development workflows, enhanced with distributable plugins. - [Claude Code Infrastructure Showcase](https://github.com/diet103/claude-code-infrastructure-showcase) by [diet103](https://github.com/diet103) - A remarkably innovative approach to working with Skills, the centerpiece of which being a technique that leverages hooks to ensure that Claude intelligently selects and activates the appropriate Skill given the current context. Well-documented and adaptable to different projects and workflows. - [Claude Code PM](https://github.com/automazeio/ccpm) by [Ran Aroussi](https://github.com/ranaroussi) - Really comprehensive and feature-packed project-management workflow for Claude Code. Numerous specialized agents, slash-commands, and strong documentation. - [Claude Code Repos Index](https://github.com/danielrosehill/Claude-Code-Repos-Index) by [Daniel Rosehill](https://github.com/danielrosehill) - This is either the work of a prolific genius, or a very clever bot (or both), although it hardly matters because the quality is so good - an index of 75+ Claude Code repositories published by the author - and I'm not talking about slop. CMS, system design, deep research, IoT, agentic workflows, server management, personal health... If you spot the lie, let me know, otherwise please check these out. - [Claude Code System Prompts](https://github.com/Piebald-AI/claude-code-system-prompts) by [Piebald AI](https://github.com/Piebald-AI) - All parts of Claude Code's system prompt, including builtin tool descriptions, sub agent prompts (Plan/Explore/Task), utility prompts (CLAUDE.md, compact, Bash cmd, security review, agent creation, etc.). Updated for each Claude Code version. - [Claude Code Tips](https://github.com/ykdojo/claude-code-tips) by [ykdojo](https://github.com/ykdojo) - A nice variety of 35+ brief but information-dense Claude Code tips covering voice input, system prompt patching, container workflows for risky tasks, conversation cloning(!), multi-model orchestration with Gemini CLI, and plenty more. Nice demos, working scripts, a plugin, I'd say this probably has a little something for everyone. - [Claude Code Ultimate Guide](https://github.com/FlorianBruniaux/claude-code-ultimate-guide) by [Florian BRUNIAUX](https://www.linkedin.com/in/florian-bruniaux-43408b83/) - A tremendous feat of documentation, this guide covers Claude Code from beginner to power user, with production-ready templates for Claude Code features, guides on agentic workflows, and a lot of great learning materials, including quizzes and a handy "cheatsheet". Whether it's the "ultimate" guide to Claude Code will be up to the reader, but a valuable resource nonetheless (as with all documentation sites, make sure it's up to date before you bet the farm). - [Claude CodePro](https://github.com/maxritter/claude-codepro) by [Max Ritter](https://www.maxritter.net) - Professional development environment for Claude Code with spec-driven workflow, TDD enforcement, cross-session memory, semantic search, quality hooks, and modular rules integration. A bit "heavyweight" but feature-packed and has wide coverage. - [claude-code-docs](https://github.com/costiash/claude-code-docs) by [Constantin Shafranski](https://github.com/costiash) - A mirror of the Anthropic© PBC documentation site for Claude/Code, but with bonus features like full-text search and query-time updates - a nice companion to `claude-code-docs` for up-to-the-minute, fully-indexed information so that Claude Code can read about itself. - [ClaudoPro Directory](https://github.com/JSONbored/claudepro-directory) by [ghost](https://github.com/JSONbored) - Well-crafted, wide selection of Claude Code hooks, slash commands, subagent files, and more, covering a range of specialized tasks and workflows. Better resources than your average "Claude-template-for-everything" site. - [Context Priming](https://github.com/disler/just-prompt/tree/main/.claude/commands) by [disler](https://github.com/disler) - Provides a systematic approach to priming Claude Code with comprehensive project context through specialized commands for different project scenarios and development contexts. - [Design Review Workflow](https://github.com/OneRedOak/claude-code-workflows/tree/main/design-review) by [Patrick Ellis](https://github.com/OneRedOak) - A tailored workflow for enabling automated UI/UX design review, including specialized sub agents, slash commands, `CLAUDE.md` excerpts, and more. Covers a broad range of criteria from responsive design to accessibility. - [Laravel TALL Stack AI Development Starter Kit](https://github.com/tott/laravel-tall-claude-ai-configs) by [tott](https://github.com/tott) - Transform your Laravel TALL (Tailwind, AlpineJS, Laravel, Livewire) stack development with comprehensive Claude Code configurations that provide intelligent assistance, systematic workflows, and domain expert consultation. - [Learn Claude Code](https://github.com/shareAI-lab/learn-claude-code) by [shareAI-Lab](https://github.com/shareAI-lab/) - A really interesting analysis of how coding agents like Claude Code are designed. It attempts to break an agent down into its fundamental parts and reconstruct it with minimal code. Great learning resource. Final product is a rudimentary agent with skills, sub-agents, and a todo-list in roughly a few hundred lines of Python. - [learn-faster-kit](https://github.com/cheukyin175/learn-faster-kit) by [Hugo Lau](https://github.com/cheukyin175) - A creative educational framework for Claude Code, inspired by the "FASTER" approach to self-teaching. Ships with a variety of agents, slash commands, and tools that enable Claude Code to help you progress at your own pace, employing well-established pedagogical techniques like active learning and spaced repetition. - [n8n_agent](https://github.com/kingler/n8n_agent/tree/main/.claude/commands) by [kingler](https://github.com/kingler) - Amazing comprehensive set of comments for code analysis, QA, design, documentation, project structure, project management, optimization, and many more. - [Project Bootstrapping and Task Management](https://github.com/steadycursor/steadystart/tree/main/.claude/commands) by [steadycursor](https://github.com/steadycursor) - Provides a structured set of commands for bootstrapping and managing a new project, including meta-commands for creating and editing custom slash-commands. - [Project Management, Implementation, Planning, and Release](https://github.com/scopecraft/command/tree/main/.claude/commands) by [scopecraft](https://github.com/scopecraft) - Really comprehensive set of commands for all aspects of SDLC. - [Project Workflow System](https://github.com/harperreed/dotfiles/tree/master/.claude/commands) by [harperreed](https://github.com/harperreed) - A set of commands that provide a comprehensive workflow system for managing projects, including task management, code review, and deployment processes. - [RIPER Workflow](https://github.com/tony/claude-code-riper-5) by [Tony Narlock](https://tony.sh) - Structured development workflow enforcing separation between Research, Innovate, Plan, Execute, and Review phases. Features consolidated subagents for context-efficiency, branch-aware memory bank, and strict mode enforcement for guided development. - [Shipping Real Code w/ Claude](https://diwank.space/field-notes-from-shipping-real-code-with-claude) by [Diwank](https://github.com/creatorrr) - A detailed blog post explaining the author's process for shipping a product with Claude Code, including CLAUDE.md files and other interesting resources. - [Simone](https://github.com/Helmi/claude-simone) by [Helmi](https://github.com/Helmi) - A broader project management workflow for Claude Code that encompasses not just a set of commands, but a system of documents, guidelines, and processes to facilitate project planning and execution. ### Ralph Wiggum - [awesome-ralph](https://github.com/snwfdhmp/awesome-ralph) by [Martin Joly](https://github.com/snwfdhmp) - A curated list of resources about Ralph, the AI coding technique that runs AI coding agents in automated loops until specifications are fulfilled. - [Ralph for Claude Code](https://github.com/frankbria/ralph-claude-code) by [Frank Bria](https://github.com/frankbria) - An autonomous AI development framework that enables Claude Code to work iteratively on projects until completion. Features intelligent exit detection, rate limiting, circuit breaker patterns, and comprehensive safety guardrails to prevent infinite loops and API overuse. Built with Bash, integrated with tmux for live monitoring, and includes 75+ comprehensive tests. - [Ralph Wiggum Marketer](https://github.com/muratcankoylan/ralph-wiggum-marketer) by [Muratcan Koylan](https://github.com/muratcankoylan) - A Claude Code plugin that provides an autonomous AI copywriter, integrating the Ralph loop with customized knowledge bases for market research agents. The agents do the research, Ralph writes the copy, you stay in bed. Whether or not you practice Ralph-Driven Development (RDD), I think these projects are interesting and creative explorations of general agentic patterns. - [ralph-orchestrator](https://github.com/mikeyobrien/ralph-orchestrator) by [mikeyobrien](https://github.com/mikeyobrien) - Ralph Orchestrator implements the simple but effective "Ralph Wiggum" technique for autonomous task completion, continuously running an AI agent against a prompt file until the task is marked as complete or limits are reached. This implementation provides a robust, well-tested, and feature-complete orchestration system for AI-driven development. Also cited in the Anthropic Ralph plugin documentation. - [ralph-wiggum-bdd](https://github.com/marcindulak/ralph-wiggum-bdd) by [marcindulak](https://github.com/marcindulak) - A standalone Bash script for Behavior-Driven Development with Ralph Wiggum Loop. In principle, while running unattended, the script can keep code and requirements in sync, but in practice it still requires interactive human supervision, so it supports both modes. The script is standalone and can be modified and committed into your project. - [The Ralph Playbook](https://github.com/ClaytonFarr/ralph-playbook) by [Clayton Farr](https://github.com/ClaytonFarr) - A remarkably detailed and comprehensive guide to the Ralph Wiggum technique, featuring well-written theoretical commentary paired with practical guidelines and advice.
## Tooling 🧰 > Tooling denotes applications that are built on top of Claude Code and consist of more components than slash-commands and `CLAUDE.md` files ### General - [cc-sessions](https://github.com/GWUDCAP/cc-sessions) by [toastdev](https://github.com/satoastshi) - An opinionated approach to productive development with Claude Code. - [cc-tools](https://github.com/Veraticus/cc-tools) by [Josh Symonds](https://github.com/Veraticus) - High-performance Go implementation of Claude Code hooks and utilities. Provides smart linting, testing, and statusline generation with minimal overhead. - [ccexp](https://github.com/nyatinte/ccexp) by [nyatinte](https://github.com/nyatinte) - Interactive CLI tool for discovering and managing Claude Code configuration files and slash commands with a beautiful terminal UI. - [cchistory](https://github.com/eckardt/cchistory) by [eckardt](https://github.com/eckardt) - Like the shell history command but for your Claude Code sessions. Easily list all Bash or "Bash-mode" (`!`) commands Claude Code ran in a session for reference. - [cclogviewer](https://github.com/Brads3290/cclogviewer) by [Brad S.](https://github.com/Brads3290) - A humble but handy utility for viewing Claude Code `.jsonl` conversation files in a pretty HTML UI. - [Claude Code Templates](https://github.com/davila7/claude-code-templates) by [Daniel Avila](https://github.com/davila7) - Incredibly awesome collection of resources from every category in this list, presented with a neatly polished UI, great features like usage dashboard, analytics, and everything from slash commands to hooks to agents. An awesome companion for this awesome list. - [Claude Composer](https://github.com/possibilities/claude-composer) by [Mike Bannister](https://github.com/possibilities) - A tool that adds small enhancements to Claude Code. - [Claude Hub](https://github.com/claude-did-this/claude-hub) by [Claude Did This](https://github.com/claude-did-this) - A webhook service that connects Claude Code to GitHub repositories, enabling AI-powered code assistance directly through pull requests and issues. This integration allows Claude to analyze repositories, answer technical questions, and help developers understand and improve their codebase through simple @mentions. - [Claude Session Restore](https://github.com/ZENG3LD/claude-session-restore) by [ZENG3LD](https://github.com/ZENG3LD) - Efficiently restore context from previous Claude Code sessions by analyzing session files and git history. Features multi-factor data collection across numerous Claude Code capacities with time-based filtering. Uses tail-based parsing for efficient handling of large session files up to 2GB. Includes both a CLI tool for manual analysis and a Claude Code skill for automatic session restoration. - [claude-code-tools](https://github.com/pchalasani/claude-code-tools) by [Prasad Chalasani](https://github.com/pchalasani) - Well-crafted toolset for session continuity, featuring skills/commands to avoid compaction and recover context across sessions with cross-agent handoff between Claude Code and Codex CLI. Includes a fast Rust/Tantivy-powered full-text session search (TUI for humans, skill/CLI for agents), tmux-cli skill + command for interacting with scripts and CLI agents, and safety hooks to block dangerous commands. - [claude-starter-kit](https://github.com/serpro69/claude-starter-kit) by [serpro69](https://github.com/serpro69) - This is a starter template repository designed to provide a complete development environment for Claude-Code with pre-configured MCP servers and tools for AI-powered development workflows. The repository is intentionally minimal, containing only configuration templates for three primary systems: Claude Code, Serena, and Task Master. - [claudekit](https://github.com/carlrannaberg/claudekit) by [Carl Rannaberg](https://github.com/carlrannaberg) - Impressive CLI toolkit providing auto-save checkpointing, code quality hooks, specification generation and execution, and 20+ specialized subagents including oracle (gpt-5), code-reviewer (6-aspect deep analysis), ai-sdk-expert (Vercel AI SDK), typescript-expert and many more for Claude Code workflows. - [Container Use](https://github.com/dagger/container-use) by [dagger](https://github.com/dagger) - Development environments for coding agents. Enable multiple agents to work safely and independently with your preferred stack. - [ContextKit](https://github.com/FlineDev/ContextKit) by [Cihat Gündüz](https://github.com/Jeehut) - A systematic development framework that transforms Claude Code into a proactive development partner. Features 4-phase planning methodology, specialized quality agents, and structured workflows that help AI produce production-ready code on first try. - [recall](https://github.com/zippoxer/recall) by [zippoxer](https://github.com/zippoxer) - Full-text search your Claude Code sessions. Run `recall` in terminal, type to search, Enter to resume. Alternative to `claude --resume`. - [Rulesync](https://github.com/dyoshikawa/rulesync) by [dyoshikawa](https://github.com/dyoshikawa) - A Node.js CLI tool that automatically generates configs (rules, ignore files, MCP servers, commands, and subagents) for various AI coding agents. Rulesync can convert configs between Claude Code and other AI agents in both directions. - [run-claude-docker](https://github.com/icanhasjonas/run-claude-docker) by [Jonas](https://github.com/icanhasjonas/) - A self-contained Docker runner that forwards your current workspace into a safe(r) isolated docker container, where you still have access to your Claude Code settings, authentication, ssh agent, pgp, optionally aws keys etc. - [stt-mcp-server-linux](https://github.com/marcindulak/stt-mcp-server-linux) by [marcindulak](https://github.com/marcindulak) - A push-to-talk speech transcription setup for Linux using a Python MCP server. Runs locally in Docker with no external API calls. Your speech is recorded, transcribed into text, and then sent to Claude running in a Tmux session. - [SuperClaude](https://github.com/SuperClaude-Org/SuperClaude_Framework) by [SuperClaude-Org](https://github.com/SuperClaude-Org) - A versatile configuration framework that enhances Claude Code with specialized commands, cognitive personas, and development methodologies, such as "Introspection" and "Orchestration". - [tweakcc](https://github.com/Piebald-AI/tweakcc) by [Piebald-AI](https://github.com/Piebald-AI) - Command-line tool to customize your Claude Code styling. - [Vibe-Log](https://github.com/vibe-log/vibe-log-cli) by [Vibe-Log](https://github.com/vibe-log) - Analyzes your Claude Code prompts locally (using CC), provides intelligent session analysis and actionable strategic guidance - works in the statusline and produces very pretty HTML reports as well. Easy to install and remove. - [viwo-cli](https://github.com/OverseedAI/viwo) by [Hal Shin](https://github.com/hal-shin) - Run Claude Code in a Docker container with git worktrees as volume mounts to enable safer usage of `--dangerously-skip-permissions` for frictionless one-shotting prompts. Allows users to spin up multiple instances of Claude Code in the background easily with reduced permission fatigue. - [VoiceMode MCP](https://github.com/mbailey/voicemode) by [Mike Bailey](https://github.com/mbailey) - VoiceMode MCP brings natural conversations to Claude Code. It supports any OpenAI API compatible voice services and installs free and open source voice services (Whisper.cpp and Kokoro-FastAPI). ### IDE Integrations - [Claude Code Chat](https://marketplace.visualstudio.com/items?itemName=AndrePimenta.claude-code-chat) by [andrepimenta](https://github.com/andrepimenta) - An elegant and user-friendly Claude Code chat interface for VS Code. - [claude-code-ide.el](https://github.com/manzaltu/claude-code-ide.el) by [manzaltu](https://github.com/manzaltu) - claude-code-ide.el integrates Claude Code with Emacs, like Anthropic’s VS Code/IntelliJ extensions. It shows ediff-based code suggestions, pulls LSP/flymake/flycheck diagnostics, and tracks buffer context. It adds an extensible MCP tool support for symbol refs/defs, project metadata, and tree-sitter AST queries. - [claude-code.el](https://github.com/stevemolitor/claude-code.el) by [stevemolitor](https://github.com/stevemolitor) - An Emacs interface for Claude Code CLI. - [claude-code.nvim](https://github.com/greggh/claude-code.nvim) by [greggh](https://github.com/greggh) - A seamless integration between Claude Code AI assistant and Neovim. - [Claudix - Claude Code for VSCode](https://github.com/Haleclipse/Claudix) by [Haleclipse](https://github.com/Haleclipse) - A VSCode extension that brings Claude Code directly into your editor with interactive chat interface, session management, intelligent file operations, terminal execution, and real-time streaming responses. Built with Vue 3, TypeScript. ### Usage Monitors - [CC Usage](https://github.com/ryoppippi/ccusage) by [ryoppippi](https://github.com/ryoppippi) - Handy CLI tool for managing and analyzing Claude Code usage, based on analyzing local Claude Code logs. Presents a nice dashboard regarding cost information, token consumption, etc. - [ccflare](https://github.com/snipeship/ccflare) by [snipeship](https://github.com/snipeship) - Claude Code usage dashboard with a web-UI that would put Tableau to shame. Thoroughly comprehensive metrics, frictionless setup, detailed logging, really really nice UI. - [ccflare -> **better-ccflare**](https://github.com/tombii/better-ccflare/) by [tombii](https://github.com/tombii) - A well-maintained and feature-enhanced fork of the glorious `ccflare` usage dashboard by @snipeship (which at the time of writing has not had an update in a few months). `better-ccflare` builds on this foundation with some performance enhancements, extended provider support, bug fixes, Docker deployment, and more. - [Claude Code Usage Monitor](https://github.com/Maciek-roboblog/Claude-Code-Usage-Monitor) by [Maciek-roboblog](https://github.com/Maciek-roboblog) - A real-time terminal-based tool for monitoring Claude Code token usage. It shows live token consumption, burn rate, and predictions for token depletion. Features include visual progress bars, session-aware analytics, and support for multiple subscription plans. - [Claudex](https://github.com/kunwar-shah/claudex) by [Kunwar Shah](https://github.com/kunwar-shah) - Claudex - A web-based browser for exploring your Claude Code conversation history across projects. Indexes your codebase for full-text search. Nice, easy-to-navigate UI. Simple dashboard interface for high-level analytics, and multiple export options as well. (And completely local w/ no telemetry!). - [viberank](https://github.com/sculptdotfun/viberank) by [nikshepsvn](https://github.com/nikshepsvn) - A community-driven leaderboard tool that enables developers to visualize, track, and compete based on their Claude Code usage statistics. It features robust data analytics, GitHub OAuth, data validation, and user-friendly CLI/web submission methods. ### Orchestrators - [Auto-Claude](https://github.com/AndyMik90/Auto-Claude) by [AndyMik90](https://github.com/AndyMik90) - Autonomous multi-agent coding framework for Claude Code (Claude Agent SDK) that integrates the full SDLC - "plans, builds, and validates software for you". Features a slick kanban-style UI and a well-designed but not over-engineered agent orchestration system. - [Claude Code Flow](https://github.com/ruvnet/claude-code-flow) by [ruvnet](https://github.com/ruvnet) - This mode serves as a code-first orchestration layer, enabling Claude to write, edit, test, and optimize code autonomously across recursive agent cycles. - [Claude Squad](https://github.com/smtg-ai/claude-squad) by [smtg-ai](https://github.com/smtg-ai) - Claude Squad is a terminal app that manages multiple Claude Code, Codex (and other local agents including Aider) in separate workspaces, allowing you to work on multiple tasks simultaneously. - [Claude Swarm](https://github.com/parruda/claude-swarm) by [parruda](https://github.com/parruda) - Launch Claude Code session that is connected to a swarm of Claude Code Agents. - [Claude Task Master](https://github.com/eyaltoledano/claude-task-master) by [eyaltoledano](https://github.com/eyaltoledano) - A task management system for AI-driven development with Claude, designed to work seamlessly with Cursor AI. - [Claude Task Runner](https://github.com/grahama1970/claude-task-runner) by [grahama1970](https://github.com/grahama1970) - A specialized tool to manage context isolation and focused task execution with Claude Code, solving the critical challenge of context length limitations and task focus when working with Claude on complex, multi-step projects. - [Happy Coder](https://github.com/slopus/happy) by [GrocerPublishAgent](https://peoplesgrocers.com/en/projects) - Spawn and control multiple Claude Codes in parallel from your phone or desktop. Happy Coder runs Claude Code on your hardware, sends push notifications when Claude needs more input or permission, and costs nothing. - [sudocode](https://github.com/sudocode-ai/sudocode) by [ssh-randy](https://github.com/ssh-randy) - Lightweight agent orchestration dev tool that lives in your repo. Integrates with various specification frameworks. It's giving Jira. - [The Agentic Startup](https://github.com/rsmdt/the-startup) by [Rudolf Schmidt](https://github.com/rsmdt) - Yet Another Claude Orchestrator - a collection of agents, commands, etc., for shipping production code - but I like this because it's comprehensive, well-written, and one of the few resources that actually uses Output Styles! +10 points! - [TSK - AI Agent Task Manager and Sandbox](https://github.com/dtormoen/tsk) by [dtormoen](https://github.com/dtormoen) - A Rust CLI tool that lets you delegate development tasks to AI agents running in sandboxed Docker environments. Multiple agents work in parallel, returning git branches for human review. ### Config Managers - [claude-rules-doctor](https://github.com/nulone/claude-rules-doctor) by [nulone](https://github.com/nulone) - CLI that detects dead `.claude/rules/` files by checking if `paths:` globs actually match files in your repo. Catches silent rule failures where renamed directories or typos in glob patterns cause rules to never apply. Features CI mode (exit 1 on dead rules), JSON output, and verbose mode showing matched files. - [ClaudeCTX](https://github.com/foxj77/claudectx) by [John Fox](https://github.com/foxj77) - claudectx lets you switch your entire Claude Code configuration with a single command.
## Status Lines 📊 > Status lines - Configurations and customizations for Claude Code's status bar functionality ### General - [CCometixLine - Claude Code Statusline](https://github.com/Haleclipse/CCometixLine) by [Haleclipse](https://github.com/Haleclipse) - A high-performance Claude Code statusline tool written in Rust with Git integration, usage tracking, interactive TUI configuration, and Claude Code enhancement utilities. - [ccstatusline](https://github.com/sirmalloc/ccstatusline) by [sirmalloc](https://github.com/sirmalloc) - A highly customizable status line formatter for Claude Code CLI that displays model info, git branch, token usage, and other metrics in your terminal. - [claude-code-statusline](https://github.com/rz1989s/claude-code-statusline) by [rz1989s](https://github.com/rz1989s) - Enhanced 4-line statusline for Claude Code with themes, cost tracking, and MCP server monitoring. - [claude-powerline](https://github.com/Owloops/claude-powerline) by [Owloops](https://github.com/Owloops) - A vim-style powerline statusline for Claude Code with real-time usage tracking, git integration, custom themes, and more. - [claudia-statusline](https://github.com/hagan/claudia-statusline) by [Hagan Franks](https://github.com/hagan) - High-performance Rust-based statusline for Claude Code with persistent stats tracking, progress bars, and optional cloud sync. Features SQLite-first persistence, git integration, context progress bars, burn rate calculation, XDG-compliant with theme support (dark/light, NO_COLOR).
## Hooks 🪝 > Hooks are a powerful API for Claude Code that allows users to activate commands and run scripts at different points in Claude's agentic lifecycle. ### General - [Britfix](https://github.com/Talieisin/britfix) by [Talieisin](https://github.com/Talieisin) - Claude outputs American spellings by default, which can have an impact on: professional credibility, compliance, documentation, and more. Britfix converts to British English, with a Claude Code hook for automatic conversion as files are written. Context-aware: handles code files intelligently by only converting comments and docstrings, never identifiers or string literals. - [CC Notify](https://github.com/dazuiba/CCNotify) by [dazuiba](https://github.com/dazuiba) - CCNotify provides desktop notifications for Claude Code, alerting you to input needs or task completion, with one-click jumps back to VS Code and task duration display. - [cchooks](https://github.com/GowayLee/cchooks) by [GowayLee](https://github.com/GowayLee) - A lightweight Python SDK with a clean API and good documentation; simplifies the process of writing hooks and integrating them into your codebase, providing a nice abstraction over the JSON configuration files. - [Claude Code Hook Comms (HCOM)](https://github.com/aannoo/claude-hook-comms) by [aannoo](https://github.com/aannoo) - Lightweight CLI tool for real-time communication between Claude Code sub agents using hooks. Enables multi-agent collaboration with @-mention targeting, live dashboard monitoring, and zero-dependency implementation. [NOTE: At the time of posting, this resource is a little unstable - I'm sharing it anyway, because I think it's incredibly promising and creative. I hope by the time you read this, it is production-ready.]. - [claude-code-hooks-sdk](https://github.com/beyondcode/claude-hooks-sdk) by [beyondcode](https://github.com/beyondcode) - A Laravel-inspired PHP SDK for building Claude Code hook responses with a clean, fluent API. This SDK makes it easy to create structured JSON responses for Claude Code hooks using an expressive, chainable interface. - [claude-hooks](https://github.com/johnlindquist/claude-hooks) by [John Lindquist](https://github.com/johnlindquist) - A TypeScript-based system for configuring and customizing Claude Code hooks with a powerful and flexible interface. - [Claudio](https://github.com/ctoth/claudio) by [Christopher Toth](https://github.com/ctoth) - A no-frills little library that adds delightful OS-native sounds to Claude Code via simple hooks. It really sparks joy. - [Dippy](https://github.com/ldayton/Dippy) by [Lily Dayton](https://github.com/ldayton) - Auto-approve safe bash commands using AST-based parsing, while prompting for destructive operations. Solves permission fatigue without disabling safety. Supports Claude Code, Gemini CLI, and Cursor. - [parry](https://github.com/vaporif/parry) by [Dmytro Onypko](https://github.com/vaporif) - Prompt injection scanner for Claude Code hooks. Scans tool inputs and outputs for injection attacks, secrets, and data exfiltration attempts. [NOTE: Early development phase but worth a look.]. - [TDD Guard](https://github.com/nizos/tdd-guard) by [Nizar Selander](https://github.com/nizos) - A hooks-driven system that monitors file operations in real-time and blocks changes that violate TDD principles. - [TypeScript Quality Hooks](https://github.com/bartolli/claude-code-typescript-hooks) by [bartolli](https://github.com/bartolli) - Quality check hook for Node.js TypeScript projects with TypeScript compilation. ESLint auto-fixing, and Prettier formatting. Uses SHA256 config caching for < 5ms validation performance during real-time editing.
## Slash-Commands 🔪 > "Slash Commands are customized, carefully refined prompts that control Claude's behavior in order to perform a specific task" ### General - [/create-hook](https://github.com/omril321/automated-notebooklm/blob/main/.claude/commands/create-hook.md) by [Omri Lavi](https://github.com/omril321) - Slash command for hook creation - intelligently prompts you through the creation process with smart suggestions based on your project setup (TS, Prettier, ESLint...). - [/linux-desktop-slash-commands](https://github.com/danielrosehill/Claude-Code-Linux-Desktop-Slash-Commands) by [Daniel Rosehill](https://github.com/danielrosehill) - A library of slash commands intended specifically to facilitate common and advanced operations on Linux desktop environments (although many would also be useful on Linux servers). Command groups include hardware benchmarking, filesystem organisation, and security posture validation. ### Version Control & Git - [/analyze-issue](https://github.com/jerseycheese/Narraitor/blob/feature/issue-227-ai-suggestions/.claude/commands/analyze-issue.md) by [jerseycheese](https://github.com/jerseycheese) - Fetches GitHub issue details to create comprehensive implementation specifications, analyzing requirements and planning structured approach with clear implementation steps. - [/commit](https://github.com/evmts/tevm-monorepo/blob/main/.claude/commands/commit.md) by [evmts](https://github.com/evmts) - Creates git commits using conventional commit format with appropriate emojis, following project standards and creating descriptive messages that explain the purpose of changes. - [/commit-fast](https://github.com/steadycursor/steadystart/blob/main/.claude/commands/2-commit-fast.md) by [steadycursor](https://github.com/steadycursor) - Automates git commit process by selecting the first suggested message, generating structured commits with consistent formatting while skipping manual confirmation and removing Claude co-Contributorship footer. - [/create-pr](https://github.com/toyamarinyon/giselle/blob/main/.claude/commands/create-pr.md) by [toyamarinyon](https://github.com/toyamarinyon) - Streamlines pull request creation by handling the entire workflow: creating a new branch, committing changes, formatting modified files with Biome, and submitting the PR. - [/create-pull-request](https://github.com/liam-hq/liam/blob/main/.claude/commands/create-pull-request.md) by [liam-hq](https://github.com/liam-hq) - Provides comprehensive PR creation guidance with GitHub CLI, enforcing title conventions, following template structure, and offering concrete command examples with best practices. - [/create-worktrees](https://github.com/evmts/tevm-monorepo/blob/main/.claude/commands/create-worktrees.md) by [evmts](https://github.com/evmts) - Creates git worktrees for all open PRs or specific branches, handling branches with slashes, cleaning up stale worktrees, and supporting custom branch creation for development. - [/fix-github-issue](https://github.com/jeremymailen/kotlinter-gradle/blob/master/.claude/commands/fix-github-issue.md) by [jeremymailen](https://github.com/jeremymailen) - Analyzes and fixes GitHub issues using a structured approach with GitHub CLI for issue details, implementing necessary code changes, running tests, and creating proper commit messages. - [/fix-issue](https://github.com/metabase/metabase/blob/master/.claude/commands/fix-issue.md) by [metabase](https://github.com/metabase) - Addresses GitHub issues by taking issue number as parameter, analyzing context, implementing solution, and testing/validating the fix for proper integration. - [/fix-pr](https://github.com/metabase/metabase/blob/master/.claude/commands/fix-pr.md) by [metabase](https://github.com/metabase) - Fetches and fixes unresolved PR comments by automatically retrieving feedback, addressing reviewer concerns, making targeted code improvements, and streamlining the review process. - [/husky](https://github.com/evmts/tevm-monorepo/blob/main/.claude/commands/husky.md) by [evmts](https://github.com/evmts) - Sets up and manages Husky Git hooks by configuring pre-commit hooks, establishing commit message standards, integrating with linting tools, and ensuring code quality on commits. - [/update-branch-name](https://github.com/giselles-ai/giselle/blob/main/.claude/commands/update-branch-name.md) by [giselles-ai](https://github.com/giselles-ai) - Updates branch names with proper prefixes and formats, enforcing naming conventions, supporting semantic prefixes, and managing remote branch updates. ### Code Analysis & Testing - [/check](https://github.com/rygwdn/slack-tools/blob/main/.claude/commands/check.md) by [rygwdn](https://github.com/rygwdn) - Performs comprehensive code quality and security checks, featuring static analysis integration, security vulnerability scanning, code style enforcement, and detailed reporting. - [/code_analysis](https://github.com/kingler/n8n_agent/blob/main/.claude/commands/code_analysis.md) by [kingler](https://github.com/kingler) - Provides a menu of advanced code analysis commands for deep inspection, including knowledge graph generation, optimization suggestions, and quality evaluation. - [/optimize](https://github.com/to4iki/ai-project-rules/blob/main/.claude/commands/optimize.md) by [to4iki](https://github.com/to4iki) - Analyzes code performance to identify bottlenecks, proposing concrete optimizations with implementation guidance for improved application performance. - [/repro-issue](https://github.com/rzykov/metabase/blob/master/.claude/commands/repro-issue.md) by [rzykov](https://github.com/rzykov) - Creates reproducible test cases for GitHub issues, ensuring tests fail reliably and documenting clear reproduction steps for developers. - [/tdd](https://github.com/zscott/pane/blob/main/.claude/commands/tdd.md) by [zscott](https://github.com/zscott) - Guides development using Test-Driven Development principles, enforcing Red-Green-Refactor discipline, integrating with git workflow, and managing PR creation. - [/tdd-implement](https://github.com/jerseycheese/Narraitor/blob/feature/issue-227-ai-suggestions/.claude/commands/tdd-implement.md) by [jerseycheese](https://github.com/jerseycheese) - Implements Test-Driven Development by analyzing feature requirements, creating tests first (red), implementing minimal passing code (green), and refactoring while maintaining tests. ### Context Loading & Priming - [/context-prime](https://github.com/elizaOS/elizaos.github.io/blob/main/.claude/commands/context-prime.md) by [elizaOS](https://github.com/elizaOS) - Primes Claude with comprehensive project understanding by loading repository structure, setting development context, establishing project goals, and defining collaboration parameters. - [/initref](https://github.com/okuvshynov/cubestat/blob/main/.claude/commands/initref.md) by [okuvshynov](https://github.com/okuvshynov) - Initializes reference documentation structure with standard doc templates, API reference setup, documentation conventions, and placeholder content generation. - [/load-llms-txt](https://github.com/ethpandaops/xatu-data/blob/master/.claude/commands/load-llms-txt.md) by [ethpandaops](https://github.com/ethpandaops) - Loads LLM configuration files to context, importing specific terminology, model configurations, and establishing baseline terminology for AI discussions. - [/load_coo_context](https://github.com/Mjvolk3/torchcell/blob/main/.claude/commands/load_coo_context.md) by [Mjvolk3](https://github.com/Mjvolk3) - References specific files for sparse matrix operations, explains transform usage, compares with previous approaches, and sets data formatting context for development. - [/load_dango_pipeline](https://github.com/Mjvolk3/torchcell/blob/main/.claude/commands/load_dango_pipeline.md) by [Mjvolk3](https://github.com/Mjvolk3) - Sets context for model training by referencing pipeline files, establishing working context, and preparing for pipeline work with relevant documentation. - [/prime](https://github.com/yzyydev/AI-Engineering-Structure/blob/main/.claude/commands/prime.md) by [yzyydev](https://github.com/yzyydev) - Sets up initial project context by viewing directory structure and reading key files, creating standardized context with directory visualization and key documentation focus. - [/rsi](https://github.com/ddisisto/si/blob/main/.claude/commands/rsi.md) by [ddisisto](https://github.com/ddisisto) - Reads all commands and key project files to optimize AI-assisted development by streamlining the process, loading command context, and setting up for better development workflow. ### Documentation & Changelogs - [/add-to-changelog](https://github.com/berrydev-ai/blockdoc-python/blob/main/.claude/commands/add-to-changelog.md) by [berrydev-ai](https://github.com/berrydev-ai) - Adds new entries to changelog files while maintaining format consistency, properly documenting changes, and following established project standards for version tracking. - [/create-docs](https://github.com/jerseycheese/Narraitor/blob/feature/issue-227-ai-suggestions/.claude/commands/create-docs.md) by [jerseycheese](https://github.com/jerseycheese) - Analyzes code structure and purpose to create comprehensive documentation detailing inputs/outputs, behavior, user interaction flows, and edge cases with error handling. - [/docs](https://github.com/slunsford/coffee-analytics/blob/main/.claude/commands/docs.md) by [slunsford](https://github.com/slunsford) - Generates comprehensive documentation that follows project structure, documenting APIs and usage patterns with consistent formatting for better user understanding. - [/explain-issue-fix](https://github.com/hackdays-io/toban-contribution-viewer/blob/main/.claude/commands/explain-issue-fix.md) by [hackdays-io](https://github.com/hackdays-io) - Documents solution approaches for GitHub issues, explaining technical decisions, detailing challenges overcome, and providing implementation context for better understanding. - [/update-docs](https://github.com/Consiliency/Flutter-Structurizr/blob/main/.claude/commands/update-docs.md) by [Consiliency](https://github.com/Consiliency) - Reviews current documentation status, updates implementation progress, reviews phase documents, and maintains documentation consistency across the project. ### CI / Deployment - [/release](https://github.com/kelp/webdown/blob/main/.claude/commands/release.md) by [kelp](https://github.com/kelp) - Manages software releases by updating changelogs, reviewing README changes, evaluating version increments, and documenting release changes for better version tracking. - [/run-ci](https://github.com/hackdays-io/toban-contribution-viewer/blob/main/.claude/commands/run-ci.md) by [hackdays-io](https://github.com/hackdays-io) - Activates virtual environments, runs CI-compatible check scripts, iteratively fixes errors, and ensures all tests pass before completion. ### Project & Task Management - [/create-command](https://github.com/scopecraft/command/blob/main/.claude/commands/create-command.md) by [scopecraft](https://github.com/scopecraft) - Guides Claude through creating new custom commands with proper structure by analyzing requirements, templating commands by category, enforcing command standards, and creating supporting documentation. - [/create-plan](https://github.com/hesreallyhim/inkverse-fork/blob/preserve-claude-resources/.claude/commands/create-plan.md) by [taddyorg](https://github.com/taddyorg) - Generates comprehensive product requirement documents outlining detailed specifications, requirements, and features following standardized document structure and format. *(Removed from origin)* - [/create-prp](https://github.com/Wirasm/claudecode-utils/blob/main/.claude/commands/create-prp.md) by [Wirasm](https://github.com/Wirasm) - Creates product requirement plans by reading PRP methodology, following template structure, creating comprehensive requirements, and structuring product definitions for development. - [/do-issue](https://github.com/jerseycheese/Narraitor/blob/feature/issue-227-ai-suggestions/.claude/commands/do-issue.md) by [jerseycheese](https://github.com/jerseycheese) - Implements GitHub issues with manual review points, following a structured approach with issue number parameter and offering alternative automated mode for efficiency. - [/prd-generator](https://github.com/dredozubov/prd-generator) by [Denis Redozubov](https://github.com/dredozubov) - A Claude Code plugin that generates comprehensive Product Requirements Documents (PRDs) from conversation context. Invoke `/create-prd` after discussing requirements and it produces a complete PRD with all standard sections including Executive Summary, User Stories, MVP Scope, Architecture, Success Criteria, and Implementation Phases. - [/project_hello_w_name](https://github.com/disler/just-prompt/blob/main/.claude/commands/project_hello_w_name.md) by [disler](https://github.com/disler) - Creates customizable greeting components with name input, demonstrating argument passing, component reusability, state management, and user input handling. - [/todo](https://github.com/chrisleyva/todo-slash-command/blob/main/todo.md) by [chrisleyva](https://github.com/chrisleyva) - A convenient command to quickly manage project todo items without leaving the Claude Code interface, featuring due dates, sorting, task prioritization, and comprehensive todo list management. ### Miscellaneous - [/fixing_go_in_graph](https://github.com/Mjvolk3/torchcell/blob/main/.claude/commands/fixing_go_in_graph.md) by [Mjvolk3](https://github.com/Mjvolk3) - Focuses on Gene Ontology annotation integration in graph databases, handling multiple data sources, addressing graph representation issues, and ensuring correct data incorporation. - [/mermaid](https://github.com/GaloyMoney/lana-bank/blob/main/.claude/commands/mermaid.md) by [GaloyMoney](https://github.com/GaloyMoney) - Generates Mermaid diagrams from SQL schema files, creating entity relationship diagrams with table properties, validating diagram compilation, and ensuring complete entity coverage. - [/review_dcell_model](https://github.com/Mjvolk3/torchcell/blob/main/.claude/commands/review_dcell_model.md) by [Mjvolk3](https://github.com/Mjvolk3) - Reviews old Dcell implementation files, comparing with newer Dango model, noting changes over time, and analyzing refactoring approaches for better code organization. - [/use-stepper](https://github.com/zuplo/docs/blob/main/.claude/commands/use-stepper.md) by [zuplo](https://github.com/zuplo) - Reformats documentation to use React Stepper component, transforming heading formats, applying proper indentation, and maintaining markdown compatibility with admonition formatting.
## CLAUDE.md Files 📂 > `CLAUDE.md` files are files that contain important guidelines and context-specific information or instructions that help Claude Code to better understand your project and your coding standards ### Language-Specific - [AI IntelliJ Plugin](https://github.com/didalgolab/ai-intellij-plugin/blob/main/CLAUDE.md) by [didalgolab](https://github.com/didalgolab) - Provides comprehensive Gradle commands for IntelliJ plugin development with platform-specific coding patterns, detailed package structure guidelines, and clear internationalization standards. - [AWS MCP Server](https://github.com/alexei-led/aws-mcp-server/blob/main/CLAUDE.md) by [alexei-led](https://github.com/alexei-led) - Features multiple Python environment setup options with detailed code style guidelines, comprehensive error handling recommendations, and security considerations for AWS CLI interactions. - [DroidconKotlin](https://github.com/touchlab/DroidconKotlin/blob/main/CLAUDE.md) by [touchlab](https://github.com/touchlab) - Delivers comprehensive Gradle commands for cross-platform Kotlin Multiplatform development with clear module structure and practical guidance for dependency injection. - [EDSL](https://github.com/hesreallyhim/awesome-claude-code/blob/main/resources/claude.md-files/EDSL/CLAUDE.md) by [expectedparrot](https://github.com/expectedparrot) - Offers detailed build and test commands with strict code style enforcement, comprehensive testing requirements, and standardized development workflow using Black and mypy. *(Removed from origin)* - [Giselle](https://github.com/giselles-ai/giselle/blob/main/CLAUDE.md) by [giselles-ai](https://github.com/giselles-ai) - Provides detailed build and test commands using pnpm and Vitest with strict code formatting requirements and comprehensive naming conventions for code consistency. - [HASH](https://github.com/hashintel/hash/blob/main/CLAUDE.md) by [hashintel](https://github.com/hashintel) - Features comprehensive repository structure breakdown with strong emphasis on coding standards, detailed Rust documentation guidelines, and systematic PR review process. - [Inkline](https://github.com/inkline/inkline/blob/main/CLAUDE.md) by [inkline](https://github.com/inkline) - Structures development workflow using pnpm with emphasis on TypeScript and Vue 3 Composition API, detailed component creation process, and comprehensive testing recommendations. - [JSBeeb](https://github.com/mattgodbolt/jsbeeb/blob/main/CLAUDE.md) by [mattgodbolt](https://github.com/mattgodbolt) - Provides development guide for JavaScript BBC Micro emulator with build and testing instructions, architecture documentation, and debugging workflows. - [Lamoom Python](https://github.com/LamoomAI/lamoom-python/blob/main/CLAUDE.md) by [LamoomAI](https://github.com/LamoomAI) - Serves as reference for production prompt engineering library with load balancing of AI Models, API documentation, and usage patterns with examples. - [LangGraphJS](https://github.com/langchain-ai/langgraphjs/blob/main/CLAUDE.md) by [langchain-ai](https://github.com/langchain-ai) - Offers comprehensive build and test commands with detailed TypeScript style guidelines, layered library architecture, and monorepo structure using yarn workspaces. - [Metabase](https://github.com/metabase/metabase/blob/master/CLAUDE.md) by [metabase](https://github.com/metabase) - Details workflow for REPL-driven development in Clojure/ClojureScript with emphasis on incremental development, testing, and step-by-step approach for feature implementation. - [SG Cars Trends Backend](https://github.com/sgcarstrends/backend/blob/main/CLAUDE.md) by [sgcarstrends](https://github.com/sgcarstrends) - Provides comprehensive structure for TypeScript monorepo projects with detailed commands for development, testing, deployment, and AWS/Cloudflare integration. - [SPy](https://github.com/spylang/spy/blob/main/CLAUDE.md) by [spylang](https://github.com/spylang) - Enforces strict coding conventions with comprehensive testing guidelines, multiple code compilation options, and backend-specific test decorators for targeted filtering. - [TPL](https://github.com/KarpelesLab/tpl/blob/master/CLAUDE.md) by [KarpelesLab](https://github.com/KarpelesLab) - Details Go project conventions with comprehensive error handling recommendations, table-driven testing approach guidelines, and modernization suggestions for latest Go features. ### Domain-Specific - [Course Builder](https://github.com/badass-courses/course-builder/blob/main/CLAUDE.md) by [badass-courses](https://github.com/badass-courses) - Enables real-time multiplayer capabilities for collaborative course creation with diverse tech stack integration and monorepo architecture using Turborepo. - [Cursor Tools](https://github.com/eastlondoner/cursor-tools/blob/main/CLAUDE.md) by [eastlondoner](https://github.com/eastlondoner) - Creates a versatile AI command interface supporting multiple providers and models with flexible command options and browser automation through "Stagehand" feature. - [Guitar](https://github.com/soramimi/Guitar/blob/master/CLAUDE.md) by [soramimi](https://github.com/soramimi) - Serves as development guide for Guitar Git GUI Client with build commands for various platforms, code style guidelines for contributing, and project structure explanation. - [Network Chronicles](https://github.com/Fimeg/NetworkChronicles/blob/legacy-v1/CLAUDE.md) by [Fimeg](https://github.com/Fimeg) - Presents detailed implementation plan for AI-driven game characters with technical specifications for LLM integration, character guidelines, and service discovery mechanics. - [Pareto Mac](https://github.com/ParetoSecurity/pareto-mac/blob/main/CLAUDE.md) by [ParetoSecurity](https://github.com/ParetoSecurity) - Serves as development guide for Mac security audit tool with build instructions, contribution guidelines, testing procedures, and workflow documentation. - [pre-commit-hooks](https://github.com/aRustyDev/pre-commit-hooks) by [aRustyDev](https://github.com/aRustyDev) - This repository is about pre-commit-hooks in general, but the `CLAUDE.md` and related `.claude/` documentation is exemplary. Thorough but not verbose. Unlike a lot of `CLAUDE.md` files, it doesn't primarily consist in shouting at Claude in all-caps. Great learning resource. Also, hooks. - [SteadyStart](https://github.com/steadycursor/steadystart/blob/main/CLAUDE.md) by [steadycursor](https://github.com/steadycursor) - Clear and direct instructives about style, permissions, Claude's "role", communications, and documentation of Claude Code sessions for other team members to stay abreast. ### Project Scaffolding & MCP - [Basic Memory](https://github.com/basicmachines-co/basic-memory/blob/main/CLAUDE.md) by [basicmachines-co](https://github.com/basicmachines-co) - Presents an innovative AI-human collaboration framework with Model Context Protocol for bidirectional LLM-markdown communication and flexible knowledge structure for complex projects. - [claude-code-mcp-enhanced](https://github.com/grahama1970/claude-code-mcp-enhanced/blob/main/CLAUDE.md) by [grahama1970](https://github.com/grahama1970) - Provides detailed and emphatic instructions for Claude to follow as a coding agent, with testing guidance, code examples, and compliance checks.
## Alternative Clients 📱 > Alternative Clients are alternative UIs and front-ends for interacting with Claude Code, either on mobile or on the desktop. ### General - [Claudable](https://github.com/opactorai/Claudable) by [Ethan Park](https://www.linkedin.com/in/seongil-park/) - Claudable is an open-source web builder that leverages local CLI agents, such as Claude Code and Cursor Agent, to build and deploy products effortlessly. - [claude-esp](https://github.com/phiat/claude-esp) by [phiat](https://github.com/phiat) - Go-based TUI that streams Claude Code's hidden output (thinking, tool calls, subagents) to a separate terminal. Watch multiple sessions simultaneously, filter by content type, and track background tasks. Ideal for debugging or understanding what Claude is doing under the hood without interrupting your main session. - [claude-tmux](https://github.com/nielsgroen/claude-tmux) by [Niels Groeneveld](https://github.com/nielsgroen) - Manage Claude Code within tmux. A tmux popup of all your Claude Code instances, enabling quick switching, status monitoring, session lifecycle management, with git worktree and pull request support. - [crystal](https://github.com/stravu/crystal) by [stravu](https://github.com/stravu) - A full-fledged desktop application for orchestrating, monitoring, and interacting with Claude Code agents. - [Omnara](https://github.com/omnara-ai/omnara) by [Ishaan Sehgal](https://github.com/ishaansehgal99) - A command center for AI agents that syncs Claude Code sessions across terminal, web, and mobile. Allows for remote monitoring, human-in-the-loop interaction, and team collaboration.
## Official Documentation 🏛️ > Links to some of Anthropic's terrific documentation and resources regarding Claude Code ### General - [Anthropic Documentation](https://docs.claude.com/en/home) by [Anthropic](https://github.com/anthropics) - The official documentation for Claude Code, including installation instructions, usage guidelines, API references, tutorials, examples, loads of information that I won't list individually. Like Claude Code, the documentation is frequently updated. - [Anthropic Quickstarts](https://github.com/anthropics/claude-quickstarts) by [Anthropic](https://github.com/anthropics) - Offers comprehensive development guides for three distinct AI-powered demo projects with standardized workflows, strict code style guidelines, and containerization instructions. - [Claude Code GitHub Actions](https://github.com/anthropics/claude-code-action/tree/main/examples) by [Anthropic](https://github.com/anthropics) - Official GitHub Actions integration for Claude Code with examples and documentation for automating AI-powered workflows in CI/CD pipelines. ## Contributing [🔝](#awesome-claude-code) ### **[Recommend a new resource here!](https://github.com/hesreallyhim/awesome-claude-code/issues/new?template=recommend-resource.yml)** Recommending a resource for the list is very simple, and the automated system handles everything for you. Please do not open a PR to submit a recommendation - the only person who is allowed to submit PRs to this repo is Claude. Make sure that you have read the CONTRIBUTING.md document and CODE_OF_CONDUCT.md before you submit a recommendation. For suggestions about the repository itself, please [open a repository enhancement issue](https://github.com/hesreallyhim/awesome-claude-code/issues/new?template=repository-enhancement.yml). This project is released with a Code of Conduct. By participating, you agree to abide by its terms. And although I take strong measures to uphold the quality and safety of this list, I take no responsibility or liability for anything that might happen as a result of these third-party resources. ## Growing thanks to you [![Stargazers over time](https://starchart.cc/hesreallyhim/awesome-claude-code.svg?variant=adaptive)](https://starchart.cc/hesreallyhim/awesome-claude-code) ## License This list is licensed under [Creative Commons CC BY-NC-ND 4.0](https://creativecommons.org/licenses/by-nc-nd/4.0/) - this means you are welcome to fork, clone, copy and redistribute the list, provided you include appropriate attribution; however you are not permitted to distribute any modified versions or to use it for any commercial purposes. This is to prevent disregard for the licenses of the authors whose resources are listed here. Please note that all resources included in this list have their own license terms. ================================================ FILE: README_ALTERNATIVES/README_AWESOME.md ================================================

Pick Your Style:

Awesome Extra Classic Flat

Awesome Claude Code

# Awesome Claude Code [![Awesome](https://awesome.re/badge.svg)](https://awesome.re) > A selectively curated list of skills, agents, plugins, hooks, and other amazing tools for enhancing your [Claude Code](https://docs.anthropic.com/en/docs/claude-code) workflow.
Featured Claude Code Projects
## Latest Additions - [Claude Scientific Skills](https://github.com/K-Dense-AI/claude-scientific-skills) by [K-Dense](https://github.com/K-Dense-AI/) - "A set of ready-to-use Agent Skills for research, science, engineering, analysis, finance and writing." That's their description - modest, simple. That's how you can tell this is really one of the best skills repos on GitHub. If you've ever thought about getting a PhD... just read all of these documents instead. Also I think it IS an AI agent or something? Awesome. - [parry](https://github.com/vaporif/parry) by [Dmytro Onypko](https://github.com/vaporif) - Prompt injection scanner for Claude Code hooks. Scans tool inputs and outputs for injection attacks, secrets, and data exfiltration attempts. [NOTE: Early development phase but worth a look.]. - [Dippy](https://github.com/ldayton/Dippy) by [Lily Dayton](https://github.com/ldayton) - Auto-approve safe bash commands using AST-based parsing, while prompting for destructive operations. Solves permission fatigue without disabling safety. Supports Claude Code, Gemini CLI, and Cursor. - [sudocode](https://github.com/sudocode-ai/sudocode) by [ssh-randy](https://github.com/ssh-randy) - Lightweight agent orchestration dev tool that lives in your repo. Integrates with various specification frameworks. It's giving Jira. - [claude-tmux](https://github.com/nielsgroen/claude-tmux) by [Niels Groeneveld](https://github.com/nielsgroen) - Manage Claude Code within tmux. A tmux popup of all your Claude Code instances, enabling quick switching, status monitoring, session lifecycle management, with git worktree and pull request support. - [claude-esp](https://github.com/phiat/claude-esp) by [phiat](https://github.com/phiat) - Go-based TUI that streams Claude Code's hidden output (thinking, tool calls, subagents) to a separate terminal. Watch multiple sessions simultaneously, filter by content type, and track background tasks. Ideal for debugging or understanding what Claude is doing under the hood without interrupting your main session. ## Contents - [Agent Skills 🤖](#agent-skills-) - [General](#general) - [Workflows & Knowledge Guides 🧠](#workflows--knowledge-guides-) - [General](#general-1) - [Ralph Wiggum](#ralph-wiggum) - [Tooling 🧰](#tooling-) - [General](#general-2) - [IDE Integrations](#ide-integrations) - [Usage Monitors](#usage-monitors) - [Orchestrators](#orchestrators) - [Config Managers](#config-managers) - [Status Lines 📊](#status-lines-) - [General](#general-3) - [Hooks 🪝](#hooks-) - [General](#general-4) - [Slash-Commands 🔪](#slash-commands-) - [General](#general-5) - [Version Control & Git](#version-control--git) - [Code Analysis & Testing](#code-analysis--testing) - [Context Loading & Priming](#context-loading--priming) - [Documentation & Changelogs](#documentation--changelogs) - [CI / Deployment](#ci--deployment) - [Project & Task Management](#project--task-management) - [Miscellaneous](#miscellaneous) - [CLAUDE.md Files 📂](#claudemd-files-) - [Language-Specific](#language-specific) - [Domain-Specific](#domain-specific) - [Project Scaffolding & MCP](#project-scaffolding--mcp) - [Alternative Clients 📱](#alternative-clients-) - [General](#general-6) - [Official Documentation 🏛️](#official-documentation-%EF%B8%8F) - [General](#general-7) ## Agent Skills 🤖 > Agent skills are model-controlled configurations (files, scripts, resources, etc.) that enable Claude Code to perform specialized tasks requiring specific knowledge or capabilities. ### General - [AgentSys](https://github.com/avifenesh/agentsys) by [avifenesh](https://github.com/avifenesh) - Workflow automation system for Claude with a group of useful plugins, agents, and skills. Automates task-to-production workflows, PR management, code cleanup, performance investigation, drift detection, and multi-agent code review. Includes [agnix](https://github.com/avifenesh/agnix) for linting agent configurations. Built on thousands of lines of code with thousands of tests. Uses deterministic detection (regex, AST) with LLM judgment for efficiency. Used on many production systems. - [AI Agent, AI Spy](https://youtu.be/0ANECpNdt-4) by [Whittaker & Tiwari](https://signalfoundation.org/) - Members from the Signal Foundation with some really great tips and tricks on how to turn your operating system into an instrument of total surveillance, and why some companies are doing this really awesome thing. [warning: YouTube link]. - [Book Factory](https://github.com/robertguss/claude-skills) by [Robert Guss](https://github.com/robertguss) - A comprehensive pipeline of Skills that replicates traditional publishing infrastructure for nonfiction book creation using specialized Claude skills. - [cc-devops-skills](https://github.com/akin-ozer/cc-devops-skills) by [akin-ozer](https://github.com/akin-ozer) - Immensely detailed set of skills for DevOps Engineers (or anyone who has to deploy code, really). Works with validations, generators, shell scripts and CLI tools to create high quality IaC code for about any platform you've ever struggled painfully to work with. Worth downloading even just as a source of documentation. - [Claude Code Agents](https://github.com/undeadlist/claude-code-agents) by [Paul - UndeadList](https://github.com/undeadlist) - Comprehensive E2E development workflow with helpful Claude Code subagent prompts for solo devs. Run multiple auditors in parallel, automate fix cycles with micro-checkpoint protocols, and do browser-based QA. Includes strict protocols to prevent AI going rogue. - [Claude Codex Settings](https://github.com/fcakyon/claude-codex-settings) by [fatih akyon](https://github.com/fcakyon) - A well-organized, well-written set of plugins covering core developer activities, such as working with common cloud platforms like GitHub, Azure, MongoDB, and popular services such as Tavily, Playwright, and more. Clear, not overly-opinionated, and compatible with a few other providers. - [Claude Mountaineering Skills](https://github.com/dreamiurg/claude-mountaineering-skills) by [Dmytro Gaivoronsky](https://github.com/dreamiurg) - Claude Code skill that automates mountain route research for North American peaks. Aggregates data from 10+ mountaineering sources like Mountaineers.org, PeakBagger.com and SummitPost.com to generate detailed route beta reports with weather, avalanche conditions, and trip reports. - [Claude Scientific Skills](https://github.com/K-Dense-AI/claude-scientific-skills) by [K-Dense](https://github.com/K-Dense-AI/) - "A set of ready-to-use Agent Skills for research, science, engineering, analysis, finance and writing." That's their description - modest, simple. That's how you can tell this is really one of the best skills repos on GitHub. If you've ever thought about getting a PhD... just read all of these documents instead. Also I think it IS an AI agent or something? Awesome. - [Codex Skill](https://github.com/skills-directory/skill-codex) by [klaudworks](https://github.com/klaudworks) - Enables users to prompt codex from claude code. Unlike the raw codex mcp server, this skill infers parameters such as model, reasoning effort, sandboxing from your prompt or asks you to specify them. It also simplifies continuing prior codex sessions so that codex can continue with the prior context. - [Compound Engineering Plugin](https://github.com/EveryInc/compound-engineering-plugin) by [EveryInc](https://github.com/EveryInc) - A very pragmatic set of well-designed agents, skills, and commands, built around a discipline of turning past mistakes and errors into lessons and opportunities for future growth and improvement. Good documentation. - [Context Engineering Kit](https://github.com/NeoLabHQ/context-engineering-kit) by [Vlad Goncharov](https://github.com/LeoVS09) - Hand-crafted collection of advanced context engineering techniques and patterns with minimal token footprint focused on improving agent result quality. - [Everything Claude Code](https://github.com/affaan-m/everything-claude-code) by [Affaan Mustafa](https://github.com/affaan-m/) - Top-notch, well-written resources covering "just about everything" from core engineering domains. What's nice about this "everything-" store is most of the resources have significant standalone value and unlike some all-encompassing frameworks, although you can opt in to the author's own specific workflow patterns if you choose, the individual resources offer exemplary patterns in (just about) every Claude Code feature you can find (apologies to the Output Styles devotees). - [Fullstack Dev Skills](https://github.com/jeffallan/claude-skills) by [jeffallan](https://github.com/jeffallan) - A comprehensive Claude Code plugin with 65 specialized skills covering full-stack development across a wide range of specific frameworks. Features 9 project workflow commands for Jira/Confluence integration and, notably, an interesting approach to context engineering via a `/common-ground` command that surfaces Claude's hidden assumptions about your project. This is a smart thing to do. - [read-only-postgres](https://github.com/jawwadfirdousi/agent-skills) by [jawwadfirdousi](https://github.com/jawwadfirdousi) - Read-only PostgreSQL query skill for Claude Code. Executes SELECT/SHOW/EXPLAIN/WITH queries across configured databases with strict validation, timeouts, and row limits. Supports multiple connections with descriptions for database selection. - [Superpowers](https://github.com/obra/superpowers) by [Jesse Vincent](https://github.com/obra) - A strong bundle of core competencies for software engineering, with good coverage of a large portion of the SDLC - from planning, reviewing, testing, debugging... Well written, well organized, and adaptable. The author refers to them as "superpowers", but many of them are just consolidating engineering best practices - which sometimes does feel like a superpower when working with Claude Code. - [Trail of Bits Security Skills](https://github.com/trailofbits/skills) by [Trail of Bits](https://github.com/trailofbits) - A very professional collection of over a dozen security-focused skills for code auditing and vulnerability detection. Includes skills for static analysis with CodeQL and Semgrep, variant analysis across codebases, fix verification, and differential code review. - [TÂCHES Claude Code Resources](https://github.com/glittercowboy/taches-cc-resources) by [TÂCHES](https://github.com/glittercowboy) - A well-balanced, "down-to-Earth" set of sub agents, skills, and commands, that are well-organized, easy to read, and a healthy focus on "meta"-skills/agents, like "skill-auditor", hook creation, etc. - the kind of things you can adapt to your workflow, and not the other way around. - [Web Assets Generator Skill](https://github.com/alonw0/web-asset-generator) by [Alon Wolenitz](https://github.com/alonw0) - Easily generate web assets from Claude Code including favicons, app icons (PWA), and social media meta images (Open Graph) for Facebook, Twitter, WhatsApp, and LinkedIn. Handles image resizing, text-to-image generation, emojis, and provides proper HTML meta tags.
## Workflows & Knowledge Guides 🧠 > A workflow is a tightly coupled set of Claude Code-native resources that facilitate specific projects ### General - [AB Method](https://github.com/ayoubben18/ab-method) by [Ayoub Bensalah](https://github.com/ayoubben18) - A principled, spec-driven workflow that transforms large problems into focused, incremental missions using Claude Code's specialized sub agents. Includes slash-commands, sub agents, and specialized workflows designed for specific parts of the SDLC. - [Agentic Workflow Patterns](https://github.com/ThibautMelen/agentic-workflow-patterns) by [ThibautMelen](https://github.com/ThibautMelen) - A comprehensive and well-documented collection of agentic patterns from Anthropic docs, with colorful Mermaid diagrams and code examples for each pattern. Covers Subagent Orchestration, Progressive Skills, Parallel Tool Calling, Master-Clone Architecture, Wizard Workflows, and more. Also compatible with other providers. - [Blogging Platform Instructions](https://github.com/cloudartisan/cloudartisan.github.io/tree/main/.claude/commands) by [cloudartisan](https://github.com/cloudartisan) - Provides a well-structured set of commands for publishing and maintaining a blogging platform, including commands for creating posts, managing categories, and handling media files. - [Claude Code Documentation Mirror](https://github.com/ericbuess/claude-code-docs) by [Eric Buess](https://github.com/ericbuess) - A mirror of the Anthropic © PBC documentation pages for Claude Code, updated every few hours. Can come in handy when trying to stay on top of the ever-expanding feature-set of Dr. Claw D. Code, Ph.D. - [Claude Code Handbook](https://nikiforovall.blog/claude-code-rules/) by [nikiforovall](https://github.com/nikiforovall) - Collection of best practices, tips, and techniques for Claude Code development workflows, enhanced with distributable plugins. - [Claude Code Infrastructure Showcase](https://github.com/diet103/claude-code-infrastructure-showcase) by [diet103](https://github.com/diet103) - A remarkably innovative approach to working with Skills, the centerpiece of which being a technique that leverages hooks to ensure that Claude intelligently selects and activates the appropriate Skill given the current context. Well-documented and adaptable to different projects and workflows. - [Claude Code PM](https://github.com/automazeio/ccpm) by [Ran Aroussi](https://github.com/ranaroussi) - Really comprehensive and feature-packed project-management workflow for Claude Code. Numerous specialized agents, slash-commands, and strong documentation. - [Claude Code Repos Index](https://github.com/danielrosehill/Claude-Code-Repos-Index) by [Daniel Rosehill](https://github.com/danielrosehill) - This is either the work of a prolific genius, or a very clever bot (or both), although it hardly matters because the quality is so good - an index of 75+ Claude Code repositories published by the author - and I'm not talking about slop. CMS, system design, deep research, IoT, agentic workflows, server management, personal health... If you spot the lie, let me know, otherwise please check these out. - [Claude Code System Prompts](https://github.com/Piebald-AI/claude-code-system-prompts) by [Piebald AI](https://github.com/Piebald-AI) - All parts of Claude Code's system prompt, including builtin tool descriptions, sub agent prompts (Plan/Explore/Task), utility prompts (CLAUDE.md, compact, Bash cmd, security review, agent creation, etc.). Updated for each Claude Code version. - [Claude Code Tips](https://github.com/ykdojo/claude-code-tips) by [ykdojo](https://github.com/ykdojo) - A nice variety of 35+ brief but information-dense Claude Code tips covering voice input, system prompt patching, container workflows for risky tasks, conversation cloning(!), multi-model orchestration with Gemini CLI, and plenty more. Nice demos, working scripts, a plugin, I'd say this probably has a little something for everyone. - [Claude Code Ultimate Guide](https://github.com/FlorianBruniaux/claude-code-ultimate-guide) by [Florian BRUNIAUX](https://www.linkedin.com/in/florian-bruniaux-43408b83/) - A tremendous feat of documentation, this guide covers Claude Code from beginner to power user, with production-ready templates for Claude Code features, guides on agentic workflows, and a lot of great learning materials, including quizzes and a handy "cheatsheet". Whether it's the "ultimate" guide to Claude Code will be up to the reader, but a valuable resource nonetheless (as with all documentation sites, make sure it's up to date before you bet the farm). - [Claude CodePro](https://github.com/maxritter/claude-codepro) by [Max Ritter](https://www.maxritter.net) - Professional development environment for Claude Code with spec-driven workflow, TDD enforcement, cross-session memory, semantic search, quality hooks, and modular rules integration. A bit "heavyweight" but feature-packed and has wide coverage. - [claude-code-docs](https://github.com/costiash/claude-code-docs) by [Constantin Shafranski](https://github.com/costiash) - A mirror of the Anthropic© PBC documentation site for Claude/Code, but with bonus features like full-text search and query-time updates - a nice companion to `claude-code-docs` for up-to-the-minute, fully-indexed information so that Claude Code can read about itself. - [ClaudoPro Directory](https://github.com/JSONbored/claudepro-directory) by [ghost](https://github.com/JSONbored) - Well-crafted, wide selection of Claude Code hooks, slash commands, subagent files, and more, covering a range of specialized tasks and workflows. Better resources than your average "Claude-template-for-everything" site. - [Context Priming](https://github.com/disler/just-prompt/tree/main/.claude/commands) by [disler](https://github.com/disler) - Provides a systematic approach to priming Claude Code with comprehensive project context through specialized commands for different project scenarios and development contexts. - [Design Review Workflow](https://github.com/OneRedOak/claude-code-workflows/tree/main/design-review) by [Patrick Ellis](https://github.com/OneRedOak) - A tailored workflow for enabling automated UI/UX design review, including specialized sub agents, slash commands, `CLAUDE.md` excerpts, and more. Covers a broad range of criteria from responsive design to accessibility. - [Laravel TALL Stack AI Development Starter Kit](https://github.com/tott/laravel-tall-claude-ai-configs) by [tott](https://github.com/tott) - Transform your Laravel TALL (Tailwind, AlpineJS, Laravel, Livewire) stack development with comprehensive Claude Code configurations that provide intelligent assistance, systematic workflows, and domain expert consultation. - [Learn Claude Code](https://github.com/shareAI-lab/learn-claude-code) by [shareAI-Lab](https://github.com/shareAI-lab/) - A really interesting analysis of how coding agents like Claude Code are designed. It attempts to break an agent down into its fundamental parts and reconstruct it with minimal code. Great learning resource. Final product is a rudimentary agent with skills, sub-agents, and a todo-list in roughly a few hundred lines of Python. - [learn-faster-kit](https://github.com/cheukyin175/learn-faster-kit) by [Hugo Lau](https://github.com/cheukyin175) - A creative educational framework for Claude Code, inspired by the "FASTER" approach to self-teaching. Ships with a variety of agents, slash commands, and tools that enable Claude Code to help you progress at your own pace, employing well-established pedagogical techniques like active learning and spaced repetition. - [n8n_agent](https://github.com/kingler/n8n_agent/tree/main/.claude/commands) by [kingler](https://github.com/kingler) - Amazing comprehensive set of comments for code analysis, QA, design, documentation, project structure, project management, optimization, and many more. - [Project Bootstrapping and Task Management](https://github.com/steadycursor/steadystart/tree/main/.claude/commands) by [steadycursor](https://github.com/steadycursor) - Provides a structured set of commands for bootstrapping and managing a new project, including meta-commands for creating and editing custom slash-commands. - [Project Management, Implementation, Planning, and Release](https://github.com/scopecraft/command/tree/main/.claude/commands) by [scopecraft](https://github.com/scopecraft) - Really comprehensive set of commands for all aspects of SDLC. - [Project Workflow System](https://github.com/harperreed/dotfiles/tree/master/.claude/commands) by [harperreed](https://github.com/harperreed) - A set of commands that provide a comprehensive workflow system for managing projects, including task management, code review, and deployment processes. - [RIPER Workflow](https://github.com/tony/claude-code-riper-5) by [Tony Narlock](https://tony.sh) - Structured development workflow enforcing separation between Research, Innovate, Plan, Execute, and Review phases. Features consolidated subagents for context-efficiency, branch-aware memory bank, and strict mode enforcement for guided development. - [Shipping Real Code w/ Claude](https://diwank.space/field-notes-from-shipping-real-code-with-claude) by [Diwank](https://github.com/creatorrr) - A detailed blog post explaining the author's process for shipping a product with Claude Code, including CLAUDE.md files and other interesting resources. - [Simone](https://github.com/Helmi/claude-simone) by [Helmi](https://github.com/Helmi) - A broader project management workflow for Claude Code that encompasses not just a set of commands, but a system of documents, guidelines, and processes to facilitate project planning and execution. ### Ralph Wiggum - [awesome-ralph](https://github.com/snwfdhmp/awesome-ralph) by [Martin Joly](https://github.com/snwfdhmp) - A curated list of resources about Ralph, the AI coding technique that runs AI coding agents in automated loops until specifications are fulfilled. - [Ralph for Claude Code](https://github.com/frankbria/ralph-claude-code) by [Frank Bria](https://github.com/frankbria) - An autonomous AI development framework that enables Claude Code to work iteratively on projects until completion. Features intelligent exit detection, rate limiting, circuit breaker patterns, and comprehensive safety guardrails to prevent infinite loops and API overuse. Built with Bash, integrated with tmux for live monitoring, and includes 75+ comprehensive tests. - [Ralph Wiggum Marketer](https://github.com/muratcankoylan/ralph-wiggum-marketer) by [Muratcan Koylan](https://github.com/muratcankoylan) - A Claude Code plugin that provides an autonomous AI copywriter, integrating the Ralph loop with customized knowledge bases for market research agents. The agents do the research, Ralph writes the copy, you stay in bed. Whether or not you practice Ralph-Driven Development (RDD), I think these projects are interesting and creative explorations of general agentic patterns. - [ralph-orchestrator](https://github.com/mikeyobrien/ralph-orchestrator) by [mikeyobrien](https://github.com/mikeyobrien) - Ralph Orchestrator implements the simple but effective "Ralph Wiggum" technique for autonomous task completion, continuously running an AI agent against a prompt file until the task is marked as complete or limits are reached. This implementation provides a robust, well-tested, and feature-complete orchestration system for AI-driven development. Also cited in the Anthropic Ralph plugin documentation. - [ralph-wiggum-bdd](https://github.com/marcindulak/ralph-wiggum-bdd) by [marcindulak](https://github.com/marcindulak) - A standalone Bash script for Behavior-Driven Development with Ralph Wiggum Loop. In principle, while running unattended, the script can keep code and requirements in sync, but in practice it still requires interactive human supervision, so it supports both modes. The script is standalone and can be modified and committed into your project. - [The Ralph Playbook](https://github.com/ClaytonFarr/ralph-playbook) by [Clayton Farr](https://github.com/ClaytonFarr) - A remarkably detailed and comprehensive guide to the Ralph Wiggum technique, featuring well-written theoretical commentary paired with practical guidelines and advice.
## Tooling 🧰 > Tooling denotes applications that are built on top of Claude Code and consist of more components than slash-commands and `CLAUDE.md` files ### General - [cc-sessions](https://github.com/GWUDCAP/cc-sessions) by [toastdev](https://github.com/satoastshi) - An opinionated approach to productive development with Claude Code. - [cc-tools](https://github.com/Veraticus/cc-tools) by [Josh Symonds](https://github.com/Veraticus) - High-performance Go implementation of Claude Code hooks and utilities. Provides smart linting, testing, and statusline generation with minimal overhead. - [ccexp](https://github.com/nyatinte/ccexp) by [nyatinte](https://github.com/nyatinte) - Interactive CLI tool for discovering and managing Claude Code configuration files and slash commands with a beautiful terminal UI. - [cchistory](https://github.com/eckardt/cchistory) by [eckardt](https://github.com/eckardt) - Like the shell history command but for your Claude Code sessions. Easily list all Bash or "Bash-mode" (`!`) commands Claude Code ran in a session for reference. - [cclogviewer](https://github.com/Brads3290/cclogviewer) by [Brad S.](https://github.com/Brads3290) - A humble but handy utility for viewing Claude Code `.jsonl` conversation files in a pretty HTML UI. - [Claude Code Templates](https://github.com/davila7/claude-code-templates) by [Daniel Avila](https://github.com/davila7) - Incredibly awesome collection of resources from every category in this list, presented with a neatly polished UI, great features like usage dashboard, analytics, and everything from slash commands to hooks to agents. An awesome companion for this awesome list. - [Claude Composer](https://github.com/possibilities/claude-composer) by [Mike Bannister](https://github.com/possibilities) - A tool that adds small enhancements to Claude Code. - [Claude Hub](https://github.com/claude-did-this/claude-hub) by [Claude Did This](https://github.com/claude-did-this) - A webhook service that connects Claude Code to GitHub repositories, enabling AI-powered code assistance directly through pull requests and issues. This integration allows Claude to analyze repositories, answer technical questions, and help developers understand and improve their codebase through simple @mentions. - [Claude Session Restore](https://github.com/ZENG3LD/claude-session-restore) by [ZENG3LD](https://github.com/ZENG3LD) - Efficiently restore context from previous Claude Code sessions by analyzing session files and git history. Features multi-factor data collection across numerous Claude Code capacities with time-based filtering. Uses tail-based parsing for efficient handling of large session files up to 2GB. Includes both a CLI tool for manual analysis and a Claude Code skill for automatic session restoration. - [claude-code-tools](https://github.com/pchalasani/claude-code-tools) by [Prasad Chalasani](https://github.com/pchalasani) - Well-crafted toolset for session continuity, featuring skills/commands to avoid compaction and recover context across sessions with cross-agent handoff between Claude Code and Codex CLI. Includes a fast Rust/Tantivy-powered full-text session search (TUI for humans, skill/CLI for agents), tmux-cli skill + command for interacting with scripts and CLI agents, and safety hooks to block dangerous commands. - [claude-starter-kit](https://github.com/serpro69/claude-starter-kit) by [serpro69](https://github.com/serpro69) - This is a starter template repository designed to provide a complete development environment for Claude-Code with pre-configured MCP servers and tools for AI-powered development workflows. The repository is intentionally minimal, containing only configuration templates for three primary systems: Claude Code, Serena, and Task Master. - [claudekit](https://github.com/carlrannaberg/claudekit) by [Carl Rannaberg](https://github.com/carlrannaberg) - Impressive CLI toolkit providing auto-save checkpointing, code quality hooks, specification generation and execution, and 20+ specialized subagents including oracle (gpt-5), code-reviewer (6-aspect deep analysis), ai-sdk-expert (Vercel AI SDK), typescript-expert and many more for Claude Code workflows. - [Container Use](https://github.com/dagger/container-use) by [dagger](https://github.com/dagger) - Development environments for coding agents. Enable multiple agents to work safely and independently with your preferred stack. - [ContextKit](https://github.com/FlineDev/ContextKit) by [Cihat Gündüz](https://github.com/Jeehut) - A systematic development framework that transforms Claude Code into a proactive development partner. Features 4-phase planning methodology, specialized quality agents, and structured workflows that help AI produce production-ready code on first try. - [recall](https://github.com/zippoxer/recall) by [zippoxer](https://github.com/zippoxer) - Full-text search your Claude Code sessions. Run `recall` in terminal, type to search, Enter to resume. Alternative to `claude --resume`. - [Rulesync](https://github.com/dyoshikawa/rulesync) by [dyoshikawa](https://github.com/dyoshikawa) - A Node.js CLI tool that automatically generates configs (rules, ignore files, MCP servers, commands, and subagents) for various AI coding agents. Rulesync can convert configs between Claude Code and other AI agents in both directions. - [run-claude-docker](https://github.com/icanhasjonas/run-claude-docker) by [Jonas](https://github.com/icanhasjonas/) - A self-contained Docker runner that forwards your current workspace into a safe(r) isolated docker container, where you still have access to your Claude Code settings, authentication, ssh agent, pgp, optionally aws keys etc. - [stt-mcp-server-linux](https://github.com/marcindulak/stt-mcp-server-linux) by [marcindulak](https://github.com/marcindulak) - A push-to-talk speech transcription setup for Linux using a Python MCP server. Runs locally in Docker with no external API calls. Your speech is recorded, transcribed into text, and then sent to Claude running in a Tmux session. - [SuperClaude](https://github.com/SuperClaude-Org/SuperClaude_Framework) by [SuperClaude-Org](https://github.com/SuperClaude-Org) - A versatile configuration framework that enhances Claude Code with specialized commands, cognitive personas, and development methodologies, such as "Introspection" and "Orchestration". - [tweakcc](https://github.com/Piebald-AI/tweakcc) by [Piebald-AI](https://github.com/Piebald-AI) - Command-line tool to customize your Claude Code styling. - [Vibe-Log](https://github.com/vibe-log/vibe-log-cli) by [Vibe-Log](https://github.com/vibe-log) - Analyzes your Claude Code prompts locally (using CC), provides intelligent session analysis and actionable strategic guidance - works in the statusline and produces very pretty HTML reports as well. Easy to install and remove. - [viwo-cli](https://github.com/OverseedAI/viwo) by [Hal Shin](https://github.com/hal-shin) - Run Claude Code in a Docker container with git worktrees as volume mounts to enable safer usage of `--dangerously-skip-permissions` for frictionless one-shotting prompts. Allows users to spin up multiple instances of Claude Code in the background easily with reduced permission fatigue. - [VoiceMode MCP](https://github.com/mbailey/voicemode) by [Mike Bailey](https://github.com/mbailey) - VoiceMode MCP brings natural conversations to Claude Code. It supports any OpenAI API compatible voice services and installs free and open source voice services (Whisper.cpp and Kokoro-FastAPI). ### IDE Integrations - [Claude Code Chat](https://marketplace.visualstudio.com/items?itemName=AndrePimenta.claude-code-chat) by [andrepimenta](https://github.com/andrepimenta) - An elegant and user-friendly Claude Code chat interface for VS Code. - [claude-code-ide.el](https://github.com/manzaltu/claude-code-ide.el) by [manzaltu](https://github.com/manzaltu) - claude-code-ide.el integrates Claude Code with Emacs, like Anthropic’s VS Code/IntelliJ extensions. It shows ediff-based code suggestions, pulls LSP/flymake/flycheck diagnostics, and tracks buffer context. It adds an extensible MCP tool support for symbol refs/defs, project metadata, and tree-sitter AST queries. - [claude-code.el](https://github.com/stevemolitor/claude-code.el) by [stevemolitor](https://github.com/stevemolitor) - An Emacs interface for Claude Code CLI. - [claude-code.nvim](https://github.com/greggh/claude-code.nvim) by [greggh](https://github.com/greggh) - A seamless integration between Claude Code AI assistant and Neovim. - [Claudix - Claude Code for VSCode](https://github.com/Haleclipse/Claudix) by [Haleclipse](https://github.com/Haleclipse) - A VSCode extension that brings Claude Code directly into your editor with interactive chat interface, session management, intelligent file operations, terminal execution, and real-time streaming responses. Built with Vue 3, TypeScript. ### Usage Monitors - [CC Usage](https://github.com/ryoppippi/ccusage) by [ryoppippi](https://github.com/ryoppippi) - Handy CLI tool for managing and analyzing Claude Code usage, based on analyzing local Claude Code logs. Presents a nice dashboard regarding cost information, token consumption, etc. - [ccflare](https://github.com/snipeship/ccflare) by [snipeship](https://github.com/snipeship) - Claude Code usage dashboard with a web-UI that would put Tableau to shame. Thoroughly comprehensive metrics, frictionless setup, detailed logging, really really nice UI. - [ccflare -> **better-ccflare**](https://github.com/tombii/better-ccflare/) by [tombii](https://github.com/tombii) - A well-maintained and feature-enhanced fork of the glorious `ccflare` usage dashboard by @snipeship (which at the time of writing has not had an update in a few months). `better-ccflare` builds on this foundation with some performance enhancements, extended provider support, bug fixes, Docker deployment, and more. - [Claude Code Usage Monitor](https://github.com/Maciek-roboblog/Claude-Code-Usage-Monitor) by [Maciek-roboblog](https://github.com/Maciek-roboblog) - A real-time terminal-based tool for monitoring Claude Code token usage. It shows live token consumption, burn rate, and predictions for token depletion. Features include visual progress bars, session-aware analytics, and support for multiple subscription plans. - [Claudex](https://github.com/kunwar-shah/claudex) by [Kunwar Shah](https://github.com/kunwar-shah) - Claudex - A web-based browser for exploring your Claude Code conversation history across projects. Indexes your codebase for full-text search. Nice, easy-to-navigate UI. Simple dashboard interface for high-level analytics, and multiple export options as well. (And completely local w/ no telemetry!). - [viberank](https://github.com/sculptdotfun/viberank) by [nikshepsvn](https://github.com/nikshepsvn) - A community-driven leaderboard tool that enables developers to visualize, track, and compete based on their Claude Code usage statistics. It features robust data analytics, GitHub OAuth, data validation, and user-friendly CLI/web submission methods. ### Orchestrators - [Auto-Claude](https://github.com/AndyMik90/Auto-Claude) by [AndyMik90](https://github.com/AndyMik90) - Autonomous multi-agent coding framework for Claude Code (Claude Agent SDK) that integrates the full SDLC - "plans, builds, and validates software for you". Features a slick kanban-style UI and a well-designed but not over-engineered agent orchestration system. - [Claude Code Flow](https://github.com/ruvnet/claude-code-flow) by [ruvnet](https://github.com/ruvnet) - This mode serves as a code-first orchestration layer, enabling Claude to write, edit, test, and optimize code autonomously across recursive agent cycles. - [Claude Squad](https://github.com/smtg-ai/claude-squad) by [smtg-ai](https://github.com/smtg-ai) - Claude Squad is a terminal app that manages multiple Claude Code, Codex (and other local agents including Aider) in separate workspaces, allowing you to work on multiple tasks simultaneously. - [Claude Swarm](https://github.com/parruda/claude-swarm) by [parruda](https://github.com/parruda) - Launch Claude Code session that is connected to a swarm of Claude Code Agents. - [Claude Task Master](https://github.com/eyaltoledano/claude-task-master) by [eyaltoledano](https://github.com/eyaltoledano) - A task management system for AI-driven development with Claude, designed to work seamlessly with Cursor AI. - [Claude Task Runner](https://github.com/grahama1970/claude-task-runner) by [grahama1970](https://github.com/grahama1970) - A specialized tool to manage context isolation and focused task execution with Claude Code, solving the critical challenge of context length limitations and task focus when working with Claude on complex, multi-step projects. - [Happy Coder](https://github.com/slopus/happy) by [GrocerPublishAgent](https://peoplesgrocers.com/en/projects) - Spawn and control multiple Claude Codes in parallel from your phone or desktop. Happy Coder runs Claude Code on your hardware, sends push notifications when Claude needs more input or permission, and costs nothing. - [sudocode](https://github.com/sudocode-ai/sudocode) by [ssh-randy](https://github.com/ssh-randy) - Lightweight agent orchestration dev tool that lives in your repo. Integrates with various specification frameworks. It's giving Jira. - [The Agentic Startup](https://github.com/rsmdt/the-startup) by [Rudolf Schmidt](https://github.com/rsmdt) - Yet Another Claude Orchestrator - a collection of agents, commands, etc., for shipping production code - but I like this because it's comprehensive, well-written, and one of the few resources that actually uses Output Styles! +10 points! - [TSK - AI Agent Task Manager and Sandbox](https://github.com/dtormoen/tsk) by [dtormoen](https://github.com/dtormoen) - A Rust CLI tool that lets you delegate development tasks to AI agents running in sandboxed Docker environments. Multiple agents work in parallel, returning git branches for human review. ### Config Managers - [claude-rules-doctor](https://github.com/nulone/claude-rules-doctor) by [nulone](https://github.com/nulone) - CLI that detects dead `.claude/rules/` files by checking if `paths:` globs actually match files in your repo. Catches silent rule failures where renamed directories or typos in glob patterns cause rules to never apply. Features CI mode (exit 1 on dead rules), JSON output, and verbose mode showing matched files. - [ClaudeCTX](https://github.com/foxj77/claudectx) by [John Fox](https://github.com/foxj77) - claudectx lets you switch your entire Claude Code configuration with a single command.
## Status Lines 📊 > Status lines - Configurations and customizations for Claude Code's status bar functionality ### General - [CCometixLine - Claude Code Statusline](https://github.com/Haleclipse/CCometixLine) by [Haleclipse](https://github.com/Haleclipse) - A high-performance Claude Code statusline tool written in Rust with Git integration, usage tracking, interactive TUI configuration, and Claude Code enhancement utilities. - [ccstatusline](https://github.com/sirmalloc/ccstatusline) by [sirmalloc](https://github.com/sirmalloc) - A highly customizable status line formatter for Claude Code CLI that displays model info, git branch, token usage, and other metrics in your terminal. - [claude-code-statusline](https://github.com/rz1989s/claude-code-statusline) by [rz1989s](https://github.com/rz1989s) - Enhanced 4-line statusline for Claude Code with themes, cost tracking, and MCP server monitoring. - [claude-powerline](https://github.com/Owloops/claude-powerline) by [Owloops](https://github.com/Owloops) - A vim-style powerline statusline for Claude Code with real-time usage tracking, git integration, custom themes, and more. - [claudia-statusline](https://github.com/hagan/claudia-statusline) by [Hagan Franks](https://github.com/hagan) - High-performance Rust-based statusline for Claude Code with persistent stats tracking, progress bars, and optional cloud sync. Features SQLite-first persistence, git integration, context progress bars, burn rate calculation, XDG-compliant with theme support (dark/light, NO_COLOR).
## Hooks 🪝 > Hooks are a powerful API for Claude Code that allows users to activate commands and run scripts at different points in Claude's agentic lifecycle. ### General - [Britfix](https://github.com/Talieisin/britfix) by [Talieisin](https://github.com/Talieisin) - Claude outputs American spellings by default, which can have an impact on: professional credibility, compliance, documentation, and more. Britfix converts to British English, with a Claude Code hook for automatic conversion as files are written. Context-aware: handles code files intelligently by only converting comments and docstrings, never identifiers or string literals. - [CC Notify](https://github.com/dazuiba/CCNotify) by [dazuiba](https://github.com/dazuiba) - CCNotify provides desktop notifications for Claude Code, alerting you to input needs or task completion, with one-click jumps back to VS Code and task duration display. - [cchooks](https://github.com/GowayLee/cchooks) by [GowayLee](https://github.com/GowayLee) - A lightweight Python SDK with a clean API and good documentation; simplifies the process of writing hooks and integrating them into your codebase, providing a nice abstraction over the JSON configuration files. - [Claude Code Hook Comms (HCOM)](https://github.com/aannoo/claude-hook-comms) by [aannoo](https://github.com/aannoo) - Lightweight CLI tool for real-time communication between Claude Code sub agents using hooks. Enables multi-agent collaboration with @-mention targeting, live dashboard monitoring, and zero-dependency implementation. [NOTE: At the time of posting, this resource is a little unstable - I'm sharing it anyway, because I think it's incredibly promising and creative. I hope by the time you read this, it is production-ready.]. - [claude-code-hooks-sdk](https://github.com/beyondcode/claude-hooks-sdk) by [beyondcode](https://github.com/beyondcode) - A Laravel-inspired PHP SDK for building Claude Code hook responses with a clean, fluent API. This SDK makes it easy to create structured JSON responses for Claude Code hooks using an expressive, chainable interface. - [claude-hooks](https://github.com/johnlindquist/claude-hooks) by [John Lindquist](https://github.com/johnlindquist) - A TypeScript-based system for configuring and customizing Claude Code hooks with a powerful and flexible interface. - [Claudio](https://github.com/ctoth/claudio) by [Christopher Toth](https://github.com/ctoth) - A no-frills little library that adds delightful OS-native sounds to Claude Code via simple hooks. It really sparks joy. - [Dippy](https://github.com/ldayton/Dippy) by [Lily Dayton](https://github.com/ldayton) - Auto-approve safe bash commands using AST-based parsing, while prompting for destructive operations. Solves permission fatigue without disabling safety. Supports Claude Code, Gemini CLI, and Cursor. - [parry](https://github.com/vaporif/parry) by [Dmytro Onypko](https://github.com/vaporif) - Prompt injection scanner for Claude Code hooks. Scans tool inputs and outputs for injection attacks, secrets, and data exfiltration attempts. [NOTE: Early development phase but worth a look.]. - [TDD Guard](https://github.com/nizos/tdd-guard) by [Nizar Selander](https://github.com/nizos) - A hooks-driven system that monitors file operations in real-time and blocks changes that violate TDD principles. - [TypeScript Quality Hooks](https://github.com/bartolli/claude-code-typescript-hooks) by [bartolli](https://github.com/bartolli) - Quality check hook for Node.js TypeScript projects with TypeScript compilation. ESLint auto-fixing, and Prettier formatting. Uses SHA256 config caching for < 5ms validation performance during real-time editing.
## Slash-Commands 🔪 > "Slash Commands are customized, carefully refined prompts that control Claude's behavior in order to perform a specific task" ### General - [/create-hook](https://github.com/omril321/automated-notebooklm/blob/main/.claude/commands/create-hook.md) by [Omri Lavi](https://github.com/omril321) - Slash command for hook creation - intelligently prompts you through the creation process with smart suggestions based on your project setup (TS, Prettier, ESLint...). - [/linux-desktop-slash-commands](https://github.com/danielrosehill/Claude-Code-Linux-Desktop-Slash-Commands) by [Daniel Rosehill](https://github.com/danielrosehill) - A library of slash commands intended specifically to facilitate common and advanced operations on Linux desktop environments (although many would also be useful on Linux servers). Command groups include hardware benchmarking, filesystem organisation, and security posture validation. ### Version Control & Git - [/analyze-issue](https://github.com/jerseycheese/Narraitor/blob/feature/issue-227-ai-suggestions/.claude/commands/analyze-issue.md) by [jerseycheese](https://github.com/jerseycheese) - Fetches GitHub issue details to create comprehensive implementation specifications, analyzing requirements and planning structured approach with clear implementation steps. - [/commit](https://github.com/evmts/tevm-monorepo/blob/main/.claude/commands/commit.md) by [evmts](https://github.com/evmts) - Creates git commits using conventional commit format with appropriate emojis, following project standards and creating descriptive messages that explain the purpose of changes. - [/commit-fast](https://github.com/steadycursor/steadystart/blob/main/.claude/commands/2-commit-fast.md) by [steadycursor](https://github.com/steadycursor) - Automates git commit process by selecting the first suggested message, generating structured commits with consistent formatting while skipping manual confirmation and removing Claude co-Contributorship footer. - [/create-pr](https://github.com/toyamarinyon/giselle/blob/main/.claude/commands/create-pr.md) by [toyamarinyon](https://github.com/toyamarinyon) - Streamlines pull request creation by handling the entire workflow: creating a new branch, committing changes, formatting modified files with Biome, and submitting the PR. - [/create-pull-request](https://github.com/liam-hq/liam/blob/main/.claude/commands/create-pull-request.md) by [liam-hq](https://github.com/liam-hq) - Provides comprehensive PR creation guidance with GitHub CLI, enforcing title conventions, following template structure, and offering concrete command examples with best practices. - [/create-worktrees](https://github.com/evmts/tevm-monorepo/blob/main/.claude/commands/create-worktrees.md) by [evmts](https://github.com/evmts) - Creates git worktrees for all open PRs or specific branches, handling branches with slashes, cleaning up stale worktrees, and supporting custom branch creation for development. - [/fix-github-issue](https://github.com/jeremymailen/kotlinter-gradle/blob/master/.claude/commands/fix-github-issue.md) by [jeremymailen](https://github.com/jeremymailen) - Analyzes and fixes GitHub issues using a structured approach with GitHub CLI for issue details, implementing necessary code changes, running tests, and creating proper commit messages. - [/fix-issue](https://github.com/metabase/metabase/blob/master/.claude/commands/fix-issue.md) by [metabase](https://github.com/metabase) - Addresses GitHub issues by taking issue number as parameter, analyzing context, implementing solution, and testing/validating the fix for proper integration. - [/fix-pr](https://github.com/metabase/metabase/blob/master/.claude/commands/fix-pr.md) by [metabase](https://github.com/metabase) - Fetches and fixes unresolved PR comments by automatically retrieving feedback, addressing reviewer concerns, making targeted code improvements, and streamlining the review process. - [/husky](https://github.com/evmts/tevm-monorepo/blob/main/.claude/commands/husky.md) by [evmts](https://github.com/evmts) - Sets up and manages Husky Git hooks by configuring pre-commit hooks, establishing commit message standards, integrating with linting tools, and ensuring code quality on commits. - [/update-branch-name](https://github.com/giselles-ai/giselle/blob/main/.claude/commands/update-branch-name.md) by [giselles-ai](https://github.com/giselles-ai) - Updates branch names with proper prefixes and formats, enforcing naming conventions, supporting semantic prefixes, and managing remote branch updates. ### Code Analysis & Testing - [/check](https://github.com/rygwdn/slack-tools/blob/main/.claude/commands/check.md) by [rygwdn](https://github.com/rygwdn) - Performs comprehensive code quality and security checks, featuring static analysis integration, security vulnerability scanning, code style enforcement, and detailed reporting. - [/code_analysis](https://github.com/kingler/n8n_agent/blob/main/.claude/commands/code_analysis.md) by [kingler](https://github.com/kingler) - Provides a menu of advanced code analysis commands for deep inspection, including knowledge graph generation, optimization suggestions, and quality evaluation. - [/optimize](https://github.com/to4iki/ai-project-rules/blob/main/.claude/commands/optimize.md) by [to4iki](https://github.com/to4iki) - Analyzes code performance to identify bottlenecks, proposing concrete optimizations with implementation guidance for improved application performance. - [/repro-issue](https://github.com/rzykov/metabase/blob/master/.claude/commands/repro-issue.md) by [rzykov](https://github.com/rzykov) - Creates reproducible test cases for GitHub issues, ensuring tests fail reliably and documenting clear reproduction steps for developers. - [/tdd](https://github.com/zscott/pane/blob/main/.claude/commands/tdd.md) by [zscott](https://github.com/zscott) - Guides development using Test-Driven Development principles, enforcing Red-Green-Refactor discipline, integrating with git workflow, and managing PR creation. - [/tdd-implement](https://github.com/jerseycheese/Narraitor/blob/feature/issue-227-ai-suggestions/.claude/commands/tdd-implement.md) by [jerseycheese](https://github.com/jerseycheese) - Implements Test-Driven Development by analyzing feature requirements, creating tests first (red), implementing minimal passing code (green), and refactoring while maintaining tests. ### Context Loading & Priming - [/context-prime](https://github.com/elizaOS/elizaos.github.io/blob/main/.claude/commands/context-prime.md) by [elizaOS](https://github.com/elizaOS) - Primes Claude with comprehensive project understanding by loading repository structure, setting development context, establishing project goals, and defining collaboration parameters. - [/initref](https://github.com/okuvshynov/cubestat/blob/main/.claude/commands/initref.md) by [okuvshynov](https://github.com/okuvshynov) - Initializes reference documentation structure with standard doc templates, API reference setup, documentation conventions, and placeholder content generation. - [/load-llms-txt](https://github.com/ethpandaops/xatu-data/blob/master/.claude/commands/load-llms-txt.md) by [ethpandaops](https://github.com/ethpandaops) - Loads LLM configuration files to context, importing specific terminology, model configurations, and establishing baseline terminology for AI discussions. - [/load_coo_context](https://github.com/Mjvolk3/torchcell/blob/main/.claude/commands/load_coo_context.md) by [Mjvolk3](https://github.com/Mjvolk3) - References specific files for sparse matrix operations, explains transform usage, compares with previous approaches, and sets data formatting context for development. - [/load_dango_pipeline](https://github.com/Mjvolk3/torchcell/blob/main/.claude/commands/load_dango_pipeline.md) by [Mjvolk3](https://github.com/Mjvolk3) - Sets context for model training by referencing pipeline files, establishing working context, and preparing for pipeline work with relevant documentation. - [/prime](https://github.com/yzyydev/AI-Engineering-Structure/blob/main/.claude/commands/prime.md) by [yzyydev](https://github.com/yzyydev) - Sets up initial project context by viewing directory structure and reading key files, creating standardized context with directory visualization and key documentation focus. - [/rsi](https://github.com/ddisisto/si/blob/main/.claude/commands/rsi.md) by [ddisisto](https://github.com/ddisisto) - Reads all commands and key project files to optimize AI-assisted development by streamlining the process, loading command context, and setting up for better development workflow. ### Documentation & Changelogs - [/add-to-changelog](https://github.com/berrydev-ai/blockdoc-python/blob/main/.claude/commands/add-to-changelog.md) by [berrydev-ai](https://github.com/berrydev-ai) - Adds new entries to changelog files while maintaining format consistency, properly documenting changes, and following established project standards for version tracking. - [/create-docs](https://github.com/jerseycheese/Narraitor/blob/feature/issue-227-ai-suggestions/.claude/commands/create-docs.md) by [jerseycheese](https://github.com/jerseycheese) - Analyzes code structure and purpose to create comprehensive documentation detailing inputs/outputs, behavior, user interaction flows, and edge cases with error handling. - [/docs](https://github.com/slunsford/coffee-analytics/blob/main/.claude/commands/docs.md) by [slunsford](https://github.com/slunsford) - Generates comprehensive documentation that follows project structure, documenting APIs and usage patterns with consistent formatting for better user understanding. - [/explain-issue-fix](https://github.com/hackdays-io/toban-contribution-viewer/blob/main/.claude/commands/explain-issue-fix.md) by [hackdays-io](https://github.com/hackdays-io) - Documents solution approaches for GitHub issues, explaining technical decisions, detailing challenges overcome, and providing implementation context for better understanding. - [/update-docs](https://github.com/Consiliency/Flutter-Structurizr/blob/main/.claude/commands/update-docs.md) by [Consiliency](https://github.com/Consiliency) - Reviews current documentation status, updates implementation progress, reviews phase documents, and maintains documentation consistency across the project. ### CI / Deployment - [/release](https://github.com/kelp/webdown/blob/main/.claude/commands/release.md) by [kelp](https://github.com/kelp) - Manages software releases by updating changelogs, reviewing README changes, evaluating version increments, and documenting release changes for better version tracking. - [/run-ci](https://github.com/hackdays-io/toban-contribution-viewer/blob/main/.claude/commands/run-ci.md) by [hackdays-io](https://github.com/hackdays-io) - Activates virtual environments, runs CI-compatible check scripts, iteratively fixes errors, and ensures all tests pass before completion. ### Project & Task Management - [/create-command](https://github.com/scopecraft/command/blob/main/.claude/commands/create-command.md) by [scopecraft](https://github.com/scopecraft) - Guides Claude through creating new custom commands with proper structure by analyzing requirements, templating commands by category, enforcing command standards, and creating supporting documentation. - [/create-plan](https://github.com/hesreallyhim/inkverse-fork/blob/preserve-claude-resources/.claude/commands/create-plan.md) by [taddyorg](https://github.com/taddyorg) - Generates comprehensive product requirement documents outlining detailed specifications, requirements, and features following standardized document structure and format. *(Removed from origin)* - [/create-prp](https://github.com/Wirasm/claudecode-utils/blob/main/.claude/commands/create-prp.md) by [Wirasm](https://github.com/Wirasm) - Creates product requirement plans by reading PRP methodology, following template structure, creating comprehensive requirements, and structuring product definitions for development. - [/do-issue](https://github.com/jerseycheese/Narraitor/blob/feature/issue-227-ai-suggestions/.claude/commands/do-issue.md) by [jerseycheese](https://github.com/jerseycheese) - Implements GitHub issues with manual review points, following a structured approach with issue number parameter and offering alternative automated mode for efficiency. - [/prd-generator](https://github.com/dredozubov/prd-generator) by [Denis Redozubov](https://github.com/dredozubov) - A Claude Code plugin that generates comprehensive Product Requirements Documents (PRDs) from conversation context. Invoke `/create-prd` after discussing requirements and it produces a complete PRD with all standard sections including Executive Summary, User Stories, MVP Scope, Architecture, Success Criteria, and Implementation Phases. - [/project_hello_w_name](https://github.com/disler/just-prompt/blob/main/.claude/commands/project_hello_w_name.md) by [disler](https://github.com/disler) - Creates customizable greeting components with name input, demonstrating argument passing, component reusability, state management, and user input handling. - [/todo](https://github.com/chrisleyva/todo-slash-command/blob/main/todo.md) by [chrisleyva](https://github.com/chrisleyva) - A convenient command to quickly manage project todo items without leaving the Claude Code interface, featuring due dates, sorting, task prioritization, and comprehensive todo list management. ### Miscellaneous - [/fixing_go_in_graph](https://github.com/Mjvolk3/torchcell/blob/main/.claude/commands/fixing_go_in_graph.md) by [Mjvolk3](https://github.com/Mjvolk3) - Focuses on Gene Ontology annotation integration in graph databases, handling multiple data sources, addressing graph representation issues, and ensuring correct data incorporation. - [/mermaid](https://github.com/GaloyMoney/lana-bank/blob/main/.claude/commands/mermaid.md) by [GaloyMoney](https://github.com/GaloyMoney) - Generates Mermaid diagrams from SQL schema files, creating entity relationship diagrams with table properties, validating diagram compilation, and ensuring complete entity coverage. - [/review_dcell_model](https://github.com/Mjvolk3/torchcell/blob/main/.claude/commands/review_dcell_model.md) by [Mjvolk3](https://github.com/Mjvolk3) - Reviews old Dcell implementation files, comparing with newer Dango model, noting changes over time, and analyzing refactoring approaches for better code organization. - [/use-stepper](https://github.com/zuplo/docs/blob/main/.claude/commands/use-stepper.md) by [zuplo](https://github.com/zuplo) - Reformats documentation to use React Stepper component, transforming heading formats, applying proper indentation, and maintaining markdown compatibility with admonition formatting.
## CLAUDE.md Files 📂 > `CLAUDE.md` files are files that contain important guidelines and context-specific information or instructions that help Claude Code to better understand your project and your coding standards ### Language-Specific - [AI IntelliJ Plugin](https://github.com/didalgolab/ai-intellij-plugin/blob/main/CLAUDE.md) by [didalgolab](https://github.com/didalgolab) - Provides comprehensive Gradle commands for IntelliJ plugin development with platform-specific coding patterns, detailed package structure guidelines, and clear internationalization standards. - [AWS MCP Server](https://github.com/alexei-led/aws-mcp-server/blob/main/CLAUDE.md) by [alexei-led](https://github.com/alexei-led) - Features multiple Python environment setup options with detailed code style guidelines, comprehensive error handling recommendations, and security considerations for AWS CLI interactions. - [DroidconKotlin](https://github.com/touchlab/DroidconKotlin/blob/main/CLAUDE.md) by [touchlab](https://github.com/touchlab) - Delivers comprehensive Gradle commands for cross-platform Kotlin Multiplatform development with clear module structure and practical guidance for dependency injection. - [EDSL](https://github.com/hesreallyhim/awesome-claude-code/blob/main/resources/claude.md-files/EDSL/CLAUDE.md) by [expectedparrot](https://github.com/expectedparrot) - Offers detailed build and test commands with strict code style enforcement, comprehensive testing requirements, and standardized development workflow using Black and mypy. *(Removed from origin)* - [Giselle](https://github.com/giselles-ai/giselle/blob/main/CLAUDE.md) by [giselles-ai](https://github.com/giselles-ai) - Provides detailed build and test commands using pnpm and Vitest with strict code formatting requirements and comprehensive naming conventions for code consistency. - [HASH](https://github.com/hashintel/hash/blob/main/CLAUDE.md) by [hashintel](https://github.com/hashintel) - Features comprehensive repository structure breakdown with strong emphasis on coding standards, detailed Rust documentation guidelines, and systematic PR review process. - [Inkline](https://github.com/inkline/inkline/blob/main/CLAUDE.md) by [inkline](https://github.com/inkline) - Structures development workflow using pnpm with emphasis on TypeScript and Vue 3 Composition API, detailed component creation process, and comprehensive testing recommendations. - [JSBeeb](https://github.com/mattgodbolt/jsbeeb/blob/main/CLAUDE.md) by [mattgodbolt](https://github.com/mattgodbolt) - Provides development guide for JavaScript BBC Micro emulator with build and testing instructions, architecture documentation, and debugging workflows. - [Lamoom Python](https://github.com/LamoomAI/lamoom-python/blob/main/CLAUDE.md) by [LamoomAI](https://github.com/LamoomAI) - Serves as reference for production prompt engineering library with load balancing of AI Models, API documentation, and usage patterns with examples. - [LangGraphJS](https://github.com/langchain-ai/langgraphjs/blob/main/CLAUDE.md) by [langchain-ai](https://github.com/langchain-ai) - Offers comprehensive build and test commands with detailed TypeScript style guidelines, layered library architecture, and monorepo structure using yarn workspaces. - [Metabase](https://github.com/metabase/metabase/blob/master/CLAUDE.md) by [metabase](https://github.com/metabase) - Details workflow for REPL-driven development in Clojure/ClojureScript with emphasis on incremental development, testing, and step-by-step approach for feature implementation. - [SG Cars Trends Backend](https://github.com/sgcarstrends/backend/blob/main/CLAUDE.md) by [sgcarstrends](https://github.com/sgcarstrends) - Provides comprehensive structure for TypeScript monorepo projects with detailed commands for development, testing, deployment, and AWS/Cloudflare integration. - [SPy](https://github.com/spylang/spy/blob/main/CLAUDE.md) by [spylang](https://github.com/spylang) - Enforces strict coding conventions with comprehensive testing guidelines, multiple code compilation options, and backend-specific test decorators for targeted filtering. - [TPL](https://github.com/KarpelesLab/tpl/blob/master/CLAUDE.md) by [KarpelesLab](https://github.com/KarpelesLab) - Details Go project conventions with comprehensive error handling recommendations, table-driven testing approach guidelines, and modernization suggestions for latest Go features. ### Domain-Specific - [Course Builder](https://github.com/badass-courses/course-builder/blob/main/CLAUDE.md) by [badass-courses](https://github.com/badass-courses) - Enables real-time multiplayer capabilities for collaborative course creation with diverse tech stack integration and monorepo architecture using Turborepo. - [Cursor Tools](https://github.com/eastlondoner/cursor-tools/blob/main/CLAUDE.md) by [eastlondoner](https://github.com/eastlondoner) - Creates a versatile AI command interface supporting multiple providers and models with flexible command options and browser automation through "Stagehand" feature. - [Guitar](https://github.com/soramimi/Guitar/blob/master/CLAUDE.md) by [soramimi](https://github.com/soramimi) - Serves as development guide for Guitar Git GUI Client with build commands for various platforms, code style guidelines for contributing, and project structure explanation. - [Network Chronicles](https://github.com/Fimeg/NetworkChronicles/blob/legacy-v1/CLAUDE.md) by [Fimeg](https://github.com/Fimeg) - Presents detailed implementation plan for AI-driven game characters with technical specifications for LLM integration, character guidelines, and service discovery mechanics. - [Pareto Mac](https://github.com/ParetoSecurity/pareto-mac/blob/main/CLAUDE.md) by [ParetoSecurity](https://github.com/ParetoSecurity) - Serves as development guide for Mac security audit tool with build instructions, contribution guidelines, testing procedures, and workflow documentation. - [pre-commit-hooks](https://github.com/aRustyDev/pre-commit-hooks) by [aRustyDev](https://github.com/aRustyDev) - This repository is about pre-commit-hooks in general, but the `CLAUDE.md` and related `.claude/` documentation is exemplary. Thorough but not verbose. Unlike a lot of `CLAUDE.md` files, it doesn't primarily consist in shouting at Claude in all-caps. Great learning resource. Also, hooks. - [SteadyStart](https://github.com/steadycursor/steadystart/blob/main/CLAUDE.md) by [steadycursor](https://github.com/steadycursor) - Clear and direct instructives about style, permissions, Claude's "role", communications, and documentation of Claude Code sessions for other team members to stay abreast. ### Project Scaffolding & MCP - [Basic Memory](https://github.com/basicmachines-co/basic-memory/blob/main/CLAUDE.md) by [basicmachines-co](https://github.com/basicmachines-co) - Presents an innovative AI-human collaboration framework with Model Context Protocol for bidirectional LLM-markdown communication and flexible knowledge structure for complex projects. - [claude-code-mcp-enhanced](https://github.com/grahama1970/claude-code-mcp-enhanced/blob/main/CLAUDE.md) by [grahama1970](https://github.com/grahama1970) - Provides detailed and emphatic instructions for Claude to follow as a coding agent, with testing guidance, code examples, and compliance checks.
## Alternative Clients 📱 > Alternative Clients are alternative UIs and front-ends for interacting with Claude Code, either on mobile or on the desktop. ### General - [Claudable](https://github.com/opactorai/Claudable) by [Ethan Park](https://www.linkedin.com/in/seongil-park/) - Claudable is an open-source web builder that leverages local CLI agents, such as Claude Code and Cursor Agent, to build and deploy products effortlessly. - [claude-esp](https://github.com/phiat/claude-esp) by [phiat](https://github.com/phiat) - Go-based TUI that streams Claude Code's hidden output (thinking, tool calls, subagents) to a separate terminal. Watch multiple sessions simultaneously, filter by content type, and track background tasks. Ideal for debugging or understanding what Claude is doing under the hood without interrupting your main session. - [claude-tmux](https://github.com/nielsgroen/claude-tmux) by [Niels Groeneveld](https://github.com/nielsgroen) - Manage Claude Code within tmux. A tmux popup of all your Claude Code instances, enabling quick switching, status monitoring, session lifecycle management, with git worktree and pull request support. - [crystal](https://github.com/stravu/crystal) by [stravu](https://github.com/stravu) - A full-fledged desktop application for orchestrating, monitoring, and interacting with Claude Code agents. - [Omnara](https://github.com/omnara-ai/omnara) by [Ishaan Sehgal](https://github.com/ishaansehgal99) - A command center for AI agents that syncs Claude Code sessions across terminal, web, and mobile. Allows for remote monitoring, human-in-the-loop interaction, and team collaboration.
## Official Documentation 🏛️ > Links to some of Anthropic's terrific documentation and resources regarding Claude Code ### General - [Anthropic Documentation](https://docs.claude.com/en/home) by [Anthropic](https://github.com/anthropics) - The official documentation for Claude Code, including installation instructions, usage guidelines, API references, tutorials, examples, loads of information that I won't list individually. Like Claude Code, the documentation is frequently updated. - [Anthropic Quickstarts](https://github.com/anthropics/claude-quickstarts) by [Anthropic](https://github.com/anthropics) - Offers comprehensive development guides for three distinct AI-powered demo projects with standardized workflows, strict code style guidelines, and containerization instructions. - [Claude Code GitHub Actions](https://github.com/anthropics/claude-code-action/tree/main/examples) by [Anthropic](https://github.com/anthropics) - Official GitHub Actions integration for Claude Code with examples and documentation for automating AI-powered workflows in CI/CD pipelines. ## Contributing [🔝](#awesome-claude-code) ### **[Recommend a new resource here!](https://github.com/hesreallyhim/awesome-claude-code/issues/new?template=recommend-resource.yml)** Recommending a resource for the list is very simple, and the automated system handles everything for you. Please do not open a PR to submit a recommendation - the only person who is allowed to submit PRs to this repo is Claude. Make sure that you have read the CONTRIBUTING.md document and CODE_OF_CONDUCT.md before you submit a recommendation. For suggestions about the repository itself, please [open a repository enhancement issue](https://github.com/hesreallyhim/awesome-claude-code/issues/new?template=repository-enhancement.yml). This project is released with a Code of Conduct. By participating, you agree to abide by its terms. And although I take strong measures to uphold the quality and safety of this list, I take no responsibility or liability for anything that might happen as a result of these third-party resources. ## Growing thanks to you [![Stargazers over time](https://starchart.cc/hesreallyhim/awesome-claude-code.svg?variant=adaptive)](https://starchart.cc/hesreallyhim/awesome-claude-code) ## License This list is licensed under [Creative Commons CC BY-NC-ND 4.0](https://creativecommons.org/licenses/by-nc-nd/4.0/) - this means you are welcome to fork, clone, copy and redistribute the list, provided you include appropriate attribution; however you are not permitted to distribute any modified versions or to use it for any commercial purposes. This is to prevent disregard for the licenses of the authors whose resources are listed here. Please note that all resources included in this list have their own license terms. ================================================ FILE: README_ALTERNATIVES/README_CLASSIC.md ================================================

Pick Your Style:

Awesome Extra Classic Flat

Awesome Claude Code
[![Typing SVG](https://readme-typing-svg.demolab.com/?font=Fira+Code&weight=600&duration=3000&pause=100&color=F7080D&width=680&lines=Lollygagging...;Skedaddling...;Bumbershooting...;Widdershinning...;Higgledy-piggledying...;Doodlebugging...;Fiddle-faddling...;Whimwhamming...;Dilly-dallying...;Flapdoodling...;Ballyhooing...;Galumphing...;Razzle-dazzling...;Tiddle-taddling...;Zigzagging...;Twinkletoeing...;Puddle-jumping...;Snicker-snacking...;Jibber-jabbering...;Frabjoussing...;Piffle-puffling...;Whirligigging...;Bibbity-bobbitying...;)](https://git.io/typing-svg) [![Awesome](https://awesome.re/badge-flat2.svg)](https://awesome.re) [![FREEDOM FUNDER](../assets/freedom-funder-badge.svg)](https://bailproject.org) # Awesome Claude Code This is a curated list of slash-commands, `CLAUDE.md` files, CLI tools, and other resources and guides for enhancing your [Claude Code](https://docs.anthropic.com/en/docs/claude-code) workflow, productivity, and vibes. Claude Code is a cutting-edge CLI-based coding assistant and agent released by [Anthropic](https://www.anthropic.com/) that you can access in your terminal or IDE. It is a rapidly evolving tool that offers a number of powerful capabilities, and allows for a lot of configuration, in a lot of different ways. Users are actively working out best practices and workflows. It is the hope that this repo will help the community share knowledge and understand how to get the most out of Claude Code. ## Latest Additions ✨ [🔝](#awesome-claude-code) [`Claude Scientific Skills`](https://github.com/K-Dense-AI/claude-scientific-skills)   by   [K-Dense](https://github.com/K-Dense-AI/)   ⚖️  MIT "A set of ready-to-use Agent Skills for research, science, engineering, analysis, finance and writing." That's their description - modest, simple. That's how you can tell this is really one of the best skills repos on GitHub. If you've ever thought about getting a PhD... just read all of these documents instead. Also I think it IS an AI agent or something? Awesome.
📊 GitHub Stats ![GitHub Stats for claude-scientific-skills](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-scientific-skills&username=K-Dense-AI&all_stats=true&stats_only=true)

[`parry`](https://github.com/vaporif/parry)   by   [Dmytro Onypko](https://github.com/vaporif)   ⚖️  MIT Prompt injection scanner for Claude Code hooks. Scans tool inputs and outputs for injection attacks, secrets, and data exfiltration attempts. [NOTE: Early development phase but worth a look.]
📊 GitHub Stats ![GitHub Stats for parry](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=parry&username=vaporif&all_stats=true&stats_only=true)

[`Dippy`](https://github.com/ldayton/Dippy)   by   [Lily Dayton](https://github.com/ldayton)   ⚖️  MIT Auto-approve safe bash commands using AST-based parsing, while prompting for destructive operations. Solves permission fatigue without disabling safety. Supports Claude Code, Gemini CLI, and Cursor.
📊 GitHub Stats ![GitHub Stats for Dippy](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=Dippy&username=ldayton&all_stats=true&stats_only=true)

[`sudocode`](https://github.com/sudocode-ai/sudocode)   by   [ssh-randy](https://github.com/ssh-randy)   ⚖️  Apache-2.0 Lightweight agent orchestration dev tool that lives in your repo. Integrates with various specification frameworks. It's giving Jira.
📊 GitHub Stats ![GitHub Stats for sudocode](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=sudocode&username=sudocode-ai&all_stats=true&stats_only=true)

[`claude-tmux`](https://github.com/nielsgroen/claude-tmux)   by   [Niels Groeneveld](https://github.com/nielsgroen)   ⚖️  NOASSERTION Manage Claude Code within tmux. A tmux popup of all your Claude Code instances, enabling quick switching, status monitoring, session lifecycle management, with git worktree and pull request support.
📊 GitHub Stats ![GitHub Stats for claude-tmux](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-tmux&username=nielsgroen&all_stats=true&stats_only=true)

[`claude-esp`](https://github.com/phiat/claude-esp)   by   [phiat](https://github.com/phiat)   ⚖️  MIT Go-based TUI that streams Claude Code's hidden output (thinking, tool calls, subagents) to a separate terminal. Watch multiple sessions simultaneously, filter by content type, and track background tasks. Ideal for debugging or understanding what Claude is doing under the hood without interrupting your main session.
📊 GitHub Stats ![GitHub Stats for claude-esp](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-esp&username=phiat&all_stats=true&stats_only=true)

## Contents [🔝](#awesome-claude-code)
Table of Contents -
Agent Skills - [General](#general-)
-
Workflows & Knowledge Guides - [General](#general--1) - [Ralph Wiggum](#ralph-wiggum-)
-
Tooling - [General](#general--2) - [IDE Integrations](#ide-integrations-) - [Usage Monitors](#usage-monitors-) - [Orchestrators](#orchestrators-) - [Config Managers](#config-managers-)
-
Status Lines - [General](#general--3)
-
Hooks - [General](#general--4)
-
Slash-Commands - [General](#general--5) - [Version Control & Git](#version-control--git-) - [Code Analysis & Testing](#code-analysis--testing-) - [Context Loading & Priming](#context-loading--priming-) - [Documentation & Changelogs](#documentation--changelogs-) - [CI / Deployment](#ci--deployment-) - [Project & Task Management](#project--task-management-) - [Miscellaneous](#miscellaneous-)
-
CLAUDE.md Files - [Language-Specific](#language-specific-) - [Domain-Specific](#domain-specific-) - [Project Scaffolding & MCP](#project-scaffolding--mcp-)
-
Alternative Clients - [General](#general--6)
-
Official Documentation - [General](#general--7)
## Agent Skills 🤖 [🔝](#awesome-claude-code) > Agent skills are model-controlled configurations (files, scripts, resources, etc.) that enable Claude Code to perform specialized tasks requiring specific knowledge or capabilities.

General 🔝

 [`AgentSys`](https://github.com/avifenesh/agentsys)   by   [avifenesh](https://github.com/avifenesh)   ⚖️  MIT Workflow automation system for Claude with a group of useful plugins, agents, and skills. Automates task-to-production workflows, PR management, code cleanup, performance investigation, drift detection, and multi-agent code review. Includes [agnix](https://github.com/avifenesh/agnix) for linting agent configurations. Built on thousands of lines of code with thousands of tests. Uses deterministic detection (regex, AST) with LLM judgment for efficiency. Used on many production systems.
📊 GitHub Stats ![GitHub Stats for agentsys](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=agentsys&username=avifenesh&all_stats=true&stats_only=true)

[`AI Agent, AI Spy`](https://youtu.be/0ANECpNdt-4)   by   [Whittaker & Tiwari](https://signalfoundation.org/)   ⚖️  No License / Not Specified Members from the Signal Foundation with some really great tips and tricks on how to turn your operating system into an instrument of total surveillance, and why some companies are doing this really awesome thing. [warning: YouTube link] [`Book Factory`](https://github.com/robertguss/claude-skills)   by   [Robert Guss](https://github.com/robertguss)   ⚖️  MIT A comprehensive pipeline of Skills that replicates traditional publishing infrastructure for nonfiction book creation using specialized Claude skills.
📊 GitHub Stats ![GitHub Stats for claude-skills](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-skills&username=robertguss&all_stats=true&stats_only=true)

[`cc-devops-skills`](https://github.com/akin-ozer/cc-devops-skills)   by   [akin-ozer](https://github.com/akin-ozer)   ⚖️  Apache-2.0 Immensely detailed set of skills for DevOps Engineers (or anyone who has to deploy code, really). Works with validations, generators, shell scripts and CLI tools to create high quality IaC code for about any platform you've ever struggled painfully to work with. Worth downloading even just as a source of documentation.
📊 GitHub Stats ![GitHub Stats for cc-devops-skills](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=cc-devops-skills&username=akin-ozer&all_stats=true&stats_only=true)

[`Claude Code Agents`](https://github.com/undeadlist/claude-code-agents)   by   [Paul - UndeadList](https://github.com/undeadlist)   ⚖️  MIT Comprehensive E2E development workflow with helpful Claude Code subagent prompts for solo devs. Run multiple auditors in parallel, automate fix cycles with micro-checkpoint protocols, and do browser-based QA. Includes strict protocols to prevent AI going rogue.
📊 GitHub Stats ![GitHub Stats for claude-code-agents](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-code-agents&username=undeadlist&all_stats=true&stats_only=true)

[`Claude Codex Settings`](https://github.com/fcakyon/claude-codex-settings)   by   [fatih akyon](https://github.com/fcakyon)   ⚖️  Apache-2.0 A well-organized, well-written set of plugins covering core developer activities, such as working with common cloud platforms like GitHub, Azure, MongoDB, and popular services such as Tavily, Playwright, and more. Clear, not overly-opinionated, and compatible with a few other providers.
📊 GitHub Stats ![GitHub Stats for claude-codex-settings](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-codex-settings&username=fcakyon&all_stats=true&stats_only=true)

[`Claude Mountaineering Skills`](https://github.com/dreamiurg/claude-mountaineering-skills)   by   [Dmytro Gaivoronsky](https://github.com/dreamiurg)   ⚖️  MIT Claude Code skill that automates mountain route research for North American peaks. Aggregates data from 10+ mountaineering sources like Mountaineers.org, PeakBagger.com and SummitPost.com to generate detailed route beta reports with weather, avalanche conditions, and trip reports.
📊 GitHub Stats ![GitHub Stats for claude-mountaineering-skills](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-mountaineering-skills&username=dreamiurg&all_stats=true&stats_only=true)

[`Claude Scientific Skills`](https://github.com/K-Dense-AI/claude-scientific-skills)   by   [K-Dense](https://github.com/K-Dense-AI/)   ⚖️  MIT "A set of ready-to-use Agent Skills for research, science, engineering, analysis, finance and writing." That's their description - modest, simple. That's how you can tell this is really one of the best skills repos on GitHub. If you've ever thought about getting a PhD... just read all of these documents instead. Also I think it IS an AI agent or something? Awesome.
📊 GitHub Stats ![GitHub Stats for claude-scientific-skills](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-scientific-skills&username=K-Dense-AI&all_stats=true&stats_only=true)

[`Codex Skill`](https://github.com/skills-directory/skill-codex)   by   [klaudworks](https://github.com/klaudworks)   ⚖️  MIT Enables users to prompt codex from claude code. Unlike the raw codex mcp server, this skill infers parameters such as model, reasoning effort, sandboxing from your prompt or asks you to specify them. It also simplifies continuing prior codex sessions so that codex can continue with the prior context.
📊 GitHub Stats ![GitHub Stats for skill-codex](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=skill-codex&username=skills-directory&all_stats=true&stats_only=true)

[`Compound Engineering Plugin`](https://github.com/EveryInc/compound-engineering-plugin)   by   [EveryInc](https://github.com/EveryInc)   ⚖️  MIT A very pragmatic set of well-designed agents, skills, and commands, built around a discipline of turning past mistakes and errors into lessons and opportunities for future growth and improvement. Good documentation.
📊 GitHub Stats ![GitHub Stats for compound-engineering-plugin](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=compound-engineering-plugin&username=EveryInc&all_stats=true&stats_only=true)

[`Context Engineering Kit`](https://github.com/NeoLabHQ/context-engineering-kit)   by   [Vlad Goncharov](https://github.com/LeoVS09)   ⚖️  GPL-3.0 Hand-crafted collection of advanced context engineering techniques and patterns with minimal token footprint focused on improving agent result quality.
📊 GitHub Stats ![GitHub Stats for context-engineering-kit](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=context-engineering-kit&username=NeoLabHQ&all_stats=true&stats_only=true)

[`Everything Claude Code`](https://github.com/affaan-m/everything-claude-code)   by   [Affaan Mustafa](https://github.com/affaan-m/)   ⚖️  MIT Top-notch, well-written resources covering "just about everything" from core engineering domains. What's nice about this "everything-" store is most of the resources have significant standalone value and unlike some all-encompassing frameworks, although you can opt in to the author's own specific workflow patterns if you choose, the individual resources offer exemplary patterns in (just about) every Claude Code feature you can find (apologies to the Output Styles devotees).
📊 GitHub Stats ![GitHub Stats for everything-claude-code](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=everything-claude-code&username=affaan-m&all_stats=true&stats_only=true)

[`Fullstack Dev Skills`](https://github.com/jeffallan/claude-skills)   by   [jeffallan](https://github.com/jeffallan)   ⚖️  MIT A comprehensive Claude Code plugin with 65 specialized skills covering full-stack development across a wide range of specific frameworks. Features 9 project workflow commands for Jira/Confluence integration and, notably, an interesting approach to context engineering via a `/common-ground` command that surfaces Claude's hidden assumptions about your project. This is a smart thing to do.
📊 GitHub Stats ![GitHub Stats for claude-skills](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-skills&username=jeffallan&all_stats=true&stats_only=true)

[`read-only-postgres`](https://github.com/jawwadfirdousi/agent-skills)   by   [jawwadfirdousi](https://github.com/jawwadfirdousi) Read-only PostgreSQL query skill for Claude Code. Executes SELECT/SHOW/EXPLAIN/WITH queries across configured databases with strict validation, timeouts, and row limits. Supports multiple connections with descriptions for database selection.
📊 GitHub Stats ![GitHub Stats for agent-skills](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=agent-skills&username=jawwadfirdousi&all_stats=true&stats_only=true)

[`Superpowers`](https://github.com/obra/superpowers)   by   [Jesse Vincent](https://github.com/obra)   ⚖️  MIT A strong bundle of core competencies for software engineering, with good coverage of a large portion of the SDLC - from planning, reviewing, testing, debugging... Well written, well organized, and adaptable. The author refers to them as "superpowers", but many of them are just consolidating engineering best practices - which sometimes does feel like a superpower when working with Claude Code.
📊 GitHub Stats ![GitHub Stats for superpowers](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=superpowers&username=obra&all_stats=true&stats_only=true)

[`Trail of Bits Security Skills`](https://github.com/trailofbits/skills)   by   [Trail of Bits](https://github.com/trailofbits)   ⚖️  CC-BY-SA-4.0 A very professional collection of over a dozen security-focused skills for code auditing and vulnerability detection. Includes skills for static analysis with CodeQL and Semgrep, variant analysis across codebases, fix verification, and differential code review.
📊 GitHub Stats ![GitHub Stats for skills](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=skills&username=trailofbits&all_stats=true&stats_only=true)

[`TÂCHES Claude Code Resources`](https://github.com/glittercowboy/taches-cc-resources)   by   [TÂCHES](https://github.com/glittercowboy)   ⚖️  MIT A well-balanced, "down-to-Earth" set of sub agents, skills, and commands, that are well-organized, easy to read, and a healthy focus on "meta"-skills/agents, like "skill-auditor", hook creation, etc. - the kind of things you can adapt to your workflow, and not the other way around.
📊 GitHub Stats ![GitHub Stats for taches-cc-resources](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=taches-cc-resources&username=glittercowboy&all_stats=true&stats_only=true)

[`Web Assets Generator Skill`](https://github.com/alonw0/web-asset-generator)   by   [Alon Wolenitz](https://github.com/alonw0)   ⚖️  MIT Easily generate web assets from Claude Code including favicons, app icons (PWA), and social media meta images (Open Graph) for Facebook, Twitter, WhatsApp, and LinkedIn. Handles image resizing, text-to-image generation, emojis, and provides proper HTML meta tags.
📊 GitHub Stats ![GitHub Stats for web-asset-generator](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=web-asset-generator&username=alonw0&all_stats=true&stats_only=true)



## Workflows & Knowledge Guides 🧠 [🔝](#awesome-claude-code) > A workflow is a tightly coupled set of Claude Code-native resources that facilitate specific projects

General 🔝

 [`AB Method`](https://github.com/ayoubben18/ab-method)   by   [Ayoub Bensalah](https://github.com/ayoubben18)   ⚖️  MIT A principled, spec-driven workflow that transforms large problems into focused, incremental missions using Claude Code's specialized sub agents. Includes slash-commands, sub agents, and specialized workflows designed for specific parts of the SDLC.
📊 GitHub Stats ![GitHub Stats for ab-method](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=ab-method&username=ayoubben18&all_stats=true&stats_only=true)

[`Agentic Workflow Patterns`](https://github.com/ThibautMelen/agentic-workflow-patterns)   by   [ThibautMelen](https://github.com/ThibautMelen) A comprehensive and well-documented collection of agentic patterns from Anthropic docs, with colorful Mermaid diagrams and code examples for each pattern. Covers Subagent Orchestration, Progressive Skills, Parallel Tool Calling, Master-Clone Architecture, Wizard Workflows, and more. Also compatible with other providers.
📊 GitHub Stats ![GitHub Stats for agentic-workflow-patterns](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=agentic-workflow-patterns&username=ThibautMelen&all_stats=true&stats_only=true)

[`Blogging Platform Instructions`](https://github.com/cloudartisan/cloudartisan.github.io/tree/main/.claude/commands)   by   [cloudartisan](https://github.com/cloudartisan)   ⚖️  CC-BY-SA-4.0 Provides a well-structured set of commands for publishing and maintaining a blogging platform, including commands for creating posts, managing categories, and handling media files.
📊 GitHub Stats ![GitHub Stats for cloudartisan.github.io](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=cloudartisan.github.io&username=cloudartisan&all_stats=true&stats_only=true)

[`Claude Code Documentation Mirror`](https://github.com/ericbuess/claude-code-docs)   by   [Eric Buess](https://github.com/ericbuess)   ⚖️  NOASSERTION A mirror of the Anthropic © PBC documentation pages for Claude Code, updated every few hours. Can come in handy when trying to stay on top of the ever-expanding feature-set of Dr. Claw D. Code, Ph.D.
📊 GitHub Stats ![GitHub Stats for claude-code-docs](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-code-docs&username=ericbuess&all_stats=true&stats_only=true)

[`Claude Code Handbook`](https://nikiforovall.blog/claude-code-rules/)   by   [nikiforovall](https://github.com/nikiforovall)   ⚖️  MIT Collection of best practices, tips, and techniques for Claude Code development workflows, enhanced with distributable plugins [`Claude Code Infrastructure Showcase`](https://github.com/diet103/claude-code-infrastructure-showcase)   by   [diet103](https://github.com/diet103)   ⚖️  MIT A remarkably innovative approach to working with Skills, the centerpiece of which being a technique that leverages hooks to ensure that Claude intelligently selects and activates the appropriate Skill given the current context. Well-documented and adaptable to different projects and workflows.
📊 GitHub Stats ![GitHub Stats for claude-code-infrastructure-showcase](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-code-infrastructure-showcase&username=diet103&all_stats=true&stats_only=true)

[`Claude Code PM`](https://github.com/automazeio/ccpm)   by   [Ran Aroussi](https://github.com/ranaroussi)   ⚖️  MIT Really comprehensive and feature-packed project-management workflow for Claude Code. Numerous specialized agents, slash-commands, and strong documentation.
📊 GitHub Stats ![GitHub Stats for ccpm](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=ccpm&username=automazeio&all_stats=true&stats_only=true)

[`Claude Code Repos Index`](https://github.com/danielrosehill/Claude-Code-Repos-Index)   by   [Daniel Rosehill](https://github.com/danielrosehill) This is either the work of a prolific genius, or a very clever bot (or both), although it hardly matters because the quality is so good - an index of 75+ Claude Code repositories published by the author - and I'm not talking about slop. CMS, system design, deep research, IoT, agentic workflows, server management, personal health... If you spot the lie, let me know, otherwise please check these out.
📊 GitHub Stats ![GitHub Stats for Claude-Code-Repos-Index](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=Claude-Code-Repos-Index&username=danielrosehill&all_stats=true&stats_only=true)

[`Claude Code System Prompts`](https://github.com/Piebald-AI/claude-code-system-prompts)   by   [Piebald AI](https://github.com/Piebald-AI)   ⚖️  MIT All parts of Claude Code's system prompt, including builtin tool descriptions, sub agent prompts (Plan/Explore/Task), utility prompts (CLAUDE.md, compact, Bash cmd, security review, agent creation, etc.). Updated for each Claude Code version.
📊 GitHub Stats ![GitHub Stats for claude-code-system-prompts](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-code-system-prompts&username=Piebald-AI&all_stats=true&stats_only=true)

[`Claude Code Tips`](https://github.com/ykdojo/claude-code-tips)   by   [ykdojo](https://github.com/ykdojo)   ⚖️  NOASSERTION A nice variety of 35+ brief but information-dense Claude Code tips covering voice input, system prompt patching, container workflows for risky tasks, conversation cloning(!), multi-model orchestration with Gemini CLI, and plenty more. Nice demos, working scripts, a plugin, I'd say this probably has a little something for everyone.
📊 GitHub Stats ![GitHub Stats for claude-code-tips](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-code-tips&username=ykdojo&all_stats=true&stats_only=true)

[`Claude Code Ultimate Guide`](https://github.com/FlorianBruniaux/claude-code-ultimate-guide)   by   [Florian BRUNIAUX](https://www.linkedin.com/in/florian-bruniaux-43408b83/)   ⚖️  CC-BY-SA-4.0 A tremendous feat of documentation, this guide covers Claude Code from beginner to power user, with production-ready templates for Claude Code features, guides on agentic workflows, and a lot of great learning materials, including quizzes and a handy "cheatsheet". Whether it's the "ultimate" guide to Claude Code will be up to the reader, but a valuable resource nonetheless (as with all documentation sites, make sure it's up to date before you bet the farm).
📊 GitHub Stats ![GitHub Stats for claude-code-ultimate-guide](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-code-ultimate-guide&username=FlorianBruniaux&all_stats=true&stats_only=true)

[`Claude CodePro`](https://github.com/maxritter/claude-codepro)   by   [Max Ritter](https://www.maxritter.net)   ⚖️  NOASSERTION Professional development environment for Claude Code with spec-driven workflow, TDD enforcement, cross-session memory, semantic search, quality hooks, and modular rules integration. A bit "heavyweight" but feature-packed and has wide coverage.
📊 GitHub Stats ![GitHub Stats for claude-codepro](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-codepro&username=maxritter&all_stats=true&stats_only=true)

[`claude-code-docs`](https://github.com/costiash/claude-code-docs)   by   [Constantin Shafranski](https://github.com/costiash)   ⚖️  MIT A mirror of the Anthropic© PBC documentation site for Claude/Code, but with bonus features like full-text search and query-time updates - a nice companion to `claude-code-docs` for up-to-the-minute, fully-indexed information so that Claude Code can read about itself.
📊 GitHub Stats ![GitHub Stats for claude-code-docs](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-code-docs&username=costiash&all_stats=true&stats_only=true)

[`ClaudoPro Directory`](https://github.com/JSONbored/claudepro-directory)   by   [ghost](https://github.com/JSONbored)   ⚖️  MIT Well-crafted, wide selection of Claude Code hooks, slash commands, subagent files, and more, covering a range of specialized tasks and workflows. Better resources than your average "Claude-template-for-everything" site.
📊 GitHub Stats ![GitHub Stats for claudepro-directory](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claudepro-directory&username=JSONbored&all_stats=true&stats_only=true)

[`Context Priming`](https://github.com/disler/just-prompt/tree/main/.claude/commands)   by   [disler](https://github.com/disler) Provides a systematic approach to priming Claude Code with comprehensive project context through specialized commands for different project scenarios and development contexts.
📊 GitHub Stats ![GitHub Stats for just-prompt](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=just-prompt&username=disler&all_stats=true&stats_only=true)

[`Design Review Workflow`](https://github.com/OneRedOak/claude-code-workflows/tree/main/design-review)   by   [Patrick Ellis](https://github.com/OneRedOak)   ⚖️  MIT A tailored workflow for enabling automated UI/UX design review, including specialized sub agents, slash commands, `CLAUDE.md` excerpts, and more. Covers a broad range of criteria from responsive design to accessibility.
📊 GitHub Stats ![GitHub Stats for claude-code-workflows](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-code-workflows&username=OneRedOak&all_stats=true&stats_only=true)

[`Laravel TALL Stack AI Development Starter Kit`](https://github.com/tott/laravel-tall-claude-ai-configs)   by   [tott](https://github.com/tott)   ⚖️  MIT Transform your Laravel TALL (Tailwind, AlpineJS, Laravel, Livewire) stack development with comprehensive Claude Code configurations that provide intelligent assistance, systematic workflows, and domain expert consultation.
📊 GitHub Stats ![GitHub Stats for laravel-tall-claude-ai-configs](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=laravel-tall-claude-ai-configs&username=tott&all_stats=true&stats_only=true)

[`Learn Claude Code`](https://github.com/shareAI-lab/learn-claude-code)   by   [shareAI-Lab](https://github.com/shareAI-lab/)   ⚖️  MIT A really interesting analysis of how coding agents like Claude Code are designed. It attempts to break an agent down into its fundamental parts and reconstruct it with minimal code. Great learning resource. Final product is a rudimentary agent with skills, sub-agents, and a todo-list in roughly a few hundred lines of Python.
📊 GitHub Stats ![GitHub Stats for learn-claude-code](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=learn-claude-code&username=shareAI-lab&all_stats=true&stats_only=true)

[`learn-faster-kit`](https://github.com/cheukyin175/learn-faster-kit)   by   [Hugo Lau](https://github.com/cheukyin175)   ⚖️  MIT A creative educational framework for Claude Code, inspired by the "FASTER" approach to self-teaching. Ships with a variety of agents, slash commands, and tools that enable Claude Code to help you progress at your own pace, employing well-established pedagogical techniques like active learning and spaced repetition.
📊 GitHub Stats ![GitHub Stats for learn-faster-kit](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=learn-faster-kit&username=cheukyin175&all_stats=true&stats_only=true)

[`n8n_agent`](https://github.com/kingler/n8n_agent/tree/main/.claude/commands)   by   [kingler](https://github.com/kingler) Amazing comprehensive set of comments for code analysis, QA, design, documentation, project structure, project management, optimization, and many more.
📊 GitHub Stats ![GitHub Stats for n8n_agent](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=n8n_agent&username=kingler&all_stats=true&stats_only=true)

[`Project Bootstrapping and Task Management`](https://github.com/steadycursor/steadystart/tree/main/.claude/commands)   by   [steadycursor](https://github.com/steadycursor) Provides a structured set of commands for bootstrapping and managing a new project, including meta-commands for creating and editing custom slash-commands.
📊 GitHub Stats ![GitHub Stats for steadystart](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=steadystart&username=steadycursor&all_stats=true&stats_only=true)

[`Project Management, Implementation, Planning, and Release`](https://github.com/scopecraft/command/tree/main/.claude/commands)   by   [scopecraft](https://github.com/scopecraft) Really comprehensive set of commands for all aspects of SDLC.
📊 GitHub Stats ![GitHub Stats for command](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=command&username=scopecraft&all_stats=true&stats_only=true)

[`Project Workflow System`](https://github.com/harperreed/dotfiles/tree/master/.claude/commands)   by   [harperreed](https://github.com/harperreed) A set of commands that provide a comprehensive workflow system for managing projects, including task management, code review, and deployment processes.
📊 GitHub Stats ![GitHub Stats for dotfiles](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=dotfiles&username=harperreed&all_stats=true&stats_only=true)

[`RIPER Workflow`](https://github.com/tony/claude-code-riper-5)   by   [Tony Narlock](https://tony.sh)   ⚖️  MIT Structured development workflow enforcing separation between Research, Innovate, Plan, Execute, and Review phases. Features consolidated subagents for context-efficiency, branch-aware memory bank, and strict mode enforcement for guided development.
📊 GitHub Stats ![GitHub Stats for claude-code-riper-5](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-code-riper-5&username=tony&all_stats=true&stats_only=true)

[`Shipping Real Code w/ Claude`](https://diwank.space/field-notes-from-shipping-real-code-with-claude)   by   [Diwank](https://github.com/creatorrr) A detailed blog post explaining the author's process for shipping a product with Claude Code, including CLAUDE.md files and other interesting resources. [`Simone`](https://github.com/Helmi/claude-simone)   by   [Helmi](https://github.com/Helmi)   ⚖️  MIT A broader project management workflow for Claude Code that encompasses not just a set of commands, but a system of documents, guidelines, and processes to facilitate project planning and execution.
📊 GitHub Stats ![GitHub Stats for claude-simone](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-simone&username=Helmi&all_stats=true&stats_only=true)

Ralph Wiggum 🔝

 [`awesome-ralph`](https://github.com/snwfdhmp/awesome-ralph)   by   [Martin Joly](https://github.com/snwfdhmp) A curated list of resources about Ralph, the AI coding technique that runs AI coding agents in automated loops until specifications are fulfilled.
📊 GitHub Stats ![GitHub Stats for awesome-ralph](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=awesome-ralph&username=snwfdhmp&all_stats=true&stats_only=true)

[`Ralph for Claude Code`](https://github.com/frankbria/ralph-claude-code)   by   [Frank Bria](https://github.com/frankbria)   ⚖️  MIT An autonomous AI development framework that enables Claude Code to work iteratively on projects until completion. Features intelligent exit detection, rate limiting, circuit breaker patterns, and comprehensive safety guardrails to prevent infinite loops and API overuse. Built with Bash, integrated with tmux for live monitoring, and includes 75+ comprehensive tests.
📊 GitHub Stats ![GitHub Stats for ralph-claude-code](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=ralph-claude-code&username=frankbria&all_stats=true&stats_only=true)

[`Ralph Wiggum Marketer`](https://github.com/muratcankoylan/ralph-wiggum-marketer)   by   [Muratcan Koylan](https://github.com/muratcankoylan) A Claude Code plugin that provides an autonomous AI copywriter, integrating the Ralph loop with customized knowledge bases for market research agents. The agents do the research, Ralph writes the copy, you stay in bed. Whether or not you practice Ralph-Driven Development (RDD), I think these projects are interesting and creative explorations of general agentic patterns.
📊 GitHub Stats ![GitHub Stats for ralph-wiggum-marketer](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=ralph-wiggum-marketer&username=muratcankoylan&all_stats=true&stats_only=true)

[`ralph-orchestrator`](https://github.com/mikeyobrien/ralph-orchestrator)   by   [mikeyobrien](https://github.com/mikeyobrien)   ⚖️  MIT Ralph Orchestrator implements the simple but effective "Ralph Wiggum" technique for autonomous task completion, continuously running an AI agent against a prompt file until the task is marked as complete or limits are reached. This implementation provides a robust, well-tested, and feature-complete orchestration system for AI-driven development. Also cited in the Anthropic Ralph plugin documentation.
📊 GitHub Stats ![GitHub Stats for ralph-orchestrator](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=ralph-orchestrator&username=mikeyobrien&all_stats=true&stats_only=true)

[`ralph-wiggum-bdd`](https://github.com/marcindulak/ralph-wiggum-bdd)   by   [marcindulak](https://github.com/marcindulak)   ⚖️  Apache-2.0 A standalone Bash script for Behavior-Driven Development with Ralph Wiggum Loop. In principle, while running unattended, the script can keep code and requirements in sync, but in practice it still requires interactive human supervision, so it supports both modes. The script is standalone and can be modified and committed into your project.
📊 GitHub Stats ![GitHub Stats for ralph-wiggum-bdd](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=ralph-wiggum-bdd&username=marcindulak&all_stats=true&stats_only=true)

[`The Ralph Playbook`](https://github.com/ClaytonFarr/ralph-playbook)   by   [Clayton Farr](https://github.com/ClaytonFarr) A remarkably detailed and comprehensive guide to the Ralph Wiggum technique, featuring well-written theoretical commentary paired with practical guidelines and advice.
📊 GitHub Stats ![GitHub Stats for ralph-playbook](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=ralph-playbook&username=ClaytonFarr&all_stats=true&stats_only=true)



## Tooling 🧰 [🔝](#awesome-claude-code) > Tooling denotes applications that are built on top of Claude Code and consist of more components than slash-commands and `CLAUDE.md` files

General 🔝

 [`cc-sessions`](https://github.com/GWUDCAP/cc-sessions)   by   [toastdev](https://github.com/satoastshi)   ⚖️  MIT An opinionated approach to productive development with Claude Code
📊 GitHub Stats ![GitHub Stats for cc-sessions](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=cc-sessions&username=GWUDCAP&all_stats=true&stats_only=true)

[`cc-tools`](https://github.com/Veraticus/cc-tools)   by   [Josh Symonds](https://github.com/Veraticus) High-performance Go implementation of Claude Code hooks and utilities. Provides smart linting, testing, and statusline generation with minimal overhead.
📊 GitHub Stats ![GitHub Stats for cc-tools](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=cc-tools&username=Veraticus&all_stats=true&stats_only=true)

[`ccexp`](https://github.com/nyatinte/ccexp)   by   [nyatinte](https://github.com/nyatinte)   ⚖️  MIT Interactive CLI tool for discovering and managing Claude Code configuration files and slash commands with a beautiful terminal UI.
📊 GitHub Stats ![GitHub Stats for ccexp](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=ccexp&username=nyatinte&all_stats=true&stats_only=true)

[`cchistory`](https://github.com/eckardt/cchistory)   by   [eckardt](https://github.com/eckardt)   ⚖️  MIT Like the shell history command but for your Claude Code sessions. Easily list all Bash or "Bash-mode" (`!`) commands Claude Code ran in a session for reference.
📊 GitHub Stats ![GitHub Stats for cchistory](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=cchistory&username=eckardt&all_stats=true&stats_only=true)

[`cclogviewer`](https://github.com/Brads3290/cclogviewer)   by   [Brad S.](https://github.com/Brads3290)   ⚖️  MIT A humble but handy utility for viewing Claude Code `.jsonl` conversation files in a pretty HTML UI.
📊 GitHub Stats ![GitHub Stats for cclogviewer](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=cclogviewer&username=Brads3290&all_stats=true&stats_only=true)

[`Claude Code Templates`](https://github.com/davila7/claude-code-templates)   by   [Daniel Avila](https://github.com/davila7)   ⚖️  MIT Incredibly awesome collection of resources from every category in this list, presented with a neatly polished UI, great features like usage dashboard, analytics, and everything from slash commands to hooks to agents. An awesome companion for this awesome list.
📊 GitHub Stats ![GitHub Stats for claude-code-templates](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-code-templates&username=davila7&all_stats=true&stats_only=true)

[`Claude Composer`](https://github.com/possibilities/claude-composer)   by   [Mike Bannister](https://github.com/possibilities)   ⚖️  Unlicense A tool that adds small enhancements to Claude Code.
📊 GitHub Stats ![GitHub Stats for claude-composer](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-composer&username=possibilities&all_stats=true&stats_only=true)

[`Claude Hub`](https://github.com/claude-did-this/claude-hub)   by   [Claude Did This](https://github.com/claude-did-this) A webhook service that connects Claude Code to GitHub repositories, enabling AI-powered code assistance directly through pull requests and issues. This integration allows Claude to analyze repositories, answer technical questions, and help developers understand and improve their codebase through simple @mentions.
📊 GitHub Stats ![GitHub Stats for claude-hub](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-hub&username=claude-did-this&all_stats=true&stats_only=true)

[`Claude Session Restore`](https://github.com/ZENG3LD/claude-session-restore)   by   [ZENG3LD](https://github.com/ZENG3LD)   ⚖️  NOASSERTION Efficiently restore context from previous Claude Code sessions by analyzing session files and git history. Features multi-factor data collection across numerous Claude Code capacities with time-based filtering. Uses tail-based parsing for efficient handling of large session files up to 2GB. Includes both a CLI tool for manual analysis and a Claude Code skill for automatic session restoration.
📊 GitHub Stats ![GitHub Stats for claude-session-restore](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-session-restore&username=ZENG3LD&all_stats=true&stats_only=true)

[`claude-code-tools`](https://github.com/pchalasani/claude-code-tools)   by   [Prasad Chalasani](https://github.com/pchalasani)   ⚖️  MIT Well-crafted toolset for session continuity, featuring skills/commands to avoid compaction and recover context across sessions with cross-agent handoff between Claude Code and Codex CLI. Includes a fast Rust/Tantivy-powered full-text session search (TUI for humans, skill/CLI for agents), tmux-cli skill + command for interacting with scripts and CLI agents, and safety hooks to block dangerous commands.
📊 GitHub Stats ![GitHub Stats for claude-code-tools](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-code-tools&username=pchalasani&all_stats=true&stats_only=true)

[`claude-starter-kit`](https://github.com/serpro69/claude-starter-kit)   by   [serpro69](https://github.com/serpro69)   ⚖️  MIT This is a starter template repository designed to provide a complete development environment for Claude-Code with pre-configured MCP servers and tools for AI-powered development workflows. The repository is intentionally minimal, containing only configuration templates for three primary systems: Claude Code, Serena, and Task Master.
📊 GitHub Stats ![GitHub Stats for claude-starter-kit](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-starter-kit&username=serpro69&all_stats=true&stats_only=true)

[`claudekit`](https://github.com/carlrannaberg/claudekit)   by   [Carl Rannaberg](https://github.com/carlrannaberg)   ⚖️  MIT Impressive CLI toolkit providing auto-save checkpointing, code quality hooks, specification generation and execution, and 20+ specialized subagents including oracle (gpt-5), code-reviewer (6-aspect deep analysis), ai-sdk-expert (Vercel AI SDK), typescript-expert and many more for Claude Code workflows.
📊 GitHub Stats ![GitHub Stats for claudekit](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claudekit&username=carlrannaberg&all_stats=true&stats_only=true)

[`Container Use`](https://github.com/dagger/container-use)   by   [dagger](https://github.com/dagger)   ⚖️  Apache-2.0 Development environments for coding agents. Enable multiple agents to work safely and independently with your preferred stack.
📊 GitHub Stats ![GitHub Stats for container-use](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=container-use&username=dagger&all_stats=true&stats_only=true)

[`ContextKit`](https://github.com/FlineDev/ContextKit)   by   [Cihat Gündüz](https://github.com/Jeehut)   ⚖️  MIT A systematic development framework that transforms Claude Code into a proactive development partner. Features 4-phase planning methodology, specialized quality agents, and structured workflows that help AI produce production-ready code on first try.
📊 GitHub Stats ![GitHub Stats for ContextKit](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=ContextKit&username=FlineDev&all_stats=true&stats_only=true)

[`recall`](https://github.com/zippoxer/recall)   by   [zippoxer](https://github.com/zippoxer)   ⚖️  MIT Full-text search your Claude Code sessions. Run `recall` in terminal, type to search, Enter to resume. Alternative to `claude --resume`.
📊 GitHub Stats ![GitHub Stats for recall](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=recall&username=zippoxer&all_stats=true&stats_only=true)

[`Rulesync`](https://github.com/dyoshikawa/rulesync)   by   [dyoshikawa](https://github.com/dyoshikawa)   ⚖️  MIT A Node.js CLI tool that automatically generates configs (rules, ignore files, MCP servers, commands, and subagents) for various AI coding agents. Rulesync can convert configs between Claude Code and other AI agents in both directions.
📊 GitHub Stats ![GitHub Stats for rulesync](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=rulesync&username=dyoshikawa&all_stats=true&stats_only=true)

[`run-claude-docker`](https://github.com/icanhasjonas/run-claude-docker)   by   [Jonas](https://github.com/icanhasjonas/)   ⚖️  MIT A self-contained Docker runner that forwards your current workspace into a safe(r) isolated docker container, where you still have access to your Claude Code settings, authentication, ssh agent, pgp, optionally aws keys etc.
📊 GitHub Stats ![GitHub Stats for run-claude-docker](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=run-claude-docker&username=icanhasjonas&all_stats=true&stats_only=true)

[`stt-mcp-server-linux`](https://github.com/marcindulak/stt-mcp-server-linux)   by   [marcindulak](https://github.com/marcindulak)   ⚖️  Apache-2.0 A push-to-talk speech transcription setup for Linux using a Python MCP server. Runs locally in Docker with no external API calls. Your speech is recorded, transcribed into text, and then sent to Claude running in a Tmux session.
📊 GitHub Stats ![GitHub Stats for stt-mcp-server-linux](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=stt-mcp-server-linux&username=marcindulak&all_stats=true&stats_only=true)

[`SuperClaude`](https://github.com/SuperClaude-Org/SuperClaude_Framework)   by   [SuperClaude-Org](https://github.com/SuperClaude-Org)   ⚖️  MIT A versatile configuration framework that enhances Claude Code with specialized commands, cognitive personas, and development methodologies, such as "Introspection" and "Orchestration".
📊 GitHub Stats ![GitHub Stats for SuperClaude_Framework](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=SuperClaude_Framework&username=SuperClaude-Org&all_stats=true&stats_only=true)

[`tweakcc`](https://github.com/Piebald-AI/tweakcc)   by   [Piebald-AI](https://github.com/Piebald-AI)   ⚖️  MIT Command-line tool to customize your Claude Code styling.
📊 GitHub Stats ![GitHub Stats for tweakcc](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=tweakcc&username=Piebald-AI&all_stats=true&stats_only=true)

[`Vibe-Log`](https://github.com/vibe-log/vibe-log-cli)   by   [Vibe-Log](https://github.com/vibe-log)   ⚖️  MIT Analyzes your Claude Code prompts locally (using CC), provides intelligent session analysis and actionable strategic guidance - works in the statusline and produces very pretty HTML reports as well. Easy to install and remove.
📊 GitHub Stats ![GitHub Stats for vibe-log-cli](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=vibe-log-cli&username=vibe-log&all_stats=true&stats_only=true)

[`viwo-cli`](https://github.com/OverseedAI/viwo)   by   [Hal Shin](https://github.com/hal-shin)   ⚖️  MIT Run Claude Code in a Docker container with git worktrees as volume mounts to enable safer usage of `--dangerously-skip-permissions` for frictionless one-shotting prompts. Allows users to spin up multiple instances of Claude Code in the background easily with reduced permission fatigue.
📊 GitHub Stats ![GitHub Stats for viwo](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=viwo&username=OverseedAI&all_stats=true&stats_only=true)

[`VoiceMode MCP`](https://github.com/mbailey/voicemode)   by   [Mike Bailey](https://github.com/mbailey)   ⚖️  MIT VoiceMode MCP brings natural conversations to Claude Code. It supports any OpenAI API compatible voice services and installs free and open source voice services (Whisper.cpp and Kokoro-FastAPI).
📊 GitHub Stats ![GitHub Stats for voicemode](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=voicemode&username=mbailey&all_stats=true&stats_only=true)

IDE Integrations 🔝

 [`Claude Code Chat`](https://marketplace.visualstudio.com/items?itemName=AndrePimenta.claude-code-chat)   by   [andrepimenta](https://github.com/andrepimenta)   ⚖️  © An elegant and user-friendly Claude Code chat interface for VS Code. [`claude-code-ide.el`](https://github.com/manzaltu/claude-code-ide.el)   by   [manzaltu](https://github.com/manzaltu)   ⚖️  GPL-3.0 claude-code-ide.el integrates Claude Code with Emacs, like Anthropic’s VS Code/IntelliJ extensions. It shows ediff-based code suggestions, pulls LSP/flymake/flycheck diagnostics, and tracks buffer context. It adds an extensible MCP tool support for symbol refs/defs, project metadata, and tree-sitter AST queries.
📊 GitHub Stats ![GitHub Stats for claude-code-ide.el](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-code-ide.el&username=manzaltu&all_stats=true&stats_only=true)

[`claude-code.el`](https://github.com/stevemolitor/claude-code.el)   by   [stevemolitor](https://github.com/stevemolitor)   ⚖️  Apache-2.0 An Emacs interface for Claude Code CLI.
📊 GitHub Stats ![GitHub Stats for claude-code.el](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-code.el&username=stevemolitor&all_stats=true&stats_only=true)

[`claude-code.nvim`](https://github.com/greggh/claude-code.nvim)   by   [greggh](https://github.com/greggh)   ⚖️  MIT A seamless integration between Claude Code AI assistant and Neovim.
📊 GitHub Stats ![GitHub Stats for claude-code.nvim](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-code.nvim&username=greggh&all_stats=true&stats_only=true)

[`Claudix - Claude Code for VSCode`](https://github.com/Haleclipse/Claudix)   by   [Haleclipse](https://github.com/Haleclipse)   ⚖️  AGPL-3.0 A VSCode extension that brings Claude Code directly into your editor with interactive chat interface, session management, intelligent file operations, terminal execution, and real-time streaming responses. Built with Vue 3, TypeScript.
📊 GitHub Stats ![GitHub Stats for Claudix](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=Claudix&username=Haleclipse&all_stats=true&stats_only=true)

Usage Monitors 🔝

 [`CC Usage`](https://github.com/ryoppippi/ccusage)   by   [ryoppippi](https://github.com/ryoppippi)   ⚖️  NOASSERTION Handy CLI tool for managing and analyzing Claude Code usage, based on analyzing local Claude Code logs. Presents a nice dashboard regarding cost information, token consumption, etc.
📊 GitHub Stats ![GitHub Stats for ccusage](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=ccusage&username=ryoppippi&all_stats=true&stats_only=true)

[`ccflare`](https://github.com/snipeship/ccflare)   by   [snipeship](https://github.com/snipeship)   ⚖️  MIT Claude Code usage dashboard with a web-UI that would put Tableau to shame. Thoroughly comprehensive metrics, frictionless setup, detailed logging, really really nice UI.
📊 GitHub Stats ![GitHub Stats for ccflare](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=ccflare&username=snipeship&all_stats=true&stats_only=true)

[`ccflare -> **better-ccflare**`](https://github.com/tombii/better-ccflare/)   by   [tombii](https://github.com/tombii)   ⚖️  MIT A well-maintained and feature-enhanced fork of the glorious `ccflare` usage dashboard by @snipeship (which at the time of writing has not had an update in a few months). `better-ccflare` builds on this foundation with some performance enhancements, extended provider support, bug fixes, Docker deployment, and more.
📊 GitHub Stats ![GitHub Stats for better-ccflare](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=better-ccflare&username=tombii&all_stats=true&stats_only=true)

[`Claude Code Usage Monitor`](https://github.com/Maciek-roboblog/Claude-Code-Usage-Monitor)   by   [Maciek-roboblog](https://github.com/Maciek-roboblog)   ⚖️  MIT A real-time terminal-based tool for monitoring Claude Code token usage. It shows live token consumption, burn rate, and predictions for token depletion. Features include visual progress bars, session-aware analytics, and support for multiple subscription plans.
📊 GitHub Stats ![GitHub Stats for Claude-Code-Usage-Monitor](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=Claude-Code-Usage-Monitor&username=Maciek-roboblog&all_stats=true&stats_only=true)

[`Claudex`](https://github.com/kunwar-shah/claudex)   by   [Kunwar Shah](https://github.com/kunwar-shah)   ⚖️  MIT Claudex - A web-based browser for exploring your Claude Code conversation history across projects. Indexes your codebase for full-text search. Nice, easy-to-navigate UI. Simple dashboard interface for high-level analytics, and multiple export options as well. (And completely local w/ no telemetry!)
📊 GitHub Stats ![GitHub Stats for claudex](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claudex&username=kunwar-shah&all_stats=true&stats_only=true)

[`viberank`](https://github.com/sculptdotfun/viberank)   by   [nikshepsvn](https://github.com/nikshepsvn)   ⚖️  MIT A community-driven leaderboard tool that enables developers to visualize, track, and compete based on their Claude Code usage statistics. It features robust data analytics, GitHub OAuth, data validation, and user-friendly CLI/web submission methods.
📊 GitHub Stats ![GitHub Stats for viberank](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=viberank&username=sculptdotfun&all_stats=true&stats_only=true)

Orchestrators 🔝

 [`Auto-Claude`](https://github.com/AndyMik90/Auto-Claude)   by   [AndyMik90](https://github.com/AndyMik90)   ⚖️  AGPL-3.0 Autonomous multi-agent coding framework for Claude Code (Claude Agent SDK) that integrates the full SDLC - "plans, builds, and validates software for you". Features a slick kanban-style UI and a well-designed but not over-engineered agent orchestration system.
📊 GitHub Stats ![GitHub Stats for Auto-Claude](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=Auto-Claude&username=AndyMik90&all_stats=true&stats_only=true)

[`Claude Code Flow`](https://github.com/ruvnet/claude-code-flow)   by   [ruvnet](https://github.com/ruvnet)   ⚖️  MIT This mode serves as a code-first orchestration layer, enabling Claude to write, edit, test, and optimize code autonomously across recursive agent cycles.
📊 GitHub Stats ![GitHub Stats for claude-code-flow](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-code-flow&username=ruvnet&all_stats=true&stats_only=true)

[`Claude Squad`](https://github.com/smtg-ai/claude-squad)   by   [smtg-ai](https://github.com/smtg-ai)   ⚖️  AGPL-3.0 Claude Squad is a terminal app that manages multiple Claude Code, Codex (and other local agents including Aider) in separate workspaces, allowing you to work on multiple tasks simultaneously.
📊 GitHub Stats ![GitHub Stats for claude-squad](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-squad&username=smtg-ai&all_stats=true&stats_only=true)

[`Claude Swarm`](https://github.com/parruda/claude-swarm)   by   [parruda](https://github.com/parruda)   ⚖️  MIT Launch Claude Code session that is connected to a swarm of Claude Code Agents.
📊 GitHub Stats ![GitHub Stats for claude-swarm](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-swarm&username=parruda&all_stats=true&stats_only=true)

[`Claude Task Master`](https://github.com/eyaltoledano/claude-task-master)   by   [eyaltoledano](https://github.com/eyaltoledano)   ⚖️  NOASSERTION A task management system for AI-driven development with Claude, designed to work seamlessly with Cursor AI.
📊 GitHub Stats ![GitHub Stats for claude-task-master](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-task-master&username=eyaltoledano&all_stats=true&stats_only=true)

[`Claude Task Runner`](https://github.com/grahama1970/claude-task-runner)   by   [grahama1970](https://github.com/grahama1970) A specialized tool to manage context isolation and focused task execution with Claude Code, solving the critical challenge of context length limitations and task focus when working with Claude on complex, multi-step projects.
📊 GitHub Stats ![GitHub Stats for claude-task-runner](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-task-runner&username=grahama1970&all_stats=true&stats_only=true)

[`Happy Coder`](https://github.com/slopus/happy)   by   [GrocerPublishAgent](https://peoplesgrocers.com/en/projects)   ⚖️  MIT Spawn and control multiple Claude Codes in parallel from your phone or desktop. Happy Coder runs Claude Code on your hardware, sends push notifications when Claude needs more input or permission, and costs nothing.
📊 GitHub Stats ![GitHub Stats for happy](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=happy&username=slopus&all_stats=true&stats_only=true)

[`sudocode`](https://github.com/sudocode-ai/sudocode)   by   [ssh-randy](https://github.com/ssh-randy)   ⚖️  Apache-2.0 Lightweight agent orchestration dev tool that lives in your repo. Integrates with various specification frameworks. It's giving Jira.
📊 GitHub Stats ![GitHub Stats for sudocode](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=sudocode&username=sudocode-ai&all_stats=true&stats_only=true)

[`The Agentic Startup`](https://github.com/rsmdt/the-startup)   by   [Rudolf Schmidt](https://github.com/rsmdt)   ⚖️  MIT Yet Another Claude Orchestrator - a collection of agents, commands, etc., for shipping production code - but I like this because it's comprehensive, well-written, and one of the few resources that actually uses Output Styles! +10 points!
📊 GitHub Stats ![GitHub Stats for the-startup](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=the-startup&username=rsmdt&all_stats=true&stats_only=true)

[`TSK - AI Agent Task Manager and Sandbox`](https://github.com/dtormoen/tsk)   by   [dtormoen](https://github.com/dtormoen)   ⚖️  MIT A Rust CLI tool that lets you delegate development tasks to AI agents running in sandboxed Docker environments. Multiple agents work in parallel, returning git branches for human review.
📊 GitHub Stats ![GitHub Stats for tsk](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=tsk&username=dtormoen&all_stats=true&stats_only=true)

Config Managers 🔝

 [`claude-rules-doctor`](https://github.com/nulone/claude-rules-doctor)   by   [nulone](https://github.com/nulone)   ⚖️  MIT CLI that detects dead `.claude/rules/` files by checking if `paths:` globs actually match files in your repo. Catches silent rule failures where renamed directories or typos in glob patterns cause rules to never apply. Features CI mode (exit 1 on dead rules), JSON output, and verbose mode showing matched files.
📊 GitHub Stats ![GitHub Stats for claude-rules-doctor](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-rules-doctor&username=nulone&all_stats=true&stats_only=true)

[`ClaudeCTX`](https://github.com/foxj77/claudectx)   by   [John Fox](https://github.com/foxj77)   ⚖️  MIT claudectx lets you switch your entire Claude Code configuration with a single command.
📊 GitHub Stats ![GitHub Stats for claudectx](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claudectx&username=foxj77&all_stats=true&stats_only=true)



## Status Lines 📊 [🔝](#awesome-claude-code) > Status lines - Configurations and customizations for Claude Code's status bar functionality

General 🔝

 [`CCometixLine - Claude Code Statusline`](https://github.com/Haleclipse/CCometixLine)   by   [Haleclipse](https://github.com/Haleclipse) A high-performance Claude Code statusline tool written in Rust with Git integration, usage tracking, interactive TUI configuration, and Claude Code enhancement utilities.
📊 GitHub Stats ![GitHub Stats for CCometixLine](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=CCometixLine&username=Haleclipse&all_stats=true&stats_only=true)

[`ccstatusline`](https://github.com/sirmalloc/ccstatusline)   by   [sirmalloc](https://github.com/sirmalloc)   ⚖️  MIT A highly customizable status line formatter for Claude Code CLI that displays model info, git branch, token usage, and other metrics in your terminal.
📊 GitHub Stats ![GitHub Stats for ccstatusline](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=ccstatusline&username=sirmalloc&all_stats=true&stats_only=true)

[`claude-code-statusline`](https://github.com/rz1989s/claude-code-statusline)   by   [rz1989s](https://github.com/rz1989s)   ⚖️  MIT Enhanced 4-line statusline for Claude Code with themes, cost tracking, and MCP server monitoring
📊 GitHub Stats ![GitHub Stats for claude-code-statusline](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-code-statusline&username=rz1989s&all_stats=true&stats_only=true)

[`claude-powerline`](https://github.com/Owloops/claude-powerline)   by   [Owloops](https://github.com/Owloops)   ⚖️  MIT A vim-style powerline statusline for Claude Code with real-time usage tracking, git integration, custom themes, and more
📊 GitHub Stats ![GitHub Stats for claude-powerline](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-powerline&username=Owloops&all_stats=true&stats_only=true)

[`claudia-statusline`](https://github.com/hagan/claudia-statusline)   by   [Hagan Franks](https://github.com/hagan)   ⚖️  MIT High-performance Rust-based statusline for Claude Code with persistent stats tracking, progress bars, and optional cloud sync. Features SQLite-first persistence, git integration, context progress bars, burn rate calculation, XDG-compliant with theme support (dark/light, NO_COLOR).
📊 GitHub Stats ![GitHub Stats for claudia-statusline](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claudia-statusline&username=hagan&all_stats=true&stats_only=true)



## Hooks 🪝 [🔝](#awesome-claude-code) > Hooks are a powerful API for Claude Code that allows users to activate commands and run scripts at different points in Claude's agentic lifecycle.

General 🔝

 [`Britfix`](https://github.com/Talieisin/britfix)   by   [Talieisin](https://github.com/Talieisin)   ⚖️  MIT Claude outputs American spellings by default, which can have an impact on: professional credibility, compliance, documentation, and more. Britfix converts to British English, with a Claude Code hook for automatic conversion as files are written. Context-aware: handles code files intelligently by only converting comments and docstrings, never identifiers or string literals.
📊 GitHub Stats ![GitHub Stats for britfix](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=britfix&username=Talieisin&all_stats=true&stats_only=true)

[`CC Notify`](https://github.com/dazuiba/CCNotify)   by   [dazuiba](https://github.com/dazuiba)   ⚖️  MIT CCNotify provides desktop notifications for Claude Code, alerting you to input needs or task completion, with one-click jumps back to VS Code and task duration display.
📊 GitHub Stats ![GitHub Stats for CCNotify](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=CCNotify&username=dazuiba&all_stats=true&stats_only=true)

[`cchooks`](https://github.com/GowayLee/cchooks)   by   [GowayLee](https://github.com/GowayLee)   ⚖️  MIT A lightweight Python SDK with a clean API and good documentation; simplifies the process of writing hooks and integrating them into your codebase, providing a nice abstraction over the JSON configuration files.
📊 GitHub Stats ![GitHub Stats for cchooks](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=cchooks&username=GowayLee&all_stats=true&stats_only=true)

[`Claude Code Hook Comms (HCOM)`](https://github.com/aannoo/claude-hook-comms)   by   [aannoo](https://github.com/aannoo)   ⚖️  MIT Lightweight CLI tool for real-time communication between Claude Code sub agents using hooks. Enables multi-agent collaboration with @-mention targeting, live dashboard monitoring, and zero-dependency implementation. [NOTE: At the time of posting, this resource is a little unstable - I'm sharing it anyway, because I think it's incredibly promising and creative. I hope by the time you read this, it is production-ready.]
📊 GitHub Stats ![GitHub Stats for claude-hook-comms](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-hook-comms&username=aannoo&all_stats=true&stats_only=true)

[`claude-code-hooks-sdk`](https://github.com/beyondcode/claude-hooks-sdk)   by   [beyondcode](https://github.com/beyondcode)   ⚖️  MIT A Laravel-inspired PHP SDK for building Claude Code hook responses with a clean, fluent API. This SDK makes it easy to create structured JSON responses for Claude Code hooks using an expressive, chainable interface.
📊 GitHub Stats ![GitHub Stats for claude-hooks-sdk](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-hooks-sdk&username=beyondcode&all_stats=true&stats_only=true)

[`claude-hooks`](https://github.com/johnlindquist/claude-hooks)   by   [John Lindquist](https://github.com/johnlindquist)   ⚖️  MIT A TypeScript-based system for configuring and customizing Claude Code hooks with a powerful and flexible interface.
📊 GitHub Stats ![GitHub Stats for claude-hooks](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-hooks&username=johnlindquist&all_stats=true&stats_only=true)

[`Claudio`](https://github.com/ctoth/claudio)   by   [Christopher Toth](https://github.com/ctoth) A no-frills little library that adds delightful OS-native sounds to Claude Code via simple hooks. It really sparks joy.
📊 GitHub Stats ![GitHub Stats for claudio](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claudio&username=ctoth&all_stats=true&stats_only=true)

[`Dippy`](https://github.com/ldayton/Dippy)   by   [Lily Dayton](https://github.com/ldayton)   ⚖️  MIT Auto-approve safe bash commands using AST-based parsing, while prompting for destructive operations. Solves permission fatigue without disabling safety. Supports Claude Code, Gemini CLI, and Cursor.
📊 GitHub Stats ![GitHub Stats for Dippy](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=Dippy&username=ldayton&all_stats=true&stats_only=true)

[`parry`](https://github.com/vaporif/parry)   by   [Dmytro Onypko](https://github.com/vaporif)   ⚖️  MIT Prompt injection scanner for Claude Code hooks. Scans tool inputs and outputs for injection attacks, secrets, and data exfiltration attempts. [NOTE: Early development phase but worth a look.]
📊 GitHub Stats ![GitHub Stats for parry](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=parry&username=vaporif&all_stats=true&stats_only=true)

[`TDD Guard`](https://github.com/nizos/tdd-guard)   by   [Nizar Selander](https://github.com/nizos)   ⚖️  MIT A hooks-driven system that monitors file operations in real-time and blocks changes that violate TDD principles.
📊 GitHub Stats ![GitHub Stats for tdd-guard](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=tdd-guard&username=nizos&all_stats=true&stats_only=true)

[`TypeScript Quality Hooks`](https://github.com/bartolli/claude-code-typescript-hooks)   by   [bartolli](https://github.com/bartolli)   ⚖️  MIT Quality check hook for Node.js TypeScript projects with TypeScript compilation. ESLint auto-fixing, and Prettier formatting. Uses SHA256 config caching for < 5ms validation performance during real-time editing.
📊 GitHub Stats ![GitHub Stats for claude-code-typescript-hooks](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-code-typescript-hooks&username=bartolli&all_stats=true&stats_only=true)



## Slash-Commands 🔪 [🔝](#awesome-claude-code) > "Slash Commands are customized, carefully refined prompts that control Claude's behavior in order to perform a specific task"

General 🔝

 [`/create-hook`](https://github.com/omril321/automated-notebooklm/blob/main/.claude/commands/create-hook.md)   by   [Omri Lavi](https://github.com/omril321)   ⚖️  Apache-2.0 Slash command for hook creation - intelligently prompts you through the creation process with smart suggestions based on your project setup (TS, Prettier, ESLint...).
📊 GitHub Stats ![GitHub Stats for automated-notebooklm](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=automated-notebooklm&username=omril321&all_stats=true&stats_only=true)

[`/linux-desktop-slash-commands`](https://github.com/danielrosehill/Claude-Code-Linux-Desktop-Slash-Commands)   by   [Daniel Rosehill](https://github.com/danielrosehill) A library of slash commands intended specifically to facilitate common and advanced operations on Linux desktop environments (although many would also be useful on Linux servers). Command groups include hardware benchmarking, filesystem organisation, and security posture validation.
📊 GitHub Stats ![GitHub Stats for Claude-Code-Linux-Desktop-Slash-Commands](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=Claude-Code-Linux-Desktop-Slash-Commands&username=danielrosehill&all_stats=true&stats_only=true)

Version Control & Git 🔝

 [`/analyze-issue`](https://github.com/jerseycheese/Narraitor/blob/feature/issue-227-ai-suggestions/.claude/commands/analyze-issue.md)   by   [jerseycheese](https://github.com/jerseycheese)   ⚖️  MIT Fetches GitHub issue details to create comprehensive implementation specifications, analyzing requirements and planning structured approach with clear implementation steps.
📊 GitHub Stats ![GitHub Stats for Narraitor](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=Narraitor&username=jerseycheese&all_stats=true&stats_only=true)

[`/commit`](https://github.com/evmts/tevm-monorepo/blob/main/.claude/commands/commit.md)   by   [evmts](https://github.com/evmts)   ⚖️  MIT Creates git commits using conventional commit format with appropriate emojis, following project standards and creating descriptive messages that explain the purpose of changes.
📊 GitHub Stats ![GitHub Stats for tevm-monorepo](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=tevm-monorepo&username=evmts&all_stats=true&stats_only=true)

[`/commit-fast`](https://github.com/steadycursor/steadystart/blob/main/.claude/commands/2-commit-fast.md)   by   [steadycursor](https://github.com/steadycursor) Automates git commit process by selecting the first suggested message, generating structured commits with consistent formatting while skipping manual confirmation and removing Claude co-Contributorship footer
📊 GitHub Stats ![GitHub Stats for steadystart](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=steadystart&username=steadycursor&all_stats=true&stats_only=true)

[`/create-pr`](https://github.com/toyamarinyon/giselle/blob/main/.claude/commands/create-pr.md)   by   [toyamarinyon](https://github.com/toyamarinyon)   ⚖️  Apache-2.0 Streamlines pull request creation by handling the entire workflow: creating a new branch, committing changes, formatting modified files with Biome, and submitting the PR.
📊 GitHub Stats ![GitHub Stats for giselle](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=giselle&username=toyamarinyon&all_stats=true&stats_only=true)

[`/create-pull-request`](https://github.com/liam-hq/liam/blob/main/.claude/commands/create-pull-request.md)   by   [liam-hq](https://github.com/liam-hq)   ⚖️  Apache-2.0 Provides comprehensive PR creation guidance with GitHub CLI, enforcing title conventions, following template structure, and offering concrete command examples with best practices.
📊 GitHub Stats ![GitHub Stats for liam](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=liam&username=liam-hq&all_stats=true&stats_only=true)

[`/create-worktrees`](https://github.com/evmts/tevm-monorepo/blob/main/.claude/commands/create-worktrees.md)   by   [evmts](https://github.com/evmts)   ⚖️  MIT Creates git worktrees for all open PRs or specific branches, handling branches with slashes, cleaning up stale worktrees, and supporting custom branch creation for development.
📊 GitHub Stats ![GitHub Stats for tevm-monorepo](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=tevm-monorepo&username=evmts&all_stats=true&stats_only=true)

[`/fix-github-issue`](https://github.com/jeremymailen/kotlinter-gradle/blob/master/.claude/commands/fix-github-issue.md)   by   [jeremymailen](https://github.com/jeremymailen)   ⚖️  Apache-2.0 Analyzes and fixes GitHub issues using a structured approach with GitHub CLI for issue details, implementing necessary code changes, running tests, and creating proper commit messages.
📊 GitHub Stats ![GitHub Stats for kotlinter-gradle](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=kotlinter-gradle&username=jeremymailen&all_stats=true&stats_only=true)

[`/fix-issue`](https://github.com/metabase/metabase/blob/master/.claude/commands/fix-issue.md)   by   [metabase](https://github.com/metabase)   ⚖️  NOASSERTION Addresses GitHub issues by taking issue number as parameter, analyzing context, implementing solution, and testing/validating the fix for proper integration.
📊 GitHub Stats ![GitHub Stats for metabase](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=metabase&username=metabase&all_stats=true&stats_only=true)

[`/fix-pr`](https://github.com/metabase/metabase/blob/master/.claude/commands/fix-pr.md)   by   [metabase](https://github.com/metabase)   ⚖️  NOASSERTION Fetches and fixes unresolved PR comments by automatically retrieving feedback, addressing reviewer concerns, making targeted code improvements, and streamlining the review process.
📊 GitHub Stats ![GitHub Stats for metabase](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=metabase&username=metabase&all_stats=true&stats_only=true)

[`/husky`](https://github.com/evmts/tevm-monorepo/blob/main/.claude/commands/husky.md)   by   [evmts](https://github.com/evmts)   ⚖️  MIT Sets up and manages Husky Git hooks by configuring pre-commit hooks, establishing commit message standards, integrating with linting tools, and ensuring code quality on commits.
📊 GitHub Stats ![GitHub Stats for tevm-monorepo](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=tevm-monorepo&username=evmts&all_stats=true&stats_only=true)

[`/update-branch-name`](https://github.com/giselles-ai/giselle/blob/main/.claude/commands/update-branch-name.md)   by   [giselles-ai](https://github.com/giselles-ai)   ⚖️  Apache-2.0 Updates branch names with proper prefixes and formats, enforcing naming conventions, supporting semantic prefixes, and managing remote branch updates.
📊 GitHub Stats ![GitHub Stats for giselle](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=giselle&username=giselles-ai&all_stats=true&stats_only=true)

Code Analysis & Testing 🔝

 [`/check`](https://github.com/rygwdn/slack-tools/blob/main/.claude/commands/check.md)   by   [rygwdn](https://github.com/rygwdn) Performs comprehensive code quality and security checks, featuring static analysis integration, security vulnerability scanning, code style enforcement, and detailed reporting.
📊 GitHub Stats ![GitHub Stats for slack-tools](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=slack-tools&username=rygwdn&all_stats=true&stats_only=true)

[`/code_analysis`](https://github.com/kingler/n8n_agent/blob/main/.claude/commands/code_analysis.md)   by   [kingler](https://github.com/kingler) Provides a menu of advanced code analysis commands for deep inspection, including knowledge graph generation, optimization suggestions, and quality evaluation.
📊 GitHub Stats ![GitHub Stats for n8n_agent](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=n8n_agent&username=kingler&all_stats=true&stats_only=true)

[`/optimize`](https://github.com/to4iki/ai-project-rules/blob/main/.claude/commands/optimize.md)   by   [to4iki](https://github.com/to4iki)   ⚖️  MIT Analyzes code performance to identify bottlenecks, proposing concrete optimizations with implementation guidance for improved application performance.
📊 GitHub Stats ![GitHub Stats for ai-project-rules](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=ai-project-rules&username=to4iki&all_stats=true&stats_only=true)

[`/repro-issue`](https://github.com/rzykov/metabase/blob/master/.claude/commands/repro-issue.md)   by   [rzykov](https://github.com/rzykov)   ⚖️  NOASSERTION Creates reproducible test cases for GitHub issues, ensuring tests fail reliably and documenting clear reproduction steps for developers.
📊 GitHub Stats ![GitHub Stats for metabase](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=metabase&username=rzykov&all_stats=true&stats_only=true)

[`/tdd`](https://github.com/zscott/pane/blob/main/.claude/commands/tdd.md)   by   [zscott](https://github.com/zscott) Guides development using Test-Driven Development principles, enforcing Red-Green-Refactor discipline, integrating with git workflow, and managing PR creation.
📊 GitHub Stats ![GitHub Stats for pane](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=pane&username=zscott&all_stats=true&stats_only=true)

[`/tdd-implement`](https://github.com/jerseycheese/Narraitor/blob/feature/issue-227-ai-suggestions/.claude/commands/tdd-implement.md)   by   [jerseycheese](https://github.com/jerseycheese)   ⚖️  MIT Implements Test-Driven Development by analyzing feature requirements, creating tests first (red), implementing minimal passing code (green), and refactoring while maintaining tests.
📊 GitHub Stats ![GitHub Stats for Narraitor](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=Narraitor&username=jerseycheese&all_stats=true&stats_only=true)

Context Loading & Priming 🔝

 [`/context-prime`](https://github.com/elizaOS/elizaos.github.io/blob/main/.claude/commands/context-prime.md)   by   [elizaOS](https://github.com/elizaOS)   ⚖️  MIT Primes Claude with comprehensive project understanding by loading repository structure, setting development context, establishing project goals, and defining collaboration parameters.
📊 GitHub Stats ![GitHub Stats for elizaos.github.io](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=elizaos.github.io&username=elizaOS&all_stats=true&stats_only=true)

[`/initref`](https://github.com/okuvshynov/cubestat/blob/main/.claude/commands/initref.md)   by   [okuvshynov](https://github.com/okuvshynov)   ⚖️  MIT Initializes reference documentation structure with standard doc templates, API reference setup, documentation conventions, and placeholder content generation.
📊 GitHub Stats ![GitHub Stats for cubestat](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=cubestat&username=okuvshynov&all_stats=true&stats_only=true)

[`/load-llms-txt`](https://github.com/ethpandaops/xatu-data/blob/master/.claude/commands/load-llms-txt.md)   by   [ethpandaops](https://github.com/ethpandaops)   ⚖️  MIT Loads LLM configuration files to context, importing specific terminology, model configurations, and establishing baseline terminology for AI discussions.
📊 GitHub Stats ![GitHub Stats for xatu-data](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=xatu-data&username=ethpandaops&all_stats=true&stats_only=true)

[`/load_coo_context`](https://github.com/Mjvolk3/torchcell/blob/main/.claude/commands/load_coo_context.md)   by   [Mjvolk3](https://github.com/Mjvolk3) References specific files for sparse matrix operations, explains transform usage, compares with previous approaches, and sets data formatting context for development.
📊 GitHub Stats ![GitHub Stats for torchcell](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=torchcell&username=Mjvolk3&all_stats=true&stats_only=true)

[`/load_dango_pipeline`](https://github.com/Mjvolk3/torchcell/blob/main/.claude/commands/load_dango_pipeline.md)   by   [Mjvolk3](https://github.com/Mjvolk3) Sets context for model training by referencing pipeline files, establishing working context, and preparing for pipeline work with relevant documentation.
📊 GitHub Stats ![GitHub Stats for torchcell](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=torchcell&username=Mjvolk3&all_stats=true&stats_only=true)

[`/prime`](https://github.com/yzyydev/AI-Engineering-Structure/blob/main/.claude/commands/prime.md)   by   [yzyydev](https://github.com/yzyydev) Sets up initial project context by viewing directory structure and reading key files, creating standardized context with directory visualization and key documentation focus.
📊 GitHub Stats ![GitHub Stats for AI-Engineering-Structure](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=AI-Engineering-Structure&username=yzyydev&all_stats=true&stats_only=true)

[`/rsi`](https://github.com/ddisisto/si/blob/main/.claude/commands/rsi.md)   by   [ddisisto](https://github.com/ddisisto) Reads all commands and key project files to optimize AI-assisted development by streamlining the process, loading command context, and setting up for better development workflow.
📊 GitHub Stats ![GitHub Stats for si](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=si&username=ddisisto&all_stats=true&stats_only=true)

Documentation & Changelogs 🔝

 [`/add-to-changelog`](https://github.com/berrydev-ai/blockdoc-python/blob/main/.claude/commands/add-to-changelog.md)   by   [berrydev-ai](https://github.com/berrydev-ai)   ⚖️  MIT Adds new entries to changelog files while maintaining format consistency, properly documenting changes, and following established project standards for version tracking.
📊 GitHub Stats ![GitHub Stats for blockdoc-python](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=blockdoc-python&username=berrydev-ai&all_stats=true&stats_only=true)

[`/create-docs`](https://github.com/jerseycheese/Narraitor/blob/feature/issue-227-ai-suggestions/.claude/commands/create-docs.md)   by   [jerseycheese](https://github.com/jerseycheese)   ⚖️  MIT Analyzes code structure and purpose to create comprehensive documentation detailing inputs/outputs, behavior, user interaction flows, and edge cases with error handling.
📊 GitHub Stats ![GitHub Stats for Narraitor](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=Narraitor&username=jerseycheese&all_stats=true&stats_only=true)

[`/docs`](https://github.com/slunsford/coffee-analytics/blob/main/.claude/commands/docs.md)   by   [slunsford](https://github.com/slunsford) Generates comprehensive documentation that follows project structure, documenting APIs and usage patterns with consistent formatting for better user understanding.
📊 GitHub Stats ![GitHub Stats for coffee-analytics](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=coffee-analytics&username=slunsford&all_stats=true&stats_only=true)

[`/explain-issue-fix`](https://github.com/hackdays-io/toban-contribution-viewer/blob/main/.claude/commands/explain-issue-fix.md)   by   [hackdays-io](https://github.com/hackdays-io) Documents solution approaches for GitHub issues, explaining technical decisions, detailing challenges overcome, and providing implementation context for better understanding.
📊 GitHub Stats ![GitHub Stats for toban-contribution-viewer](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=toban-contribution-viewer&username=hackdays-io&all_stats=true&stats_only=true)

[`/update-docs`](https://github.com/Consiliency/Flutter-Structurizr/blob/main/.claude/commands/update-docs.md)   by   [Consiliency](https://github.com/Consiliency)   ⚖️  MIT Reviews current documentation status, updates implementation progress, reviews phase documents, and maintains documentation consistency across the project.
📊 GitHub Stats ![GitHub Stats for Flutter-Structurizr](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=Flutter-Structurizr&username=Consiliency&all_stats=true&stats_only=true)

CI / Deployment 🔝

 [`/release`](https://github.com/kelp/webdown/blob/main/.claude/commands/release.md)   by   [kelp](https://github.com/kelp)   ⚖️  MIT Manages software releases by updating changelogs, reviewing README changes, evaluating version increments, and documenting release changes for better version tracking.
📊 GitHub Stats ![GitHub Stats for webdown](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=webdown&username=kelp&all_stats=true&stats_only=true)

[`/run-ci`](https://github.com/hackdays-io/toban-contribution-viewer/blob/main/.claude/commands/run-ci.md)   by   [hackdays-io](https://github.com/hackdays-io) Activates virtual environments, runs CI-compatible check scripts, iteratively fixes errors, and ensures all tests pass before completion.
📊 GitHub Stats ![GitHub Stats for toban-contribution-viewer](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=toban-contribution-viewer&username=hackdays-io&all_stats=true&stats_only=true)

Project & Task Management 🔝

 [`/create-command`](https://github.com/scopecraft/command/blob/main/.claude/commands/create-command.md)   by   [scopecraft](https://github.com/scopecraft) Guides Claude through creating new custom commands with proper structure by analyzing requirements, templating commands by category, enforcing command standards, and creating supporting documentation.
📊 GitHub Stats ![GitHub Stats for command](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=command&username=scopecraft&all_stats=true&stats_only=true)

[`/create-plan`](https://github.com/hesreallyhim/inkverse-fork/blob/preserve-claude-resources/.claude/commands/create-plan.md)   by   [taddyorg](https://github.com/taddyorg)   ⚖️  AGPL-3.0 Generates comprehensive product requirement documents outlining detailed specifications, requirements, and features following standardized document structure and format.* * Removed from origin [`/create-prp`](https://github.com/Wirasm/claudecode-utils/blob/main/.claude/commands/create-prp.md)   by   [Wirasm](https://github.com/Wirasm)   ⚖️  MIT Creates product requirement plans by reading PRP methodology, following template structure, creating comprehensive requirements, and structuring product definitions for development.
📊 GitHub Stats ![GitHub Stats for claudecode-utils](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claudecode-utils&username=Wirasm&all_stats=true&stats_only=true)

[`/do-issue`](https://github.com/jerseycheese/Narraitor/blob/feature/issue-227-ai-suggestions/.claude/commands/do-issue.md)   by   [jerseycheese](https://github.com/jerseycheese)   ⚖️  MIT Implements GitHub issues with manual review points, following a structured approach with issue number parameter and offering alternative automated mode for efficiency.
📊 GitHub Stats ![GitHub Stats for Narraitor](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=Narraitor&username=jerseycheese&all_stats=true&stats_only=true)

[`/prd-generator`](https://github.com/dredozubov/prd-generator)   by   [Denis Redozubov](https://github.com/dredozubov)   ⚖️  MIT A Claude Code plugin that generates comprehensive Product Requirements Documents (PRDs) from conversation context. Invoke `/create-prd` after discussing requirements and it produces a complete PRD with all standard sections including Executive Summary, User Stories, MVP Scope, Architecture, Success Criteria, and Implementation Phases.
📊 GitHub Stats ![GitHub Stats for prd-generator](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=prd-generator&username=dredozubov&all_stats=true&stats_only=true)

[`/project_hello_w_name`](https://github.com/disler/just-prompt/blob/main/.claude/commands/project_hello_w_name.md)   by   [disler](https://github.com/disler) Creates customizable greeting components with name input, demonstrating argument passing, component reusability, state management, and user input handling.
📊 GitHub Stats ![GitHub Stats for just-prompt](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=just-prompt&username=disler&all_stats=true&stats_only=true)

[`/todo`](https://github.com/chrisleyva/todo-slash-command/blob/main/todo.md)   by   [chrisleyva](https://github.com/chrisleyva)   ⚖️  MIT A convenient command to quickly manage project todo items without leaving the Claude Code interface, featuring due dates, sorting, task prioritization, and comprehensive todo list management.
📊 GitHub Stats ![GitHub Stats for todo-slash-command](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=todo-slash-command&username=chrisleyva&all_stats=true&stats_only=true)

Miscellaneous 🔝

 [`/fixing_go_in_graph`](https://github.com/Mjvolk3/torchcell/blob/main/.claude/commands/fixing_go_in_graph.md)   by   [Mjvolk3](https://github.com/Mjvolk3) Focuses on Gene Ontology annotation integration in graph databases, handling multiple data sources, addressing graph representation issues, and ensuring correct data incorporation.
📊 GitHub Stats ![GitHub Stats for torchcell](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=torchcell&username=Mjvolk3&all_stats=true&stats_only=true)

[`/mermaid`](https://github.com/GaloyMoney/lana-bank/blob/main/.claude/commands/mermaid.md)   by   [GaloyMoney](https://github.com/GaloyMoney)   ⚖️  NOASSERTION Generates Mermaid diagrams from SQL schema files, creating entity relationship diagrams with table properties, validating diagram compilation, and ensuring complete entity coverage.
📊 GitHub Stats ![GitHub Stats for lana-bank](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=lana-bank&username=GaloyMoney&all_stats=true&stats_only=true)

[`/review_dcell_model`](https://github.com/Mjvolk3/torchcell/blob/main/.claude/commands/review_dcell_model.md)   by   [Mjvolk3](https://github.com/Mjvolk3) Reviews old Dcell implementation files, comparing with newer Dango model, noting changes over time, and analyzing refactoring approaches for better code organization.
📊 GitHub Stats ![GitHub Stats for torchcell](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=torchcell&username=Mjvolk3&all_stats=true&stats_only=true)

[`/use-stepper`](https://github.com/zuplo/docs/blob/main/.claude/commands/use-stepper.md)   by   [zuplo](https://github.com/zuplo) Reformats documentation to use React Stepper component, transforming heading formats, applying proper indentation, and maintaining markdown compatibility with admonition formatting.
📊 GitHub Stats ![GitHub Stats for docs](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=docs&username=zuplo&all_stats=true&stats_only=true)



## CLAUDE.md Files 📂 [🔝](#awesome-claude-code) > `CLAUDE.md` files are files that contain important guidelines and context-specific information or instructions that help Claude Code to better understand your project and your coding standards

Language-Specific 🔝

 [`AI IntelliJ Plugin`](https://github.com/didalgolab/ai-intellij-plugin/blob/main/CLAUDE.md)   by   [didalgolab](https://github.com/didalgolab)   ⚖️  Apache-2.0 Provides comprehensive Gradle commands for IntelliJ plugin development with platform-specific coding patterns, detailed package structure guidelines, and clear internationalization standards.
📊 GitHub Stats ![GitHub Stats for ai-intellij-plugin](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=ai-intellij-plugin&username=didalgolab&all_stats=true&stats_only=true)

[`AWS MCP Server`](https://github.com/alexei-led/aws-mcp-server/blob/main/CLAUDE.md)   by   [alexei-led](https://github.com/alexei-led)   ⚖️  MIT Features multiple Python environment setup options with detailed code style guidelines, comprehensive error handling recommendations, and security considerations for AWS CLI interactions.
📊 GitHub Stats ![GitHub Stats for aws-mcp-server](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=aws-mcp-server&username=alexei-led&all_stats=true&stats_only=true)

[`DroidconKotlin`](https://github.com/touchlab/DroidconKotlin/blob/main/CLAUDE.md)   by   [touchlab](https://github.com/touchlab)   ⚖️  Apache-2.0 Delivers comprehensive Gradle commands for cross-platform Kotlin Multiplatform development with clear module structure and practical guidance for dependency injection.
📊 GitHub Stats ![GitHub Stats for DroidconKotlin](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=DroidconKotlin&username=touchlab&all_stats=true&stats_only=true)

[`EDSL`](https://github.com/hesreallyhim/awesome-claude-code/blob/main/resources/claude.md-files/EDSL/CLAUDE.md)   by   [expectedparrot](https://github.com/expectedparrot)   ⚖️  MIT Offers detailed build and test commands with strict code style enforcement, comprehensive testing requirements, and standardized development workflow using Black and mypy.* * Removed from origin [`Giselle`](https://github.com/giselles-ai/giselle/blob/main/CLAUDE.md)   by   [giselles-ai](https://github.com/giselles-ai)   ⚖️  Apache-2.0 Provides detailed build and test commands using pnpm and Vitest with strict code formatting requirements and comprehensive naming conventions for code consistency.
📊 GitHub Stats ![GitHub Stats for giselle](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=giselle&username=giselles-ai&all_stats=true&stats_only=true)

[`HASH`](https://github.com/hashintel/hash/blob/main/CLAUDE.md)   by   [hashintel](https://github.com/hashintel)   ⚖️  NOASSERTION Features comprehensive repository structure breakdown with strong emphasis on coding standards, detailed Rust documentation guidelines, and systematic PR review process.
📊 GitHub Stats ![GitHub Stats for hash](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=hash&username=hashintel&all_stats=true&stats_only=true)

[`Inkline`](https://github.com/inkline/inkline/blob/main/CLAUDE.md)   by   [inkline](https://github.com/inkline)   ⚖️  NOASSERTION Structures development workflow using pnpm with emphasis on TypeScript and Vue 3 Composition API, detailed component creation process, and comprehensive testing recommendations.
📊 GitHub Stats ![GitHub Stats for inkline](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=inkline&username=inkline&all_stats=true&stats_only=true)

[`JSBeeb`](https://github.com/mattgodbolt/jsbeeb/blob/main/CLAUDE.md)   by   [mattgodbolt](https://github.com/mattgodbolt)   ⚖️  GPL-3.0 Provides development guide for JavaScript BBC Micro emulator with build and testing instructions, architecture documentation, and debugging workflows.
📊 GitHub Stats ![GitHub Stats for jsbeeb](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=jsbeeb&username=mattgodbolt&all_stats=true&stats_only=true)

[`Lamoom Python`](https://github.com/LamoomAI/lamoom-python/blob/main/CLAUDE.md)   by   [LamoomAI](https://github.com/LamoomAI)   ⚖️  Apache-2.0 Serves as reference for production prompt engineering library with load balancing of AI Models, API documentation, and usage patterns with examples.
📊 GitHub Stats ![GitHub Stats for lamoom-python](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=lamoom-python&username=LamoomAI&all_stats=true&stats_only=true)

[`LangGraphJS`](https://github.com/langchain-ai/langgraphjs/blob/main/CLAUDE.md)   by   [langchain-ai](https://github.com/langchain-ai)   ⚖️  MIT Offers comprehensive build and test commands with detailed TypeScript style guidelines, layered library architecture, and monorepo structure using yarn workspaces.
📊 GitHub Stats ![GitHub Stats for langgraphjs](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=langgraphjs&username=langchain-ai&all_stats=true&stats_only=true)

[`Metabase`](https://github.com/metabase/metabase/blob/master/CLAUDE.md)   by   [metabase](https://github.com/metabase)   ⚖️  NOASSERTION Details workflow for REPL-driven development in Clojure/ClojureScript with emphasis on incremental development, testing, and step-by-step approach for feature implementation.
📊 GitHub Stats ![GitHub Stats for metabase](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=metabase&username=metabase&all_stats=true&stats_only=true)

[`SG Cars Trends Backend`](https://github.com/sgcarstrends/backend/blob/main/CLAUDE.md)   by   [sgcarstrends](https://github.com/sgcarstrends)   ⚖️  MIT Provides comprehensive structure for TypeScript monorepo projects with detailed commands for development, testing, deployment, and AWS/Cloudflare integration.
📊 GitHub Stats ![GitHub Stats for backend](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=backend&username=sgcarstrends&all_stats=true&stats_only=true)

[`SPy`](https://github.com/spylang/spy/blob/main/CLAUDE.md)   by   [spylang](https://github.com/spylang)   ⚖️  MIT Enforces strict coding conventions with comprehensive testing guidelines, multiple code compilation options, and backend-specific test decorators for targeted filtering.
📊 GitHub Stats ![GitHub Stats for spy](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=spy&username=spylang&all_stats=true&stats_only=true)

[`TPL`](https://github.com/KarpelesLab/tpl/blob/master/CLAUDE.md)   by   [KarpelesLab](https://github.com/KarpelesLab)   ⚖️  MIT Details Go project conventions with comprehensive error handling recommendations, table-driven testing approach guidelines, and modernization suggestions for latest Go features.
📊 GitHub Stats ![GitHub Stats for tpl](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=tpl&username=KarpelesLab&all_stats=true&stats_only=true)

Domain-Specific 🔝

 [`Course Builder`](https://github.com/badass-courses/course-builder/blob/main/CLAUDE.md)   by   [badass-courses](https://github.com/badass-courses)   ⚖️  MIT Enables real-time multiplayer capabilities for collaborative course creation with diverse tech stack integration and monorepo architecture using Turborepo.
📊 GitHub Stats ![GitHub Stats for course-builder](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=course-builder&username=badass-courses&all_stats=true&stats_only=true)

[`Cursor Tools`](https://github.com/eastlondoner/cursor-tools/blob/main/CLAUDE.md)   by   [eastlondoner](https://github.com/eastlondoner)   ⚖️  MIT Creates a versatile AI command interface supporting multiple providers and models with flexible command options and browser automation through "Stagehand" feature.
📊 GitHub Stats ![GitHub Stats for cursor-tools](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=cursor-tools&username=eastlondoner&all_stats=true&stats_only=true)

[`Guitar`](https://github.com/soramimi/Guitar/blob/master/CLAUDE.md)   by   [soramimi](https://github.com/soramimi)   ⚖️  GPL-2.0 Serves as development guide for Guitar Git GUI Client with build commands for various platforms, code style guidelines for contributing, and project structure explanation.
📊 GitHub Stats ![GitHub Stats for Guitar](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=Guitar&username=soramimi&all_stats=true&stats_only=true)

[`Network Chronicles`](https://github.com/Fimeg/NetworkChronicles/blob/legacy-v1/CLAUDE.md)   by   [Fimeg](https://github.com/Fimeg)   ⚖️  MIT Presents detailed implementation plan for AI-driven game characters with technical specifications for LLM integration, character guidelines, and service discovery mechanics.
📊 GitHub Stats ![GitHub Stats for NetworkChronicles](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=NetworkChronicles&username=Fimeg&all_stats=true&stats_only=true)

[`Pareto Mac`](https://github.com/ParetoSecurity/pareto-mac/blob/main/CLAUDE.md)   by   [ParetoSecurity](https://github.com/ParetoSecurity)   ⚖️  GPL-3.0 Serves as development guide for Mac security audit tool with build instructions, contribution guidelines, testing procedures, and workflow documentation.
📊 GitHub Stats ![GitHub Stats for pareto-mac](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=pareto-mac&username=ParetoSecurity&all_stats=true&stats_only=true)

[`pre-commit-hooks`](https://github.com/aRustyDev/pre-commit-hooks)   by   [aRustyDev](https://github.com/aRustyDev)   ⚖️  AGPL-3.0 This repository is about pre-commit-hooks in general, but the `CLAUDE.md` and related `.claude/` documentation is exemplary. Thorough but not verbose. Unlike a lot of `CLAUDE.md` files, it doesn't primarily consist in shouting at Claude in all-caps. Great learning resource. Also, hooks.
📊 GitHub Stats ![GitHub Stats for pre-commit-hooks](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=pre-commit-hooks&username=aRustyDev&all_stats=true&stats_only=true)

[`SteadyStart`](https://github.com/steadycursor/steadystart/blob/main/CLAUDE.md)   by   [steadycursor](https://github.com/steadycursor) Clear and direct instructives about style, permissions, Claude's "role", communications, and documentation of Claude Code sessions for other team members to stay abreast.
📊 GitHub Stats ![GitHub Stats for steadystart](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=steadystart&username=steadycursor&all_stats=true&stats_only=true)

Project Scaffolding & MCP 🔝

 [`Basic Memory`](https://github.com/basicmachines-co/basic-memory/blob/main/CLAUDE.md)   by   [basicmachines-co](https://github.com/basicmachines-co)   ⚖️  AGPL-3.0 Presents an innovative AI-human collaboration framework with Model Context Protocol for bidirectional LLM-markdown communication and flexible knowledge structure for complex projects.
📊 GitHub Stats ![GitHub Stats for basic-memory](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=basic-memory&username=basicmachines-co&all_stats=true&stats_only=true)

[`claude-code-mcp-enhanced`](https://github.com/grahama1970/claude-code-mcp-enhanced/blob/main/CLAUDE.md)   by   [grahama1970](https://github.com/grahama1970)   ⚖️  MIT Provides detailed and emphatic instructions for Claude to follow as a coding agent, with testing guidance, code examples, and compliance checks.
📊 GitHub Stats ![GitHub Stats for claude-code-mcp-enhanced](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-code-mcp-enhanced&username=grahama1970&all_stats=true&stats_only=true)



## Alternative Clients 📱 [🔝](#awesome-claude-code) > Alternative Clients are alternative UIs and front-ends for interacting with Claude Code, either on mobile or on the desktop.

General 🔝

 [`Claudable`](https://github.com/opactorai/Claudable)   by   [Ethan Park](https://www.linkedin.com/in/seongil-park/)   ⚖️  MIT Claudable is an open-source web builder that leverages local CLI agents, such as Claude Code and Cursor Agent, to build and deploy products effortlessly.
📊 GitHub Stats ![GitHub Stats for Claudable](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=Claudable&username=opactorai&all_stats=true&stats_only=true)

[`claude-esp`](https://github.com/phiat/claude-esp)   by   [phiat](https://github.com/phiat)   ⚖️  MIT Go-based TUI that streams Claude Code's hidden output (thinking, tool calls, subagents) to a separate terminal. Watch multiple sessions simultaneously, filter by content type, and track background tasks. Ideal for debugging or understanding what Claude is doing under the hood without interrupting your main session.
📊 GitHub Stats ![GitHub Stats for claude-esp](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-esp&username=phiat&all_stats=true&stats_only=true)

[`claude-tmux`](https://github.com/nielsgroen/claude-tmux)   by   [Niels Groeneveld](https://github.com/nielsgroen)   ⚖️  NOASSERTION Manage Claude Code within tmux. A tmux popup of all your Claude Code instances, enabling quick switching, status monitoring, session lifecycle management, with git worktree and pull request support.
📊 GitHub Stats ![GitHub Stats for claude-tmux](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-tmux&username=nielsgroen&all_stats=true&stats_only=true)

[`crystal`](https://github.com/stravu/crystal)   by   [stravu](https://github.com/stravu)   ⚖️  MIT A full-fledged desktop application for orchestrating, monitoring, and interacting with Claude Code agents.
📊 GitHub Stats ![GitHub Stats for crystal](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=crystal&username=stravu&all_stats=true&stats_only=true)

[`Omnara`](https://github.com/omnara-ai/omnara)   by   [Ishaan Sehgal](https://github.com/ishaansehgal99)   ⚖️  Apache-2.0 A command center for AI agents that syncs Claude Code sessions across terminal, web, and mobile. Allows for remote monitoring, human-in-the-loop interaction, and team collaboration.
📊 GitHub Stats ![GitHub Stats for omnara](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=omnara&username=omnara-ai&all_stats=true&stats_only=true)



## Official Documentation 🏛️ [🔝](#awesome-claude-code) > Links to some of Anthropic's terrific documentation and resources regarding Claude Code

General 🔝

 [`Anthropic Documentation`](https://docs.claude.com/en/home)   by   [Anthropic](https://github.com/anthropics)   ⚖️  © The official documentation for Claude Code, including installation instructions, usage guidelines, API references, tutorials, examples, loads of information that I won't list individually. Like Claude Code, the documentation is frequently updated. [`Anthropic Quickstarts`](https://github.com/anthropics/claude-quickstarts)   by   [Anthropic](https://github.com/anthropics)   ⚖️  MIT Offers comprehensive development guides for three distinct AI-powered demo projects with standardized workflows, strict code style guidelines, and containerization instructions.
📊 GitHub Stats ![GitHub Stats for claude-quickstarts](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-quickstarts&username=anthropics&all_stats=true&stats_only=true)

[`Claude Code GitHub Actions`](https://github.com/anthropics/claude-code-action/tree/main/examples)   by   [Anthropic](https://github.com/anthropics)   ⚖️  MIT Official GitHub Actions integration for Claude Code with examples and documentation for automating AI-powered workflows in CI/CD pipelines.
📊 GitHub Stats ![GitHub Stats for claude-code-action](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-code-action&username=anthropics&all_stats=true&stats_only=true)


## Contributing [🔝](#awesome-claude-code) ### **[Recommend a new resource here!](https://github.com/hesreallyhim/awesome-claude-code/issues/new?template=recommend-resource.yml)** Recommending a resource for the list is very simple, and the automated system handles everything for you. Please do not open a PR to submit a recommendation - the only person who is allowed to submit PRs to this repo is Claude. Make sure that you have read the CONTRIBUTING.md document and CODE_OF_CONDUCT.md before you submit a recommendation. For suggestions about the repository itself, please [open a repository enhancement issue](https://github.com/hesreallyhim/awesome-claude-code/issues/new?template=repository-enhancement.yml). This project is released with a Code of Conduct. By participating, you agree to abide by its terms. And although I take strong measures to uphold the quality and safety of this list, I take no responsibility or liability for anything that might happen as a result of these third-party resources. ## Growing thanks to you [![Stargazers over time](https://starchart.cc/hesreallyhim/awesome-claude-code.svg?variant=adaptive)](https://starchart.cc/hesreallyhim/awesome-claude-code) ## License This list is licensed under [Creative Commons CC BY-NC-ND 4.0](https://creativecommons.org/licenses/by-nc-nd/4.0/) - this means you are welcome to fork, clone, copy and redistribute the list, provided you include appropriate attribution; however you are not permitted to distribute any modified versions or to use it for any commercial purposes. This is to prevent disregard for the licenses of the authors whose resources are listed here. Please note that all resources included in this list have their own license terms. ================================================ FILE: README_ALTERNATIVES/README_EXTRA.md ================================================

Pick Your Style:

Awesome Extra Classic Flat

[![Awesome](https://awesome.re/badge-flat2.svg)](https://awesome.re)
Awesome Claude Code Terminal

Featured Claude Code Projects

System Info Terminal
About Claude Code
Designed by Claude Code Web
Disclaimer: Not affiliated or endorsed by Anthropic PBC. Claude Code is a product of Anthropic.
                                      *
### ⚡ TERMINAL NAVIGATION ⚡
Agent Skills Workflows Tooling
Status Lines Hooks Slash Commands
CLAUDE.md Files Alternative Clients Documentation

LATEST ADDITIONS
Claude Scientific Skills _"A set of ready-to-use Agent Skills for research, science, engineering, analysis, finance and writing." That's their description - modest, simple. That's how you can tell this is really one of the best skills repos on GitHub. If you've ever thought about getting a PhD... just read all of these documents instead. Also I think it IS an AI agent or something? Awesome._ ![GitHub Stats for claude-scientific-skills](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-scientific-skills&username=K-Dense-AI&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000) parry _Prompt injection scanner for Claude Code hooks. Scans tool inputs and outputs for injection attacks, secrets, and data exfiltration attempts. [NOTE: Early development phase but worth a look.]_ ![GitHub Stats for parry](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=parry&username=vaporif&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000) Dippy _Auto-approve safe bash commands using AST-based parsing, while prompting for destructive operations. Solves permission fatigue without disabling safety. Supports Claude Code, Gemini CLI, and Cursor._ ![GitHub Stats for Dippy](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=Dippy&username=ldayton&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000) sudocode _Lightweight agent orchestration dev tool that lives in your repo. Integrates with various specification frameworks. It's giving Jira._ ![GitHub Stats for sudocode](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=sudocode&username=sudocode-ai&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000) claude-tmux _Manage Claude Code within tmux. A tmux popup of all your Claude Code instances, enabling quick switching, status monitoring, session lifecycle management, with git worktree and pull request support._ ![GitHub Stats for claude-tmux](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-tmux&username=nielsgroen&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000) claude-esp _Go-based TUI that streams Claude Code's hidden output (thinking, tool calls, subagents) to a separate terminal. Watch multiple sessions simultaneously, filter by content type, and track background tasks. Ideal for debugging or understanding what Claude is doing under the hood without interrupting your main session._ ![GitHub Stats for claude-esp](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-esp&username=phiat&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Directory Listing

Agent Skills

🔝 Back to top

Agent skills are model-controlled configurations (files, scripts, resources, etc.) that enable Claude Code to perform specialized tasks requiring specific knowledge or capabilities.

General AgentSys _Workflow automation system for Claude with a group of useful plugins, agents, and skills. Automates task-to-production workflows, PR management, code cleanup, performance investigation, drift detection, and multi-agent code review. Includes [agnix](https://github.com/avifenesh/agnix) for linting agent configurations. Built on thousands of lines of code with thousands of tests. Uses deterministic detection (regex, AST) with LLM judgment for efficiency. Used on many production systems._ ![GitHub Stats for agentsys](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=agentsys&username=avifenesh&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
AI Agent, AI Spy _Members from the Signal Foundation with some really great tips and tricks on how to turn your operating system into an instrument of total surveillance, and why some companies are doing this really awesome thing. [warning: YouTube link]_
Book Factory _A comprehensive pipeline of Skills that replicates traditional publishing infrastructure for nonfiction book creation using specialized Claude skills._ ![GitHub Stats for claude-skills](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-skills&username=robertguss&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
cc-devops-skills _Immensely detailed set of skills for DevOps Engineers (or anyone who has to deploy code, really). Works with validations, generators, shell scripts and CLI tools to create high quality IaC code for about any platform you've ever struggled painfully to work with. Worth downloading even just as a source of documentation._ ![GitHub Stats for cc-devops-skills](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=cc-devops-skills&username=akin-ozer&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Claude Code Agents _Comprehensive E2E development workflow with helpful Claude Code subagent prompts for solo devs. Run multiple auditors in parallel, automate fix cycles with micro-checkpoint protocols, and do browser-based QA. Includes strict protocols to prevent AI going rogue._ ![GitHub Stats for claude-code-agents](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-code-agents&username=undeadlist&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Claude Codex Settings _A well-organized, well-written set of plugins covering core developer activities, such as working with common cloud platforms like GitHub, Azure, MongoDB, and popular services such as Tavily, Playwright, and more. Clear, not overly-opinionated, and compatible with a few other providers._ ![GitHub Stats for claude-codex-settings](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-codex-settings&username=fcakyon&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Claude Mountaineering Skills _Claude Code skill that automates mountain route research for North American peaks. Aggregates data from 10+ mountaineering sources like Mountaineers.org, PeakBagger.com and SummitPost.com to generate detailed route beta reports with weather, avalanche conditions, and trip reports._ ![GitHub Stats for claude-mountaineering-skills](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-mountaineering-skills&username=dreamiurg&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Claude Scientific Skills _"A set of ready-to-use Agent Skills for research, science, engineering, analysis, finance and writing." That's their description - modest, simple. That's how you can tell this is really one of the best skills repos on GitHub. If you've ever thought about getting a PhD... just read all of these documents instead. Also I think it IS an AI agent or something? Awesome._ ![GitHub Stats for claude-scientific-skills](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-scientific-skills&username=K-Dense-AI&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Codex Skill _Enables users to prompt codex from claude code. Unlike the raw codex mcp server, this skill infers parameters such as model, reasoning effort, sandboxing from your prompt or asks you to specify them. It also simplifies continuing prior codex sessions so that codex can continue with the prior context._ ![GitHub Stats for skill-codex](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=skill-codex&username=skills-directory&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Compound Engineering Plugin _A very pragmatic set of well-designed agents, skills, and commands, built around a discipline of turning past mistakes and errors into lessons and opportunities for future growth and improvement. Good documentation._ ![GitHub Stats for compound-engineering-plugin](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=compound-engineering-plugin&username=EveryInc&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Context Engineering Kit _Hand-crafted collection of advanced context engineering techniques and patterns with minimal token footprint focused on improving agent result quality._ ![GitHub Stats for context-engineering-kit](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=context-engineering-kit&username=NeoLabHQ&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Everything Claude Code _Top-notch, well-written resources covering "just about everything" from core engineering domains. What's nice about this "everything-" store is most of the resources have significant standalone value and unlike some all-encompassing frameworks, although you can opt in to the author's own specific workflow patterns if you choose, the individual resources offer exemplary patterns in (just about) every Claude Code feature you can find (apologies to the Output Styles devotees)._ ![GitHub Stats for everything-claude-code](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=everything-claude-code&username=affaan-m&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Fullstack Dev Skills _A comprehensive Claude Code plugin with 65 specialized skills covering full-stack development across a wide range of specific frameworks. Features 9 project workflow commands for Jira/Confluence integration and, notably, an interesting approach to context engineering via a `/common-ground` command that surfaces Claude's hidden assumptions about your project. This is a smart thing to do._ ![GitHub Stats for claude-skills](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-skills&username=jeffallan&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
read-only-postgres _Read-only PostgreSQL query skill for Claude Code. Executes SELECT/SHOW/EXPLAIN/WITH queries across configured databases with strict validation, timeouts, and row limits. Supports multiple connections with descriptions for database selection._ ![GitHub Stats for agent-skills](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=agent-skills&username=jawwadfirdousi&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Superpowers _A strong bundle of core competencies for software engineering, with good coverage of a large portion of the SDLC - from planning, reviewing, testing, debugging... Well written, well organized, and adaptable. The author refers to them as "superpowers", but many of them are just consolidating engineering best practices - which sometimes does feel like a superpower when working with Claude Code._ ![GitHub Stats for superpowers](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=superpowers&username=obra&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Trail of Bits Security Skills _A very professional collection of over a dozen security-focused skills for code auditing and vulnerability detection. Includes skills for static analysis with CodeQL and Semgrep, variant analysis across codebases, fix verification, and differential code review._ ![GitHub Stats for skills](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=skills&username=trailofbits&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
TÂCHES Claude Code Resources _A well-balanced, "down-to-Earth" set of sub agents, skills, and commands, that are well-organized, easy to read, and a healthy focus on "meta"-skills/agents, like "skill-auditor", hook creation, etc. - the kind of things you can adapt to your workflow, and not the other way around._ ![GitHub Stats for taches-cc-resources](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=taches-cc-resources&username=glittercowboy&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Web Assets Generator Skill _Easily generate web assets from Claude Code including favicons, app icons (PWA), and social media meta images (Open Graph) for Facebook, Twitter, WhatsApp, and LinkedIn. Handles image resizing, text-to-image generation, emojis, and provides proper HTML meta tags._ ![GitHub Stats for web-asset-generator](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=web-asset-generator&username=alonw0&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)

Workflows & Knowledge Guides

🔝 Back to top

A workflow is a tightly coupled set of Claude Code-native resources that facilitate specific projects

General AB Method _A principled, spec-driven workflow that transforms large problems into focused, incremental missions using Claude Code's specialized sub agents. Includes slash-commands, sub agents, and specialized workflows designed for specific parts of the SDLC._ ![GitHub Stats for ab-method](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=ab-method&username=ayoubben18&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Agentic Workflow Patterns _A comprehensive and well-documented collection of agentic patterns from Anthropic docs, with colorful Mermaid diagrams and code examples for each pattern. Covers Subagent Orchestration, Progressive Skills, Parallel Tool Calling, Master-Clone Architecture, Wizard Workflows, and more. Also compatible with other providers._ ![GitHub Stats for agentic-workflow-patterns](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=agentic-workflow-patterns&username=ThibautMelen&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Blogging Platform Instructions _Provides a well-structured set of commands for publishing and maintaining a blogging platform, including commands for creating posts, managing categories, and handling media files._ ![GitHub Stats for cloudartisan.github.io](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=cloudartisan.github.io&username=cloudartisan&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Claude Code Documentation Mirror _A mirror of the Anthropic © PBC documentation pages for Claude Code, updated every few hours. Can come in handy when trying to stay on top of the ever-expanding feature-set of Dr. Claw D. Code, Ph.D._ ![GitHub Stats for claude-code-docs](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-code-docs&username=ericbuess&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Claude Code Handbook _Collection of best practices, tips, and techniques for Claude Code development workflows, enhanced with distributable plugins_
Claude Code Infrastructure Showcase _A remarkably innovative approach to working with Skills, the centerpiece of which being a technique that leverages hooks to ensure that Claude intelligently selects and activates the appropriate Skill given the current context. Well-documented and adaptable to different projects and workflows._ ![GitHub Stats for claude-code-infrastructure-showcase](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-code-infrastructure-showcase&username=diet103&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Claude Code PM _Really comprehensive and feature-packed project-management workflow for Claude Code. Numerous specialized agents, slash-commands, and strong documentation._ ![GitHub Stats for ccpm](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=ccpm&username=automazeio&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Claude Code Repos Index _This is either the work of a prolific genius, or a very clever bot (or both), although it hardly matters because the quality is so good - an index of 75+ Claude Code repositories published by the author - and I'm not talking about slop. CMS, system design, deep research, IoT, agentic workflows, server management, personal health... If you spot the lie, let me know, otherwise please check these out._ ![GitHub Stats for Claude-Code-Repos-Index](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=Claude-Code-Repos-Index&username=danielrosehill&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Claude Code System Prompts _All parts of Claude Code's system prompt, including builtin tool descriptions, sub agent prompts (Plan/Explore/Task), utility prompts (CLAUDE.md, compact, Bash cmd, security review, agent creation, etc.). Updated for each Claude Code version._ ![GitHub Stats for claude-code-system-prompts](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-code-system-prompts&username=Piebald-AI&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Claude Code Tips _A nice variety of 35+ brief but information-dense Claude Code tips covering voice input, system prompt patching, container workflows for risky tasks, conversation cloning(!), multi-model orchestration with Gemini CLI, and plenty more. Nice demos, working scripts, a plugin, I'd say this probably has a little something for everyone._ ![GitHub Stats for claude-code-tips](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-code-tips&username=ykdojo&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Claude Code Ultimate Guide _A tremendous feat of documentation, this guide covers Claude Code from beginner to power user, with production-ready templates for Claude Code features, guides on agentic workflows, and a lot of great learning materials, including quizzes and a handy "cheatsheet". Whether it's the "ultimate" guide to Claude Code will be up to the reader, but a valuable resource nonetheless (as with all documentation sites, make sure it's up to date before you bet the farm)._ ![GitHub Stats for claude-code-ultimate-guide](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-code-ultimate-guide&username=FlorianBruniaux&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Claude CodePro _Professional development environment for Claude Code with spec-driven workflow, TDD enforcement, cross-session memory, semantic search, quality hooks, and modular rules integration. A bit "heavyweight" but feature-packed and has wide coverage._ ![GitHub Stats for claude-codepro](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-codepro&username=maxritter&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
claude-code-docs _A mirror of the Anthropic© PBC documentation site for Claude/Code, but with bonus features like full-text search and query-time updates - a nice companion to `claude-code-docs` for up-to-the-minute, fully-indexed information so that Claude Code can read about itself._ ![GitHub Stats for claude-code-docs](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-code-docs&username=costiash&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
ClaudoPro Directory _Well-crafted, wide selection of Claude Code hooks, slash commands, subagent files, and more, covering a range of specialized tasks and workflows. Better resources than your average "Claude-template-for-everything" site._ ![GitHub Stats for claudepro-directory](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claudepro-directory&username=JSONbored&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Context Priming _Provides a systematic approach to priming Claude Code with comprehensive project context through specialized commands for different project scenarios and development contexts._ ![GitHub Stats for just-prompt](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=just-prompt&username=disler&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Design Review Workflow _A tailored workflow for enabling automated UI/UX design review, including specialized sub agents, slash commands, `CLAUDE.md` excerpts, and more. Covers a broad range of criteria from responsive design to accessibility._ ![GitHub Stats for claude-code-workflows](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-code-workflows&username=OneRedOak&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Laravel TALL Stack AI Development Starter Kit _Transform your Laravel TALL (Tailwind, AlpineJS, Laravel, Livewire) stack development with comprehensive Claude Code configurations that provide intelligent assistance, systematic workflows, and domain expert consultation._ ![GitHub Stats for laravel-tall-claude-ai-configs](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=laravel-tall-claude-ai-configs&username=tott&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Learn Claude Code _A really interesting analysis of how coding agents like Claude Code are designed. It attempts to break an agent down into its fundamental parts and reconstruct it with minimal code. Great learning resource. Final product is a rudimentary agent with skills, sub-agents, and a todo-list in roughly a few hundred lines of Python._ ![GitHub Stats for learn-claude-code](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=learn-claude-code&username=shareAI-lab&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
learn-faster-kit _A creative educational framework for Claude Code, inspired by the "FASTER" approach to self-teaching. Ships with a variety of agents, slash commands, and tools that enable Claude Code to help you progress at your own pace, employing well-established pedagogical techniques like active learning and spaced repetition._ ![GitHub Stats for learn-faster-kit](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=learn-faster-kit&username=cheukyin175&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
n8n_agent _Amazing comprehensive set of comments for code analysis, QA, design, documentation, project structure, project management, optimization, and many more._ ![GitHub Stats for n8n_agent](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=n8n_agent&username=kingler&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Project Bootstrapping and Task Management _Provides a structured set of commands for bootstrapping and managing a new project, including meta-commands for creating and editing custom slash-commands._ ![GitHub Stats for steadystart](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=steadystart&username=steadycursor&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Project Management, Implementation, Planning, and Release _Really comprehensive set of commands for all aspects of SDLC._ ![GitHub Stats for command](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=command&username=scopecraft&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Project Workflow System _A set of commands that provide a comprehensive workflow system for managing projects, including task management, code review, and deployment processes._ ![GitHub Stats for dotfiles](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=dotfiles&username=harperreed&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
RIPER Workflow _Structured development workflow enforcing separation between Research, Innovate, Plan, Execute, and Review phases. Features consolidated subagents for context-efficiency, branch-aware memory bank, and strict mode enforcement for guided development._ ![GitHub Stats for claude-code-riper-5](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-code-riper-5&username=tony&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Shipping Real Code w/ Claude _A detailed blog post explaining the author's process for shipping a product with Claude Code, including CLAUDE.md files and other interesting resources._
Simone _A broader project management workflow for Claude Code that encompasses not just a set of commands, but a system of documents, guidelines, and processes to facilitate project planning and execution._ ![GitHub Stats for claude-simone](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-simone&username=Helmi&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Ralph Wiggum awesome-ralph _A curated list of resources about Ralph, the AI coding technique that runs AI coding agents in automated loops until specifications are fulfilled._ ![GitHub Stats for awesome-ralph](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=awesome-ralph&username=snwfdhmp&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Ralph for Claude Code _An autonomous AI development framework that enables Claude Code to work iteratively on projects until completion. Features intelligent exit detection, rate limiting, circuit breaker patterns, and comprehensive safety guardrails to prevent infinite loops and API overuse. Built with Bash, integrated with tmux for live monitoring, and includes 75+ comprehensive tests._ ![GitHub Stats for ralph-claude-code](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=ralph-claude-code&username=frankbria&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Ralph Wiggum Marketer _A Claude Code plugin that provides an autonomous AI copywriter, integrating the Ralph loop with customized knowledge bases for market research agents. The agents do the research, Ralph writes the copy, you stay in bed. Whether or not you practice Ralph-Driven Development (RDD), I think these projects are interesting and creative explorations of general agentic patterns._ ![GitHub Stats for ralph-wiggum-marketer](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=ralph-wiggum-marketer&username=muratcankoylan&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
ralph-orchestrator _Ralph Orchestrator implements the simple but effective "Ralph Wiggum" technique for autonomous task completion, continuously running an AI agent against a prompt file until the task is marked as complete or limits are reached. This implementation provides a robust, well-tested, and feature-complete orchestration system for AI-driven development. Also cited in the Anthropic Ralph plugin documentation._ ![GitHub Stats for ralph-orchestrator](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=ralph-orchestrator&username=mikeyobrien&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
ralph-wiggum-bdd _A standalone Bash script for Behavior-Driven Development with Ralph Wiggum Loop. In principle, while running unattended, the script can keep code and requirements in sync, but in practice it still requires interactive human supervision, so it supports both modes. The script is standalone and can be modified and committed into your project._ ![GitHub Stats for ralph-wiggum-bdd](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=ralph-wiggum-bdd&username=marcindulak&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
The Ralph Playbook _A remarkably detailed and comprehensive guide to the Ralph Wiggum technique, featuring well-written theoretical commentary paired with practical guidelines and advice._ ![GitHub Stats for ralph-playbook](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=ralph-playbook&username=ClaytonFarr&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)

Tooling

🔝 Back to top

Tooling denotes applications that are built on top of Claude Code and consist of more components than slash-commands and `CLAUDE.md` files

General cc-sessions _An opinionated approach to productive development with Claude Code_ ![GitHub Stats for cc-sessions](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=cc-sessions&username=GWUDCAP&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
cc-tools _High-performance Go implementation of Claude Code hooks and utilities. Provides smart linting, testing, and statusline generation with minimal overhead._ ![GitHub Stats for cc-tools](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=cc-tools&username=Veraticus&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
ccexp _Interactive CLI tool for discovering and managing Claude Code configuration files and slash commands with a beautiful terminal UI._ ![GitHub Stats for ccexp](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=ccexp&username=nyatinte&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
cchistory _Like the shell history command but for your Claude Code sessions. Easily list all Bash or "Bash-mode" (`!`) commands Claude Code ran in a session for reference._ ![GitHub Stats for cchistory](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=cchistory&username=eckardt&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
cclogviewer _A humble but handy utility for viewing Claude Code `.jsonl` conversation files in a pretty HTML UI._ ![GitHub Stats for cclogviewer](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=cclogviewer&username=Brads3290&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Claude Code Templates _Incredibly awesome collection of resources from every category in this list, presented with a neatly polished UI, great features like usage dashboard, analytics, and everything from slash commands to hooks to agents. An awesome companion for this awesome list._ ![GitHub Stats for claude-code-templates](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-code-templates&username=davila7&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Claude Composer _A tool that adds small enhancements to Claude Code._ ![GitHub Stats for claude-composer](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-composer&username=possibilities&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Claude Hub _A webhook service that connects Claude Code to GitHub repositories, enabling AI-powered code assistance directly through pull requests and issues. This integration allows Claude to analyze repositories, answer technical questions, and help developers understand and improve their codebase through simple @mentions._ ![GitHub Stats for claude-hub](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-hub&username=claude-did-this&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Claude Session Restore _Efficiently restore context from previous Claude Code sessions by analyzing session files and git history. Features multi-factor data collection across numerous Claude Code capacities with time-based filtering. Uses tail-based parsing for efficient handling of large session files up to 2GB. Includes both a CLI tool for manual analysis and a Claude Code skill for automatic session restoration._ ![GitHub Stats for claude-session-restore](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-session-restore&username=ZENG3LD&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
claude-code-tools _Well-crafted toolset for session continuity, featuring skills/commands to avoid compaction and recover context across sessions with cross-agent handoff between Claude Code and Codex CLI. Includes a fast Rust/Tantivy-powered full-text session search (TUI for humans, skill/CLI for agents), tmux-cli skill + command for interacting with scripts and CLI agents, and safety hooks to block dangerous commands._ ![GitHub Stats for claude-code-tools](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-code-tools&username=pchalasani&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
claude-starter-kit _This is a starter template repository designed to provide a complete development environment for Claude-Code with pre-configured MCP servers and tools for AI-powered development workflows. The repository is intentionally minimal, containing only configuration templates for three primary systems: Claude Code, Serena, and Task Master._ ![GitHub Stats for claude-starter-kit](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-starter-kit&username=serpro69&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
claudekit _Impressive CLI toolkit providing auto-save checkpointing, code quality hooks, specification generation and execution, and 20+ specialized subagents including oracle (gpt-5), code-reviewer (6-aspect deep analysis), ai-sdk-expert (Vercel AI SDK), typescript-expert and many more for Claude Code workflows._ ![GitHub Stats for claudekit](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claudekit&username=carlrannaberg&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Container Use _Development environments for coding agents. Enable multiple agents to work safely and independently with your preferred stack._ ![GitHub Stats for container-use](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=container-use&username=dagger&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
ContextKit _A systematic development framework that transforms Claude Code into a proactive development partner. Features 4-phase planning methodology, specialized quality agents, and structured workflows that help AI produce production-ready code on first try._ ![GitHub Stats for ContextKit](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=ContextKit&username=FlineDev&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
recall _Full-text search your Claude Code sessions. Run `recall` in terminal, type to search, Enter to resume. Alternative to `claude --resume`._ ![GitHub Stats for recall](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=recall&username=zippoxer&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Rulesync _A Node.js CLI tool that automatically generates configs (rules, ignore files, MCP servers, commands, and subagents) for various AI coding agents. Rulesync can convert configs between Claude Code and other AI agents in both directions._ ![GitHub Stats for rulesync](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=rulesync&username=dyoshikawa&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
run-claude-docker _A self-contained Docker runner that forwards your current workspace into a safe(r) isolated docker container, where you still have access to your Claude Code settings, authentication, ssh agent, pgp, optionally aws keys etc._ ![GitHub Stats for run-claude-docker](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=run-claude-docker&username=icanhasjonas&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
stt-mcp-server-linux _A push-to-talk speech transcription setup for Linux using a Python MCP server. Runs locally in Docker with no external API calls. Your speech is recorded, transcribed into text, and then sent to Claude running in a Tmux session._ ![GitHub Stats for stt-mcp-server-linux](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=stt-mcp-server-linux&username=marcindulak&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
SuperClaude _A versatile configuration framework that enhances Claude Code with specialized commands, cognitive personas, and development methodologies, such as "Introspection" and "Orchestration"._ ![GitHub Stats for SuperClaude_Framework](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=SuperClaude_Framework&username=SuperClaude-Org&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
tweakcc _Command-line tool to customize your Claude Code styling._ ![GitHub Stats for tweakcc](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=tweakcc&username=Piebald-AI&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Vibe-Log _Analyzes your Claude Code prompts locally (using CC), provides intelligent session analysis and actionable strategic guidance - works in the statusline and produces very pretty HTML reports as well. Easy to install and remove._ ![GitHub Stats for vibe-log-cli](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=vibe-log-cli&username=vibe-log&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
viwo-cli _Run Claude Code in a Docker container with git worktrees as volume mounts to enable safer usage of `--dangerously-skip-permissions` for frictionless one-shotting prompts. Allows users to spin up multiple instances of Claude Code in the background easily with reduced permission fatigue._ ![GitHub Stats for viwo](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=viwo&username=OverseedAI&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
VoiceMode MCP _VoiceMode MCP brings natural conversations to Claude Code. It supports any OpenAI API compatible voice services and installs free and open source voice services (Whisper.cpp and Kokoro-FastAPI)._ ![GitHub Stats for voicemode](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=voicemode&username=mbailey&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
IDE Integrations Claude Code Chat _An elegant and user-friendly Claude Code chat interface for VS Code._
claude-code-ide.el _claude-code-ide.el integrates Claude Code with Emacs, like Anthropic’s VS Code/IntelliJ extensions. It shows ediff-based code suggestions, pulls LSP/flymake/flycheck diagnostics, and tracks buffer context. It adds an extensible MCP tool support for symbol refs/defs, project metadata, and tree-sitter AST queries._ ![GitHub Stats for claude-code-ide.el](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-code-ide.el&username=manzaltu&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
claude-code.el _An Emacs interface for Claude Code CLI._ ![GitHub Stats for claude-code.el](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-code.el&username=stevemolitor&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
claude-code.nvim _A seamless integration between Claude Code AI assistant and Neovim._ ![GitHub Stats for claude-code.nvim](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-code.nvim&username=greggh&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Claudix - Claude Code for VSCode _A VSCode extension that brings Claude Code directly into your editor with interactive chat interface, session management, intelligent file operations, terminal execution, and real-time streaming responses. Built with Vue 3, TypeScript._ ![GitHub Stats for Claudix](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=Claudix&username=Haleclipse&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Usage Monitors CC Usage _Handy CLI tool for managing and analyzing Claude Code usage, based on analyzing local Claude Code logs. Presents a nice dashboard regarding cost information, token consumption, etc._ ![GitHub Stats for ccusage](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=ccusage&username=ryoppippi&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
ccflare _Claude Code usage dashboard with a web-UI that would put Tableau to shame. Thoroughly comprehensive metrics, frictionless setup, detailed logging, really really nice UI._ ![GitHub Stats for ccflare](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=ccflare&username=snipeship&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
ccflare -> **better-ccflare** _A well-maintained and feature-enhanced fork of the glorious `ccflare` usage dashboard by @snipeship (which at the time of writing has not had an update in a few months). `better-ccflare` builds on this foundation with some performance enhancements, extended provider support, bug fixes, Docker deployment, and more._ ![GitHub Stats for better-ccflare](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=better-ccflare&username=tombii&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Claude Code Usage Monitor _A real-time terminal-based tool for monitoring Claude Code token usage. It shows live token consumption, burn rate, and predictions for token depletion. Features include visual progress bars, session-aware analytics, and support for multiple subscription plans._ ![GitHub Stats for Claude-Code-Usage-Monitor](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=Claude-Code-Usage-Monitor&username=Maciek-roboblog&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Claudex _Claudex - A web-based browser for exploring your Claude Code conversation history across projects. Indexes your codebase for full-text search. Nice, easy-to-navigate UI. Simple dashboard interface for high-level analytics, and multiple export options as well. (And completely local w/ no telemetry!)_ ![GitHub Stats for claudex](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claudex&username=kunwar-shah&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
viberank _A community-driven leaderboard tool that enables developers to visualize, track, and compete based on their Claude Code usage statistics. It features robust data analytics, GitHub OAuth, data validation, and user-friendly CLI/web submission methods._ ![GitHub Stats for viberank](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=viberank&username=sculptdotfun&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Orchestrators Auto-Claude _Autonomous multi-agent coding framework for Claude Code (Claude Agent SDK) that integrates the full SDLC - "plans, builds, and validates software for you". Features a slick kanban-style UI and a well-designed but not over-engineered agent orchestration system._ ![GitHub Stats for Auto-Claude](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=Auto-Claude&username=AndyMik90&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Claude Code Flow _This mode serves as a code-first orchestration layer, enabling Claude to write, edit, test, and optimize code autonomously across recursive agent cycles._ ![GitHub Stats for claude-code-flow](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-code-flow&username=ruvnet&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Claude Squad _Claude Squad is a terminal app that manages multiple Claude Code, Codex (and other local agents including Aider) in separate workspaces, allowing you to work on multiple tasks simultaneously._ ![GitHub Stats for claude-squad](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-squad&username=smtg-ai&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Claude Swarm _Launch Claude Code session that is connected to a swarm of Claude Code Agents._ ![GitHub Stats for claude-swarm](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-swarm&username=parruda&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Claude Task Master _A task management system for AI-driven development with Claude, designed to work seamlessly with Cursor AI._ ![GitHub Stats for claude-task-master](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-task-master&username=eyaltoledano&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Claude Task Runner _A specialized tool to manage context isolation and focused task execution with Claude Code, solving the critical challenge of context length limitations and task focus when working with Claude on complex, multi-step projects._ ![GitHub Stats for claude-task-runner](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-task-runner&username=grahama1970&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Happy Coder _Spawn and control multiple Claude Codes in parallel from your phone or desktop. Happy Coder runs Claude Code on your hardware, sends push notifications when Claude needs more input or permission, and costs nothing._ ![GitHub Stats for happy](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=happy&username=slopus&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
sudocode _Lightweight agent orchestration dev tool that lives in your repo. Integrates with various specification frameworks. It's giving Jira._ ![GitHub Stats for sudocode](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=sudocode&username=sudocode-ai&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
The Agentic Startup _Yet Another Claude Orchestrator - a collection of agents, commands, etc., for shipping production code - but I like this because it's comprehensive, well-written, and one of the few resources that actually uses Output Styles! +10 points!_ ![GitHub Stats for the-startup](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=the-startup&username=rsmdt&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
TSK - AI Agent Task Manager and Sandbox _A Rust CLI tool that lets you delegate development tasks to AI agents running in sandboxed Docker environments. Multiple agents work in parallel, returning git branches for human review._ ![GitHub Stats for tsk](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=tsk&username=dtormoen&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Config Managers claude-rules-doctor _CLI that detects dead `.claude/rules/` files by checking if `paths:` globs actually match files in your repo. Catches silent rule failures where renamed directories or typos in glob patterns cause rules to never apply. Features CI mode (exit 1 on dead rules), JSON output, and verbose mode showing matched files._ ![GitHub Stats for claude-rules-doctor](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-rules-doctor&username=nulone&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
ClaudeCTX _claudectx lets you switch your entire Claude Code configuration with a single command._ ![GitHub Stats for claudectx](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claudectx&username=foxj77&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)

Status Lines

🔝 Back to top

Status lines - Configurations and customizations for Claude Code's status bar functionality

General CCometixLine - Claude Code Statusline _A high-performance Claude Code statusline tool written in Rust with Git integration, usage tracking, interactive TUI configuration, and Claude Code enhancement utilities._ ![GitHub Stats for CCometixLine](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=CCometixLine&username=Haleclipse&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
ccstatusline _A highly customizable status line formatter for Claude Code CLI that displays model info, git branch, token usage, and other metrics in your terminal._ ![GitHub Stats for ccstatusline](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=ccstatusline&username=sirmalloc&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
claude-code-statusline _Enhanced 4-line statusline for Claude Code with themes, cost tracking, and MCP server monitoring_ ![GitHub Stats for claude-code-statusline](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-code-statusline&username=rz1989s&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
claude-powerline _A vim-style powerline statusline for Claude Code with real-time usage tracking, git integration, custom themes, and more_ ![GitHub Stats for claude-powerline](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-powerline&username=Owloops&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
claudia-statusline _High-performance Rust-based statusline for Claude Code with persistent stats tracking, progress bars, and optional cloud sync. Features SQLite-first persistence, git integration, context progress bars, burn rate calculation, XDG-compliant with theme support (dark/light, NO_COLOR)._ ![GitHub Stats for claudia-statusline](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claudia-statusline&username=hagan&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)

Hooks

🔝 Back to top

Hooks are a powerful API for Claude Code that allows users to activate commands and run scripts at different points in Claude's agentic lifecycle.

General Britfix _Claude outputs American spellings by default, which can have an impact on: professional credibility, compliance, documentation, and more. Britfix converts to British English, with a Claude Code hook for automatic conversion as files are written. Context-aware: handles code files intelligently by only converting comments and docstrings, never identifiers or string literals._ ![GitHub Stats for britfix](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=britfix&username=Talieisin&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
CC Notify _CCNotify provides desktop notifications for Claude Code, alerting you to input needs or task completion, with one-click jumps back to VS Code and task duration display._ ![GitHub Stats for CCNotify](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=CCNotify&username=dazuiba&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
cchooks _A lightweight Python SDK with a clean API and good documentation; simplifies the process of writing hooks and integrating them into your codebase, providing a nice abstraction over the JSON configuration files._ ![GitHub Stats for cchooks](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=cchooks&username=GowayLee&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Claude Code Hook Comms (HCOM) _Lightweight CLI tool for real-time communication between Claude Code sub agents using hooks. Enables multi-agent collaboration with @-mention targeting, live dashboard monitoring, and zero-dependency implementation. [NOTE: At the time of posting, this resource is a little unstable - I'm sharing it anyway, because I think it's incredibly promising and creative. I hope by the time you read this, it is production-ready.]_ ![GitHub Stats for claude-hook-comms](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-hook-comms&username=aannoo&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
claude-code-hooks-sdk _A Laravel-inspired PHP SDK for building Claude Code hook responses with a clean, fluent API. This SDK makes it easy to create structured JSON responses for Claude Code hooks using an expressive, chainable interface._ ![GitHub Stats for claude-hooks-sdk](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-hooks-sdk&username=beyondcode&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
claude-hooks _A TypeScript-based system for configuring and customizing Claude Code hooks with a powerful and flexible interface._ ![GitHub Stats for claude-hooks](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-hooks&username=johnlindquist&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Claudio _A no-frills little library that adds delightful OS-native sounds to Claude Code via simple hooks. It really sparks joy._ ![GitHub Stats for claudio](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claudio&username=ctoth&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Dippy _Auto-approve safe bash commands using AST-based parsing, while prompting for destructive operations. Solves permission fatigue without disabling safety. Supports Claude Code, Gemini CLI, and Cursor._ ![GitHub Stats for Dippy](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=Dippy&username=ldayton&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
parry _Prompt injection scanner for Claude Code hooks. Scans tool inputs and outputs for injection attacks, secrets, and data exfiltration attempts. [NOTE: Early development phase but worth a look.]_ ![GitHub Stats for parry](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=parry&username=vaporif&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
TDD Guard _A hooks-driven system that monitors file operations in real-time and blocks changes that violate TDD principles._ ![GitHub Stats for tdd-guard](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=tdd-guard&username=nizos&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
TypeScript Quality Hooks _Quality check hook for Node.js TypeScript projects with TypeScript compilation. ESLint auto-fixing, and Prettier formatting. Uses SHA256 config caching for < 5ms validation performance during real-time editing._ ![GitHub Stats for claude-code-typescript-hooks](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-code-typescript-hooks&username=bartolli&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)

Slash-Commands

🔝 Back to top

"Slash Commands are customized, carefully refined prompts that control Claude's behavior in order to perform a specific task"

General /create-hook _Slash command for hook creation - intelligently prompts you through the creation process with smart suggestions based on your project setup (TS, Prettier, ESLint...)._ ![GitHub Stats for automated-notebooklm](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=automated-notebooklm&username=omril321&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
/linux-desktop-slash-commands _A library of slash commands intended specifically to facilitate common and advanced operations on Linux desktop environments (although many would also be useful on Linux servers). Command groups include hardware benchmarking, filesystem organisation, and security posture validation._ ![GitHub Stats for Claude-Code-Linux-Desktop-Slash-Commands](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=Claude-Code-Linux-Desktop-Slash-Commands&username=danielrosehill&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Version Control & Git /analyze-issue _Fetches GitHub issue details to create comprehensive implementation specifications, analyzing requirements and planning structured approach with clear implementation steps._ ![GitHub Stats for Narraitor](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=Narraitor&username=jerseycheese&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
/commit _Creates git commits using conventional commit format with appropriate emojis, following project standards and creating descriptive messages that explain the purpose of changes._ ![GitHub Stats for tevm-monorepo](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=tevm-monorepo&username=evmts&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
/commit-fast _Automates git commit process by selecting the first suggested message, generating structured commits with consistent formatting while skipping manual confirmation and removing Claude co-Contributorship footer_ ![GitHub Stats for steadystart](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=steadystart&username=steadycursor&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
/create-pr _Streamlines pull request creation by handling the entire workflow: creating a new branch, committing changes, formatting modified files with Biome, and submitting the PR._ ![GitHub Stats for giselle](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=giselle&username=toyamarinyon&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
/create-pull-request _Provides comprehensive PR creation guidance with GitHub CLI, enforcing title conventions, following template structure, and offering concrete command examples with best practices._ ![GitHub Stats for liam](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=liam&username=liam-hq&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
/create-worktrees _Creates git worktrees for all open PRs or specific branches, handling branches with slashes, cleaning up stale worktrees, and supporting custom branch creation for development._ ![GitHub Stats for tevm-monorepo](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=tevm-monorepo&username=evmts&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
/fix-github-issue _Analyzes and fixes GitHub issues using a structured approach with GitHub CLI for issue details, implementing necessary code changes, running tests, and creating proper commit messages._ ![GitHub Stats for kotlinter-gradle](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=kotlinter-gradle&username=jeremymailen&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
/fix-issue _Addresses GitHub issues by taking issue number as parameter, analyzing context, implementing solution, and testing/validating the fix for proper integration._ ![GitHub Stats for metabase](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=metabase&username=metabase&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
/fix-pr _Fetches and fixes unresolved PR comments by automatically retrieving feedback, addressing reviewer concerns, making targeted code improvements, and streamlining the review process._ ![GitHub Stats for metabase](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=metabase&username=metabase&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
/husky _Sets up and manages Husky Git hooks by configuring pre-commit hooks, establishing commit message standards, integrating with linting tools, and ensuring code quality on commits._ ![GitHub Stats for tevm-monorepo](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=tevm-monorepo&username=evmts&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
/update-branch-name _Updates branch names with proper prefixes and formats, enforcing naming conventions, supporting semantic prefixes, and managing remote branch updates._ ![GitHub Stats for giselle](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=giselle&username=giselles-ai&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Code Analysis & Testing /check _Performs comprehensive code quality and security checks, featuring static analysis integration, security vulnerability scanning, code style enforcement, and detailed reporting._ ![GitHub Stats for slack-tools](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=slack-tools&username=rygwdn&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
/code_analysis _Provides a menu of advanced code analysis commands for deep inspection, including knowledge graph generation, optimization suggestions, and quality evaluation._ ![GitHub Stats for n8n_agent](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=n8n_agent&username=kingler&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
/optimize _Analyzes code performance to identify bottlenecks, proposing concrete optimizations with implementation guidance for improved application performance._ ![GitHub Stats for ai-project-rules](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=ai-project-rules&username=to4iki&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
/repro-issue _Creates reproducible test cases for GitHub issues, ensuring tests fail reliably and documenting clear reproduction steps for developers._ ![GitHub Stats for metabase](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=metabase&username=rzykov&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
/tdd _Guides development using Test-Driven Development principles, enforcing Red-Green-Refactor discipline, integrating with git workflow, and managing PR creation._ ![GitHub Stats for pane](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=pane&username=zscott&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
/tdd-implement _Implements Test-Driven Development by analyzing feature requirements, creating tests first (red), implementing minimal passing code (green), and refactoring while maintaining tests._ ![GitHub Stats for Narraitor](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=Narraitor&username=jerseycheese&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Context Loading & Priming /context-prime _Primes Claude with comprehensive project understanding by loading repository structure, setting development context, establishing project goals, and defining collaboration parameters._ ![GitHub Stats for elizaos.github.io](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=elizaos.github.io&username=elizaOS&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
/initref _Initializes reference documentation structure with standard doc templates, API reference setup, documentation conventions, and placeholder content generation._ ![GitHub Stats for cubestat](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=cubestat&username=okuvshynov&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
/load-llms-txt _Loads LLM configuration files to context, importing specific terminology, model configurations, and establishing baseline terminology for AI discussions._ ![GitHub Stats for xatu-data](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=xatu-data&username=ethpandaops&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
/load_coo_context _References specific files for sparse matrix operations, explains transform usage, compares with previous approaches, and sets data formatting context for development._ ![GitHub Stats for torchcell](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=torchcell&username=Mjvolk3&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
/load_dango_pipeline _Sets context for model training by referencing pipeline files, establishing working context, and preparing for pipeline work with relevant documentation._ ![GitHub Stats for torchcell](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=torchcell&username=Mjvolk3&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
/prime _Sets up initial project context by viewing directory structure and reading key files, creating standardized context with directory visualization and key documentation focus._ ![GitHub Stats for AI-Engineering-Structure](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=AI-Engineering-Structure&username=yzyydev&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
/rsi _Reads all commands and key project files to optimize AI-assisted development by streamlining the process, loading command context, and setting up for better development workflow._ ![GitHub Stats for si](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=si&username=ddisisto&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Documentation & Changelogs /add-to-changelog _Adds new entries to changelog files while maintaining format consistency, properly documenting changes, and following established project standards for version tracking._ ![GitHub Stats for blockdoc-python](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=blockdoc-python&username=berrydev-ai&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
/create-docs _Analyzes code structure and purpose to create comprehensive documentation detailing inputs/outputs, behavior, user interaction flows, and edge cases with error handling._ ![GitHub Stats for Narraitor](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=Narraitor&username=jerseycheese&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
/docs _Generates comprehensive documentation that follows project structure, documenting APIs and usage patterns with consistent formatting for better user understanding._ ![GitHub Stats for coffee-analytics](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=coffee-analytics&username=slunsford&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
/explain-issue-fix _Documents solution approaches for GitHub issues, explaining technical decisions, detailing challenges overcome, and providing implementation context for better understanding._ ![GitHub Stats for toban-contribution-viewer](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=toban-contribution-viewer&username=hackdays-io&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
/update-docs _Reviews current documentation status, updates implementation progress, reviews phase documents, and maintains documentation consistency across the project._ ![GitHub Stats for Flutter-Structurizr](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=Flutter-Structurizr&username=Consiliency&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
CI / Deployment /release _Manages software releases by updating changelogs, reviewing README changes, evaluating version increments, and documenting release changes for better version tracking._ ![GitHub Stats for webdown](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=webdown&username=kelp&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
/run-ci _Activates virtual environments, runs CI-compatible check scripts, iteratively fixes errors, and ensures all tests pass before completion._ ![GitHub Stats for toban-contribution-viewer](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=toban-contribution-viewer&username=hackdays-io&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Project & Task Management /create-command _Guides Claude through creating new custom commands with proper structure by analyzing requirements, templating commands by category, enforcing command standards, and creating supporting documentation._ ![GitHub Stats for command](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=command&username=scopecraft&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
/create-plan _Generates comprehensive product requirement documents outlining detailed specifications, requirements, and features following standardized document structure and format._* * Removed from origin
/create-prp _Creates product requirement plans by reading PRP methodology, following template structure, creating comprehensive requirements, and structuring product definitions for development._ ![GitHub Stats for claudecode-utils](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claudecode-utils&username=Wirasm&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
/do-issue _Implements GitHub issues with manual review points, following a structured approach with issue number parameter and offering alternative automated mode for efficiency._ ![GitHub Stats for Narraitor](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=Narraitor&username=jerseycheese&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
/prd-generator _A Claude Code plugin that generates comprehensive Product Requirements Documents (PRDs) from conversation context. Invoke `/create-prd` after discussing requirements and it produces a complete PRD with all standard sections including Executive Summary, User Stories, MVP Scope, Architecture, Success Criteria, and Implementation Phases._ ![GitHub Stats for prd-generator](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=prd-generator&username=dredozubov&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
/project_hello_w_name _Creates customizable greeting components with name input, demonstrating argument passing, component reusability, state management, and user input handling._ ![GitHub Stats for just-prompt](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=just-prompt&username=disler&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
/todo _A convenient command to quickly manage project todo items without leaving the Claude Code interface, featuring due dates, sorting, task prioritization, and comprehensive todo list management._ ![GitHub Stats for todo-slash-command](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=todo-slash-command&username=chrisleyva&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Miscellaneous /fixing_go_in_graph _Focuses on Gene Ontology annotation integration in graph databases, handling multiple data sources, addressing graph representation issues, and ensuring correct data incorporation._ ![GitHub Stats for torchcell](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=torchcell&username=Mjvolk3&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
/mermaid _Generates Mermaid diagrams from SQL schema files, creating entity relationship diagrams with table properties, validating diagram compilation, and ensuring complete entity coverage._ ![GitHub Stats for lana-bank](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=lana-bank&username=GaloyMoney&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
/review_dcell_model _Reviews old Dcell implementation files, comparing with newer Dango model, noting changes over time, and analyzing refactoring approaches for better code organization._ ![GitHub Stats for torchcell](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=torchcell&username=Mjvolk3&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
/use-stepper _Reformats documentation to use React Stepper component, transforming heading formats, applying proper indentation, and maintaining markdown compatibility with admonition formatting._ ![GitHub Stats for docs](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=docs&username=zuplo&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)

CLAUDE.md Files

🔝 Back to top

`CLAUDE.md` files are files that contain important guidelines and context-specific information or instructions that help Claude Code to better understand your project and your coding standards

Language-Specific AI IntelliJ Plugin _Provides comprehensive Gradle commands for IntelliJ plugin development with platform-specific coding patterns, detailed package structure guidelines, and clear internationalization standards._ ![GitHub Stats for ai-intellij-plugin](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=ai-intellij-plugin&username=didalgolab&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
AWS MCP Server _Features multiple Python environment setup options with detailed code style guidelines, comprehensive error handling recommendations, and security considerations for AWS CLI interactions._ ![GitHub Stats for aws-mcp-server](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=aws-mcp-server&username=alexei-led&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
DroidconKotlin _Delivers comprehensive Gradle commands for cross-platform Kotlin Multiplatform development with clear module structure and practical guidance for dependency injection._ ![GitHub Stats for DroidconKotlin](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=DroidconKotlin&username=touchlab&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
EDSL _Offers detailed build and test commands with strict code style enforcement, comprehensive testing requirements, and standardized development workflow using Black and mypy._* * Removed from origin
Giselle _Provides detailed build and test commands using pnpm and Vitest with strict code formatting requirements and comprehensive naming conventions for code consistency._ ![GitHub Stats for giselle](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=giselle&username=giselles-ai&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
HASH _Features comprehensive repository structure breakdown with strong emphasis on coding standards, detailed Rust documentation guidelines, and systematic PR review process._ ![GitHub Stats for hash](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=hash&username=hashintel&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Inkline _Structures development workflow using pnpm with emphasis on TypeScript and Vue 3 Composition API, detailed component creation process, and comprehensive testing recommendations._ ![GitHub Stats for inkline](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=inkline&username=inkline&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
JSBeeb _Provides development guide for JavaScript BBC Micro emulator with build and testing instructions, architecture documentation, and debugging workflows._ ![GitHub Stats for jsbeeb](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=jsbeeb&username=mattgodbolt&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Lamoom Python _Serves as reference for production prompt engineering library with load balancing of AI Models, API documentation, and usage patterns with examples._ ![GitHub Stats for lamoom-python](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=lamoom-python&username=LamoomAI&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
LangGraphJS _Offers comprehensive build and test commands with detailed TypeScript style guidelines, layered library architecture, and monorepo structure using yarn workspaces._ ![GitHub Stats for langgraphjs](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=langgraphjs&username=langchain-ai&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Metabase _Details workflow for REPL-driven development in Clojure/ClojureScript with emphasis on incremental development, testing, and step-by-step approach for feature implementation._ ![GitHub Stats for metabase](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=metabase&username=metabase&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
SG Cars Trends Backend _Provides comprehensive structure for TypeScript monorepo projects with detailed commands for development, testing, deployment, and AWS/Cloudflare integration._ ![GitHub Stats for backend](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=backend&username=sgcarstrends&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
SPy _Enforces strict coding conventions with comprehensive testing guidelines, multiple code compilation options, and backend-specific test decorators for targeted filtering._ ![GitHub Stats for spy](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=spy&username=spylang&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
TPL _Details Go project conventions with comprehensive error handling recommendations, table-driven testing approach guidelines, and modernization suggestions for latest Go features._ ![GitHub Stats for tpl](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=tpl&username=KarpelesLab&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Domain-Specific Course Builder _Enables real-time multiplayer capabilities for collaborative course creation with diverse tech stack integration and monorepo architecture using Turborepo._ ![GitHub Stats for course-builder](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=course-builder&username=badass-courses&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Cursor Tools _Creates a versatile AI command interface supporting multiple providers and models with flexible command options and browser automation through "Stagehand" feature._ ![GitHub Stats for cursor-tools](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=cursor-tools&username=eastlondoner&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Guitar _Serves as development guide for Guitar Git GUI Client with build commands for various platforms, code style guidelines for contributing, and project structure explanation._ ![GitHub Stats for Guitar](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=Guitar&username=soramimi&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Network Chronicles _Presents detailed implementation plan for AI-driven game characters with technical specifications for LLM integration, character guidelines, and service discovery mechanics._ ![GitHub Stats for NetworkChronicles](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=NetworkChronicles&username=Fimeg&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Pareto Mac _Serves as development guide for Mac security audit tool with build instructions, contribution guidelines, testing procedures, and workflow documentation._ ![GitHub Stats for pareto-mac](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=pareto-mac&username=ParetoSecurity&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
pre-commit-hooks _This repository is about pre-commit-hooks in general, but the `CLAUDE.md` and related `.claude/` documentation is exemplary. Thorough but not verbose. Unlike a lot of `CLAUDE.md` files, it doesn't primarily consist in shouting at Claude in all-caps. Great learning resource. Also, hooks._ ![GitHub Stats for pre-commit-hooks](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=pre-commit-hooks&username=aRustyDev&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
SteadyStart _Clear and direct instructives about style, permissions, Claude's "role", communications, and documentation of Claude Code sessions for other team members to stay abreast._ ![GitHub Stats for steadystart](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=steadystart&username=steadycursor&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Project Scaffolding & MCP Basic Memory _Presents an innovative AI-human collaboration framework with Model Context Protocol for bidirectional LLM-markdown communication and flexible knowledge structure for complex projects._ ![GitHub Stats for basic-memory](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=basic-memory&username=basicmachines-co&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
claude-code-mcp-enhanced _Provides detailed and emphatic instructions for Claude to follow as a coding agent, with testing guidance, code examples, and compliance checks._ ![GitHub Stats for claude-code-mcp-enhanced](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-code-mcp-enhanced&username=grahama1970&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)

Alternative Clients

🔝 Back to top

Alternative Clients are alternative UIs and front-ends for interacting with Claude Code, either on mobile or on the desktop.

General Claudable _Claudable is an open-source web builder that leverages local CLI agents, such as Claude Code and Cursor Agent, to build and deploy products effortlessly._ ![GitHub Stats for Claudable](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=Claudable&username=opactorai&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
claude-esp _Go-based TUI that streams Claude Code's hidden output (thinking, tool calls, subagents) to a separate terminal. Watch multiple sessions simultaneously, filter by content type, and track background tasks. Ideal for debugging or understanding what Claude is doing under the hood without interrupting your main session._ ![GitHub Stats for claude-esp](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-esp&username=phiat&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
claude-tmux _Manage Claude Code within tmux. A tmux popup of all your Claude Code instances, enabling quick switching, status monitoring, session lifecycle management, with git worktree and pull request support._ ![GitHub Stats for claude-tmux](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-tmux&username=nielsgroen&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
crystal _A full-fledged desktop application for orchestrating, monitoring, and interacting with Claude Code agents._ ![GitHub Stats for crystal](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=crystal&username=stravu&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Omnara _A command center for AI agents that syncs Claude Code sessions across terminal, web, and mobile. Allows for remote monitoring, human-in-the-loop interaction, and team collaboration._ ![GitHub Stats for omnara](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=omnara&username=omnara-ai&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)

Official Documentation

🔝 Back to top

Links to some of Anthropic's terrific documentation and resources regarding Claude Code

General Anthropic Documentation _The official documentation for Claude Code, including installation instructions, usage guidelines, API references, tutorials, examples, loads of information that I won't list individually. Like Claude Code, the documentation is frequently updated._
Anthropic Quickstarts _Offers comprehensive development guides for three distinct AI-powered demo projects with standardized workflows, strict code style guidelines, and containerization instructions._ ![GitHub Stats for claude-quickstarts](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-quickstarts&username=anthropics&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
Claude Code GitHub Actions _Official GitHub Actions integration for Claude Code with examples and documentation for automating AI-powered workflows in CI/CD pipelines._ ![GitHub Stats for claude-code-action](https://github-readme-stats-fork-orpin.vercel.app/api/pin/?repo=claude-code-action&username=anthropics&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
## Contributing [🔝](#awesome-claude-code) ### **[Recommend a new resource here!](https://github.com/hesreallyhim/awesome-claude-code/issues/new?template=recommend-resource.yml)** Recommending a resource for the list is very simple, and the automated system handles everything for you. Please do not open a PR to submit a recommendation - the only person who is allowed to submit PRs to this repo is Claude. Make sure that you have read the CONTRIBUTING.md document and CODE_OF_CONDUCT.md before you submit a recommendation. For suggestions about the repository itself, please [open a repository enhancement issue](https://github.com/hesreallyhim/awesome-claude-code/issues/new?template=repository-enhancement.yml). This project is released with a Code of Conduct. By participating, you agree to abide by its terms. And although I take strong measures to uphold the quality and safety of this list, I take no responsibility or liability for anything that might happen as a result of these third-party resources. ## Growing thanks to you [![Stargazers over time](https://starchart.cc/hesreallyhim/awesome-claude-code.svg?variant=adaptive)](https://starchart.cc/hesreallyhim/awesome-claude-code) ## License This list is licensed under [Creative Commons CC BY-NC-ND 4.0](https://creativecommons.org/licenses/by-nc-nd/4.0/) - this means you are welcome to fork, clone, copy and redistribute the list, provided you include appropriate attribution; however you are not permitted to distribute any modified versions or to use it for any commercial purposes. This is to prevent disregard for the licenses of the authors whose resources are listed here. Please note that all resources included in this list have their own license terms. ================================================ FILE: README_ALTERNATIVES/README_FLAT_ALL_AZ.md ================================================

Pick Your Style:

Awesome Extra Classic Flat

# Awesome Claude Code (Flat) [![Awesome](https://awesome.re/badge-flat2.svg)](https://awesome.re) A flat list view of all resources. Category: **All** | Sorted: alphabetically by name --- ## Sort By:

A - Z UPDATED CREATED RELEASES

Category:

All Tooling Commands CLAUDE.md Workflows Hooks Skills Styles Status Docs Clients

Currently viewing: **All** sorted alphabetically by name

--- ## Resources
Resource Category Sub-Category Description
/add-to-changelog
by berrydev-ai		 Slash-Commands Documentation & Changelogs Adds new entries to changelog files while maintaining format consistency, properly documenting changes, and following established project standards for version tracking.
stars forks issues prs created last-commit release-date version license
/analyze-issue
by jerseycheese		 Slash-Commands Version Control & Git Fetches GitHub issue details to create comprehensive implementation specifications, analyzing requirements and planning structured approach with clear implementation steps.
stars forks issues prs created last-commit release-date version license
/check
by rygwdn		 Slash-Commands Code Analysis & Testing Performs comprehensive code quality and security checks, featuring static analysis integration, security vulnerability scanning, code style enforcement, and detailed reporting.
stars forks issues prs created last-commit release-date version license
/code_analysis
by kingler		 Slash-Commands Code Analysis & Testing Provides a menu of advanced code analysis commands for deep inspection, including knowledge graph generation, optimization suggestions, and quality evaluation.
stars forks issues prs created last-commit release-date version license
/commit
by evmts		 Slash-Commands Version Control & Git Creates git commits using conventional commit format with appropriate emojis, following project standards and creating descriptive messages that explain the purpose of changes.
stars forks issues prs created last-commit release-date version license
/commit-fast
by steadycursor		 Slash-Commands Version Control & Git Automates git commit process by selecting the first suggested message, generating structured commits with consistent formatting while skipping manual confirmation and removing Claude co-Contributorship footer
stars forks issues prs created last-commit release-date version license
/context-prime
by elizaOS		 Slash-Commands Context Loading & Priming Primes Claude with comprehensive project understanding by loading repository structure, setting development context, establishing project goals, and defining collaboration parameters.
stars forks issues prs created last-commit release-date version license
/create-command
by scopecraft		 Slash-Commands Project & Task Management Guides Claude through creating new custom commands with proper structure by analyzing requirements, templating commands by category, enforcing command standards, and creating supporting documentation.
stars forks issues prs created last-commit release-date version license
/create-docs
by jerseycheese		 Slash-Commands Documentation & Changelogs Analyzes code structure and purpose to create comprehensive documentation detailing inputs/outputs, behavior, user interaction flows, and edge cases with error handling.
stars forks issues prs created last-commit release-date version license
/create-hook
by Omri Lavi		 Slash-Commands General Slash command for hook creation - intelligently prompts you through the creation process with smart suggestions based on your project setup (TS, Prettier, ESLint...).
stars forks issues prs created last-commit release-date version license
/create-plan
by taddyorg		 Slash-Commands Project & Task Management Generates comprehensive product requirement documents outlining detailed specifications, requirements, and features following standardized document structure and format.
stars forks issues prs created last-commit release-date version license
/create-pr
by toyamarinyon		 Slash-Commands Version Control & Git Streamlines pull request creation by handling the entire workflow: creating a new branch, committing changes, formatting modified files with Biome, and submitting the PR.
stars forks issues prs created last-commit release-date version license
/create-prp
by Wirasm		 Slash-Commands Project & Task Management Creates product requirement plans by reading PRP methodology, following template structure, creating comprehensive requirements, and structuring product definitions for development.
stars forks issues prs created last-commit release-date version license
/create-pull-request
by liam-hq		 Slash-Commands Version Control & Git Provides comprehensive PR creation guidance with GitHub CLI, enforcing title conventions, following template structure, and offering concrete command examples with best practices.
stars forks issues prs created last-commit release-date version license
/create-worktrees
by evmts		 Slash-Commands Version Control & Git Creates git worktrees for all open PRs or specific branches, handling branches with slashes, cleaning up stale worktrees, and supporting custom branch creation for development.
stars forks issues prs created last-commit release-date version license
/do-issue
by jerseycheese		 Slash-Commands Project & Task Management Implements GitHub issues with manual review points, following a structured approach with issue number parameter and offering alternative automated mode for efficiency.
stars forks issues prs created last-commit release-date version license
/docs
by slunsford		 Slash-Commands Documentation & Changelogs Generates comprehensive documentation that follows project structure, documenting APIs and usage patterns with consistent formatting for better user understanding.
stars forks issues prs created last-commit release-date version license
/explain-issue-fix
by hackdays-io		 Slash-Commands Documentation & Changelogs Documents solution approaches for GitHub issues, explaining technical decisions, detailing challenges overcome, and providing implementation context for better understanding.
stars forks issues prs created last-commit release-date version license
/fix-github-issue
by jeremymailen		 Slash-Commands Version Control & Git Analyzes and fixes GitHub issues using a structured approach with GitHub CLI for issue details, implementing necessary code changes, running tests, and creating proper commit messages.
stars forks issues prs created last-commit release-date version license
/fix-issue
by metabase		 Slash-Commands Version Control & Git Addresses GitHub issues by taking issue number as parameter, analyzing context, implementing solution, and testing/validating the fix for proper integration.
stars forks issues prs created last-commit release-date version license
/fix-pr
by metabase		 Slash-Commands Version Control & Git Fetches and fixes unresolved PR comments by automatically retrieving feedback, addressing reviewer concerns, making targeted code improvements, and streamlining the review process.
stars forks issues prs created last-commit release-date version license
/fixing_go_in_graph
by Mjvolk3		 Slash-Commands Miscellaneous Focuses on Gene Ontology annotation integration in graph databases, handling multiple data sources, addressing graph representation issues, and ensuring correct data incorporation.
stars forks issues prs created last-commit release-date version license
/husky
by evmts		 Slash-Commands Version Control & Git Sets up and manages Husky Git hooks by configuring pre-commit hooks, establishing commit message standards, integrating with linting tools, and ensuring code quality on commits.
stars forks issues prs created last-commit release-date version license
/initref
by okuvshynov		 Slash-Commands Context Loading & Priming Initializes reference documentation structure with standard doc templates, API reference setup, documentation conventions, and placeholder content generation.
stars forks issues prs created last-commit release-date version license
/linux-desktop-slash-commands
by Daniel Rosehill		 Slash-Commands General A library of slash commands intended specifically to facilitate common and advanced operations on Linux desktop environments (although many would also be useful on Linux servers). Command groups include hardware benchmarking, filesystem organisation, and security posture validation.
stars forks issues prs created last-commit release-date version license
/load-llms-txt
by ethpandaops		 Slash-Commands Context Loading & Priming Loads LLM configuration files to context, importing specific terminology, model configurations, and establishing baseline terminology for AI discussions.
stars forks issues prs created last-commit release-date version license
/load_coo_context
by Mjvolk3		 Slash-Commands Context Loading & Priming References specific files for sparse matrix operations, explains transform usage, compares with previous approaches, and sets data formatting context for development.
stars forks issues prs created last-commit release-date version license
/load_dango_pipeline
by Mjvolk3		 Slash-Commands Context Loading & Priming Sets context for model training by referencing pipeline files, establishing working context, and preparing for pipeline work with relevant documentation.
stars forks issues prs created last-commit release-date version license
/mermaid
by GaloyMoney		 Slash-Commands Miscellaneous Generates Mermaid diagrams from SQL schema files, creating entity relationship diagrams with table properties, validating diagram compilation, and ensuring complete entity coverage.
stars forks issues prs created last-commit release-date version license
/optimize
by to4iki		 Slash-Commands Code Analysis & Testing Analyzes code performance to identify bottlenecks, proposing concrete optimizations with implementation guidance for improved application performance.
stars forks issues prs created last-commit release-date version license
/prd-generator
by Denis Redozubov		 Slash-Commands Project & Task Management A Claude Code plugin that generates comprehensive Product Requirements Documents (PRDs) from conversation context. Invoke `/create-prd` after discussing requirements and it produces a complete PRD with all standard sections including Executive Summary, User Stories, MVP Scope, Architecture, Success Criteria, and Implementation Phases.
stars forks issues prs created last-commit release-date version license
/prime
by yzyydev		 Slash-Commands Context Loading & Priming Sets up initial project context by viewing directory structure and reading key files, creating standardized context with directory visualization and key documentation focus.
stars forks issues prs created last-commit release-date version license
/project_hello_w_name
by disler		 Slash-Commands Project & Task Management Creates customizable greeting components with name input, demonstrating argument passing, component reusability, state management, and user input handling.
stars forks issues prs created last-commit release-date version license
/release
by kelp		 Slash-Commands CI / Deployment Manages software releases by updating changelogs, reviewing README changes, evaluating version increments, and documenting release changes for better version tracking.
stars forks issues prs created last-commit release-date version license
/repro-issue
by rzykov		 Slash-Commands Code Analysis & Testing Creates reproducible test cases for GitHub issues, ensuring tests fail reliably and documenting clear reproduction steps for developers.
stars forks issues prs created last-commit release-date version license
/review_dcell_model
by Mjvolk3		 Slash-Commands Miscellaneous Reviews old Dcell implementation files, comparing with newer Dango model, noting changes over time, and analyzing refactoring approaches for better code organization.
stars forks issues prs created last-commit release-date version license
/rsi
by ddisisto		 Slash-Commands Context Loading & Priming Reads all commands and key project files to optimize AI-assisted development by streamlining the process, loading command context, and setting up for better development workflow.
stars forks issues prs created last-commit release-date version license
/run-ci
by hackdays-io		 Slash-Commands CI / Deployment Activates virtual environments, runs CI-compatible check scripts, iteratively fixes errors, and ensures all tests pass before completion.
stars forks issues prs created last-commit release-date version license
/tdd
by zscott		 Slash-Commands Code Analysis & Testing Guides development using Test-Driven Development principles, enforcing Red-Green-Refactor discipline, integrating with git workflow, and managing PR creation.
stars forks issues prs created last-commit release-date version license
/tdd-implement
by jerseycheese		 Slash-Commands Code Analysis & Testing Implements Test-Driven Development by analyzing feature requirements, creating tests first (red), implementing minimal passing code (green), and refactoring while maintaining tests.
stars forks issues prs created last-commit release-date version license
/todo
by chrisleyva		 Slash-Commands Project & Task Management A convenient command to quickly manage project todo items without leaving the Claude Code interface, featuring due dates, sorting, task prioritization, and comprehensive todo list management.
stars forks issues prs created last-commit release-date version license
/update-branch-name
by giselles-ai		 Slash-Commands Version Control & Git Updates branch names with proper prefixes and formats, enforcing naming conventions, supporting semantic prefixes, and managing remote branch updates.
stars forks issues prs created last-commit release-date version license
/update-docs
by Consiliency		 Slash-Commands Documentation & Changelogs Reviews current documentation status, updates implementation progress, reviews phase documents, and maintains documentation consistency across the project.
stars forks issues prs created last-commit release-date version license
/use-stepper
by zuplo		 Slash-Commands Miscellaneous Reformats documentation to use React Stepper component, transforming heading formats, applying proper indentation, and maintaining markdown compatibility with admonition formatting.
stars forks issues prs created last-commit release-date version license
AB Method
by Ayoub Bensalah		 Workflows & Knowledge Guides General A principled, spec-driven workflow that transforms large problems into focused, incremental missions using Claude Code's specialized sub agents. Includes slash-commands, sub agents, and specialized workflows designed for specific parts of the SDLC.
stars forks issues prs created last-commit release-date version license
Agentic Workflow Patterns
by ThibautMelen		 Workflows & Knowledge Guides General A comprehensive and well-documented collection of agentic patterns from Anthropic docs, with colorful Mermaid diagrams and code examples for each pattern. Covers Subagent Orchestration, Progressive Skills, Parallel Tool Calling, Master-Clone Architecture, Wizard Workflows, and more. Also compatible with other providers.
stars forks issues prs created last-commit release-date version license
AgentSys
by avifenesh		 Agent Skills General Workflow automation system for Claude with a group of useful plugins, agents, and skills. Automates task-to-production workflows, PR management, code cleanup, performance investigation, drift detection, and multi-agent code review. Includes [agnix](https://github.com/avifenesh/agnix) for linting agent configurations. Built on thousands of lines of code with thousands of tests. Uses deterministic detection (regex, AST) with LLM judgment for efficiency. Used on many production systems.
stars forks issues prs created last-commit release-date version license
AI Agent, AI Spy
by Whittaker & Tiwari		 Agent Skills General Members from the Signal Foundation with some really great tips and tricks on how to turn your operating system into an instrument of total surveillance, and why some companies are doing this really awesome thing. [warning: YouTube link]
AI IntelliJ Plugin
by didalgolab		 CLAUDE.md Files Language-Specific Provides comprehensive Gradle commands for IntelliJ plugin development with platform-specific coding patterns, detailed package structure guidelines, and clear internationalization standards.
stars forks issues prs created last-commit release-date version license
Anthropic Documentation
by Anthropic		 Official Documentation General The official documentation for Claude Code, including installation instructions, usage guidelines, API references, tutorials, examples, loads of information that I won't list individually. Like Claude Code, the documentation is frequently updated.
Anthropic Quickstarts
by Anthropic		 Official Documentation General Offers comprehensive development guides for three distinct AI-powered demo projects with standardized workflows, strict code style guidelines, and containerization instructions.
stars forks issues prs created last-commit release-date version license
Auto-Claude
by AndyMik90		 Tooling Orchestrators Autonomous multi-agent coding framework for Claude Code (Claude Agent SDK) that integrates the full SDLC - "plans, builds, and validates software for you". Features a slick kanban-style UI and a well-designed but not over-engineered agent orchestration system.
stars forks issues prs created last-commit release-date version license
Awesome Claude Code Output Styles (That I Really Like)
by Really Him		 Output Styles General A fun and moderately amusing collection of experimental output styles.
stars forks issues prs created last-commit release-date version license
awesome-ralph
by Martin Joly		 Workflows & Knowledge Guides Ralph Wiggum A curated list of resources about Ralph, the AI coding technique that runs AI coding agents in automated loops until specifications are fulfilled.
stars forks issues prs created last-commit release-date version license
AWS MCP Server
by alexei-led		 CLAUDE.md Files Language-Specific Features multiple Python environment setup options with detailed code style guidelines, comprehensive error handling recommendations, and security considerations for AWS CLI interactions.
stars forks issues prs created last-commit release-date version license
Basic Memory
by basicmachines-co		 CLAUDE.md Files Project Scaffolding & MCP Presents an innovative AI-human collaboration framework with Model Context Protocol for bidirectional LLM-markdown communication and flexible knowledge structure for complex projects.
stars forks issues prs created last-commit release-date version license
Blogging Platform Instructions
by cloudartisan		 Workflows & Knowledge Guides General Provides a well-structured set of commands for publishing and maintaining a blogging platform, including commands for creating posts, managing categories, and handling media files.
stars forks issues prs created last-commit release-date version license
Book Factory
by Robert Guss		 Agent Skills General A comprehensive pipeline of Skills that replicates traditional publishing infrastructure for nonfiction book creation using specialized Claude skills.
stars forks issues prs created last-commit release-date version license
Britfix
by Talieisin		 Hooks General Claude outputs American spellings by default, which can have an impact on: professional credibility, compliance, documentation, and more. Britfix converts to British English, with a Claude Code hook for automatic conversion as files are written. Context-aware: handles code files intelligently by only converting comments and docstrings, never identifiers or string literals.
stars forks issues prs created last-commit release-date version license
CC Notify
by dazuiba		 Hooks General CCNotify provides desktop notifications for Claude Code, alerting you to input needs or task completion, with one-click jumps back to VS Code and task duration display.
stars forks issues prs created last-commit release-date version license
CC Usage
by ryoppippi		 Tooling Usage Monitors Handy CLI tool for managing and analyzing Claude Code usage, based on analyzing local Claude Code logs. Presents a nice dashboard regarding cost information, token consumption, etc.
stars forks issues prs created last-commit release-date version license
cc-devops-skills
by akin-ozer		 Agent Skills General Immensely detailed set of skills for DevOps Engineers (or anyone who has to deploy code, really). Works with validations, generators, shell scripts and CLI tools to create high quality IaC code for about any platform you've ever struggled painfully to work with. Worth downloading even just as a source of documentation.
stars forks issues prs created last-commit release-date version license
cc-sessions
by toastdev		 Tooling General An opinionated approach to productive development with Claude Code
stars forks issues prs created last-commit release-date version license
cc-tools
by Josh Symonds		 Tooling General High-performance Go implementation of Claude Code hooks and utilities. Provides smart linting, testing, and statusline generation with minimal overhead.
stars forks issues prs created last-commit release-date version license
ccexp
by nyatinte		 Tooling General Interactive CLI tool for discovering and managing Claude Code configuration files and slash commands with a beautiful terminal UI.
stars forks issues prs created last-commit release-date version license
ccflare
by snipeship		 Tooling Usage Monitors Claude Code usage dashboard with a web-UI that would put Tableau to shame. Thoroughly comprehensive metrics, frictionless setup, detailed logging, really really nice UI.
stars forks issues prs created last-commit release-date version license
ccflare -> **better-ccflare**
by tombii		 Tooling Usage Monitors A well-maintained and feature-enhanced fork of the glorious `ccflare` usage dashboard by @snipeship (which at the time of writing has not had an update in a few months). `better-ccflare` builds on this foundation with some performance enhancements, extended provider support, bug fixes, Docker deployment, and more.
stars forks issues prs created last-commit release-date version license
cchistory
by eckardt		 Tooling General Like the shell history command but for your Claude Code sessions. Easily list all Bash or "Bash-mode" (`!`) commands Claude Code ran in a session for reference.
stars forks issues prs created last-commit release-date version license
cchooks
by GowayLee		 Hooks General A lightweight Python SDK with a clean API and good documentation; simplifies the process of writing hooks and integrating them into your codebase, providing a nice abstraction over the JSON configuration files.
stars forks issues prs created last-commit release-date version license
cclogviewer
by Brad S.		 Tooling General A humble but handy utility for viewing Claude Code `.jsonl` conversation files in a pretty HTML UI.
stars forks issues prs created last-commit release-date version license
CCometixLine - Claude Code Statusline
by Haleclipse		 Status Lines General A high-performance Claude Code statusline tool written in Rust with Git integration, usage tracking, interactive TUI configuration, and Claude Code enhancement utilities.
stars forks issues prs created last-commit release-date version license
ccoutputstyles
by Vivek Nair		 Output Styles General CLI tool and template gallery for customizing Claude Code output styles with pre-built templates. Features over 15 templates at the time of writing!
stars forks issues prs created last-commit release-date version license
ccstatusline
by sirmalloc		 Status Lines General A highly customizable status line formatter for Claude Code CLI that displays model info, git branch, token usage, and other metrics in your terminal.
stars forks issues prs created last-commit release-date version license
Claudable
by Ethan Park		 Alternative Clients General Claudable is an open-source web builder that leverages local CLI agents, such as Claude Code and Cursor Agent, to build and deploy products effortlessly.
stars forks issues prs created last-commit release-date version license
Claude Code Agents
by Paul - UndeadList		 Agent Skills General Comprehensive E2E development workflow with helpful Claude Code subagent prompts for solo devs. Run multiple auditors in parallel, automate fix cycles with micro-checkpoint protocols, and do browser-based QA. Includes strict protocols to prevent AI going rogue.
stars forks issues prs created last-commit release-date version license
Claude Code Chat
by andrepimenta		 Tooling IDE Integrations An elegant and user-friendly Claude Code chat interface for VS Code.
Claude Code Documentation Mirror
by Eric Buess		 Workflows & Knowledge Guides General A mirror of the Anthropic © PBC documentation pages for Claude Code, updated every few hours. Can come in handy when trying to stay on top of the ever-expanding feature-set of Dr. Claw D. Code, Ph.D.
stars forks issues prs created last-commit release-date version license
Claude Code Flow
by ruvnet		 Tooling Orchestrators This mode serves as a code-first orchestration layer, enabling Claude to write, edit, test, and optimize code autonomously across recursive agent cycles.
stars forks issues prs created last-commit release-date version license
Claude Code GitHub Actions
by Anthropic		 Official Documentation General Official GitHub Actions integration for Claude Code with examples and documentation for automating AI-powered workflows in CI/CD pipelines.
stars forks issues prs created last-commit release-date version license
Claude Code Handbook
by nikiforovall		 Workflows & Knowledge Guides General Collection of best practices, tips, and techniques for Claude Code development workflows, enhanced with distributable plugins
Claude Code Hook Comms (HCOM)
by aannoo		 Hooks General Lightweight CLI tool for real-time communication between Claude Code sub agents using hooks. Enables multi-agent collaboration with @-mention targeting, live dashboard monitoring, and zero-dependency implementation. [NOTE: At the time of posting, this resource is a little unstable - I'm sharing it anyway, because I think it's incredibly promising and creative. I hope by the time you read this, it is production-ready.]
stars forks issues prs created last-commit release-date version license
Claude Code Infrastructure Showcase
by diet103		 Workflows & Knowledge Guides General A remarkably innovative approach to working with Skills, the centerpiece of which being a technique that leverages hooks to ensure that Claude intelligently selects and activates the appropriate Skill given the current context. Well-documented and adaptable to different projects and workflows.
stars forks issues prs created last-commit release-date version license
Claude Code Output Styles - Debugging
by Jamie Matthews		 Output Styles General A small set of well-written output styles, specifically focused on debugging - root cause analysis, systematic, methodical debugging, encouraging a more careful approach to bug-squashing from Claude Code.
stars forks issues prs created last-commit release-date version license
Claude Code PM
by Ran Aroussi		 Workflows & Knowledge Guides General Really comprehensive and feature-packed project-management workflow for Claude Code. Numerous specialized agents, slash-commands, and strong documentation.
stars forks issues prs created last-commit release-date version license
Claude Code Repos Index
by Daniel Rosehill		 Workflows & Knowledge Guides General This is either the work of a prolific genius, or a very clever bot (or both), although it hardly matters because the quality is so good - an index of 75+ Claude Code repositories published by the author - and I'm not talking about slop. CMS, system design, deep research, IoT, agentic workflows, server management, personal health... If you spot the lie, let me know, otherwise please check these out.
stars forks issues prs created last-commit release-date version license
Claude Code System Prompts
by Piebald AI		 Workflows & Knowledge Guides General All parts of Claude Code's system prompt, including builtin tool descriptions, sub agent prompts (Plan/Explore/Task), utility prompts (CLAUDE.md, compact, Bash cmd, security review, agent creation, etc.). Updated for each Claude Code version.
stars forks issues prs created last-commit release-date version license
Claude Code Templates
by Daniel Avila		 Tooling General Incredibly awesome collection of resources from every category in this list, presented with a neatly polished UI, great features like usage dashboard, analytics, and everything from slash commands to hooks to agents. An awesome companion for this awesome list.
stars forks issues prs created last-commit release-date version license
Claude Code Tips
by ykdojo		 Workflows & Knowledge Guides General A nice variety of 35+ brief but information-dense Claude Code tips covering voice input, system prompt patching, container workflows for risky tasks, conversation cloning(!), multi-model orchestration with Gemini CLI, and plenty more. Nice demos, working scripts, a plugin, I'd say this probably has a little something for everyone.
stars forks issues prs created last-commit release-date version license
Claude Code Ultimate Guide
by Florian BRUNIAUX		 Workflows & Knowledge Guides General A tremendous feat of documentation, this guide covers Claude Code from beginner to power user, with production-ready templates for Claude Code features, guides on agentic workflows, and a lot of great learning materials, including quizzes and a handy "cheatsheet". Whether it's the "ultimate" guide to Claude Code will be up to the reader, but a valuable resource nonetheless (as with all documentation sites, make sure it's up to date before you bet the farm).
stars forks issues prs created last-commit release-date version license
Claude Code Usage Monitor
by Maciek-roboblog		 Tooling Usage Monitors A real-time terminal-based tool for monitoring Claude Code token usage. It shows live token consumption, burn rate, and predictions for token depletion. Features include visual progress bars, session-aware analytics, and support for multiple subscription plans.
stars forks issues prs created last-commit release-date version license
Claude CodePro
by Max Ritter		 Workflows & Knowledge Guides General Professional development environment for Claude Code with spec-driven workflow, TDD enforcement, cross-session memory, semantic search, quality hooks, and modular rules integration. A bit "heavyweight" but feature-packed and has wide coverage.
stars forks issues prs created last-commit release-date version license
Claude Codex Settings
by fatih akyon		 Agent Skills General A well-organized, well-written set of plugins covering core developer activities, such as working with common cloud platforms like GitHub, Azure, MongoDB, and popular services such as Tavily, Playwright, and more. Clear, not overly-opinionated, and compatible with a few other providers.
stars forks issues prs created last-commit release-date version license
Claude Composer
by Mike Bannister		 Tooling General A tool that adds small enhancements to Claude Code.
stars forks issues prs created last-commit release-date version license
Claude Hub
by Claude Did This		 Tooling General A webhook service that connects Claude Code to GitHub repositories, enabling AI-powered code assistance directly through pull requests and issues. This integration allows Claude to analyze repositories, answer technical questions, and help developers understand and improve their codebase through simple @mentions.
stars forks issues prs created last-commit release-date version license
Claude Mountaineering Skills
by Dmytro Gaivoronsky		 Agent Skills General Claude Code skill that automates mountain route research for North American peaks. Aggregates data from 10+ mountaineering sources like Mountaineers.org, PeakBagger.com and SummitPost.com to generate detailed route beta reports with weather, avalanche conditions, and trip reports.
stars forks issues prs created last-commit release-date version license
Claude Scientific Skills
by K-Dense		 Agent Skills General "A set of ready-to-use Agent Skills for research, science, engineering, analysis, finance and writing." That's their description - modest, simple. That's how you can tell this is really one of the best skills repos on GitHub. If you've ever thought about getting a PhD... just read all of these documents instead. Also I think it IS an AI agent or something? Awesome.
stars forks issues prs created last-commit release-date version license
Claude Session Restore
by ZENG3LD		 Tooling General Efficiently restore context from previous Claude Code sessions by analyzing session files and git history. Features multi-factor data collection across numerous Claude Code capacities with time-based filtering. Uses tail-based parsing for efficient handling of large session files up to 2GB. Includes both a CLI tool for manual analysis and a Claude Code skill for automatic session restoration.
stars forks issues prs created last-commit release-date version license
Claude Squad
by smtg-ai		 Tooling Orchestrators Claude Squad is a terminal app that manages multiple Claude Code, Codex (and other local agents including Aider) in separate workspaces, allowing you to work on multiple tasks simultaneously.
stars forks issues prs created last-commit release-date version license
Claude Swarm
by parruda		 Tooling Orchestrators Launch Claude Code session that is connected to a swarm of Claude Code Agents.
stars forks issues prs created last-commit release-date version license
Claude Task Master
by eyaltoledano		 Tooling Orchestrators A task management system for AI-driven development with Claude, designed to work seamlessly with Cursor AI.
stars forks issues prs created last-commit release-date version license
Claude Task Runner
by grahama1970		 Tooling Orchestrators A specialized tool to manage context isolation and focused task execution with Claude Code, solving the critical challenge of context length limitations and task focus when working with Claude on complex, multi-step projects.
stars forks issues prs created last-commit release-date version license
claude-code-docs
by Constantin Shafranski		 Workflows & Knowledge Guides General A mirror of the Anthropic© PBC documentation site for Claude/Code, but with bonus features like full-text search and query-time updates - a nice companion to `claude-code-docs` for up-to-the-minute, fully-indexed information so that Claude Code can read about itself.
stars forks issues prs created last-commit release-date version license
claude-code-hooks-sdk
by beyondcode		 Hooks General A Laravel-inspired PHP SDK for building Claude Code hook responses with a clean, fluent API. This SDK makes it easy to create structured JSON responses for Claude Code hooks using an expressive, chainable interface.
stars forks issues prs created last-commit release-date version license
claude-code-ide.el
by manzaltu		 Tooling IDE Integrations claude-code-ide.el integrates Claude Code with Emacs, like Anthropic’s VS Code/IntelliJ extensions. It shows ediff-based code suggestions, pulls LSP/flymake/flycheck diagnostics, and tracks buffer context. It adds an extensible MCP tool support for symbol refs/defs, project metadata, and tree-sitter AST queries.
stars forks issues prs created last-commit release-date version license
claude-code-mcp-enhanced
by grahama1970		 CLAUDE.md Files Project Scaffolding & MCP Provides detailed and emphatic instructions for Claude to follow as a coding agent, with testing guidance, code examples, and compliance checks.
stars forks issues prs created last-commit release-date version license
claude-code-statusline
by rz1989s		 Status Lines General Enhanced 4-line statusline for Claude Code with themes, cost tracking, and MCP server monitoring
stars forks issues prs created last-commit release-date version license
claude-code-tools
by Prasad Chalasani		 Tooling General Well-crafted toolset for session continuity, featuring skills/commands to avoid compaction and recover context across sessions with cross-agent handoff between Claude Code and Codex CLI. Includes a fast Rust/Tantivy-powered full-text session search (TUI for humans, skill/CLI for agents), tmux-cli skill + command for interacting with scripts and CLI agents, and safety hooks to block dangerous commands.
stars forks issues prs created last-commit release-date version license
claude-code.el
by stevemolitor		 Tooling IDE Integrations An Emacs interface for Claude Code CLI.
stars forks issues prs created last-commit release-date version license
claude-code.nvim
by greggh		 Tooling IDE Integrations A seamless integration between Claude Code AI assistant and Neovim.
stars forks issues prs created last-commit release-date version license
claude-esp
by phiat		 Alternative Clients General Go-based TUI that streams Claude Code's hidden output (thinking, tool calls, subagents) to a separate terminal. Watch multiple sessions simultaneously, filter by content type, and track background tasks. Ideal for debugging or understanding what Claude is doing under the hood without interrupting your main session.
stars forks issues prs created last-commit release-date version license
claude-hooks
by John Lindquist		 Hooks General A TypeScript-based system for configuring and customizing Claude Code hooks with a powerful and flexible interface.
stars forks issues prs created last-commit release-date version license
claude-powerline
by Owloops		 Status Lines General A vim-style powerline statusline for Claude Code with real-time usage tracking, git integration, custom themes, and more
stars forks issues prs created last-commit release-date version license
claude-rules-doctor
by nulone		 Tooling Config Managers CLI that detects dead `.claude/rules/` files by checking if `paths:` globs actually match files in your repo. Catches silent rule failures where renamed directories or typos in glob patterns cause rules to never apply. Features CI mode (exit 1 on dead rules), JSON output, and verbose mode showing matched files.
stars forks issues prs created last-commit release-date version license
claude-starter-kit
by serpro69		 Tooling General This is a starter template repository designed to provide a complete development environment for Claude-Code with pre-configured MCP servers and tools for AI-powered development workflows. The repository is intentionally minimal, containing only configuration templates for three primary systems: Claude Code, Serena, and Task Master.
stars forks issues prs created last-commit release-date version license
claude-tmux
by Niels Groeneveld		 Alternative Clients General Manage Claude Code within tmux. A tmux popup of all your Claude Code instances, enabling quick switching, status monitoring, session lifecycle management, with git worktree and pull request support.
stars forks issues prs created last-commit release-date version license
ClaudeCTX
by John Fox		 Tooling Config Managers claudectx lets you switch your entire Claude Code configuration with a single command.
stars forks issues prs created last-commit release-date version license
claudekit
by Carl Rannaberg		 Tooling General Impressive CLI toolkit providing auto-save checkpointing, code quality hooks, specification generation and execution, and 20+ specialized subagents including oracle (gpt-5), code-reviewer (6-aspect deep analysis), ai-sdk-expert (Vercel AI SDK), typescript-expert and many more for Claude Code workflows.
stars forks issues prs created last-commit release-date version license
Claudex
by Kunwar Shah		 Tooling Usage Monitors Claudex - A web-based browser for exploring your Claude Code conversation history across projects. Indexes your codebase for full-text search. Nice, easy-to-navigate UI. Simple dashboard interface for high-level analytics, and multiple export options as well. (And completely local w/ no telemetry!)
stars forks issues prs created last-commit release-date version license
claudia-statusline
by Hagan Franks		 Status Lines General High-performance Rust-based statusline for Claude Code with persistent stats tracking, progress bars, and optional cloud sync. Features SQLite-first persistence, git integration, context progress bars, burn rate calculation, XDG-compliant with theme support (dark/light, NO_COLOR).
stars forks issues prs created last-commit release-date version license
Claudio
by Christopher Toth		 Hooks General A no-frills little library that adds delightful OS-native sounds to Claude Code via simple hooks. It really sparks joy.
stars forks issues prs created last-commit release-date version license
Claudix - Claude Code for VSCode
by Haleclipse		 Tooling IDE Integrations A VSCode extension that brings Claude Code directly into your editor with interactive chat interface, session management, intelligent file operations, terminal execution, and real-time streaming responses. Built with Vue 3, TypeScript.
stars forks issues prs created last-commit release-date version license
ClaudoPro Directory
by ghost		 Workflows & Knowledge Guides General Well-crafted, wide selection of Claude Code hooks, slash commands, subagent files, and more, covering a range of specialized tasks and workflows. Better resources than your average "Claude-template-for-everything" site.
stars forks issues prs created last-commit release-date version license
Codex Skill
by klaudworks		 Agent Skills General Enables users to prompt codex from claude code. Unlike the raw codex mcp server, this skill infers parameters such as model, reasoning effort, sandboxing from your prompt or asks you to specify them. It also simplifies continuing prior codex sessions so that codex can continue with the prior context.
stars forks issues prs created last-commit release-date version license
Compound Engineering Plugin
by EveryInc		 Agent Skills General A very pragmatic set of well-designed agents, skills, and commands, built around a discipline of turning past mistakes and errors into lessons and opportunities for future growth and improvement. Good documentation.
stars forks issues prs created last-commit release-date version license
Container Use
by dagger		 Tooling General Development environments for coding agents. Enable multiple agents to work safely and independently with your preferred stack.
stars forks issues prs created last-commit release-date version license
Context Engineering Kit
by Vlad Goncharov		 Agent Skills General Hand-crafted collection of advanced context engineering techniques and patterns with minimal token footprint focused on improving agent result quality.
stars forks issues prs created last-commit release-date version license
Context Priming
by disler		 Workflows & Knowledge Guides General Provides a systematic approach to priming Claude Code with comprehensive project context through specialized commands for different project scenarios and development contexts.
stars forks issues prs created last-commit release-date version license
ContextKit
by Cihat Gündüz		 Tooling General A systematic development framework that transforms Claude Code into a proactive development partner. Features 4-phase planning methodology, specialized quality agents, and structured workflows that help AI produce production-ready code on first try.
stars forks issues prs created last-commit release-date version license
Course Builder
by badass-courses		 CLAUDE.md Files Domain-Specific Enables real-time multiplayer capabilities for collaborative course creation with diverse tech stack integration and monorepo architecture using Turborepo.
stars forks issues prs created last-commit release-date version license
crystal
by stravu		 Alternative Clients General A full-fledged desktop application for orchestrating, monitoring, and interacting with Claude Code agents.
stars forks issues prs created last-commit release-date version license
Cursor Tools
by eastlondoner		 CLAUDE.md Files Domain-Specific Creates a versatile AI command interface supporting multiple providers and models with flexible command options and browser automation through "Stagehand" feature.
stars forks issues prs created last-commit release-date version license
Design Review Workflow
by Patrick Ellis		 Workflows & Knowledge Guides General A tailored workflow for enabling automated UI/UX design review, including specialized sub agents, slash commands, `CLAUDE.md` excerpts, and more. Covers a broad range of criteria from responsive design to accessibility.
stars forks issues prs created last-commit release-date version license
Dippy
by Lily Dayton		 Hooks General Auto-approve safe bash commands using AST-based parsing, while prompting for destructive operations. Solves permission fatigue without disabling safety. Supports Claude Code, Gemini CLI, and Cursor.
stars forks issues prs created last-commit release-date version license
DroidconKotlin
by touchlab		 CLAUDE.md Files Language-Specific Delivers comprehensive Gradle commands for cross-platform Kotlin Multiplatform development with clear module structure and practical guidance for dependency injection.
stars forks issues prs created last-commit release-date version license
EDSL
by expectedparrot		 CLAUDE.md Files Language-Specific Offers detailed build and test commands with strict code style enforcement, comprehensive testing requirements, and standardized development workflow using Black and mypy.
stars forks issues prs created last-commit release-date version license
Everything Claude Code
by Affaan Mustafa		 Agent Skills General Top-notch, well-written resources covering "just about everything" from core engineering domains. What's nice about this "everything-" store is most of the resources have significant standalone value and unlike some all-encompassing frameworks, although you can opt in to the author's own specific workflow patterns if you choose, the individual resources offer exemplary patterns in (just about) every Claude Code feature you can find (apologies to the Output Styles devotees).
stars forks issues prs created last-commit release-date version license
Fullstack Dev Skills
by jeffallan		 Agent Skills General A comprehensive Claude Code plugin with 65 specialized skills covering full-stack development across a wide range of specific frameworks. Features 9 project workflow commands for Jira/Confluence integration and, notably, an interesting approach to context engineering via a `/common-ground` command that surfaces Claude's hidden assumptions about your project. This is a smart thing to do.
stars forks issues prs created last-commit release-date version license
Gen-Alpha Slang
by Steve Nims		 Output Styles General This is really... different. I don't know what to say about this one. It does what it says on the tin. You might find it funny, you might want throw up. I'll just say candidly this is included strictly for its potentially comedic awesomeness.
stars forks issues prs created last-commit release-date version license
Giselle
by giselles-ai		 CLAUDE.md Files Language-Specific Provides detailed build and test commands using pnpm and Vitest with strict code formatting requirements and comprehensive naming conventions for code consistency.
stars forks issues prs created last-commit release-date version license
Guitar
by soramimi		 CLAUDE.md Files Domain-Specific Serves as development guide for Guitar Git GUI Client with build commands for various platforms, code style guidelines for contributing, and project structure explanation.
stars forks issues prs created last-commit release-date version license
Happy Coder
by GrocerPublishAgent		 Tooling Orchestrators Spawn and control multiple Claude Codes in parallel from your phone or desktop. Happy Coder runs Claude Code on your hardware, sends push notifications when Claude needs more input or permission, and costs nothing.
stars forks issues prs created last-commit release-date version license
HASH
by hashintel		 CLAUDE.md Files Language-Specific Features comprehensive repository structure breakdown with strong emphasis on coding standards, detailed Rust documentation guidelines, and systematic PR review process.
stars forks issues prs created last-commit release-date version license
Inkline
by inkline		 CLAUDE.md Files Language-Specific Structures development workflow using pnpm with emphasis on TypeScript and Vue 3 Composition API, detailed component creation process, and comprehensive testing recommendations.
stars forks issues prs created last-commit release-date version license
JSBeeb
by mattgodbolt		 CLAUDE.md Files Language-Specific Provides development guide for JavaScript BBC Micro emulator with build and testing instructions, architecture documentation, and debugging workflows.
stars forks issues prs created last-commit release-date version license
Lamoom Python
by LamoomAI		 CLAUDE.md Files Language-Specific Serves as reference for production prompt engineering library with load balancing of AI Models, API documentation, and usage patterns with examples.
stars forks issues prs created last-commit release-date version license
LangGraphJS
by langchain-ai		 CLAUDE.md Files Language-Specific Offers comprehensive build and test commands with detailed TypeScript style guidelines, layered library architecture, and monorepo structure using yarn workspaces.
stars forks issues prs created last-commit release-date version license
Laravel TALL Stack AI Development Starter Kit
by tott		 Workflows & Knowledge Guides General Transform your Laravel TALL (Tailwind, AlpineJS, Laravel, Livewire) stack development with comprehensive Claude Code configurations that provide intelligent assistance, systematic workflows, and domain expert consultation.
stars forks issues prs created last-commit release-date version license
Learn Claude Code
by shareAI-Lab		 Workflows & Knowledge Guides General A really interesting analysis of how coding agents like Claude Code are designed. It attempts to break an agent down into its fundamental parts and reconstruct it with minimal code. Great learning resource. Final product is a rudimentary agent with skills, sub-agents, and a todo-list in roughly a few hundred lines of Python.
stars forks issues prs created last-commit release-date version license
learn-faster-kit
by Hugo Lau		 Workflows & Knowledge Guides General A creative educational framework for Claude Code, inspired by the "FASTER" approach to self-teaching. Ships with a variety of agents, slash commands, and tools that enable Claude Code to help you progress at your own pace, employing well-established pedagogical techniques like active learning and spaced repetition.
stars forks issues prs created last-commit release-date version license
Metabase
by metabase		 CLAUDE.md Files Language-Specific Details workflow for REPL-driven development in Clojure/ClojureScript with emphasis on incremental development, testing, and step-by-step approach for feature implementation.
stars forks issues prs created last-commit release-date version license
n8n_agent
by kingler		 Workflows & Knowledge Guides General Amazing comprehensive set of comments for code analysis, QA, design, documentation, project structure, project management, optimization, and many more.
stars forks issues prs created last-commit release-date version license
Network Chronicles
by Fimeg		 CLAUDE.md Files Domain-Specific Presents detailed implementation plan for AI-driven game characters with technical specifications for LLM integration, character guidelines, and service discovery mechanics.
stars forks issues prs created last-commit release-date version license
Omnara
by Ishaan Sehgal		 Alternative Clients General A command center for AI agents that syncs Claude Code sessions across terminal, web, and mobile. Allows for remote monitoring, human-in-the-loop interaction, and team collaboration.
stars forks issues prs created last-commit release-date version license
Pareto Mac
by ParetoSecurity		 CLAUDE.md Files Domain-Specific Serves as development guide for Mac security audit tool with build instructions, contribution guidelines, testing procedures, and workflow documentation.
stars forks issues prs created last-commit release-date version license
parry
by Dmytro Onypko		 Hooks General Prompt injection scanner for Claude Code hooks. Scans tool inputs and outputs for injection attacks, secrets, and data exfiltration attempts. [NOTE: Early development phase but worth a look.]
stars forks issues prs created last-commit release-date version license
Plannotator
by backnotprop		 Hooks - Interactive plan review UI that intercepts ExitPlanMode via hooks, letting users visually annotate plans with comments, deletions, and replacements before approving or denying with detailed feedback.
stars forks issues prs created last-commit release-date version license
pre-commit-hooks
by aRustyDev		 CLAUDE.md Files Domain-Specific This repository is about pre-commit-hooks in general, but the `CLAUDE.md` and related `.claude/` documentation is exemplary. Thorough but not verbose. Unlike a lot of `CLAUDE.md` files, it doesn't primarily consist in shouting at Claude in all-caps. Great learning resource. Also, hooks.
stars forks issues prs created last-commit release-date version license
Project Bootstrapping and Task Management
by steadycursor		 Workflows & Knowledge Guides General Provides a structured set of commands for bootstrapping and managing a new project, including meta-commands for creating and editing custom slash-commands.
stars forks issues prs created last-commit release-date version license
Project Management, Implementation, Planning, and Release
by scopecraft		 Workflows & Knowledge Guides General Really comprehensive set of commands for all aspects of SDLC.
stars forks issues prs created last-commit release-date version license
Project Workflow System
by harperreed		 Workflows & Knowledge Guides General A set of commands that provide a comprehensive workflow system for managing projects, including task management, code review, and deployment processes.
stars forks issues prs created last-commit release-date version license
Ralph for Claude Code
by Frank Bria		 Workflows & Knowledge Guides Ralph Wiggum An autonomous AI development framework that enables Claude Code to work iteratively on projects until completion. Features intelligent exit detection, rate limiting, circuit breaker patterns, and comprehensive safety guardrails to prevent infinite loops and API overuse. Built with Bash, integrated with tmux for live monitoring, and includes 75+ comprehensive tests.
stars forks issues prs created last-commit release-date version license
Ralph Wiggum Marketer
by Muratcan Koylan		 Workflows & Knowledge Guides Ralph Wiggum A Claude Code plugin that provides an autonomous AI copywriter, integrating the Ralph loop with customized knowledge bases for market research agents. The agents do the research, Ralph writes the copy, you stay in bed. Whether or not you practice Ralph-Driven Development (RDD), I think these projects are interesting and creative explorations of general agentic patterns.
stars forks issues prs created last-commit release-date version license
ralph-orchestrator
by mikeyobrien		 Workflows & Knowledge Guides Ralph Wiggum Ralph Orchestrator implements the simple but effective "Ralph Wiggum" technique for autonomous task completion, continuously running an AI agent against a prompt file until the task is marked as complete or limits are reached. This implementation provides a robust, well-tested, and feature-complete orchestration system for AI-driven development. Also cited in the Anthropic Ralph plugin documentation.
stars forks issues prs created last-commit release-date version license
ralph-wiggum-bdd
by marcindulak		 Workflows & Knowledge Guides Ralph Wiggum A standalone Bash script for Behavior-Driven Development with Ralph Wiggum Loop. In principle, while running unattended, the script can keep code and requirements in sync, but in practice it still requires interactive human supervision, so it supports both modes. The script is standalone and can be modified and committed into your project.
stars forks issues prs created last-commit release-date version license
read-only-postgres
by jawwadfirdousi		 Agent Skills General Read-only PostgreSQL query skill for Claude Code. Executes SELECT/SHOW/EXPLAIN/WITH queries across configured databases with strict validation, timeouts, and row limits. Supports multiple connections with descriptions for database selection.
stars forks issues prs created last-commit release-date version license
recall
by zippoxer		 Tooling General Full-text search your Claude Code sessions. Run `recall` in terminal, type to search, Enter to resume. Alternative to `claude --resume`.
stars forks issues prs created last-commit release-date version license
RIPER Workflow
by Tony Narlock		 Workflows & Knowledge Guides General Structured development workflow enforcing separation between Research, Innovate, Plan, Execute, and Review phases. Features consolidated subagents for context-efficiency, branch-aware memory bank, and strict mode enforcement for guided development.
stars forks issues prs created last-commit release-date version license
Rulesync
by dyoshikawa		 Tooling General A Node.js CLI tool that automatically generates configs (rules, ignore files, MCP servers, commands, and subagents) for various AI coding agents. Rulesync can convert configs between Claude Code and other AI agents in both directions.
stars forks issues prs created last-commit release-date version license
run-claude-docker
by Jonas		 Tooling General A self-contained Docker runner that forwards your current workspace into a safe(r) isolated docker container, where you still have access to your Claude Code settings, authentication, ssh agent, pgp, optionally aws keys etc.
stars forks issues prs created last-commit release-date version license
SG Cars Trends Backend
by sgcarstrends		 CLAUDE.md Files Language-Specific Provides comprehensive structure for TypeScript monorepo projects with detailed commands for development, testing, deployment, and AWS/Cloudflare integration.
stars forks issues prs created last-commit release-date version license
Shipping Real Code w/ Claude
by Diwank		 Workflows & Knowledge Guides General A detailed blog post explaining the author's process for shipping a product with Claude Code, including CLAUDE.md files and other interesting resources.
Simone
by Helmi		 Workflows & Knowledge Guides General A broader project management workflow for Claude Code that encompasses not just a set of commands, but a system of documents, guidelines, and processes to facilitate project planning and execution.
stars forks issues prs created last-commit release-date version license
SPy
by spylang		 CLAUDE.md Files Language-Specific Enforces strict coding conventions with comprehensive testing guidelines, multiple code compilation options, and backend-specific test decorators for targeted filtering.
stars forks issues prs created last-commit release-date version license
SteadyStart
by steadycursor		 CLAUDE.md Files Domain-Specific Clear and direct instructives about style, permissions, Claude's "role", communications, and documentation of Claude Code sessions for other team members to stay abreast.
stars forks issues prs created last-commit release-date version license
stt-mcp-server-linux
by marcindulak		 Tooling General A push-to-talk speech transcription setup for Linux using a Python MCP server. Runs locally in Docker with no external API calls. Your speech is recorded, transcribed into text, and then sent to Claude running in a Tmux session.
stars forks issues prs created last-commit release-date version license
sudocode
by ssh-randy		 Tooling Orchestrators Lightweight agent orchestration dev tool that lives in your repo. Integrates with various specification frameworks. It's giving Jira.
stars forks issues prs created last-commit release-date version license
SuperClaude
by SuperClaude-Org		 Tooling General A versatile configuration framework that enhances Claude Code with specialized commands, cognitive personas, and development methodologies, such as "Introspection" and "Orchestration".
stars forks issues prs created last-commit release-date version license
Superpowers
by Jesse Vincent		 Agent Skills General A strong bundle of core competencies for software engineering, with good coverage of a large portion of the SDLC - from planning, reviewing, testing, debugging... Well written, well organized, and adaptable. The author refers to them as "superpowers", but many of them are just consolidating engineering best practices - which sometimes does feel like a superpower when working with Claude Code.
stars forks issues prs created last-commit release-date version license
TDD Guard
by Nizar Selander		 Hooks General A hooks-driven system that monitors file operations in real-time and blocks changes that violate TDD principles.
stars forks issues prs created last-commit release-date version license
The Agentic Startup
by Rudolf Schmidt		 Tooling Orchestrators Yet Another Claude Orchestrator - a collection of agents, commands, etc., for shipping production code - but I like this because it's comprehensive, well-written, and one of the few resources that actually uses Output Styles! +10 points!
stars forks issues prs created last-commit release-date version license
The Ralph Playbook
by Clayton Farr		 Workflows & Knowledge Guides Ralph Wiggum A remarkably detailed and comprehensive guide to the Ralph Wiggum technique, featuring well-written theoretical commentary paired with practical guidelines and advice.
stars forks issues prs created last-commit release-date version license
TPL
by KarpelesLab		 CLAUDE.md Files Language-Specific Details Go project conventions with comprehensive error handling recommendations, table-driven testing approach guidelines, and modernization suggestions for latest Go features.
stars forks issues prs created last-commit release-date version license
Trail of Bits Security Skills
by Trail of Bits		 Agent Skills General A very professional collection of over a dozen security-focused skills for code auditing and vulnerability detection. Includes skills for static analysis with CodeQL and Semgrep, variant analysis across codebases, fix verification, and differential code review.
stars forks issues prs created last-commit release-date version license
TSK - AI Agent Task Manager and Sandbox
by dtormoen		 Tooling Orchestrators A Rust CLI tool that lets you delegate development tasks to AI agents running in sandboxed Docker environments. Multiple agents work in parallel, returning git branches for human review.
stars forks issues prs created last-commit release-date version license
tweakcc
by Piebald-AI		 Tooling General Command-line tool to customize your Claude Code styling.
stars forks issues prs created last-commit release-date version license
TypeScript Quality Hooks
by bartolli		 Hooks General Quality check hook for Node.js TypeScript projects with TypeScript compilation. ESLint auto-fixing, and Prettier formatting. Uses SHA256 config caching for < 5ms validation performance during real-time editing.
stars forks issues prs created last-commit release-date version license
TÂCHES Claude Code Resources
by TÂCHES		 Agent Skills General A well-balanced, "down-to-Earth" set of sub agents, skills, and commands, that are well-organized, easy to read, and a healthy focus on "meta"-skills/agents, like "skill-auditor", hook creation, etc. - the kind of things you can adapt to your workflow, and not the other way around.
stars forks issues prs created last-commit release-date version license
Vibe-Log
by Vibe-Log		 Tooling General Analyzes your Claude Code prompts locally (using CC), provides intelligent session analysis and actionable strategic guidance - works in the statusline and produces very pretty HTML reports as well. Easy to install and remove.
stars forks issues prs created last-commit release-date version license
viberank
by nikshepsvn		 Tooling Usage Monitors A community-driven leaderboard tool that enables developers to visualize, track, and compete based on their Claude Code usage statistics. It features robust data analytics, GitHub OAuth, data validation, and user-friendly CLI/web submission methods.
stars forks issues prs created last-commit release-date version license
viwo-cli
by Hal Shin		 Tooling General Run Claude Code in a Docker container with git worktrees as volume mounts to enable safer usage of `--dangerously-skip-permissions` for frictionless one-shotting prompts. Allows users to spin up multiple instances of Claude Code in the background easily with reduced permission fatigue.
stars forks issues prs created last-commit release-date version license
VoiceMode MCP
by Mike Bailey		 Tooling General VoiceMode MCP brings natural conversations to Claude Code. It supports any OpenAI API compatible voice services and installs free and open source voice services (Whisper.cpp and Kokoro-FastAPI).
stars forks issues prs created last-commit release-date version license
Web Assets Generator Skill
by Alon Wolenitz		 Agent Skills General Easily generate web assets from Claude Code including favicons, app icons (PWA), and social media meta images (Open Graph) for Facebook, Twitter, WhatsApp, and LinkedIn. Handles image resizing, text-to-image generation, emojis, and provides proper HTML meta tags.
stars forks issues prs created last-commit release-date version license
--- **Total Resources:** 192 **Last Generated:** 2026-03-02 ================================================ FILE: README_ALTERNATIVES/README_FLAT_ALL_CREATED.md ================================================

Pick Your Style:

Awesome Extra Classic Flat

# Awesome Claude Code (Flat) [![Awesome](https://awesome.re/badge-flat2.svg)](https://awesome.re) A flat list view of all resources. Category: **All** | Sorted: by date created --- ## Sort By:

A - Z UPDATED CREATED RELEASES

Category:

All Tooling Commands CLAUDE.md Workflows Hooks Skills Styles Status Docs Clients

Currently viewing: **All** sorted by date created

--- ## Resources
Resource Category Sub-Category Description
AI Agent, AI Spy
by Whittaker & Tiwari		 Agent Skills General Members from the Signal Foundation with some really great tips and tricks on how to turn your operating system into an instrument of total surveillance, and why some companies are doing this really awesome thing. [warning: YouTube link]
Claude Code Handbook
by nikiforovall		 Workflows & Knowledge Guides General Collection of best practices, tips, and techniques for Claude Code development workflows, enhanced with distributable plugins
Shipping Real Code w/ Claude
by Diwank		 Workflows & Knowledge Guides General A detailed blog post explaining the author's process for shipping a product with Claude Code, including CLAUDE.md files and other interesting resources.
Claude Code Chat
by andrepimenta		 Tooling IDE Integrations An elegant and user-friendly Claude Code chat interface for VS Code.
ClaudeCTX
by John Fox		 Tooling Config Managers claudectx lets you switch your entire Claude Code configuration with a single command.
stars forks issues prs created last-commit release-date version license
Anthropic Documentation
by Anthropic		 Official Documentation General The official documentation for Claude Code, including installation instructions, usage guidelines, API references, tutorials, examples, loads of information that I won't list individually. Like Claude Code, the documentation is frequently updated.
parry
by Dmytro Onypko		 Hooks General Prompt injection scanner for Claude Code hooks. Scans tool inputs and outputs for injection attacks, secrets, and data exfiltration attempts. [NOTE: Early development phase but worth a look.]
stars forks issues prs created last-commit release-date version license
read-only-postgres
by jawwadfirdousi		 Agent Skills General Read-only PostgreSQL query skill for Claude Code. Executes SELECT/SHOW/EXPLAIN/WITH queries across configured databases with strict validation, timeouts, and row limits. Supports multiple connections with descriptions for database selection.
stars forks issues prs created last-commit release-date version license
claude-rules-doctor
by nulone		 Tooling Config Managers CLI that detects dead `.claude/rules/` files by checking if `paths:` globs actually match files in your repo. Catches silent rule failures where renamed directories or typos in glob patterns cause rules to never apply. Features CI mode (exit 1 on dead rules), JSON output, and verbose mode showing matched files.
stars forks issues prs created last-commit release-date version license
Claude Session Restore
by ZENG3LD		 Tooling General Efficiently restore context from previous Claude Code sessions by analyzing session files and git history. Features multi-factor data collection across numerous Claude Code capacities with time-based filtering. Uses tail-based parsing for efficient handling of large session files up to 2GB. Includes both a CLI tool for manual analysis and a Claude Code skill for automatic session restoration.
stars forks issues prs created last-commit release-date version license
ralph-wiggum-bdd
by marcindulak		 Workflows & Knowledge Guides Ralph Wiggum A standalone Bash script for Behavior-Driven Development with Ralph Wiggum Loop. In principle, while running unattended, the script can keep code and requirements in sync, but in practice it still requires interactive human supervision, so it supports both modes. The script is standalone and can be modified and committed into your project.
stars forks issues prs created last-commit release-date version license
Book Factory
by Robert Guss		 Agent Skills General A comprehensive pipeline of Skills that replicates traditional publishing infrastructure for nonfiction book creation using specialized Claude skills.
stars forks issues prs created last-commit release-date version license
awesome-ralph
by Martin Joly		 Workflows & Knowledge Guides Ralph Wiggum A curated list of resources about Ralph, the AI coding technique that runs AI coding agents in automated loops until specifications are fulfilled.
stars forks issues prs created last-commit release-date version license
Everything Claude Code
by Affaan Mustafa		 Agent Skills General Top-notch, well-written resources covering "just about everything" from core engineering domains. What's nice about this "everything-" store is most of the resources have significant standalone value and unlike some all-encompassing frameworks, although you can opt in to the author's own specific workflow patterns if you choose, the individual resources offer exemplary patterns in (just about) every Claude Code feature you can find (apologies to the Output Styles devotees).
stars forks issues prs created last-commit release-date version license
AgentSys
by avifenesh		 Agent Skills General Workflow automation system for Claude with a group of useful plugins, agents, and skills. Automates task-to-production workflows, PR management, code cleanup, performance investigation, drift detection, and multi-agent code review. Includes [agnix](https://github.com/avifenesh/agnix) for linting agent configurations. Built on thousands of lines of code with thousands of tests. Uses deterministic detection (regex, AST) with LLM judgment for efficiency. Used on many production systems.
stars forks issues prs created last-commit release-date version license
Trail of Bits Security Skills
by Trail of Bits		 Agent Skills General A very professional collection of over a dozen security-focused skills for code auditing and vulnerability detection. Includes skills for static analysis with CodeQL and Semgrep, variant analysis across codebases, fix verification, and differential code review.
stars forks issues prs created last-commit release-date version license
/prd-generator
by Denis Redozubov		 Slash-Commands Project & Task Management A Claude Code plugin that generates comprehensive Product Requirements Documents (PRDs) from conversation context. Invoke `/create-prd` after discussing requirements and it produces a complete PRD with all standard sections including Executive Summary, User Stories, MVP Scope, Architecture, Success Criteria, and Implementation Phases.
stars forks issues prs created last-commit release-date version license
claude-tmux
by Niels Groeneveld		 Alternative Clients General Manage Claude Code within tmux. A tmux popup of all your Claude Code instances, enabling quick switching, status monitoring, session lifecycle management, with git worktree and pull request support.
stars forks issues prs created last-commit release-date version license
The Ralph Playbook
by Clayton Farr		 Workflows & Knowledge Guides Ralph Wiggum A remarkably detailed and comprehensive guide to the Ralph Wiggum technique, featuring well-written theoretical commentary paired with practical guidelines and advice.
stars forks issues prs created last-commit release-date version license
Claude Code Ultimate Guide
by Florian BRUNIAUX		 Workflows & Knowledge Guides General A tremendous feat of documentation, this guide covers Claude Code from beginner to power user, with production-ready templates for Claude Code features, guides on agentic workflows, and a lot of great learning materials, including quizzes and a handy "cheatsheet". Whether it's the "ultimate" guide to Claude Code will be up to the reader, but a valuable resource nonetheless (as with all documentation sites, make sure it's up to date before you bet the farm).
stars forks issues prs created last-commit release-date version license
claude-esp
by phiat		 Alternative Clients General Go-based TUI that streams Claude Code's hidden output (thinking, tool calls, subagents) to a separate terminal. Watch multiple sessions simultaneously, filter by content type, and track background tasks. Ideal for debugging or understanding what Claude is doing under the hood without interrupting your main session.
stars forks issues prs created last-commit release-date version license
Dippy
by Lily Dayton		 Hooks General Auto-approve safe bash commands using AST-based parsing, while prompting for destructive operations. Solves permission fatigue without disabling safety. Supports Claude Code, Gemini CLI, and Cursor.
stars forks issues prs created last-commit release-date version license
Ralph Wiggum Marketer
by Muratcan Koylan		 Workflows & Knowledge Guides Ralph Wiggum A Claude Code plugin that provides an autonomous AI copywriter, integrating the Ralph loop with customized knowledge bases for market research agents. The agents do the research, Ralph writes the copy, you stay in bed. Whether or not you practice Ralph-Driven Development (RDD), I think these projects are interesting and creative explorations of general agentic patterns.
stars forks issues prs created last-commit release-date version license
Plannotator
by backnotprop		 Hooks - Interactive plan review UI that intercepts ExitPlanMode via hooks, letting users visually annotate plans with comments, deletions, and replacements before approving or denying with detailed feedback.
stars forks issues prs created last-commit release-date version license
Claude Code Agents
by Paul - UndeadList		 Agent Skills General Comprehensive E2E development workflow with helpful Claude Code subagent prompts for solo devs. Run multiple auditors in parallel, automate fix cycles with micro-checkpoint protocols, and do browser-based QA. Includes strict protocols to prevent AI going rogue.
stars forks issues prs created last-commit release-date version license
cc-devops-skills
by akin-ozer		 Agent Skills General Immensely detailed set of skills for DevOps Engineers (or anyone who has to deploy code, really). Works with validations, generators, shell scripts and CLI tools to create high quality IaC code for about any platform you've ever struggled painfully to work with. Worth downloading even just as a source of documentation.
stars forks issues prs created last-commit release-date version license
Auto-Claude
by AndyMik90		 Tooling Orchestrators Autonomous multi-agent coding framework for Claude Code (Claude Agent SDK) that integrates the full SDLC - "plans, builds, and validates software for you". Features a slick kanban-style UI and a well-designed but not over-engineered agent orchestration system.
stars forks issues prs created last-commit release-date version license
Britfix
by Talieisin		 Hooks General Claude outputs American spellings by default, which can have an impact on: professional credibility, compliance, documentation, and more. Britfix converts to British English, with a Claude Code hook for automatic conversion as files are written. Context-aware: handles code files intelligently by only converting comments and docstrings, never identifiers or string literals.
stars forks issues prs created last-commit release-date version license
recall
by zippoxer		 Tooling General Full-text search your Claude Code sessions. Run `recall` in terminal, type to search, Enter to resume. Alternative to `claude --resume`.
stars forks issues prs created last-commit release-date version license
Claude Code Tips
by ykdojo		 Workflows & Knowledge Guides General A nice variety of 35+ brief but information-dense Claude Code tips covering voice input, system prompt patching, container workflows for risky tasks, conversation cloning(!), multi-model orchestration with Gemini CLI, and plenty more. Nice demos, working scripts, a plugin, I'd say this probably has a little something for everyone.
stars forks issues prs created last-commit release-date version license
Agentic Workflow Patterns
by ThibautMelen		 Workflows & Knowledge Guides General A comprehensive and well-documented collection of agentic patterns from Anthropic docs, with colorful Mermaid diagrams and code examples for each pattern. Covers Subagent Orchestration, Progressive Skills, Parallel Tool Calling, Master-Clone Architecture, Wizard Workflows, and more. Also compatible with other providers.
stars forks issues prs created last-commit release-date version license
Gen-Alpha Slang
by Steve Nims		 Output Styles General This is really... different. I don't know what to say about this one. It does what it says on the tin. You might find it funny, you might want throw up. I'll just say candidly this is included strictly for its potentially comedic awesomeness.
stars forks issues prs created last-commit release-date version license
Awesome Claude Code Output Styles (That I Really Like)
by Really Him		 Output Styles General A fun and moderately amusing collection of experimental output styles.
stars forks issues prs created last-commit release-date version license
Claude Code System Prompts
by Piebald AI		 Workflows & Knowledge Guides General All parts of Claude Code's system prompt, including builtin tool descriptions, sub agent prompts (Plan/Explore/Task), utility prompts (CLAUDE.md, compact, Bash cmd, security review, agent creation, etc.). Updated for each Claude Code version.
stars forks issues prs created last-commit release-date version license
Context Engineering Kit
by Vlad Goncharov		 Agent Skills General Hand-crafted collection of advanced context engineering techniques and patterns with minimal token footprint focused on improving agent result quality.
stars forks issues prs created last-commit release-date version license
TÂCHES Claude Code Resources
by TÂCHES		 Agent Skills General A well-balanced, "down-to-Earth" set of sub agents, skills, and commands, that are well-organized, easy to read, and a healthy focus on "meta"-skills/agents, like "skill-auditor", hook creation, etc. - the kind of things you can adapt to your workflow, and not the other way around.
stars forks issues prs created last-commit release-date version license
Claudix - Claude Code for VSCode
by Haleclipse		 Tooling IDE Integrations A VSCode extension that brings Claude Code directly into your editor with interactive chat interface, session management, intelligent file operations, terminal execution, and real-time streaming responses. Built with Vue 3, TypeScript.
stars forks issues prs created last-commit release-date version license
learn-faster-kit
by Hugo Lau		 Workflows & Knowledge Guides General A creative educational framework for Claude Code, inspired by the "FASTER" approach to self-teaching. Ships with a variety of agents, slash commands, and tools that enable Claude Code to help you progress at your own pace, employing well-established pedagogical techniques like active learning and spaced repetition.
stars forks issues prs created last-commit release-date version license
Claude Code Infrastructure Showcase
by diet103		 Workflows & Knowledge Guides General A remarkably innovative approach to working with Skills, the centerpiece of which being a technique that leverages hooks to ensure that Claude intelligently selects and activates the appropriate Skill given the current context. Well-documented and adaptable to different projects and workflows.
stars forks issues prs created last-commit release-date version license
Claude CodePro
by Max Ritter		 Workflows & Knowledge Guides General Professional development environment for Claude Code with spec-driven workflow, TDD enforcement, cross-session memory, semantic search, quality hooks, and modular rules integration. A bit "heavyweight" but feature-packed and has wide coverage.
stars forks issues prs created last-commit release-date version license
Codex Skill
by klaudworks		 Agent Skills General Enables users to prompt codex from claude code. Unlike the raw codex mcp server, this skill infers parameters such as model, reasoning effort, sandboxing from your prompt or asks you to specify them. It also simplifies continuing prior codex sessions so that codex can continue with the prior context.
stars forks issues prs created last-commit release-date version license
/linux-desktop-slash-commands
by Daniel Rosehill		 Slash-Commands General A library of slash commands intended specifically to facilitate common and advanced operations on Linux desktop environments (although many would also be useful on Linux servers). Command groups include hardware benchmarking, filesystem organisation, and security posture validation.
stars forks issues prs created last-commit release-date version license
Web Assets Generator Skill
by Alon Wolenitz		 Agent Skills General Easily generate web assets from Claude Code including favicons, app icons (PWA), and social media meta images (Open Graph) for Facebook, Twitter, WhatsApp, and LinkedIn. Handles image resizing, text-to-image generation, emojis, and provides proper HTML meta tags.
stars forks issues prs created last-commit release-date version license
Claude Mountaineering Skills
by Dmytro Gaivoronsky		 Agent Skills General Claude Code skill that automates mountain route research for North American peaks. Aggregates data from 10+ mountaineering sources like Mountaineers.org, PeakBagger.com and SummitPost.com to generate detailed route beta reports with weather, avalanche conditions, and trip reports.
stars forks issues prs created last-commit release-date version license
Fullstack Dev Skills
by jeffallan		 Agent Skills General A comprehensive Claude Code plugin with 65 specialized skills covering full-stack development across a wide range of specific frameworks. Features 9 project workflow commands for Jira/Confluence integration and, notably, an interesting approach to context engineering via a `/common-ground` command that surfaces Claude's hidden assumptions about your project. This is a smart thing to do.
stars forks issues prs created last-commit release-date version license
Claude Scientific Skills
by K-Dense		 Agent Skills General "A set of ready-to-use Agent Skills for research, science, engineering, analysis, finance and writing." That's their description - modest, simple. That's how you can tell this is really one of the best skills repos on GitHub. If you've ever thought about getting a PhD... just read all of these documents instead. Also I think it IS an AI agent or something? Awesome.
stars forks issues prs created last-commit release-date version license
claude-starter-kit
by serpro69		 Tooling General This is a starter template repository designed to provide a complete development environment for Claude-Code with pre-configured MCP servers and tools for AI-powered development workflows. The repository is intentionally minimal, containing only configuration templates for three primary systems: Claude Code, Serena, and Task Master.
stars forks issues prs created last-commit release-date version license
sudocode
by ssh-randy		 Tooling Orchestrators Lightweight agent orchestration dev tool that lives in your repo. Integrates with various specification frameworks. It's giving Jira.
stars forks issues prs created last-commit release-date version license
Claude Code Repos Index
by Daniel Rosehill		 Workflows & Knowledge Guides General This is either the work of a prolific genius, or a very clever bot (or both), although it hardly matters because the quality is so good - an index of 75+ Claude Code repositories published by the author - and I'm not talking about slop. CMS, system design, deep research, IoT, agentic workflows, server management, personal health... If you spot the lie, let me know, otherwise please check these out.
stars forks issues prs created last-commit release-date version license
Compound Engineering Plugin
by EveryInc		 Agent Skills General A very pragmatic set of well-designed agents, skills, and commands, built around a discipline of turning past mistakes and errors into lessons and opportunities for future growth and improvement. Good documentation.
stars forks issues prs created last-commit release-date version license
Superpowers
by Jesse Vincent		 Agent Skills General A strong bundle of core competencies for software engineering, with good coverage of a large portion of the SDLC - from planning, reviewing, testing, debugging... Well written, well organized, and adaptable. The author refers to them as "superpowers", but many of them are just consolidating engineering best practices - which sometimes does feel like a superpower when working with Claude Code.
stars forks issues prs created last-commit release-date version license
Claude Code Output Styles - Debugging
by Jamie Matthews		 Output Styles General A small set of well-written output styles, specifically focused on debugging - root cause analysis, systematic, methodical debugging, encouraging a more careful approach to bug-squashing from Claude Code.
stars forks issues prs created last-commit release-date version license
ClaudoPro Directory
by ghost		 Workflows & Knowledge Guides General Well-crafted, wide selection of Claude Code hooks, slash commands, subagent files, and more, covering a range of specialized tasks and workflows. Better resources than your average "Claude-template-for-everything" site.
stars forks issues prs created last-commit release-date version license
ContextKit
by Cihat Gündüz		 Tooling General A systematic development framework that transforms Claude Code into a proactive development partner. Features 4-phase planning methodology, specialized quality agents, and structured workflows that help AI produce production-ready code on first try.
stars forks issues prs created last-commit release-date version license
Claudex
by Kunwar Shah		 Tooling Usage Monitors Claudex - A web-based browser for exploring your Claude Code conversation history across projects. Indexes your codebase for full-text search. Nice, easy-to-navigate UI. Simple dashboard interface for high-level analytics, and multiple export options as well. (And completely local w/ no telemetry!)
stars forks issues prs created last-commit release-date version license
ralph-orchestrator
by mikeyobrien		 Workflows & Knowledge Guides Ralph Wiggum Ralph Orchestrator implements the simple but effective "Ralph Wiggum" technique for autonomous task completion, continuously running an AI agent against a prompt file until the task is marked as complete or limits are reached. This implementation provides a robust, well-tested, and feature-complete orchestration system for AI-driven development. Also cited in the Anthropic Ralph plugin documentation.
stars forks issues prs created last-commit release-date version license
stt-mcp-server-linux
by marcindulak		 Tooling General A push-to-talk speech transcription setup for Linux using a Python MCP server. Runs locally in Docker with no external API calls. Your speech is recorded, transcribed into text, and then sent to Claude running in a Tmux session.
stars forks issues prs created last-commit release-date version license
RIPER Workflow
by Tony Narlock		 Workflows & Knowledge Guides General Structured development workflow enforcing separation between Research, Innovate, Plan, Execute, and Review phases. Features consolidated subagents for context-efficiency, branch-aware memory bank, and strict mode enforcement for guided development.
stars forks issues prs created last-commit release-date version license
viwo-cli
by Hal Shin		 Tooling General Run Claude Code in a Docker container with git worktrees as volume mounts to enable safer usage of `--dangerously-skip-permissions` for frictionless one-shotting prompts. Allows users to spin up multiple instances of Claude Code in the background easily with reduced permission fatigue.
stars forks issues prs created last-commit release-date version license
Ralph for Claude Code
by Frank Bria		 Workflows & Knowledge Guides Ralph Wiggum An autonomous AI development framework that enables Claude Code to work iteratively on projects until completion. Features intelligent exit detection, rate limiting, circuit breaker patterns, and comprehensive safety guardrails to prevent infinite loops and API overuse. Built with Bash, integrated with tmux for live monitoring, and includes 75+ comprehensive tests.
stars forks issues prs created last-commit release-date version license
cc-sessions
by toastdev		 Tooling General An opinionated approach to productive development with Claude Code
stars forks issues prs created last-commit release-date version license
cc-tools
by Josh Symonds		 Tooling General High-performance Go implementation of Claude Code hooks and utilities. Provides smart linting, testing, and statusline generation with minimal overhead.
stars forks issues prs created last-commit release-date version license
claudia-statusline
by Hagan Franks		 Status Lines General High-performance Rust-based statusline for Claude Code with persistent stats tracking, progress bars, and optional cloud sync. Features SQLite-first persistence, git integration, context progress bars, burn rate calculation, XDG-compliant with theme support (dark/light, NO_COLOR).
stars forks issues prs created last-commit release-date version license
ccoutputstyles
by Vivek Nair		 Output Styles General CLI tool and template gallery for customizing Claude Code output styles with pre-built templates. Features over 15 templates at the time of writing!
stars forks issues prs created last-commit release-date version license
Claudable
by Ethan Park		 Alternative Clients General Claudable is an open-source web builder that leverages local CLI agents, such as Claude Code and Cursor Agent, to build and deploy products effortlessly.
stars forks issues prs created last-commit release-date version license
Claude Code PM
by Ran Aroussi		 Workflows & Knowledge Guides General Really comprehensive and feature-packed project-management workflow for Claude Code. Numerous specialized agents, slash-commands, and strong documentation.
stars forks issues prs created last-commit release-date version license
claude-code-statusline
by rz1989s		 Status Lines General Enhanced 4-line statusline for Claude Code with themes, cost tracking, and MCP server monitoring
stars forks issues prs created last-commit release-date version license
Vibe-Log
by Vibe-Log		 Tooling General Analyzes your Claude Code prompts locally (using CC), provides intelligent session analysis and actionable strategic guidance - works in the statusline and produces very pretty HTML reports as well. Easy to install and remove.
stars forks issues prs created last-commit release-date version license
run-claude-docker
by Jonas		 Tooling General A self-contained Docker runner that forwards your current workspace into a safe(r) isolated docker container, where you still have access to your Claude Code settings, authentication, ssh agent, pgp, optionally aws keys etc.
stars forks issues prs created last-commit release-date version license
Design Review Workflow
by Patrick Ellis		 Workflows & Knowledge Guides General A tailored workflow for enabling automated UI/UX design review, including specialized sub agents, slash commands, `CLAUDE.md` excerpts, and more. Covers a broad range of criteria from responsive design to accessibility.
stars forks issues prs created last-commit release-date version license
CCometixLine - Claude Code Statusline
by Haleclipse		 Status Lines General A high-performance Claude Code statusline tool written in Rust with Git integration, usage tracking, interactive TUI configuration, and Claude Code enhancement utilities.
stars forks issues prs created last-commit release-date version license
AB Method
by Ayoub Bensalah		 Workflows & Knowledge Guides General A principled, spec-driven workflow that transforms large problems into focused, incremental missions using Claude Code's specialized sub agents. Includes slash-commands, sub agents, and specialized workflows designed for specific parts of the SDLC.
stars forks issues prs created last-commit release-date version license
claude-powerline
by Owloops		 Status Lines General A vim-style powerline statusline for Claude Code with real-time usage tracking, git integration, custom themes, and more
stars forks issues prs created last-commit release-date version license
Laravel TALL Stack AI Development Starter Kit
by tott		 Workflows & Knowledge Guides General Transform your Laravel TALL (Tailwind, AlpineJS, Laravel, Livewire) stack development with comprehensive Claude Code configurations that provide intelligent assistance, systematic workflows, and domain expert consultation.
stars forks issues prs created last-commit release-date version license
ccstatusline
by sirmalloc		 Status Lines General A highly customizable status line formatter for Claude Code CLI that displays model info, git branch, token usage, and other metrics in your terminal.
stars forks issues prs created last-commit release-date version license
The Agentic Startup
by Rudolf Schmidt		 Tooling Orchestrators Yet Another Claude Orchestrator - a collection of agents, commands, etc., for shipping production code - but I like this because it's comprehensive, well-written, and one of the few resources that actually uses Output Styles! +10 points!
stars forks issues prs created last-commit release-date version license
claude-code-tools
by Prasad Chalasani		 Tooling General Well-crafted toolset for session continuity, featuring skills/commands to avoid compaction and recover context across sessions with cross-agent handoff between Claude Code and Codex CLI. Includes a fast Rust/Tantivy-powered full-text session search (TUI for humans, skill/CLI for agents), tmux-cli skill + command for interacting with scripts and CLI agents, and safety hooks to block dangerous commands.
stars forks issues prs created last-commit release-date version license
cclogviewer
by Brad S.		 Tooling General A humble but handy utility for viewing Claude Code `.jsonl` conversation files in a pretty HTML UI.
stars forks issues prs created last-commit release-date version license
Claudio
by Christopher Toth		 Hooks General A no-frills little library that adds delightful OS-native sounds to Claude Code via simple hooks. It really sparks joy.
stars forks issues prs created last-commit release-date version license
ccflare
by snipeship		 Tooling Usage Monitors Claude Code usage dashboard with a web-UI that would put Tableau to shame. Thoroughly comprehensive metrics, frictionless setup, detailed logging, really really nice UI.
stars forks issues prs created last-commit release-date version license
ccflare -> **better-ccflare**
by tombii		 Tooling Usage Monitors A well-maintained and feature-enhanced fork of the glorious `ccflare` usage dashboard by @snipeship (which at the time of writing has not had an update in a few months). `better-ccflare` builds on this foundation with some performance enhancements, extended provider support, bug fixes, Docker deployment, and more.
stars forks issues prs created last-commit release-date version license
CC Notify
by dazuiba		 Hooks General CCNotify provides desktop notifications for Claude Code, alerting you to input needs or task completion, with one-click jumps back to VS Code and task duration display.
stars forks issues prs created last-commit release-date version license
/create-hook
by Omri Lavi		 Slash-Commands General Slash command for hook creation - intelligently prompts you through the creation process with smart suggestions based on your project setup (TS, Prettier, ESLint...).
stars forks issues prs created last-commit release-date version license
Claude Code Hook Comms (HCOM)
by aannoo		 Hooks General Lightweight CLI tool for real-time communication between Claude Code sub agents using hooks. Enables multi-agent collaboration with @-mention targeting, live dashboard monitoring, and zero-dependency implementation. [NOTE: At the time of posting, this resource is a little unstable - I'm sharing it anyway, because I think it's incredibly promising and creative. I hope by the time you read this, it is production-ready.]
stars forks issues prs created last-commit release-date version license
TypeScript Quality Hooks
by bartolli		 Hooks General Quality check hook for Node.js TypeScript projects with TypeScript compilation. ESLint auto-fixing, and Prettier formatting. Uses SHA256 config caching for < 5ms validation performance during real-time editing.
stars forks issues prs created last-commit release-date version license
tweakcc
by Piebald-AI		 Tooling General Command-line tool to customize your Claude Code styling.
stars forks issues prs created last-commit release-date version license
cchooks
by GowayLee		 Hooks General A lightweight Python SDK with a clean API and good documentation; simplifies the process of writing hooks and integrating them into your codebase, providing a nice abstraction over the JSON configuration files.
stars forks issues prs created last-commit release-date version license
SuperClaude
by SuperClaude-Org		 Tooling General A versatile configuration framework that enhances Claude Code with specialized commands, cognitive personas, and development methodologies, such as "Introspection" and "Orchestration".
stars forks issues prs created last-commit release-date version license
Happy Coder
by GrocerPublishAgent		 Tooling Orchestrators Spawn and control multiple Claude Codes in parallel from your phone or desktop. Happy Coder runs Claude Code on your hardware, sends push notifications when Claude needs more input or permission, and costs nothing.
stars forks issues prs created last-commit release-date version license
claudekit
by Carl Rannaberg		 Tooling General Impressive CLI toolkit providing auto-save checkpointing, code quality hooks, specification generation and execution, and 20+ specialized subagents including oracle (gpt-5), code-reviewer (6-aspect deep analysis), ai-sdk-expert (Vercel AI SDK), typescript-expert and many more for Claude Code workflows.
stars forks issues prs created last-commit release-date version license
Claude Code Documentation Mirror
by Eric Buess		 Workflows & Knowledge Guides General A mirror of the Anthropic © PBC documentation pages for Claude Code, updated every few hours. Can come in handy when trying to stay on top of the ever-expanding feature-set of Dr. Claw D. Code, Ph.D.
stars forks issues prs created last-commit release-date version license
claude-code-docs
by Constantin Shafranski		 Workflows & Knowledge Guides General A mirror of the Anthropic© PBC documentation site for Claude/Code, but with bonus features like full-text search and query-time updates - a nice companion to `claude-code-docs` for up-to-the-minute, fully-indexed information so that Claude Code can read about itself.
stars forks issues prs created last-commit release-date version license
Claude Codex Settings
by fatih akyon		 Agent Skills General A well-organized, well-written set of plugins covering core developer activities, such as working with common cloud platforms like GitHub, Azure, MongoDB, and popular services such as Tavily, Playwright, and more. Clear, not overly-opinionated, and compatible with a few other providers.
stars forks issues prs created last-commit release-date version license
Omnara
by Ishaan Sehgal		 Alternative Clients General A command center for AI agents that syncs Claude Code sessions across terminal, web, and mobile. Allows for remote monitoring, human-in-the-loop interaction, and team collaboration.
stars forks issues prs created last-commit release-date version license
Claude Code Templates
by Daniel Avila		 Tooling General Incredibly awesome collection of resources from every category in this list, presented with a neatly polished UI, great features like usage dashboard, analytics, and everything from slash commands to hooks to agents. An awesome companion for this awesome list.
stars forks issues prs created last-commit release-date version license
claude-hooks
by John Lindquist		 Hooks General A TypeScript-based system for configuring and customizing Claude Code hooks with a powerful and flexible interface.
stars forks issues prs created last-commit release-date version license
claude-code-hooks-sdk
by beyondcode		 Hooks General A Laravel-inspired PHP SDK for building Claude Code hook responses with a clean, fluent API. This SDK makes it easy to create structured JSON responses for Claude Code hooks using an expressive, chainable interface.
stars forks issues prs created last-commit release-date version license
TDD Guard
by Nizar Selander		 Hooks General A hooks-driven system that monitors file operations in real-time and blocks changes that violate TDD principles.
stars forks issues prs created last-commit release-date version license
viberank
by nikshepsvn		 Tooling Usage Monitors A community-driven leaderboard tool that enables developers to visualize, track, and compete based on their Claude Code usage statistics. It features robust data analytics, GitHub OAuth, data validation, and user-friendly CLI/web submission methods.
stars forks issues prs created last-commit release-date version license
ccexp
by nyatinte		 Tooling General Interactive CLI tool for discovering and managing Claude Code configuration files and slash commands with a beautiful terminal UI.
stars forks issues prs created last-commit release-date version license
Learn Claude Code
by shareAI-Lab		 Workflows & Knowledge Guides General A really interesting analysis of how coding agents like Claude Code are designed. It attempts to break an agent down into its fundamental parts and reconstruct it with minimal code. Great learning resource. Final product is a rudimentary agent with skills, sub-agents, and a todo-list in roughly a few hundred lines of Python.
stars forks issues prs created last-commit release-date version license
claude-code-ide.el
by manzaltu		 Tooling IDE Integrations claude-code-ide.el integrates Claude Code with Emacs, like Anthropic’s VS Code/IntelliJ extensions. It shows ediff-based code suggestions, pulls LSP/flymake/flycheck diagnostics, and tracks buffer context. It adds an extensible MCP tool support for symbol refs/defs, project metadata, and tree-sitter AST queries.
stars forks issues prs created last-commit release-date version license
/todo
by chrisleyva		 Slash-Commands Project & Task Management A convenient command to quickly manage project todo items without leaving the Claude Code interface, featuring due dates, sorting, task prioritization, and comprehensive todo list management.
stars forks issues prs created last-commit release-date version license
Claude Code Usage Monitor
by Maciek-roboblog		 Tooling Usage Monitors A real-time terminal-based tool for monitoring Claude Code token usage. It shows live token consumption, burn rate, and predictions for token depletion. Features include visual progress bars, session-aware analytics, and support for multiple subscription plans.
stars forks issues prs created last-commit release-date version license
Rulesync
by dyoshikawa		 Tooling General A Node.js CLI tool that automatically generates configs (rules, ignore files, MCP servers, commands, and subagents) for various AI coding agents. Rulesync can convert configs between Claude Code and other AI agents in both directions.
stars forks issues prs created last-commit release-date version license
crystal
by stravu		 Alternative Clients General A full-fledged desktop application for orchestrating, monitoring, and interacting with Claude Code agents.
stars forks issues prs created last-commit release-date version license
VoiceMode MCP
by Mike Bailey		 Tooling General VoiceMode MCP brings natural conversations to Claude Code. It supports any OpenAI API compatible voice services and installs free and open source voice services (Whisper.cpp and Kokoro-FastAPI).
stars forks issues prs created last-commit release-date version license
cchistory
by eckardt		 Tooling General Like the shell history command but for your Claude Code sessions. Easily list all Bash or "Bash-mode" (`!`) commands Claude Code ran in a session for reference.
stars forks issues prs created last-commit release-date version license
Claude Code Flow
by ruvnet		 Tooling Orchestrators This mode serves as a code-first orchestration layer, enabling Claude to write, edit, test, and optimize code autonomously across recursive agent cycles.
stars forks issues prs created last-commit release-date version license
TSK - AI Agent Task Manager and Sandbox
by dtormoen		 Tooling Orchestrators A Rust CLI tool that lets you delegate development tasks to AI agents running in sandboxed Docker environments. Multiple agents work in parallel, returning git branches for human review.
stars forks issues prs created last-commit release-date version license
CC Usage
by ryoppippi		 Tooling Usage Monitors Handy CLI tool for managing and analyzing Claude Code usage, based on analyzing local Claude Code logs. Presents a nice dashboard regarding cost information, token consumption, etc.
stars forks issues prs created last-commit release-date version license
Claude Swarm
by parruda		 Tooling Orchestrators Launch Claude Code session that is connected to a swarm of Claude Code Agents.
stars forks issues prs created last-commit release-date version license
Claude Composer
by Mike Bannister		 Tooling General A tool that adds small enhancements to Claude Code.
stars forks issues prs created last-commit release-date version license
Container Use
by dagger		 Tooling General Development environments for coding agents. Enable multiple agents to work safely and independently with your preferred stack.
stars forks issues prs created last-commit release-date version license
Simone
by Helmi		 Workflows & Knowledge Guides General A broader project management workflow for Claude Code that encompasses not just a set of commands, but a system of documents, guidelines, and processes to facilitate project planning and execution.
stars forks issues prs created last-commit release-date version license
Claude Hub
by Claude Did This		 Tooling General A webhook service that connects Claude Code to GitHub repositories, enabling AI-powered code assistance directly through pull requests and issues. This integration allows Claude to analyze repositories, answer technical questions, and help developers understand and improve their codebase through simple @mentions.
stars forks issues prs created last-commit release-date version license
Claude Code GitHub Actions
by Anthropic		 Official Documentation General Official GitHub Actions integration for Claude Code with examples and documentation for automating AI-powered workflows in CI/CD pipelines.
stars forks issues prs created last-commit release-date version license
/rsi
by ddisisto		 Slash-Commands Context Loading & Priming Reads all commands and key project files to optimize AI-assisted development by streamlining the process, loading command context, and setting up for better development workflow.
stars forks issues prs created last-commit release-date version license
n8n_agent
by kingler		 Workflows & Knowledge Guides General Amazing comprehensive set of comments for code analysis, QA, design, documentation, project structure, project management, optimization, and many more.
stars forks issues prs created last-commit release-date version license
/code_analysis
by kingler		 Slash-Commands Code Analysis & Testing Provides a menu of advanced code analysis commands for deep inspection, including knowledge graph generation, optimization suggestions, and quality evaluation.
stars forks issues prs created last-commit release-date version license
claude-code-mcp-enhanced
by grahama1970		 CLAUDE.md Files Project Scaffolding & MCP Provides detailed and emphatic instructions for Claude to follow as a coding agent, with testing guidance, code examples, and compliance checks.
stars forks issues prs created last-commit release-date version license
Claude Task Runner
by grahama1970		 Tooling Orchestrators A specialized tool to manage context isolation and focused task execution with Claude Code, solving the critical challenge of context length limitations and task focus when working with Claude on complex, multi-step projects.
stars forks issues prs created last-commit release-date version license
/update-docs
by Consiliency		 Slash-Commands Documentation & Changelogs Reviews current documentation status, updates implementation progress, reviews phase documents, and maintains documentation consistency across the project.
stars forks issues prs created last-commit release-date version license
/create-prp
by Wirasm		 Slash-Commands Project & Task Management Creates product requirement plans by reading PRP methodology, following template structure, creating comprehensive requirements, and structuring product definitions for development.
stars forks issues prs created last-commit release-date version license
Project Management, Implementation, Planning, and Release
by scopecraft		 Workflows & Knowledge Guides General Really comprehensive set of commands for all aspects of SDLC.
stars forks issues prs created last-commit release-date version license
/create-command
by scopecraft		 Slash-Commands Project & Task Management Guides Claude through creating new custom commands with proper structure by analyzing requirements, templating commands by category, enforcing command standards, and creating supporting documentation.
stars forks issues prs created last-commit release-date version license
/prime
by yzyydev		 Slash-Commands Context Loading & Priming Sets up initial project context by viewing directory structure and reading key files, creating standardized context with directory visualization and key documentation focus.
stars forks issues prs created last-commit release-date version license
/create-plan
by taddyorg		 Slash-Commands Project & Task Management Generates comprehensive product requirement documents outlining detailed specifications, requirements, and features following standardized document structure and format.
stars forks issues prs created last-commit release-date version license
/analyze-issue
by jerseycheese		 Slash-Commands Version Control & Git Fetches GitHub issue details to create comprehensive implementation specifications, analyzing requirements and planning structured approach with clear implementation steps.
stars forks issues prs created last-commit release-date version license
/tdd-implement
by jerseycheese		 Slash-Commands Code Analysis & Testing Implements Test-Driven Development by analyzing feature requirements, creating tests first (red), implementing minimal passing code (green), and refactoring while maintaining tests.
stars forks issues prs created last-commit release-date version license
/create-docs
by jerseycheese		 Slash-Commands Documentation & Changelogs Analyzes code structure and purpose to create comprehensive documentation detailing inputs/outputs, behavior, user interaction flows, and edge cases with error handling.
stars forks issues prs created last-commit release-date version license
/do-issue
by jerseycheese		 Slash-Commands Project & Task Management Implements GitHub issues with manual review points, following a structured approach with issue number parameter and offering alternative automated mode for efficiency.
stars forks issues prs created last-commit release-date version license
/optimize
by to4iki		 Slash-Commands Code Analysis & Testing Analyzes code performance to identify bottlenecks, proposing concrete optimizations with implementation guidance for improved application performance.
stars forks issues prs created last-commit release-date version license
EDSL
by expectedparrot		 CLAUDE.md Files Language-Specific Offers detailed build and test commands with strict code style enforcement, comprehensive testing requirements, and standardized development workflow using Black and mypy.
stars forks issues prs created last-commit release-date version license
/explain-issue-fix
by hackdays-io		 Slash-Commands Documentation & Changelogs Documents solution approaches for GitHub issues, explaining technical decisions, detailing challenges overcome, and providing implementation context for better understanding.
stars forks issues prs created last-commit release-date version license
/run-ci
by hackdays-io		 Slash-Commands CI / Deployment Activates virtual environments, runs CI-compatible check scripts, iteratively fixes errors, and ensures all tests pass before completion.
stars forks issues prs created last-commit release-date version license
/check
by rygwdn		 Slash-Commands Code Analysis & Testing Performs comprehensive code quality and security checks, featuring static analysis integration, security vulnerability scanning, code style enforcement, and detailed reporting.
stars forks issues prs created last-commit release-date version license
/add-to-changelog
by berrydev-ai		 Slash-Commands Documentation & Changelogs Adds new entries to changelog files while maintaining format consistency, properly documenting changes, and following established project standards for version tracking.
stars forks issues prs created last-commit release-date version license
Context Priming
by disler		 Workflows & Knowledge Guides General Provides a systematic approach to priming Claude Code with comprehensive project context through specialized commands for different project scenarios and development contexts.
stars forks issues prs created last-commit release-date version license
/project_hello_w_name
by disler		 Slash-Commands Project & Task Management Creates customizable greeting components with name input, demonstrating argument passing, component reusability, state management, and user input handling.
stars forks issues prs created last-commit release-date version license
/release
by kelp		 Slash-Commands CI / Deployment Manages software releases by updating changelogs, reviewing README changes, evaluating version increments, and documenting release changes for better version tracking.
stars forks issues prs created last-commit release-date version license
claude-code.el
by stevemolitor		 Tooling IDE Integrations An Emacs interface for Claude Code CLI.
stars forks issues prs created last-commit release-date version license
AWS MCP Server
by alexei-led		 CLAUDE.md Files Language-Specific Features multiple Python environment setup options with detailed code style guidelines, comprehensive error handling recommendations, and security considerations for AWS CLI interactions.
stars forks issues prs created last-commit release-date version license
Claude Squad
by smtg-ai		 Tooling Orchestrators Claude Squad is a terminal app that manages multiple Claude Code, Codex (and other local agents including Aider) in separate workspaces, allowing you to work on multiple tasks simultaneously.
stars forks issues prs created last-commit release-date version license
/tdd
by zscott		 Slash-Commands Code Analysis & Testing Guides development using Test-Driven Development principles, enforcing Red-Green-Refactor discipline, integrating with git workflow, and managing PR creation.
stars forks issues prs created last-commit release-date version license
Network Chronicles
by Fimeg		 CLAUDE.md Files Domain-Specific Presents detailed implementation plan for AI-driven game characters with technical specifications for LLM integration, character guidelines, and service discovery mechanics.
stars forks issues prs created last-commit release-date version license
Claude Task Master
by eyaltoledano		 Tooling Orchestrators A task management system for AI-driven development with Claude, designed to work seamlessly with Cursor AI.
stars forks issues prs created last-commit release-date version license
claude-code.nvim
by greggh		 Tooling IDE Integrations A seamless integration between Claude Code AI assistant and Neovim.
stars forks issues prs created last-commit release-date version license
Cursor Tools
by eastlondoner		 CLAUDE.md Files Domain-Specific Creates a versatile AI command interface supporting multiple providers and models with flexible command options and browser automation through "Stagehand" feature.
stars forks issues prs created last-commit release-date version license
Basic Memory
by basicmachines-co		 CLAUDE.md Files Project Scaffolding & MCP Presents an innovative AI-human collaboration framework with Model Context Protocol for bidirectional LLM-markdown communication and flexible knowledge structure for complex projects.
stars forks issues prs created last-commit release-date version license
/context-prime
by elizaOS		 Slash-Commands Context Loading & Priming Primes Claude with comprehensive project understanding by loading repository structure, setting development context, establishing project goals, and defining collaboration parameters.
stars forks issues prs created last-commit release-date version license
Anthropic Quickstarts
by Anthropic		 Official Documentation General Offers comprehensive development guides for three distinct AI-powered demo projects with standardized workflows, strict code style guidelines, and containerization instructions.
stars forks issues prs created last-commit release-date version license
/create-pull-request
by liam-hq		 Slash-Commands Version Control & Git Provides comprehensive PR creation guidance with GitHub CLI, enforcing title conventions, following template structure, and offering concrete command examples with best practices.
stars forks issues prs created last-commit release-date version license
pre-commit-hooks
by aRustyDev		 CLAUDE.md Files Domain-Specific This repository is about pre-commit-hooks in general, but the `CLAUDE.md` and related `.claude/` documentation is exemplary. Thorough but not verbose. Unlike a lot of `CLAUDE.md` files, it doesn't primarily consist in shouting at Claude in all-caps. Great learning resource. Also, hooks.
stars forks issues prs created last-commit release-date version license
/mermaid
by GaloyMoney		 Slash-Commands Miscellaneous Generates Mermaid diagrams from SQL schema files, creating entity relationship diagrams with table properties, validating diagram compilation, and ensuring complete entity coverage.
stars forks issues prs created last-commit release-date version license
Project Bootstrapping and Task Management
by steadycursor		 Workflows & Knowledge Guides General Provides a structured set of commands for bootstrapping and managing a new project, including meta-commands for creating and editing custom slash-commands.
stars forks issues prs created last-commit release-date version license
/commit-fast
by steadycursor		 Slash-Commands Version Control & Git Automates git commit process by selecting the first suggested message, generating structured commits with consistent formatting while skipping manual confirmation and removing Claude co-Contributorship footer
stars forks issues prs created last-commit release-date version license
SteadyStart
by steadycursor		 CLAUDE.md Files Domain-Specific Clear and direct instructives about style, permissions, Claude's "role", communications, and documentation of Claude Code sessions for other team members to stay abreast.
stars forks issues prs created last-commit release-date version license
/load-llms-txt
by ethpandaops		 Slash-Commands Context Loading & Priming Loads LLM configuration files to context, importing specific terminology, model configurations, and establishing baseline terminology for AI discussions.
stars forks issues prs created last-commit release-date version license
Lamoom Python
by LamoomAI		 CLAUDE.md Files Language-Specific Serves as reference for production prompt engineering library with load balancing of AI Models, API documentation, and usage patterns with examples.
stars forks issues prs created last-commit release-date version license
LangGraphJS
by langchain-ai		 CLAUDE.md Files Language-Specific Offers comprehensive build and test commands with detailed TypeScript style guidelines, layered library architecture, and monorepo structure using yarn workspaces.
stars forks issues prs created last-commit release-date version license
/create-pr
by toyamarinyon		 Slash-Commands Version Control & Git Streamlines pull request creation by handling the entire workflow: creating a new branch, committing changes, formatting modified files with Biome, and submitting the PR.
stars forks issues prs created last-commit release-date version license
/update-branch-name
by giselles-ai		 Slash-Commands Version Control & Git Updates branch names with proper prefixes and formats, enforcing naming conventions, supporting semantic prefixes, and managing remote branch updates.
stars forks issues prs created last-commit release-date version license
Giselle
by giselles-ai		 CLAUDE.md Files Language-Specific Provides detailed build and test commands using pnpm and Vitest with strict code formatting requirements and comprehensive naming conventions for code consistency.
stars forks issues prs created last-commit release-date version license
Course Builder
by badass-courses		 CLAUDE.md Files Domain-Specific Enables real-time multiplayer capabilities for collaborative course creation with diverse tech stack integration and monorepo architecture using Turborepo.
stars forks issues prs created last-commit release-date version license
SG Cars Trends Backend
by sgcarstrends		 CLAUDE.md Files Language-Specific Provides comprehensive structure for TypeScript monorepo projects with detailed commands for development, testing, deployment, and AWS/Cloudflare integration.
stars forks issues prs created last-commit release-date version license
/docs
by slunsford		 Slash-Commands Documentation & Changelogs Generates comprehensive documentation that follows project structure, documenting APIs and usage patterns with consistent formatting for better user understanding.
stars forks issues prs created last-commit release-date version license
/load_coo_context
by Mjvolk3		 Slash-Commands Context Loading & Priming References specific files for sparse matrix operations, explains transform usage, compares with previous approaches, and sets data formatting context for development.
stars forks issues prs created last-commit release-date version license
/load_dango_pipeline
by Mjvolk3		 Slash-Commands Context Loading & Priming Sets context for model training by referencing pipeline files, establishing working context, and preparing for pipeline work with relevant documentation.
stars forks issues prs created last-commit release-date version license
/fixing_go_in_graph
by Mjvolk3		 Slash-Commands Miscellaneous Focuses on Gene Ontology annotation integration in graph databases, handling multiple data sources, addressing graph representation issues, and ensuring correct data incorporation.
stars forks issues prs created last-commit release-date version license
/review_dcell_model
by Mjvolk3		 Slash-Commands Miscellaneous Reviews old Dcell implementation files, comparing with newer Dango model, noting changes over time, and analyzing refactoring approaches for better code organization.
stars forks issues prs created last-commit release-date version license
SPy
by spylang		 CLAUDE.md Files Language-Specific Enforces strict coding conventions with comprehensive testing guidelines, multiple code compilation options, and backend-specific test decorators for targeted filtering.
stars forks issues prs created last-commit release-date version license
AI IntelliJ Plugin
by didalgolab		 CLAUDE.md Files Language-Specific Provides comprehensive Gradle commands for IntelliJ plugin development with platform-specific coding patterns, detailed package structure guidelines, and clear internationalization standards.
stars forks issues prs created last-commit release-date version license
/commit
by evmts		 Slash-Commands Version Control & Git Creates git commits using conventional commit format with appropriate emojis, following project standards and creating descriptive messages that explain the purpose of changes.
stars forks issues prs created last-commit release-date version license
/create-worktrees
by evmts		 Slash-Commands Version Control & Git Creates git worktrees for all open PRs or specific branches, handling branches with slashes, cleaning up stale worktrees, and supporting custom branch creation for development.
stars forks issues prs created last-commit release-date version license
/husky
by evmts		 Slash-Commands Version Control & Git Sets up and manages Husky Git hooks by configuring pre-commit hooks, establishing commit message standards, integrating with linting tools, and ensuring code quality on commits.
stars forks issues prs created last-commit release-date version license
/initref
by okuvshynov		 Slash-Commands Context Loading & Priming Initializes reference documentation structure with standard doc templates, API reference setup, documentation conventions, and placeholder content generation.
stars forks issues prs created last-commit release-date version license
Blogging Platform Instructions
by cloudartisan		 Workflows & Knowledge Guides General Provides a well-structured set of commands for publishing and maintaining a blogging platform, including commands for creating posts, managing categories, and handling media files.
stars forks issues prs created last-commit release-date version license
/use-stepper
by zuplo		 Slash-Commands Miscellaneous Reformats documentation to use React Stepper component, transforming heading formats, applying proper indentation, and maintaining markdown compatibility with admonition formatting.
stars forks issues prs created last-commit release-date version license
Pareto Mac
by ParetoSecurity		 CLAUDE.md Files Domain-Specific Serves as development guide for Mac security audit tool with build instructions, contribution guidelines, testing procedures, and workflow documentation.
stars forks issues prs created last-commit release-date version license
Project Workflow System
by harperreed		 Workflows & Knowledge Guides General A set of commands that provide a comprehensive workflow system for managing projects, including task management, code review, and deployment processes.
stars forks issues prs created last-commit release-date version license
TPL
by KarpelesLab		 CLAUDE.md Files Language-Specific Details Go project conventions with comprehensive error handling recommendations, table-driven testing approach guidelines, and modernization suggestions for latest Go features.
stars forks issues prs created last-commit release-date version license
HASH
by hashintel		 CLAUDE.md Files Language-Specific Features comprehensive repository structure breakdown with strong emphasis on coding standards, detailed Rust documentation guidelines, and systematic PR review process.
stars forks issues prs created last-commit release-date version license
DroidconKotlin
by touchlab		 CLAUDE.md Files Language-Specific Delivers comprehensive Gradle commands for cross-platform Kotlin Multiplatform development with clear module structure and practical guidance for dependency injection.
stars forks issues prs created last-commit release-date version license
Inkline
by inkline		 CLAUDE.md Files Language-Specific Structures development workflow using pnpm with emphasis on TypeScript and Vue 3 Composition API, detailed component creation process, and comprehensive testing recommendations.
stars forks issues prs created last-commit release-date version license
/fix-github-issue
by jeremymailen		 Slash-Commands Version Control & Git Analyzes and fixes GitHub issues using a structured approach with GitHub CLI for issue details, implementing necessary code changes, running tests, and creating proper commit messages.
stars forks issues prs created last-commit release-date version license
Guitar
by soramimi		 CLAUDE.md Files Domain-Specific Serves as development guide for Guitar Git GUI Client with build commands for various platforms, code style guidelines for contributing, and project structure explanation.
stars forks issues prs created last-commit release-date version license
/fix-issue
by metabase		 Slash-Commands Version Control & Git Addresses GitHub issues by taking issue number as parameter, analyzing context, implementing solution, and testing/validating the fix for proper integration.
stars forks issues prs created last-commit release-date version license
/fix-pr
by metabase		 Slash-Commands Version Control & Git Fetches and fixes unresolved PR comments by automatically retrieving feedback, addressing reviewer concerns, making targeted code improvements, and streamlining the review process.
stars forks issues prs created last-commit release-date version license
/repro-issue
by rzykov		 Slash-Commands Code Analysis & Testing Creates reproducible test cases for GitHub issues, ensuring tests fail reliably and documenting clear reproduction steps for developers.
stars forks issues prs created last-commit release-date version license
Metabase
by metabase		 CLAUDE.md Files Language-Specific Details workflow for REPL-driven development in Clojure/ClojureScript with emphasis on incremental development, testing, and step-by-step approach for feature implementation.
stars forks issues prs created last-commit release-date version license
JSBeeb
by mattgodbolt		 CLAUDE.md Files Language-Specific Provides development guide for JavaScript BBC Micro emulator with build and testing instructions, architecture documentation, and debugging workflows.
stars forks issues prs created last-commit release-date version license
--- **Total Resources:** 192 **Last Generated:** 2026-03-02 ================================================ FILE: README_ALTERNATIVES/README_FLAT_ALL_RELEASES.md ================================================

Pick Your Style:

Awesome Extra Classic Flat

# Awesome Claude Code (Flat) [![Awesome](https://awesome.re/badge-flat2.svg)](https://awesome.re) A flat list view of all resources. Category: **All** | Sorted: by latest release (30 days) --- ## Sort By:

A - Z UPDATED CREATED RELEASES

Category:

All Tooling Commands CLAUDE.md Workflows Hooks Skills Styles Status Docs Clients

Currently viewing: **All** sorted by latest release (30 days) (past 30 days)

--- ## Resources > **Note:** Latest release data is pulled from GitHub Releases only. Projects without GitHub Releases will not show release info here. Please verify with the project directly.
Resource Version Source Release Date Description
claude-esp
by phiat		 v0.3.1 GitHub 2026-02-28 Go-based TUI that streams Claude Code's hidden output (thinking, tool calls, subagents) to a separate terminal. Watch multiple sessions simultaneously, filter by content type, and track background tasks. Ideal for debugging or understanding what Claude is doing under the hood without interrupting your main session.
stars forks issues prs created last-commit release-date version license
Claude Code System Prompts
by Piebald AI		 v2.1.63 GitHub 2026-02-28 All parts of Claude Code's system prompt, including builtin tool descriptions, sub agent prompts (Plan/Explore/Task), utility prompts (CLAUDE.md, compact, Bash cmd, security review, agent creation, etc.). Updated for each Claude Code version.
stars forks issues prs created last-commit release-date version license
SG Cars Trends Backend
by sgcarstrends		 v4.62.1 GitHub 2026-02-28 Provides comprehensive structure for TypeScript monorepo projects with detailed commands for development, testing, deployment, and AWS/Cloudflare integration.
stars forks issues prs created last-commit release-date version license
The Agentic Startup
by Rudolf Schmidt		 v3.4.0 GitHub 2026-02-28 Yet Another Claude Orchestrator - a collection of agents, commands, etc., for shipping production code - but I like this because it's comprehensive, well-written, and one of the few resources that actually uses Output Styles! +10 points!
stars forks issues prs created last-commit release-date version license
claude-code-statusline
by rz1989s		 v2.19.0 GitHub 2026-02-28 Enhanced 4-line statusline for Claude Code with themes, cost tracking, and MCP server monitoring
stars forks issues prs created last-commit release-date version license
tweakcc
by Piebald-AI		 v4.0.10 GitHub 2026-02-28 Command-line tool to customize your Claude Code styling.
stars forks issues prs created last-commit release-date version license
claude-code-docs
by Constantin Shafranski		 v0.6.0 GitHub 2026-02-28 A mirror of the Anthropic© PBC documentation site for Claude/Code, but with bonus features like full-text search and query-time updates - a nice companion to `claude-code-docs` for up-to-the-minute, fully-indexed information so that Claude Code can read about itself.
stars forks issues prs created last-commit release-date version license
TSK - AI Agent Task Manager and Sandbox
by dtormoen		 v0.10.1 GitHub 2026-02-27 A Rust CLI tool that lets you delegate development tasks to AI agents running in sandboxed Docker environments. Multiple agents work in parallel, returning git branches for human review.
stars forks issues prs created last-commit release-date version license
Claude Scientific Skills
by K-Dense		 v2.24.0 GitHub 2026-02-27 "A set of ready-to-use Agent Skills for research, science, engineering, analysis, finance and writing." That's their description - modest, simple. That's how you can tell this is really one of the best skills repos on GitHub. If you've ever thought about getting a PhD... just read all of these documents instead. Also I think it IS an AI agent or something? Awesome.
stars forks issues prs created last-commit release-date version license
AWS MCP Server
by alexei-led		 v1.7.0 GitHub 2026-02-27 Features multiple Python environment setup options with detailed code style guidelines, comprehensive error handling recommendations, and security considerations for AWS CLI interactions.
stars forks issues prs created last-commit release-date version license
Rulesync
by dyoshikawa		 v7.10.0 GitHub 2026-02-27 A Node.js CLI tool that automatically generates configs (rules, ignore files, MCP servers, commands, and subagents) for various AI coding agents. Rulesync can convert configs between Claude Code and other AI agents in both directions.
stars forks issues prs created last-commit release-date version license
Everything Claude Code
by Affaan Mustafa		 v1.7.0 GitHub 2026-02-27 Top-notch, well-written resources covering "just about everything" from core engineering domains. What's nice about this "everything-" store is most of the resources have significant standalone value and unlike some all-encompassing frameworks, although you can opt in to the author's own specific workflow patterns if you choose, the individual resources offer exemplary patterns in (just about) every Claude Code feature you can find (apologies to the Output Styles devotees).
stars forks issues prs created last-commit release-date version license
claude-powerline
by Owloops		 v1.19.0 GitHub 2026-02-27 A vim-style powerline statusline for Claude Code with real-time usage tracking, git integration, custom themes, and more
stars forks issues prs created last-commit release-date version license
AgentSys
by avifenesh		 v5.2.0 GitHub 2026-02-27 Workflow automation system for Claude with a group of useful plugins, agents, and skills. Automates task-to-production workflows, PR management, code cleanup, performance investigation, drift detection, and multi-agent code review. Includes [agnix](https://github.com/avifenesh/agnix) for linting agent configurations. Built on thousands of lines of code with thousands of tests. Uses deterministic detection (regex, AST) with LLM judgment for efficiency. Used on many production systems.
stars forks issues prs created last-commit release-date version license
Plannotator
by backnotprop		 v0.9.3 GitHub 2026-02-27 Interactive plan review UI that intercepts ExitPlanMode via hooks, letting users visually annotate plans with comments, deletions, and replacements before approving or denying with detailed feedback.
stars forks issues prs created last-commit release-date version license
/update-branch-name
by giselles-ai		 v0.67.0 GitHub 2026-02-27 Updates branch names with proper prefixes and formats, enforcing naming conventions, supporting semantic prefixes, and managing remote branch updates.
stars forks issues prs created last-commit release-date version license
Giselle
by giselles-ai		 v0.67.0 GitHub 2026-02-27 Provides detailed build and test commands using pnpm and Vitest with strict code formatting requirements and comprehensive naming conventions for code consistency.
stars forks issues prs created last-commit release-date version license
crystal
by stravu		 v0.3.5 GitHub 2026-02-26 A full-fledged desktop application for orchestrating, monitoring, and interacting with Claude Code agents.
stars forks issues prs created last-commit release-date version license
LangGraphJS
by langchain-ai		 @langchain/langgraph-ui@1.1.14 GitHub 2026-02-26 Offers comprehensive build and test commands with detailed TypeScript style guidelines, layered library architecture, and monorepo structure using yarn workspaces.
stars forks issues prs created last-commit release-date version license
Claude CodePro
by Max Ritter		 v7.0.6 GitHub 2026-02-26 Professional development environment for Claude Code with spec-driven workflow, TDD enforcement, cross-session memory, semantic search, quality hooks, and modular rules integration. A bit "heavyweight" but feature-packed and has wide coverage.
stars forks issues prs created last-commit release-date version license
ccflare -> **better-ccflare**
by tombii		 v3.2.2 GitHub 2026-02-25 A well-maintained and feature-enhanced fork of the glorious `ccflare` usage dashboard by @snipeship (which at the time of writing has not had an update in a few months). `better-ccflare` builds on this foundation with some performance enhancements, extended provider support, bug fixes, Docker deployment, and more.
stars forks issues prs created last-commit release-date version license
ralph-orchestrator
by mikeyobrien		 v2.6.0 GitHub 2026-02-25 Ralph Orchestrator implements the simple but effective "Ralph Wiggum" technique for autonomous task completion, continuously running an AI agent against a prompt file until the task is marked as complete or limits are reached. This implementation provides a robust, well-tested, and feature-complete orchestration system for AI-driven development. Also cited in the Anthropic Ralph plugin documentation.
stars forks issues prs created last-commit release-date version license
Course Builder
by badass-courses		 aihero-cli-v0.1.0 GitHub 2026-02-25 Enables real-time multiplayer capabilities for collaborative course creation with diverse tech stack integration and monorepo architecture using Turborepo.
stars forks issues prs created last-commit release-date version license
Context Engineering Kit
by Vlad Goncharov		 v2.1.1 GitHub 2026-02-24 Hand-crafted collection of advanced context engineering techniques and patterns with minimal token footprint focused on improving agent result quality.
stars forks issues prs created last-commit release-date version license
Fullstack Dev Skills
by jeffallan		 v0.4.9 GitHub 2026-02-24 A comprehensive Claude Code plugin with 65 specialized skills covering full-stack development across a wide range of specific frameworks. Features 9 project workflow commands for Jira/Confluence integration and, notably, an interesting approach to context engineering via a `/common-ground` command that surfaces Claude's hidden assumptions about your project. This is a smart thing to do.
stars forks issues prs created last-commit release-date version license
CC Usage
by ryoppippi		 v18.0.8 GitHub 2026-02-24 Handy CLI tool for managing and analyzing Claude Code usage, based on analyzing local Claude Code logs. Presents a nice dashboard regarding cost information, token consumption, etc.
stars forks issues prs created last-commit release-date version license
VoiceMode MCP
by Mike Bailey		 v8.3.0 GitHub 2026-02-24 VoiceMode MCP brings natural conversations to Claude Code. It supports any OpenAI API compatible voice services and installs free and open source voice services (Whisper.cpp and Kokoro-FastAPI).
stars forks issues prs created last-commit release-date version license
JSBeeb
by mattgodbolt		 v1.4.0 GitHub 2026-02-23 Provides development guide for JavaScript BBC Micro emulator with build and testing instructions, architecture documentation, and debugging workflows.
stars forks issues prs created last-commit release-date version license
sudocode
by ssh-randy		 v0.1.25 GitHub 2026-02-23 Lightweight agent orchestration dev tool that lives in your repo. Integrates with various specification frameworks. It's giving Jira.
stars forks issues prs created last-commit release-date version license
Claude Code Hook Comms (HCOM)
by aannoo		 v0.6.22 GitHub 2026-02-22 Lightweight CLI tool for real-time communication between Claude Code sub agents using hooks. Enables multi-agent collaboration with @-mention targeting, live dashboard monitoring, and zero-dependency implementation. [NOTE: At the time of posting, this resource is a little unstable - I'm sharing it anyway, because I think it's incredibly promising and creative. I hope by the time you read this, it is production-ready.]
stars forks issues prs created last-commit release-date version license
Claude Code Tips
by ykdojo		 v0.25.1 GitHub 2026-02-22 A nice variety of 35+ brief but information-dense Claude Code tips covering voice input, system prompt patching, container workflows for risky tasks, conversation cloning(!), multi-model orchestration with Gemini CLI, and plenty more. Nice demos, working scripts, a plugin, I'd say this probably has a little something for everyone.
stars forks issues prs created last-commit release-date version license
Basic Memory
by basicmachines-co		 v0.18.5 GitHub 2026-02-20 Presents an innovative AI-human collaboration framework with Model Context Protocol for bidirectional LLM-markdown communication and flexible knowledge structure for complex projects.
stars forks issues prs created last-commit release-date version license
Auto-Claude
by AndyMik90		 v2.7.6 GitHub 2026-02-20 Autonomous multi-agent coding framework for Claude Code (Claude Agent SDK) that integrates the full SDLC - "plans, builds, and validates software for you". Features a slick kanban-style UI and a well-designed but not over-engineered agent orchestration system.
stars forks issues prs created last-commit release-date version license
claude-code-tools
by Prasad Chalasani		 v1.10.7 GitHub 2026-02-19 Well-crafted toolset for session continuity, featuring skills/commands to avoid compaction and recover context across sessions with cross-agent handoff between Claude Code and Codex CLI. Includes a fast Rust/Tantivy-powered full-text session search (TUI for humans, skill/CLI for agents), tmux-cli skill + command for interacting with scripts and CLI agents, and safety hooks to block dangerous commands.
stars forks issues prs created last-commit release-date version license
Compound Engineering Plugin
by EveryInc		 v0.8.0 GitHub 2026-02-17 A very pragmatic set of well-designed agents, skills, and commands, built around a discipline of turning past mistakes and errors into lessons and opportunities for future growth and improvement. Good documentation.
stars forks issues prs created last-commit release-date version license
/fix-issue
by metabase		 v0.58.6 GitHub 2026-02-12 Addresses GitHub issues by taking issue number as parameter, analyzing context, implementing solution, and testing/validating the fix for proper integration.
stars forks issues prs created last-commit release-date version license
/fix-pr
by metabase		 v0.58.6 GitHub 2026-02-12 Fetches and fixes unresolved PR comments by automatically retrieving feedback, addressing reviewer concerns, making targeted code improvements, and streamlining the review process.
stars forks issues prs created last-commit release-date version license
Metabase
by metabase		 v0.58.6 GitHub 2026-02-12 Details workflow for REPL-driven development in Clojure/ClojureScript with emphasis on incremental development, testing, and step-by-step approach for feature implementation.
stars forks issues prs created last-commit release-date version license
/mermaid
by GaloyMoney		 0.40.1 GitHub 2026-02-12 Generates Mermaid diagrams from SQL schema files, creating entity relationship diagrams with table properties, validating diagram compilation, and ensuring complete entity coverage.
stars forks issues prs created last-commit release-date version license
Claudex
by Kunwar Shah		 v1.3.0 GitHub 2026-02-12 Claudex - A web-based browser for exploring your Claude Code conversation history across projects. Indexes your codebase for full-text search. Nice, easy-to-navigate UI. Simple dashboard interface for high-level analytics, and multiple export options as well. (And completely local w/ no telemetry!)
stars forks issues prs created last-commit release-date version license
Claude Swarm
by parruda		 swarm_sdk-v2.7.15 GitHub 2026-02-12 Launch Claude Code session that is connected to a swarm of Claude Code Agents.
stars forks issues prs created last-commit release-date version license
/fix-github-issue
by jeremymailen		 5.4.2 GitHub 2026-02-10 Analyzes and fixes GitHub issues using a structured approach with GitHub CLI for issue details, implementing necessary code changes, running tests, and creating proper commit messages.
stars forks issues prs created last-commit release-date version license
CCometixLine - Claude Code Statusline
by Haleclipse		 v1.1.1 GitHub 2026-02-09 A high-performance Claude Code statusline tool written in Rust with Git integration, usage tracking, interactive TUI configuration, and Claude Code enhancement utilities.
stars forks issues prs created last-commit release-date version license
Claude Codex Settings
by fatih akyon		 v2.1.0 GitHub 2026-02-04 A well-organized, well-written set of plugins covering core developer activities, such as working with common cloud platforms like GitHub, Azure, MongoDB, and popular services such as Tavily, Playwright, and more. Clear, not overly-opinionated, and compatible with a few other providers.
stars forks issues prs created last-commit release-date version license
Claude Task Master
by eyaltoledano		 task-master-ai@0.43.0 GitHub 2026-02-04 A task management system for AI-driven development with Claude, designed to work seamlessly with Cursor AI.
stars forks issues prs created last-commit release-date version license
claude-starter-kit
by serpro69		 v0.2.0 GitHub 2026-02-01 This is a starter template repository designed to provide a complete development environment for Claude-Code with pre-configured MCP servers and tools for AI-powered development workflows. The repository is intentionally minimal, containing only configuration templates for three primary systems: Claude Code, Serena, and Task Master.
stars forks issues prs created last-commit release-date version license
Dippy
by Lily Dayton		 v0.2.5 GitHub 2026-02-01 Auto-approve safe bash commands using AST-based parsing, while prompting for destructive operations. Solves permission fatigue without disabling safety. Supports Claude Code, Gemini CLI, and Cursor.
stars forks issues prs created last-commit release-date version license
--- **Total Resources:** 47 **Last Generated:** 2026-03-02 ================================================ FILE: README_ALTERNATIVES/README_FLAT_ALL_UPDATED.md ================================================

Pick Your Style:

Awesome Extra Classic Flat

# Awesome Claude Code (Flat) [![Awesome](https://awesome.re/badge-flat2.svg)](https://awesome.re) A flat list view of all resources. Category: **All** | Sorted: by last updated date --- ## Sort By:

A - Z UPDATED CREATED RELEASES

Category:

All Tooling Commands CLAUDE.md Workflows Hooks Skills Styles Status Docs Clients

Currently viewing: **All** sorted by last updated date

--- ## Resources
Resource Category Sub-Category Description
AI Agent, AI Spy
by Whittaker & Tiwari		 Agent Skills General Members from the Signal Foundation with some really great tips and tricks on how to turn your operating system into an instrument of total surveillance, and why some companies are doing this really awesome thing. [warning: YouTube link]
Claude Code Handbook
by nikiforovall		 Workflows & Knowledge Guides General Collection of best practices, tips, and techniques for Claude Code development workflows, enhanced with distributable plugins
Shipping Real Code w/ Claude
by Diwank		 Workflows & Knowledge Guides General A detailed blog post explaining the author's process for shipping a product with Claude Code, including CLAUDE.md files and other interesting resources.
Claude Code Chat
by andrepimenta		 Tooling IDE Integrations An elegant and user-friendly Claude Code chat interface for VS Code.
Anthropic Documentation
by Anthropic		 Official Documentation General The official documentation for Claude Code, including installation instructions, usage guidelines, API references, tutorials, examples, loads of information that I won't list individually. Like Claude Code, the documentation is frequently updated.
Plannotator
by backnotprop		 Hooks - Interactive plan review UI that intercepts ExitPlanMode via hooks, letting users visually annotate plans with comments, deletions, and replacements before approving or denying with detailed feedback.
stars forks issues prs created last-commit release-date version license
claude-code-docs
by Constantin Shafranski		 Workflows & Knowledge Guides General A mirror of the Anthropic© PBC documentation site for Claude/Code, but with bonus features like full-text search and query-time updates - a nice companion to `claude-code-docs` for up-to-the-minute, fully-indexed information so that Claude Code can read about itself.
stars forks issues prs created last-commit release-date version license
Claude Code Documentation Mirror
by Eric Buess		 Workflows & Knowledge Guides General A mirror of the Anthropic © PBC documentation pages for Claude Code, updated every few hours. Can come in handy when trying to stay on top of the ever-expanding feature-set of Dr. Claw D. Code, Ph.D.
stars forks issues prs created last-commit release-date version license
Claude Code GitHub Actions
by Anthropic		 Official Documentation General Official GitHub Actions integration for Claude Code with examples and documentation for automating AI-powered workflows in CI/CD pipelines.
stars forks issues prs created last-commit release-date version license
Rulesync
by dyoshikawa		 Tooling General A Node.js CLI tool that automatically generates configs (rules, ignore files, MCP servers, commands, and subagents) for various AI coding agents. Rulesync can convert configs between Claude Code and other AI agents in both directions.
stars forks issues prs created last-commit release-date version license
Claude Code Templates
by Daniel Avila		 Tooling General Incredibly awesome collection of resources from every category in this list, presented with a neatly polished UI, great features like usage dashboard, analytics, and everything from slash commands to hooks to agents. An awesome companion for this awesome list.
stars forks issues prs created last-commit release-date version license
Blogging Platform Instructions
by cloudartisan		 Workflows & Knowledge Guides General Provides a well-structured set of commands for publishing and maintaining a blogging platform, including commands for creating posts, managing categories, and handling media files.
stars forks issues prs created last-commit release-date version license
Claude Scientific Skills
by K-Dense		 Agent Skills General "A set of ready-to-use Agent Skills for research, science, engineering, analysis, finance and writing." That's their description - modest, simple. That's how you can tell this is really one of the best skills repos on GitHub. If you've ever thought about getting a PhD... just read all of these documents instead. Also I think it IS an AI agent or something? Awesome.
stars forks issues prs created last-commit release-date version license
Compound Engineering Plugin
by EveryInc		 Agent Skills General A very pragmatic set of well-designed agents, skills, and commands, built around a discipline of turning past mistakes and errors into lessons and opportunities for future growth and improvement. Good documentation.
stars forks issues prs created last-commit release-date version license
parry
by Dmytro Onypko		 Hooks General Prompt injection scanner for Claude Code hooks. Scans tool inputs and outputs for injection attacks, secrets, and data exfiltration attempts. [NOTE: Early development phase but worth a look.]
stars forks issues prs created last-commit release-date version license
TSK - AI Agent Task Manager and Sandbox
by dtormoen		 Tooling Orchestrators A Rust CLI tool that lets you delegate development tasks to AI agents running in sandboxed Docker environments. Multiple agents work in parallel, returning git branches for human review.
stars forks issues prs created last-commit release-date version license
ralph-orchestrator
by mikeyobrien		 Workflows & Knowledge Guides Ralph Wiggum Ralph Orchestrator implements the simple but effective "Ralph Wiggum" technique for autonomous task completion, continuously running an AI agent against a prompt file until the task is marked as complete or limits are reached. This implementation provides a robust, well-tested, and feature-complete orchestration system for AI-driven development. Also cited in the Anthropic Ralph plugin documentation.
stars forks issues prs created last-commit release-date version license
Everything Claude Code
by Affaan Mustafa		 Agent Skills General Top-notch, well-written resources covering "just about everything" from core engineering domains. What's nice about this "everything-" store is most of the resources have significant standalone value and unlike some all-encompassing frameworks, although you can opt in to the author's own specific workflow patterns if you choose, the individual resources offer exemplary patterns in (just about) every Claude Code feature you can find (apologies to the Output Styles devotees).
stars forks issues prs created last-commit release-date version license
SG Cars Trends Backend
by sgcarstrends		 CLAUDE.md Files Language-Specific Provides comprehensive structure for TypeScript monorepo projects with detailed commands for development, testing, deployment, and AWS/Cloudflare integration.
stars forks issues prs created last-commit release-date version license
AgentSys
by avifenesh		 Agent Skills General Workflow automation system for Claude with a group of useful plugins, agents, and skills. Automates task-to-production workflows, PR management, code cleanup, performance investigation, drift detection, and multi-agent code review. Includes [agnix](https://github.com/avifenesh/agnix) for linting agent configurations. Built on thousands of lines of code with thousands of tests. Uses deterministic detection (regex, AST) with LLM judgment for efficiency. Used on many production systems.
stars forks issues prs created last-commit release-date version license
Fullstack Dev Skills
by jeffallan		 Agent Skills General A comprehensive Claude Code plugin with 65 specialized skills covering full-stack development across a wide range of specific frameworks. Features 9 project workflow commands for Jira/Confluence integration and, notably, an interesting approach to context engineering via a `/common-ground` command that surfaces Claude's hidden assumptions about your project. This is a smart thing to do.
stars forks issues prs created last-commit release-date version license
Claude CodePro
by Max Ritter		 Workflows & Knowledge Guides General Professional development environment for Claude Code with spec-driven workflow, TDD enforcement, cross-session memory, semantic search, quality hooks, and modular rules integration. A bit "heavyweight" but feature-packed and has wide coverage.
stars forks issues prs created last-commit release-date version license
Codex Skill
by klaudworks		 Agent Skills General Enables users to prompt codex from claude code. Unlike the raw codex mcp server, this skill infers parameters such as model, reasoning effort, sandboxing from your prompt or asks you to specify them. It also simplifies continuing prior codex sessions so that codex can continue with the prior context.
stars forks issues prs created last-commit release-date version license
TDD Guard
by Nizar Selander		 Hooks General A hooks-driven system that monitors file operations in real-time and blocks changes that violate TDD principles.
stars forks issues prs created last-commit release-date version license
Claude Squad
by smtg-ai		 Tooling Orchestrators Claude Squad is a terminal app that manages multiple Claude Code, Codex (and other local agents including Aider) in separate workspaces, allowing you to work on multiple tasks simultaneously.
stars forks issues prs created last-commit release-date version license
Claude Code Tips
by ykdojo		 Workflows & Knowledge Guides General A nice variety of 35+ brief but information-dense Claude Code tips covering voice input, system prompt patching, container workflows for risky tasks, conversation cloning(!), multi-model orchestration with Gemini CLI, and plenty more. Nice demos, working scripts, a plugin, I'd say this probably has a little something for everyone.
stars forks issues prs created last-commit release-date version license
VoiceMode MCP
by Mike Bailey		 Tooling General VoiceMode MCP brings natural conversations to Claude Code. It supports any OpenAI API compatible voice services and installs free and open source voice services (Whisper.cpp and Kokoro-FastAPI).
stars forks issues prs created last-commit release-date version license
claude-powerline
by Owloops		 Status Lines General A vim-style powerline statusline for Claude Code with real-time usage tracking, git integration, custom themes, and more
stars forks issues prs created last-commit release-date version license
EDSL
by expectedparrot		 CLAUDE.md Files Language-Specific Offers detailed build and test commands with strict code style enforcement, comprehensive testing requirements, and standardized development workflow using Black and mypy.
stars forks issues prs created last-commit release-date version license
Claude Code Ultimate Guide
by Florian BRUNIAUX		 Workflows & Knowledge Guides General A tremendous feat of documentation, this guide covers Claude Code from beginner to power user, with production-ready templates for Claude Code features, guides on agentic workflows, and a lot of great learning materials, including quizzes and a handy "cheatsheet". Whether it's the "ultimate" guide to Claude Code will be up to the reader, but a valuable resource nonetheless (as with all documentation sites, make sure it's up to date before you bet the farm).
stars forks issues prs created last-commit release-date version license
claude-code-tools
by Prasad Chalasani		 Tooling General Well-crafted toolset for session continuity, featuring skills/commands to avoid compaction and recover context across sessions with cross-agent handoff between Claude Code and Codex CLI. Includes a fast Rust/Tantivy-powered full-text session search (TUI for humans, skill/CLI for agents), tmux-cli skill + command for interacting with scripts and CLI agents, and safety hooks to block dangerous commands.
stars forks issues prs created last-commit release-date version license
claude-esp
by phiat		 Alternative Clients General Go-based TUI that streams Claude Code's hidden output (thinking, tool calls, subagents) to a separate terminal. Watch multiple sessions simultaneously, filter by content type, and track background tasks. Ideal for debugging or understanding what Claude is doing under the hood without interrupting your main session.
stars forks issues prs created last-commit release-date version license
Claude Code Flow
by ruvnet		 Tooling Orchestrators This mode serves as a code-first orchestration layer, enabling Claude to write, edit, test, and optimize code autonomously across recursive agent cycles.
stars forks issues prs created last-commit release-date version license
tweakcc
by Piebald-AI		 Tooling General Command-line tool to customize your Claude Code styling.
stars forks issues prs created last-commit release-date version license
Claude Code System Prompts
by Piebald AI		 Workflows & Knowledge Guides General All parts of Claude Code's system prompt, including builtin tool descriptions, sub agent prompts (Plan/Explore/Task), utility prompts (CLAUDE.md, compact, Bash cmd, security review, agent creation, etc.). Updated for each Claude Code version.
stars forks issues prs created last-commit release-date version license
The Agentic Startup
by Rudolf Schmidt		 Tooling Orchestrators Yet Another Claude Orchestrator - a collection of agents, commands, etc., for shipping production code - but I like this because it's comprehensive, well-written, and one of the few resources that actually uses Output Styles! +10 points!
stars forks issues prs created last-commit release-date version license
claude-code-statusline
by rz1989s		 Status Lines General Enhanced 4-line statusline for Claude Code with themes, cost tracking, and MCP server monitoring
stars forks issues prs created last-commit release-date version license
ccstatusline
by sirmalloc		 Status Lines General A highly customizable status line formatter for Claude Code CLI that displays model info, git branch, token usage, and other metrics in your terminal.
stars forks issues prs created last-commit release-date version license
Learn Claude Code
by shareAI-Lab		 Workflows & Knowledge Guides General A really interesting analysis of how coding agents like Claude Code are designed. It attempts to break an agent down into its fundamental parts and reconstruct it with minimal code. Great learning resource. Final product is a rudimentary agent with skills, sub-agents, and a todo-list in roughly a few hundred lines of Python.
stars forks issues prs created last-commit release-date version license
AWS MCP Server
by alexei-led		 CLAUDE.md Files Language-Specific Features multiple Python environment setup options with detailed code style guidelines, comprehensive error handling recommendations, and security considerations for AWS CLI interactions.
stars forks issues prs created last-commit release-date version license
Trail of Bits Security Skills
by Trail of Bits		 Agent Skills General A very professional collection of over a dozen security-focused skills for code auditing and vulnerability detection. Includes skills for static analysis with CodeQL and Semgrep, variant analysis across codebases, fix verification, and differential code review.
stars forks issues prs created last-commit release-date version license
crystal
by stravu		 Alternative Clients General A full-fledged desktop application for orchestrating, monitoring, and interacting with Claude Code agents.
stars forks issues prs created last-commit release-date version license
Happy Coder
by GrocerPublishAgent		 Tooling Orchestrators Spawn and control multiple Claude Codes in parallel from your phone or desktop. Happy Coder runs Claude Code on your hardware, sends push notifications when Claude needs more input or permission, and costs nothing.
stars forks issues prs created last-commit release-date version license
Ralph for Claude Code
by Frank Bria		 Workflows & Knowledge Guides Ralph Wiggum An autonomous AI development framework that enables Claude Code to work iteratively on projects until completion. Features intelligent exit detection, rate limiting, circuit breaker patterns, and comprehensive safety guardrails to prevent infinite loops and API overuse. Built with Bash, integrated with tmux for live monitoring, and includes 75+ comprehensive tests.
stars forks issues prs created last-commit release-date version license
ccflare -> **better-ccflare**
by tombii		 Tooling Usage Monitors A well-maintained and feature-enhanced fork of the glorious `ccflare` usage dashboard by @snipeship (which at the time of writing has not had an update in a few months). `better-ccflare` builds on this foundation with some performance enhancements, extended provider support, bug fixes, Docker deployment, and more.
stars forks issues prs created last-commit release-date version license
Project Workflow System
by harperreed		 Workflows & Knowledge Guides General A set of commands that provide a comprehensive workflow system for managing projects, including task management, code review, and deployment processes.
stars forks issues prs created last-commit release-date version license
SuperClaude
by SuperClaude-Org		 Tooling General A versatile configuration framework that enhances Claude Code with specialized commands, cognitive personas, and development methodologies, such as "Introspection" and "Orchestration".
stars forks issues prs created last-commit release-date version license
claude-rules-doctor
by nulone		 Tooling Config Managers CLI that detects dead `.claude/rules/` files by checking if `paths:` globs actually match files in your repo. Catches silent rule failures where renamed directories or typos in glob patterns cause rules to never apply. Features CI mode (exit 1 on dead rules), JSON output, and verbose mode showing matched files.
stars forks issues prs created last-commit release-date version license
Context Engineering Kit
by Vlad Goncharov		 Agent Skills General Hand-crafted collection of advanced context engineering techniques and patterns with minimal token footprint focused on improving agent result quality.
stars forks issues prs created last-commit release-date version license
CC Usage
by ryoppippi		 Tooling Usage Monitors Handy CLI tool for managing and analyzing Claude Code usage, based on analyzing local Claude Code logs. Presents a nice dashboard regarding cost information, token consumption, etc.
stars forks issues prs created last-commit release-date version license
sudocode
by ssh-randy		 Tooling Orchestrators Lightweight agent orchestration dev tool that lives in your repo. Integrates with various specification frameworks. It's giving Jira.
stars forks issues prs created last-commit release-date version license
The Ralph Playbook
by Clayton Farr		 Workflows & Knowledge Guides Ralph Wiggum A remarkably detailed and comprehensive guide to the Ralph Wiggum technique, featuring well-written theoretical commentary paired with practical guidelines and advice.
stars forks issues prs created last-commit release-date version license
claude-starter-kit
by serpro69		 Tooling General This is a starter template repository designed to provide a complete development environment for Claude-Code with pre-configured MCP servers and tools for AI-powered development workflows. The repository is intentionally minimal, containing only configuration templates for three primary systems: Claude Code, Serena, and Task Master.
stars forks issues prs created last-commit release-date version license
Container Use
by dagger		 Tooling General Development environments for coding agents. Enable multiple agents to work safely and independently with your preferred stack.
stars forks issues prs created last-commit release-date version license
Claude Code Hook Comms (HCOM)
by aannoo		 Hooks General Lightweight CLI tool for real-time communication between Claude Code sub agents using hooks. Enables multi-agent collaboration with @-mention targeting, live dashboard monitoring, and zero-dependency implementation. [NOTE: At the time of posting, this resource is a little unstable - I'm sharing it anyway, because I think it's incredibly promising and creative. I hope by the time you read this, it is production-ready.]
stars forks issues prs created last-commit release-date version license
Auto-Claude
by AndyMik90		 Tooling Orchestrators Autonomous multi-agent coding framework for Claude Code (Claude Agent SDK) that integrates the full SDLC - "plans, builds, and validates software for you". Features a slick kanban-style UI and a well-designed but not over-engineered agent orchestration system.
stars forks issues prs created last-commit release-date version license
Superpowers
by Jesse Vincent		 Agent Skills General A strong bundle of core competencies for software engineering, with good coverage of a large portion of the SDLC - from planning, reviewing, testing, debugging... Well written, well organized, and adaptable. The author refers to them as "superpowers", but many of them are just consolidating engineering best practices - which sometimes does feel like a superpower when working with Claude Code.
stars forks issues prs created last-commit release-date version license
Claude Code Repos Index
by Daniel Rosehill		 Workflows & Knowledge Guides General This is either the work of a prolific genius, or a very clever bot (or both), although it hardly matters because the quality is so good - an index of 75+ Claude Code repositories published by the author - and I'm not talking about slop. CMS, system design, deep research, IoT, agentic workflows, server management, personal health... If you spot the lie, let me know, otherwise please check these out.
stars forks issues prs created last-commit release-date version license
Claude Codex Settings
by fatih akyon		 Agent Skills General A well-organized, well-written set of plugins covering core developer activities, such as working with common cloud platforms like GitHub, Azure, MongoDB, and popular services such as Tavily, Playwright, and more. Clear, not overly-opinionated, and compatible with a few other providers.
stars forks issues prs created last-commit release-date version license
Claudio
by Christopher Toth		 Hooks General A no-frills little library that adds delightful OS-native sounds to Claude Code via simple hooks. It really sparks joy.
stars forks issues prs created last-commit release-date version license
Claude Mountaineering Skills
by Dmytro Gaivoronsky		 Agent Skills General Claude Code skill that automates mountain route research for North American peaks. Aggregates data from 10+ mountaineering sources like Mountaineers.org, PeakBagger.com and SummitPost.com to generate detailed route beta reports with weather, avalanche conditions, and trip reports.
stars forks issues prs created last-commit release-date version license
Claudex
by Kunwar Shah		 Tooling Usage Monitors Claudex - A web-based browser for exploring your Claude Code conversation history across projects. Indexes your codebase for full-text search. Nice, easy-to-navigate UI. Simple dashboard interface for high-level analytics, and multiple export options as well. (And completely local w/ no telemetry!)
stars forks issues prs created last-commit release-date version license
read-only-postgres
by jawwadfirdousi		 Agent Skills General Read-only PostgreSQL query skill for Claude Code. Executes SELECT/SHOW/EXPLAIN/WITH queries across configured databases with strict validation, timeouts, and row limits. Supports multiple connections with descriptions for database selection.
stars forks issues prs created last-commit release-date version license
Claude Swarm
by parruda		 Tooling Orchestrators Launch Claude Code session that is connected to a swarm of Claude Code Agents.
stars forks issues prs created last-commit release-date version license
cc-devops-skills
by akin-ozer		 Agent Skills General Immensely detailed set of skills for DevOps Engineers (or anyone who has to deploy code, really). Works with validations, generators, shell scripts and CLI tools to create high quality IaC code for about any platform you've ever struggled painfully to work with. Worth downloading even just as a source of documentation.
stars forks issues prs created last-commit release-date version license
Metabase
by metabase		 CLAUDE.md Files Language-Specific Details workflow for REPL-driven development in Clojure/ClojureScript with emphasis on incremental development, testing, and step-by-step approach for feature implementation.
stars forks issues prs created last-commit release-date version license
CCometixLine - Claude Code Statusline
by Haleclipse		 Status Lines General A high-performance Claude Code statusline tool written in Rust with Git integration, usage tracking, interactive TUI configuration, and Claude Code enhancement utilities.
stars forks issues prs created last-commit release-date version license
RIPER Workflow
by Tony Narlock		 Workflows & Knowledge Guides General Structured development workflow enforcing separation between Research, Innovate, Plan, Execute, and Review phases. Features consolidated subagents for context-efficiency, branch-aware memory bank, and strict mode enforcement for guided development.
stars forks issues prs created last-commit release-date version license
/analyze-issue
by jerseycheese		 Slash-Commands Version Control & Git Fetches GitHub issue details to create comprehensive implementation specifications, analyzing requirements and planning structured approach with clear implementation steps.
stars forks issues prs created last-commit release-date version license
/tdd-implement
by jerseycheese		 Slash-Commands Code Analysis & Testing Implements Test-Driven Development by analyzing feature requirements, creating tests first (red), implementing minimal passing code (green), and refactoring while maintaining tests.
stars forks issues prs created last-commit release-date version license
/create-docs
by jerseycheese		 Slash-Commands Documentation & Changelogs Analyzes code structure and purpose to create comprehensive documentation detailing inputs/outputs, behavior, user interaction flows, and edge cases with error handling.
stars forks issues prs created last-commit release-date version license
/do-issue
by jerseycheese		 Slash-Commands Project & Task Management Implements GitHub issues with manual review points, following a structured approach with issue number parameter and offering alternative automated mode for efficiency.
stars forks issues prs created last-commit release-date version license
ralph-wiggum-bdd
by marcindulak		 Workflows & Knowledge Guides Ralph Wiggum A standalone Bash script for Behavior-Driven Development with Ralph Wiggum Loop. In principle, while running unattended, the script can keep code and requirements in sync, but in practice it still requires interactive human supervision, so it supports both modes. The script is standalone and can be modified and committed into your project.
stars forks issues prs created last-commit release-date version license
Anthropic Quickstarts
by Anthropic		 Official Documentation General Offers comprehensive development guides for three distinct AI-powered demo projects with standardized workflows, strict code style guidelines, and containerization instructions.
stars forks issues prs created last-commit release-date version license
claude-code.nvim
by greggh		 Tooling IDE Integrations A seamless integration between Claude Code AI assistant and Neovim.
stars forks issues prs created last-commit release-date version license
Claude Task Master
by eyaltoledano		 Tooling Orchestrators A task management system for AI-driven development with Claude, designed to work seamlessly with Cursor AI.
stars forks issues prs created last-commit release-date version license
Course Builder
by badass-courses		 CLAUDE.md Files Domain-Specific Enables real-time multiplayer capabilities for collaborative course creation with diverse tech stack integration and monorepo architecture using Turborepo.
stars forks issues prs created last-commit release-date version license
awesome-ralph
by Martin Joly		 Workflows & Knowledge Guides Ralph Wiggum A curated list of resources about Ralph, the AI coding technique that runs AI coding agents in automated loops until specifications are fulfilled.
stars forks issues prs created last-commit release-date version license
claude-code-ide.el
by manzaltu		 Tooling IDE Integrations claude-code-ide.el integrates Claude Code with Emacs, like Anthropic’s VS Code/IntelliJ extensions. It shows ediff-based code suggestions, pulls LSP/flymake/flycheck diagnostics, and tracks buffer context. It adds an extensible MCP tool support for symbol refs/defs, project metadata, and tree-sitter AST queries.
stars forks issues prs created last-commit release-date version license
Basic Memory
by basicmachines-co		 CLAUDE.md Files Project Scaffolding & MCP Presents an innovative AI-human collaboration framework with Model Context Protocol for bidirectional LLM-markdown communication and flexible knowledge structure for complex projects.
stars forks issues prs created last-commit release-date version license
Ralph Wiggum Marketer
by Muratcan Koylan		 Workflows & Knowledge Guides Ralph Wiggum A Claude Code plugin that provides an autonomous AI copywriter, integrating the Ralph loop with customized knowledge bases for market research agents. The agents do the research, Ralph writes the copy, you stay in bed. Whether or not you practice Ralph-Driven Development (RDD), I think these projects are interesting and creative explorations of general agentic patterns.
stars forks issues prs created last-commit release-date version license
Dippy
by Lily Dayton		 Hooks General Auto-approve safe bash commands using AST-based parsing, while prompting for destructive operations. Solves permission fatigue without disabling safety. Supports Claude Code, Gemini CLI, and Cursor.
stars forks issues prs created last-commit release-date version license
Claude Code Agents
by Paul - UndeadList		 Agent Skills General Comprehensive E2E development workflow with helpful Claude Code subagent prompts for solo devs. Run multiple auditors in parallel, automate fix cycles with micro-checkpoint protocols, and do browser-based QA. Includes strict protocols to prevent AI going rogue.
stars forks issues prs created last-commit release-date version license
Web Assets Generator Skill
by Alon Wolenitz		 Agent Skills General Easily generate web assets from Claude Code including favicons, app icons (PWA), and social media meta images (Open Graph) for Facebook, Twitter, WhatsApp, and LinkedIn. Handles image resizing, text-to-image generation, emojis, and provides proper HTML meta tags.
stars forks issues prs created last-commit release-date version license
/create-plan
by taddyorg		 Slash-Commands Project & Task Management Generates comprehensive product requirement documents outlining detailed specifications, requirements, and features following standardized document structure and format.
stars forks issues prs created last-commit release-date version license
ContextKit
by Cihat Gündüz		 Tooling General A systematic development framework that transforms Claude Code into a proactive development partner. Features 4-phase planning methodology, specialized quality agents, and structured workflows that help AI produce production-ready code on first try.
stars forks issues prs created last-commit release-date version license
ClaudeCTX
by John Fox		 Tooling Config Managers claudectx lets you switch your entire Claude Code configuration with a single command.
stars forks issues prs created last-commit release-date version license
Claude Session Restore
by ZENG3LD		 Tooling General Efficiently restore context from previous Claude Code sessions by analyzing session files and git history. Features multi-factor data collection across numerous Claude Code capacities with time-based filtering. Uses tail-based parsing for efficient handling of large session files up to 2GB. Includes both a CLI tool for manual analysis and a Claude Code skill for automatic session restoration.
stars forks issues prs created last-commit release-date version license
viberank
by nikshepsvn		 Tooling Usage Monitors A community-driven leaderboard tool that enables developers to visualize, track, and compete based on their Claude Code usage statistics. It features robust data analytics, GitHub OAuth, data validation, and user-friendly CLI/web submission methods.
stars forks issues prs created last-commit release-date version license
TÂCHES Claude Code Resources
by TÂCHES		 Agent Skills General A well-balanced, "down-to-Earth" set of sub agents, skills, and commands, that are well-organized, easy to read, and a healthy focus on "meta"-skills/agents, like "skill-auditor", hook creation, etc. - the kind of things you can adapt to your workflow, and not the other way around.
stars forks issues prs created last-commit release-date version license
cc-tools
by Josh Symonds		 Tooling General High-performance Go implementation of Claude Code hooks and utilities. Provides smart linting, testing, and statusline generation with minimal overhead.
stars forks issues prs created last-commit release-date version license
Book Factory
by Robert Guss		 Agent Skills General A comprehensive pipeline of Skills that replicates traditional publishing infrastructure for nonfiction book creation using specialized Claude skills.
stars forks issues prs created last-commit release-date version license
claudia-statusline
by Hagan Franks		 Status Lines General High-performance Rust-based statusline for Claude Code with persistent stats tracking, progress bars, and optional cloud sync. Features SQLite-first persistence, git integration, context progress bars, burn rate calculation, XDG-compliant with theme support (dark/light, NO_COLOR).
stars forks issues prs created last-commit release-date version license
Britfix
by Talieisin		 Hooks General Claude outputs American spellings by default, which can have an impact on: professional credibility, compliance, documentation, and more. Britfix converts to British English, with a Claude Code hook for automatic conversion as files are written. Context-aware: handles code files intelligently by only converting comments and docstrings, never identifiers or string literals.
stars forks issues prs created last-commit release-date version license
claudekit
by Carl Rannaberg		 Tooling General Impressive CLI toolkit providing auto-save checkpointing, code quality hooks, specification generation and execution, and 20+ specialized subagents including oracle (gpt-5), code-reviewer (6-aspect deep analysis), ai-sdk-expert (Vercel AI SDK), typescript-expert and many more for Claude Code workflows.
stars forks issues prs created last-commit release-date version license
/prd-generator
by Denis Redozubov		 Slash-Commands Project & Task Management A Claude Code plugin that generates comprehensive Product Requirements Documents (PRDs) from conversation context. Invoke `/create-prd` after discussing requirements and it produces a complete PRD with all standard sections including Executive Summary, User Stories, MVP Scope, Architecture, Success Criteria, and Implementation Phases.
stars forks issues prs created last-commit release-date version license
recall
by zippoxer		 Tooling General Full-text search your Claude Code sessions. Run `recall` in terminal, type to search, Enter to resume. Alternative to `claude --resume`.
stars forks issues prs created last-commit release-date version license
claude-tmux
by Niels Groeneveld		 Alternative Clients General Manage Claude Code within tmux. A tmux popup of all your Claude Code instances, enabling quick switching, status monitoring, session lifecycle management, with git worktree and pull request support.
stars forks issues prs created last-commit release-date version license
Pareto Mac
by ParetoSecurity		 CLAUDE.md Files Domain-Specific Serves as development guide for Mac security audit tool with build instructions, contribution guidelines, testing procedures, and workflow documentation.
stars forks issues prs created last-commit release-date version license
Gen-Alpha Slang
by Steve Nims		 Output Styles General This is really... different. I don't know what to say about this one. It does what it says on the tin. You might find it funny, you might want throw up. I'll just say candidly this is included strictly for its potentially comedic awesomeness.
stars forks issues prs created last-commit release-date version license
claude-code-hooks-sdk
by beyondcode		 Hooks General A Laravel-inspired PHP SDK for building Claude Code hook responses with a clean, fluent API. This SDK makes it easy to create structured JSON responses for Claude Code hooks using an expressive, chainable interface.
stars forks issues prs created last-commit release-date version license
stt-mcp-server-linux
by marcindulak		 Tooling General A push-to-talk speech transcription setup for Linux using a Python MCP server. Runs locally in Docker with no external API calls. Your speech is recorded, transcribed into text, and then sent to Claude running in a Tmux session.
stars forks issues prs created last-commit release-date version license
LangGraphJS
by langchain-ai		 CLAUDE.md Files Language-Specific Offers comprehensive build and test commands with detailed TypeScript style guidelines, layered library architecture, and monorepo structure using yarn workspaces.
stars forks issues prs created last-commit release-date version license
viwo-cli
by Hal Shin		 Tooling General Run Claude Code in a Docker container with git worktrees as volume mounts to enable safer usage of `--dangerously-skip-permissions` for frictionless one-shotting prompts. Allows users to spin up multiple instances of Claude Code in the background easily with reduced permission fatigue.
stars forks issues prs created last-commit release-date version license
Giselle
by giselles-ai		 CLAUDE.md Files Language-Specific Provides detailed build and test commands using pnpm and Vitest with strict code formatting requirements and comprehensive naming conventions for code consistency.
stars forks issues prs created last-commit release-date version license
Omnara
by Ishaan Sehgal		 Alternative Clients General A command center for AI agents that syncs Claude Code sessions across terminal, web, and mobile. Allows for remote monitoring, human-in-the-loop interaction, and team collaboration.
stars forks issues prs created last-commit release-date version license
claude-code.el
by stevemolitor		 Tooling IDE Integrations An Emacs interface for Claude Code CLI.
stars forks issues prs created last-commit release-date version license
HASH
by hashintel		 CLAUDE.md Files Language-Specific Features comprehensive repository structure breakdown with strong emphasis on coding standards, detailed Rust documentation guidelines, and systematic PR review process.
stars forks issues prs created last-commit release-date version license
Vibe-Log
by Vibe-Log		 Tooling General Analyzes your Claude Code prompts locally (using CC), provides intelligent session analysis and actionable strategic guidance - works in the statusline and produces very pretty HTML reports as well. Easy to install and remove.
stars forks issues prs created last-commit release-date version license
Claudix - Claude Code for VSCode
by Haleclipse		 Tooling IDE Integrations A VSCode extension that brings Claude Code directly into your editor with interactive chat interface, session management, intelligent file operations, terminal execution, and real-time streaming responses. Built with Vue 3, TypeScript.
stars forks issues prs created last-commit release-date version license
SPy
by spylang		 CLAUDE.md Files Language-Specific Enforces strict coding conventions with comprehensive testing guidelines, multiple code compilation options, and backend-specific test decorators for targeted filtering.
stars forks issues prs created last-commit release-date version license
Agentic Workflow Patterns
by ThibautMelen		 Workflows & Knowledge Guides General A comprehensive and well-documented collection of agentic patterns from Anthropic docs, with colorful Mermaid diagrams and code examples for each pattern. Covers Subagent Orchestration, Progressive Skills, Parallel Tool Calling, Master-Clone Architecture, Wizard Workflows, and more. Also compatible with other providers.
stars forks issues prs created last-commit release-date version license
ClaudoPro Directory
by ghost		 Workflows & Knowledge Guides General Well-crafted, wide selection of Claude Code hooks, slash commands, subagent files, and more, covering a range of specialized tasks and workflows. Better resources than your average "Claude-template-for-everything" site.
stars forks issues prs created last-commit release-date version license
Claudable
by Ethan Park		 Alternative Clients General Claudable is an open-source web builder that leverages local CLI agents, such as Claude Code and Cursor Agent, to build and deploy products effortlessly.
stars forks issues prs created last-commit release-date version license
learn-faster-kit
by Hugo Lau		 Workflows & Knowledge Guides General A creative educational framework for Claude Code, inspired by the "FASTER" approach to self-teaching. Ships with a variety of agents, slash commands, and tools that enable Claude Code to help you progress at your own pace, employing well-established pedagogical techniques like active learning and spaced repetition.
stars forks issues prs created last-commit release-date version license
pre-commit-hooks
by aRustyDev		 CLAUDE.md Files Domain-Specific This repository is about pre-commit-hooks in general, but the `CLAUDE.md` and related `.claude/` documentation is exemplary. Thorough but not verbose. Unlike a lot of `CLAUDE.md` files, it doesn't primarily consist in shouting at Claude in all-caps. Great learning resource. Also, hooks.
stars forks issues prs created last-commit release-date version license
Awesome Claude Code Output Styles (That I Really Like)
by Really Him		 Output Styles General A fun and moderately amusing collection of experimental output styles.
stars forks issues prs created last-commit release-date version license
JSBeeb
by mattgodbolt		 CLAUDE.md Files Language-Specific Provides development guide for JavaScript BBC Micro emulator with build and testing instructions, architecture documentation, and debugging workflows.
stars forks issues prs created last-commit release-date version license
cchooks
by GowayLee		 Hooks General A lightweight Python SDK with a clean API and good documentation; simplifies the process of writing hooks and integrating them into your codebase, providing a nice abstraction over the JSON configuration files.
stars forks issues prs created last-commit release-date version license
AB Method
by Ayoub Bensalah		 Workflows & Knowledge Guides General A principled, spec-driven workflow that transforms large problems into focused, incremental missions using Claude Code's specialized sub agents. Includes slash-commands, sub agents, and specialized workflows designed for specific parts of the SDLC.
stars forks issues prs created last-commit release-date version license
Project Management, Implementation, Planning, and Release
by scopecraft		 Workflows & Knowledge Guides General Really comprehensive set of commands for all aspects of SDLC.
stars forks issues prs created last-commit release-date version license
ccexp
by nyatinte		 Tooling General Interactive CLI tool for discovering and managing Claude Code configuration files and slash commands with a beautiful terminal UI.
stars forks issues prs created last-commit release-date version license
/linux-desktop-slash-commands
by Daniel Rosehill		 Slash-Commands General A library of slash commands intended specifically to facilitate common and advanced operations on Linux desktop environments (although many would also be useful on Linux servers). Command groups include hardware benchmarking, filesystem organisation, and security posture validation.
stars forks issues prs created last-commit release-date version license
Claude Code Infrastructure Showcase
by diet103		 Workflows & Knowledge Guides General A remarkably innovative approach to working with Skills, the centerpiece of which being a technique that leverages hooks to ensure that Claude intelligently selects and activates the appropriate Skill given the current context. Well-documented and adaptable to different projects and workflows.
stars forks issues prs created last-commit release-date version license
cchistory
by eckardt		 Tooling General Like the shell history command but for your Claude Code sessions. Easily list all Bash or "Bash-mode" (`!`) commands Claude Code ran in a session for reference.
stars forks issues prs created last-commit release-date version license
cc-sessions
by toastdev		 Tooling General An opinionated approach to productive development with Claude Code
stars forks issues prs created last-commit release-date version license
CC Notify
by dazuiba		 Hooks General CCNotify provides desktop notifications for Claude Code, alerting you to input needs or task completion, with one-click jumps back to VS Code and task duration display.
stars forks issues prs created last-commit release-date version license
/create-hook
by Omri Lavi		 Slash-Commands General Slash command for hook creation - intelligently prompts you through the creation process with smart suggestions based on your project setup (TS, Prettier, ESLint...).
stars forks issues prs created last-commit release-date version license
Claude Code PM
by Ran Aroussi		 Workflows & Knowledge Guides General Really comprehensive and feature-packed project-management workflow for Claude Code. Numerous specialized agents, slash-commands, and strong documentation.
stars forks issues prs created last-commit release-date version license
Claude Code Output Styles - Debugging
by Jamie Matthews		 Output Styles General A small set of well-written output styles, specifically focused on debugging - root cause analysis, systematic, methodical debugging, encouraging a more careful approach to bug-squashing from Claude Code.
stars forks issues prs created last-commit release-date version license
/prime
by yzyydev		 Slash-Commands Context Loading & Priming Sets up initial project context by viewing directory structure and reading key files, creating standardized context with directory visualization and key documentation focus.
stars forks issues prs created last-commit release-date version license
Design Review Workflow
by Patrick Ellis		 Workflows & Knowledge Guides General A tailored workflow for enabling automated UI/UX design review, including specialized sub agents, slash commands, `CLAUDE.md` excerpts, and more. Covers a broad range of criteria from responsive design to accessibility.
stars forks issues prs created last-commit release-date version license
ccoutputstyles
by Vivek Nair		 Output Styles General CLI tool and template gallery for customizing Claude Code output styles with pre-built templates. Features over 15 templates at the time of writing!
stars forks issues prs created last-commit release-date version license
TypeScript Quality Hooks
by bartolli		 Hooks General Quality check hook for Node.js TypeScript projects with TypeScript compilation. ESLint auto-fixing, and Prettier formatting. Uses SHA256 config caching for < 5ms validation performance during real-time editing.
stars forks issues prs created last-commit release-date version license
Simone
by Helmi		 Workflows & Knowledge Guides General A broader project management workflow for Claude Code that encompasses not just a set of commands, but a system of documents, guidelines, and processes to facilitate project planning and execution.
stars forks issues prs created last-commit release-date version license
ccflare
by snipeship		 Tooling Usage Monitors Claude Code usage dashboard with a web-UI that would put Tableau to shame. Thoroughly comprehensive metrics, frictionless setup, detailed logging, really really nice UI.
stars forks issues prs created last-commit release-date version license
Cursor Tools
by eastlondoner		 CLAUDE.md Files Domain-Specific Creates a versatile AI command interface supporting multiple providers and models with flexible command options and browser automation through "Stagehand" feature.
stars forks issues prs created last-commit release-date version license
/create-pull-request
by liam-hq		 Slash-Commands Version Control & Git Provides comprehensive PR creation guidance with GitHub CLI, enforcing title conventions, following template structure, and offering concrete command examples with best practices.
stars forks issues prs created last-commit release-date version license
run-claude-docker
by Jonas		 Tooling General A self-contained Docker runner that forwards your current workspace into a safe(r) isolated docker container, where you still have access to your Claude Code settings, authentication, ssh agent, pgp, optionally aws keys etc.
stars forks issues prs created last-commit release-date version license
Context Priming
by disler		 Workflows & Knowledge Guides General Provides a systematic approach to priming Claude Code with comprehensive project context through specialized commands for different project scenarios and development contexts.
stars forks issues prs created last-commit release-date version license
Laravel TALL Stack AI Development Starter Kit
by tott		 Workflows & Knowledge Guides General Transform your Laravel TALL (Tailwind, AlpineJS, Laravel, Livewire) stack development with comprehensive Claude Code configurations that provide intelligent assistance, systematic workflows, and domain expert consultation.
stars forks issues prs created last-commit release-date version license
cclogviewer
by Brad S.		 Tooling General A humble but handy utility for viewing Claude Code `.jsonl` conversation files in a pretty HTML UI.
stars forks issues prs created last-commit release-date version license
Project Bootstrapping and Task Management
by steadycursor		 Workflows & Knowledge Guides General Provides a structured set of commands for bootstrapping and managing a new project, including meta-commands for creating and editing custom slash-commands.
stars forks issues prs created last-commit release-date version license
claude-hooks
by John Lindquist		 Hooks General A TypeScript-based system for configuring and customizing Claude Code hooks with a powerful and flexible interface.
stars forks issues prs created last-commit release-date version license
Claude Composer
by Mike Bannister		 Tooling General A tool that adds small enhancements to Claude Code.
stars forks issues prs created last-commit release-date version license
Claude Code Usage Monitor
by Maciek-roboblog		 Tooling Usage Monitors A real-time terminal-based tool for monitoring Claude Code token usage. It shows live token consumption, burn rate, and predictions for token depletion. Features include visual progress bars, session-aware analytics, and support for multiple subscription plans.
stars forks issues prs created last-commit release-date version license
/create-command
by scopecraft		 Slash-Commands Project & Task Management Guides Claude through creating new custom commands with proper structure by analyzing requirements, templating commands by category, enforcing command standards, and creating supporting documentation.
stars forks issues prs created last-commit release-date version license
Network Chronicles
by Fimeg		 CLAUDE.md Files Domain-Specific Presents detailed implementation plan for AI-driven game characters with technical specifications for LLM integration, character guidelines, and service discovery mechanics.
stars forks issues prs created last-commit release-date version license
/todo
by chrisleyva		 Slash-Commands Project & Task Management A convenient command to quickly manage project todo items without leaving the Claude Code interface, featuring due dates, sorting, task prioritization, and comprehensive todo list management.
stars forks issues prs created last-commit release-date version license
Claude Hub
by Claude Did This		 Tooling General A webhook service that connects Claude Code to GitHub repositories, enabling AI-powered code assistance directly through pull requests and issues. This integration allows Claude to analyze repositories, answer technical questions, and help developers understand and improve their codebase through simple @mentions.
stars forks issues prs created last-commit release-date version license
/docs
by slunsford		 Slash-Commands Documentation & Changelogs Generates comprehensive documentation that follows project structure, documenting APIs and usage patterns with consistent formatting for better user understanding.
stars forks issues prs created last-commit release-date version license
/create-prp
by Wirasm		 Slash-Commands Project & Task Management Creates product requirement plans by reading PRP methodology, following template structure, creating comprehensive requirements, and structuring product definitions for development.
stars forks issues prs created last-commit release-date version license
/update-docs
by Consiliency		 Slash-Commands Documentation & Changelogs Reviews current documentation status, updates implementation progress, reviews phase documents, and maintains documentation consistency across the project.
stars forks issues prs created last-commit release-date version license
/rsi
by ddisisto		 Slash-Commands Context Loading & Priming Reads all commands and key project files to optimize AI-assisted development by streamlining the process, loading command context, and setting up for better development workflow.
stars forks issues prs created last-commit release-date version license
n8n_agent
by kingler		 Workflows & Knowledge Guides General Amazing comprehensive set of comments for code analysis, QA, design, documentation, project structure, project management, optimization, and many more.
stars forks issues prs created last-commit release-date version license
/code_analysis
by kingler		 Slash-Commands Code Analysis & Testing Provides a menu of advanced code analysis commands for deep inspection, including knowledge graph generation, optimization suggestions, and quality evaluation.
stars forks issues prs created last-commit release-date version license
claude-code-mcp-enhanced
by grahama1970		 CLAUDE.md Files Project Scaffolding & MCP Provides detailed and emphatic instructions for Claude to follow as a coding agent, with testing guidance, code examples, and compliance checks.
stars forks issues prs created last-commit release-date version license
/fixing_go_in_graph
by Mjvolk3		 Slash-Commands Miscellaneous Focuses on Gene Ontology annotation integration in graph databases, handling multiple data sources, addressing graph representation issues, and ensuring correct data incorporation.
stars forks issues prs created last-commit release-date version license
/review_dcell_model
by Mjvolk3		 Slash-Commands Miscellaneous Reviews old Dcell implementation files, comparing with newer Dango model, noting changes over time, and analyzing refactoring approaches for better code organization.
stars forks issues prs created last-commit release-date version license
Claude Task Runner
by grahama1970		 Tooling Orchestrators A specialized tool to manage context isolation and focused task execution with Claude Code, solving the critical challenge of context length limitations and task focus when working with Claude on complex, multi-step projects.
stars forks issues prs created last-commit release-date version license
/load-llms-txt
by ethpandaops		 Slash-Commands Context Loading & Priming Loads LLM configuration files to context, importing specific terminology, model configurations, and establishing baseline terminology for AI discussions.
stars forks issues prs created last-commit release-date version license
SteadyStart
by steadycursor		 CLAUDE.md Files Domain-Specific Clear and direct instructives about style, permissions, Claude's "role", communications, and documentation of Claude Code sessions for other team members to stay abreast.
stars forks issues prs created last-commit release-date version license
/load_dango_pipeline
by Mjvolk3		 Slash-Commands Context Loading & Priming Sets context for model training by referencing pipeline files, establishing working context, and preparing for pipeline work with relevant documentation.
stars forks issues prs created last-commit release-date version license
/load_coo_context
by Mjvolk3		 Slash-Commands Context Loading & Priming References specific files for sparse matrix operations, explains transform usage, compares with previous approaches, and sets data formatting context for development.
stars forks issues prs created last-commit release-date version license
/check
by rygwdn		 Slash-Commands Code Analysis & Testing Performs comprehensive code quality and security checks, featuring static analysis integration, security vulnerability scanning, code style enforcement, and detailed reporting.
stars forks issues prs created last-commit release-date version license
/add-to-changelog
by berrydev-ai		 Slash-Commands Documentation & Changelogs Adds new entries to changelog files while maintaining format consistency, properly documenting changes, and following established project standards for version tracking.
stars forks issues prs created last-commit release-date version license
/optimize
by to4iki		 Slash-Commands Code Analysis & Testing Analyzes code performance to identify bottlenecks, proposing concrete optimizations with implementation guidance for improved application performance.
stars forks issues prs created last-commit release-date version license
/fix-github-issue
by jeremymailen		 Slash-Commands Version Control & Git Analyzes and fixes GitHub issues using a structured approach with GitHub CLI for issue details, implementing necessary code changes, running tests, and creating proper commit messages.
stars forks issues prs created last-commit release-date version license
/explain-issue-fix
by hackdays-io		 Slash-Commands Documentation & Changelogs Documents solution approaches for GitHub issues, explaining technical decisions, detailing challenges overcome, and providing implementation context for better understanding.
stars forks issues prs created last-commit release-date version license
/run-ci
by hackdays-io		 Slash-Commands CI / Deployment Activates virtual environments, runs CI-compatible check scripts, iteratively fixes errors, and ensures all tests pass before completion.
stars forks issues prs created last-commit release-date version license
/use-stepper
by zuplo		 Slash-Commands Miscellaneous Reformats documentation to use React Stepper component, transforming heading formats, applying proper indentation, and maintaining markdown compatibility with admonition formatting.
stars forks issues prs created last-commit release-date version license
/initref
by okuvshynov		 Slash-Commands Context Loading & Priming Initializes reference documentation structure with standard doc templates, API reference setup, documentation conventions, and placeholder content generation.
stars forks issues prs created last-commit release-date version license
/update-branch-name
by giselles-ai		 Slash-Commands Version Control & Git Updates branch names with proper prefixes and formats, enforcing naming conventions, supporting semantic prefixes, and managing remote branch updates.
stars forks issues prs created last-commit release-date version license
/fix-issue
by metabase		 Slash-Commands Version Control & Git Addresses GitHub issues by taking issue number as parameter, analyzing context, implementing solution, and testing/validating the fix for proper integration.
stars forks issues prs created last-commit release-date version license
/fix-pr
by metabase		 Slash-Commands Version Control & Git Fetches and fixes unresolved PR comments by automatically retrieving feedback, addressing reviewer concerns, making targeted code improvements, and streamlining the review process.
stars forks issues prs created last-commit release-date version license
/repro-issue
by rzykov		 Slash-Commands Code Analysis & Testing Creates reproducible test cases for GitHub issues, ensuring tests fail reliably and documenting clear reproduction steps for developers.
stars forks issues prs created last-commit release-date version license
/commit-fast
by steadycursor		 Slash-Commands Version Control & Git Automates git commit process by selecting the first suggested message, generating structured commits with consistent formatting while skipping manual confirmation and removing Claude co-Contributorship footer
stars forks issues prs created last-commit release-date version license
/create-pr
by toyamarinyon		 Slash-Commands Version Control & Git Streamlines pull request creation by handling the entire workflow: creating a new branch, committing changes, formatting modified files with Biome, and submitting the PR.
stars forks issues prs created last-commit release-date version license
/context-prime
by elizaOS		 Slash-Commands Context Loading & Priming Primes Claude with comprehensive project understanding by loading repository structure, setting development context, establishing project goals, and defining collaboration parameters.
stars forks issues prs created last-commit release-date version license
/mermaid
by GaloyMoney		 Slash-Commands Miscellaneous Generates Mermaid diagrams from SQL schema files, creating entity relationship diagrams with table properties, validating diagram compilation, and ensuring complete entity coverage.
stars forks issues prs created last-commit release-date version license
Guitar
by soramimi		 CLAUDE.md Files Domain-Specific Serves as development guide for Guitar Git GUI Client with build commands for various platforms, code style guidelines for contributing, and project structure explanation.
stars forks issues prs created last-commit release-date version license
TPL
by KarpelesLab		 CLAUDE.md Files Language-Specific Details Go project conventions with comprehensive error handling recommendations, table-driven testing approach guidelines, and modernization suggestions for latest Go features.
stars forks issues prs created last-commit release-date version license
DroidconKotlin
by touchlab		 CLAUDE.md Files Language-Specific Delivers comprehensive Gradle commands for cross-platform Kotlin Multiplatform development with clear module structure and practical guidance for dependency injection.
stars forks issues prs created last-commit release-date version license
/commit
by evmts		 Slash-Commands Version Control & Git Creates git commits using conventional commit format with appropriate emojis, following project standards and creating descriptive messages that explain the purpose of changes.
stars forks issues prs created last-commit release-date version license
/release
by kelp		 Slash-Commands CI / Deployment Manages software releases by updating changelogs, reviewing README changes, evaluating version increments, and documenting release changes for better version tracking.
stars forks issues prs created last-commit release-date version license
/project_hello_w_name
by disler		 Slash-Commands Project & Task Management Creates customizable greeting components with name input, demonstrating argument passing, component reusability, state management, and user input handling.
stars forks issues prs created last-commit release-date version license
/create-worktrees
by evmts		 Slash-Commands Version Control & Git Creates git worktrees for all open PRs or specific branches, handling branches with slashes, cleaning up stale worktrees, and supporting custom branch creation for development.
stars forks issues prs created last-commit release-date version license
/husky
by evmts		 Slash-Commands Version Control & Git Sets up and manages Husky Git hooks by configuring pre-commit hooks, establishing commit message standards, integrating with linting tools, and ensuring code quality on commits.
stars forks issues prs created last-commit release-date version license
AI IntelliJ Plugin
by didalgolab		 CLAUDE.md Files Language-Specific Provides comprehensive Gradle commands for IntelliJ plugin development with platform-specific coding patterns, detailed package structure guidelines, and clear internationalization standards.
stars forks issues prs created last-commit release-date version license
/tdd
by zscott		 Slash-Commands Code Analysis & Testing Guides development using Test-Driven Development principles, enforcing Red-Green-Refactor discipline, integrating with git workflow, and managing PR creation.
stars forks issues prs created last-commit release-date version license
Lamoom Python
by LamoomAI		 CLAUDE.md Files Language-Specific Serves as reference for production prompt engineering library with load balancing of AI Models, API documentation, and usage patterns with examples.
stars forks issues prs created last-commit release-date version license
Inkline
by inkline		 CLAUDE.md Files Language-Specific Structures development workflow using pnpm with emphasis on TypeScript and Vue 3 Composition API, detailed component creation process, and comprehensive testing recommendations.
stars forks issues prs created last-commit release-date version license
--- **Total Resources:** 192 **Last Generated:** 2026-03-02 ================================================ FILE: README_ALTERNATIVES/README_FLAT_CLAUDE-MD_AZ.md ================================================

Pick Your Style:

Awesome Extra Classic Flat

# Awesome Claude Code (Flat) [![Awesome](https://awesome.re/badge-flat2.svg)](https://awesome.re) A flat list view of all resources. Category: **CLAUDE.md** | Sorted: alphabetically by name --- ## Sort By:

A - Z UPDATED CREATED RELEASES

Category:

All Tooling Commands CLAUDE.md Workflows Hooks Skills Styles Status Docs Clients

Currently viewing: **CLAUDE.md** sorted alphabetically by name

--- ## Resources
Resource Category Sub-Category Description
AI IntelliJ Plugin
by didalgolab		 CLAUDE.md Files Language-Specific Provides comprehensive Gradle commands for IntelliJ plugin development with platform-specific coding patterns, detailed package structure guidelines, and clear internationalization standards.
stars forks issues prs created last-commit release-date version license
AWS MCP Server
by alexei-led		 CLAUDE.md Files Language-Specific Features multiple Python environment setup options with detailed code style guidelines, comprehensive error handling recommendations, and security considerations for AWS CLI interactions.
stars forks issues prs created last-commit release-date version license
Basic Memory
by basicmachines-co		 CLAUDE.md Files Project Scaffolding & MCP Presents an innovative AI-human collaboration framework with Model Context Protocol for bidirectional LLM-markdown communication and flexible knowledge structure for complex projects.
stars forks issues prs created last-commit release-date version license
claude-code-mcp-enhanced
by grahama1970		 CLAUDE.md Files Project Scaffolding & MCP Provides detailed and emphatic instructions for Claude to follow as a coding agent, with testing guidance, code examples, and compliance checks.
stars forks issues prs created last-commit release-date version license
Course Builder
by badass-courses		 CLAUDE.md Files Domain-Specific Enables real-time multiplayer capabilities for collaborative course creation with diverse tech stack integration and monorepo architecture using Turborepo.
stars forks issues prs created last-commit release-date version license
Cursor Tools
by eastlondoner		 CLAUDE.md Files Domain-Specific Creates a versatile AI command interface supporting multiple providers and models with flexible command options and browser automation through "Stagehand" feature.
stars forks issues prs created last-commit release-date version license
DroidconKotlin
by touchlab		 CLAUDE.md Files Language-Specific Delivers comprehensive Gradle commands for cross-platform Kotlin Multiplatform development with clear module structure and practical guidance for dependency injection.
stars forks issues prs created last-commit release-date version license
EDSL
by expectedparrot		 CLAUDE.md Files Language-Specific Offers detailed build and test commands with strict code style enforcement, comprehensive testing requirements, and standardized development workflow using Black and mypy.
stars forks issues prs created last-commit release-date version license
Giselle
by giselles-ai		 CLAUDE.md Files Language-Specific Provides detailed build and test commands using pnpm and Vitest with strict code formatting requirements and comprehensive naming conventions for code consistency.
stars forks issues prs created last-commit release-date version license
Guitar
by soramimi		 CLAUDE.md Files Domain-Specific Serves as development guide for Guitar Git GUI Client with build commands for various platforms, code style guidelines for contributing, and project structure explanation.
stars forks issues prs created last-commit release-date version license
HASH
by hashintel		 CLAUDE.md Files Language-Specific Features comprehensive repository structure breakdown with strong emphasis on coding standards, detailed Rust documentation guidelines, and systematic PR review process.
stars forks issues prs created last-commit release-date version license
Inkline
by inkline		 CLAUDE.md Files Language-Specific Structures development workflow using pnpm with emphasis on TypeScript and Vue 3 Composition API, detailed component creation process, and comprehensive testing recommendations.
stars forks issues prs created last-commit release-date version license
JSBeeb
by mattgodbolt		 CLAUDE.md Files Language-Specific Provides development guide for JavaScript BBC Micro emulator with build and testing instructions, architecture documentation, and debugging workflows.
stars forks issues prs created last-commit release-date version license
Lamoom Python
by LamoomAI		 CLAUDE.md Files Language-Specific Serves as reference for production prompt engineering library with load balancing of AI Models, API documentation, and usage patterns with examples.
stars forks issues prs created last-commit release-date version license
LangGraphJS
by langchain-ai		 CLAUDE.md Files Language-Specific Offers comprehensive build and test commands with detailed TypeScript style guidelines, layered library architecture, and monorepo structure using yarn workspaces.
stars forks issues prs created last-commit release-date version license
Metabase
by metabase		 CLAUDE.md Files Language-Specific Details workflow for REPL-driven development in Clojure/ClojureScript with emphasis on incremental development, testing, and step-by-step approach for feature implementation.
stars forks issues prs created last-commit release-date version license
Network Chronicles
by Fimeg		 CLAUDE.md Files Domain-Specific Presents detailed implementation plan for AI-driven game characters with technical specifications for LLM integration, character guidelines, and service discovery mechanics.
stars forks issues prs created last-commit release-date version license
Pareto Mac
by ParetoSecurity		 CLAUDE.md Files Domain-Specific Serves as development guide for Mac security audit tool with build instructions, contribution guidelines, testing procedures, and workflow documentation.
stars forks issues prs created last-commit release-date version license
pre-commit-hooks
by aRustyDev		 CLAUDE.md Files Domain-Specific This repository is about pre-commit-hooks in general, but the `CLAUDE.md` and related `.claude/` documentation is exemplary. Thorough but not verbose. Unlike a lot of `CLAUDE.md` files, it doesn't primarily consist in shouting at Claude in all-caps. Great learning resource. Also, hooks.
stars forks issues prs created last-commit release-date version license
SG Cars Trends Backend
by sgcarstrends		 CLAUDE.md Files Language-Specific Provides comprehensive structure for TypeScript monorepo projects with detailed commands for development, testing, deployment, and AWS/Cloudflare integration.
stars forks issues prs created last-commit release-date version license
SPy
by spylang		 CLAUDE.md Files Language-Specific Enforces strict coding conventions with comprehensive testing guidelines, multiple code compilation options, and backend-specific test decorators for targeted filtering.
stars forks issues prs created last-commit release-date version license
SteadyStart
by steadycursor		 CLAUDE.md Files Domain-Specific Clear and direct instructives about style, permissions, Claude's "role", communications, and documentation of Claude Code sessions for other team members to stay abreast.
stars forks issues prs created last-commit release-date version license
TPL
by KarpelesLab		 CLAUDE.md Files Language-Specific Details Go project conventions with comprehensive error handling recommendations, table-driven testing approach guidelines, and modernization suggestions for latest Go features.
stars forks issues prs created last-commit release-date version license
--- **Total Resources:** 23 **Last Generated:** 2026-03-02 ================================================ FILE: README_ALTERNATIVES/README_FLAT_CLAUDE-MD_CREATED.md ================================================

Pick Your Style:

Awesome Extra Classic Flat

# Awesome Claude Code (Flat) [![Awesome](https://awesome.re/badge-flat2.svg)](https://awesome.re) A flat list view of all resources. Category: **CLAUDE.md** | Sorted: by date created --- ## Sort By:

A - Z UPDATED CREATED RELEASES

Category:

All Tooling Commands CLAUDE.md Workflows Hooks Skills Styles Status Docs Clients

Currently viewing: **CLAUDE.md** sorted by date created

--- ## Resources
Resource Category Sub-Category Description
claude-code-mcp-enhanced
by grahama1970		 CLAUDE.md Files Project Scaffolding & MCP Provides detailed and emphatic instructions for Claude to follow as a coding agent, with testing guidance, code examples, and compliance checks.
stars forks issues prs created last-commit release-date version license
EDSL
by expectedparrot		 CLAUDE.md Files Language-Specific Offers detailed build and test commands with strict code style enforcement, comprehensive testing requirements, and standardized development workflow using Black and mypy.
stars forks issues prs created last-commit release-date version license
AWS MCP Server
by alexei-led		 CLAUDE.md Files Language-Specific Features multiple Python environment setup options with detailed code style guidelines, comprehensive error handling recommendations, and security considerations for AWS CLI interactions.
stars forks issues prs created last-commit release-date version license
Network Chronicles
by Fimeg		 CLAUDE.md Files Domain-Specific Presents detailed implementation plan for AI-driven game characters with technical specifications for LLM integration, character guidelines, and service discovery mechanics.
stars forks issues prs created last-commit release-date version license
Cursor Tools
by eastlondoner		 CLAUDE.md Files Domain-Specific Creates a versatile AI command interface supporting multiple providers and models with flexible command options and browser automation through "Stagehand" feature.
stars forks issues prs created last-commit release-date version license
Basic Memory
by basicmachines-co		 CLAUDE.md Files Project Scaffolding & MCP Presents an innovative AI-human collaboration framework with Model Context Protocol for bidirectional LLM-markdown communication and flexible knowledge structure for complex projects.
stars forks issues prs created last-commit release-date version license
pre-commit-hooks
by aRustyDev		 CLAUDE.md Files Domain-Specific This repository is about pre-commit-hooks in general, but the `CLAUDE.md` and related `.claude/` documentation is exemplary. Thorough but not verbose. Unlike a lot of `CLAUDE.md` files, it doesn't primarily consist in shouting at Claude in all-caps. Great learning resource. Also, hooks.
stars forks issues prs created last-commit release-date version license
SteadyStart
by steadycursor		 CLAUDE.md Files Domain-Specific Clear and direct instructives about style, permissions, Claude's "role", communications, and documentation of Claude Code sessions for other team members to stay abreast.
stars forks issues prs created last-commit release-date version license
Lamoom Python
by LamoomAI		 CLAUDE.md Files Language-Specific Serves as reference for production prompt engineering library with load balancing of AI Models, API documentation, and usage patterns with examples.
stars forks issues prs created last-commit release-date version license
LangGraphJS
by langchain-ai		 CLAUDE.md Files Language-Specific Offers comprehensive build and test commands with detailed TypeScript style guidelines, layered library architecture, and monorepo structure using yarn workspaces.
stars forks issues prs created last-commit release-date version license
Giselle
by giselles-ai		 CLAUDE.md Files Language-Specific Provides detailed build and test commands using pnpm and Vitest with strict code formatting requirements and comprehensive naming conventions for code consistency.
stars forks issues prs created last-commit release-date version license
Course Builder
by badass-courses		 CLAUDE.md Files Domain-Specific Enables real-time multiplayer capabilities for collaborative course creation with diverse tech stack integration and monorepo architecture using Turborepo.
stars forks issues prs created last-commit release-date version license
SG Cars Trends Backend
by sgcarstrends		 CLAUDE.md Files Language-Specific Provides comprehensive structure for TypeScript monorepo projects with detailed commands for development, testing, deployment, and AWS/Cloudflare integration.
stars forks issues prs created last-commit release-date version license
SPy
by spylang		 CLAUDE.md Files Language-Specific Enforces strict coding conventions with comprehensive testing guidelines, multiple code compilation options, and backend-specific test decorators for targeted filtering.
stars forks issues prs created last-commit release-date version license
AI IntelliJ Plugin
by didalgolab		 CLAUDE.md Files Language-Specific Provides comprehensive Gradle commands for IntelliJ plugin development with platform-specific coding patterns, detailed package structure guidelines, and clear internationalization standards.
stars forks issues prs created last-commit release-date version license
Pareto Mac
by ParetoSecurity		 CLAUDE.md Files Domain-Specific Serves as development guide for Mac security audit tool with build instructions, contribution guidelines, testing procedures, and workflow documentation.
stars forks issues prs created last-commit release-date version license
TPL
by KarpelesLab		 CLAUDE.md Files Language-Specific Details Go project conventions with comprehensive error handling recommendations, table-driven testing approach guidelines, and modernization suggestions for latest Go features.
stars forks issues prs created last-commit release-date version license
HASH
by hashintel		 CLAUDE.md Files Language-Specific Features comprehensive repository structure breakdown with strong emphasis on coding standards, detailed Rust documentation guidelines, and systematic PR review process.
stars forks issues prs created last-commit release-date version license
DroidconKotlin
by touchlab		 CLAUDE.md Files Language-Specific Delivers comprehensive Gradle commands for cross-platform Kotlin Multiplatform development with clear module structure and practical guidance for dependency injection.
stars forks issues prs created last-commit release-date version license
Inkline
by inkline		 CLAUDE.md Files Language-Specific Structures development workflow using pnpm with emphasis on TypeScript and Vue 3 Composition API, detailed component creation process, and comprehensive testing recommendations.
stars forks issues prs created last-commit release-date version license
Guitar
by soramimi		 CLAUDE.md Files Domain-Specific Serves as development guide for Guitar Git GUI Client with build commands for various platforms, code style guidelines for contributing, and project structure explanation.
stars forks issues prs created last-commit release-date version license
Metabase
by metabase		 CLAUDE.md Files Language-Specific Details workflow for REPL-driven development in Clojure/ClojureScript with emphasis on incremental development, testing, and step-by-step approach for feature implementation.
stars forks issues prs created last-commit release-date version license
JSBeeb
by mattgodbolt		 CLAUDE.md Files Language-Specific Provides development guide for JavaScript BBC Micro emulator with build and testing instructions, architecture documentation, and debugging workflows.
stars forks issues prs created last-commit release-date version license
--- **Total Resources:** 23 **Last Generated:** 2026-03-02 ================================================ FILE: README_ALTERNATIVES/README_FLAT_CLAUDE-MD_RELEASES.md ================================================

Pick Your Style:

Awesome Extra Classic Flat

# Awesome Claude Code (Flat) [![Awesome](https://awesome.re/badge-flat2.svg)](https://awesome.re) A flat list view of all resources. Category: **CLAUDE.md** | Sorted: by latest release (30 days) --- ## Sort By:

A - Z UPDATED CREATED RELEASES

Category:

All Tooling Commands CLAUDE.md Workflows Hooks Skills Styles Status Docs Clients

Currently viewing: **CLAUDE.md** sorted by latest release (30 days) (past 30 days)

--- ## Resources > **Note:** Latest release data is pulled from GitHub Releases only. Projects without GitHub Releases will not show release info here. Please verify with the project directly.
Resource Version Source Release Date Description
SG Cars Trends Backend
by sgcarstrends		 v4.62.1 GitHub 2026-02-28 Provides comprehensive structure for TypeScript monorepo projects with detailed commands for development, testing, deployment, and AWS/Cloudflare integration.
stars forks issues prs created last-commit release-date version license
AWS MCP Server
by alexei-led		 v1.7.0 GitHub 2026-02-27 Features multiple Python environment setup options with detailed code style guidelines, comprehensive error handling recommendations, and security considerations for AWS CLI interactions.
stars forks issues prs created last-commit release-date version license
Giselle
by giselles-ai		 v0.67.0 GitHub 2026-02-27 Provides detailed build and test commands using pnpm and Vitest with strict code formatting requirements and comprehensive naming conventions for code consistency.
stars forks issues prs created last-commit release-date version license
LangGraphJS
by langchain-ai		 @langchain/langgraph-ui@1.1.14 GitHub 2026-02-26 Offers comprehensive build and test commands with detailed TypeScript style guidelines, layered library architecture, and monorepo structure using yarn workspaces.
stars forks issues prs created last-commit release-date version license
Course Builder
by badass-courses		 aihero-cli-v0.1.0 GitHub 2026-02-25 Enables real-time multiplayer capabilities for collaborative course creation with diverse tech stack integration and monorepo architecture using Turborepo.
stars forks issues prs created last-commit release-date version license
JSBeeb
by mattgodbolt		 v1.4.0 GitHub 2026-02-23 Provides development guide for JavaScript BBC Micro emulator with build and testing instructions, architecture documentation, and debugging workflows.
stars forks issues prs created last-commit release-date version license
Basic Memory
by basicmachines-co		 v0.18.5 GitHub 2026-02-20 Presents an innovative AI-human collaboration framework with Model Context Protocol for bidirectional LLM-markdown communication and flexible knowledge structure for complex projects.
stars forks issues prs created last-commit release-date version license
Metabase
by metabase		 v0.58.6 GitHub 2026-02-12 Details workflow for REPL-driven development in Clojure/ClojureScript with emphasis on incremental development, testing, and step-by-step approach for feature implementation.
stars forks issues prs created last-commit release-date version license
--- **Total Resources:** 8 **Last Generated:** 2026-03-02 ================================================ FILE: README_ALTERNATIVES/README_FLAT_CLAUDE-MD_UPDATED.md ================================================

Pick Your Style:

Awesome Extra Classic Flat

# Awesome Claude Code (Flat) [![Awesome](https://awesome.re/badge-flat2.svg)](https://awesome.re) A flat list view of all resources. Category: **CLAUDE.md** | Sorted: by last updated date --- ## Sort By:

A - Z UPDATED CREATED RELEASES

Category:

All Tooling Commands CLAUDE.md Workflows Hooks Skills Styles Status Docs Clients

Currently viewing: **CLAUDE.md** sorted by last updated date

--- ## Resources
Resource Category Sub-Category Description
SG Cars Trends Backend
by sgcarstrends		 CLAUDE.md Files Language-Specific Provides comprehensive structure for TypeScript monorepo projects with detailed commands for development, testing, deployment, and AWS/Cloudflare integration.
stars forks issues prs created last-commit release-date version license
EDSL
by expectedparrot		 CLAUDE.md Files Language-Specific Offers detailed build and test commands with strict code style enforcement, comprehensive testing requirements, and standardized development workflow using Black and mypy.
stars forks issues prs created last-commit release-date version license
AWS MCP Server
by alexei-led		 CLAUDE.md Files Language-Specific Features multiple Python environment setup options with detailed code style guidelines, comprehensive error handling recommendations, and security considerations for AWS CLI interactions.
stars forks issues prs created last-commit release-date version license
Metabase
by metabase		 CLAUDE.md Files Language-Specific Details workflow for REPL-driven development in Clojure/ClojureScript with emphasis on incremental development, testing, and step-by-step approach for feature implementation.
stars forks issues prs created last-commit release-date version license
Course Builder
by badass-courses		 CLAUDE.md Files Domain-Specific Enables real-time multiplayer capabilities for collaborative course creation with diverse tech stack integration and monorepo architecture using Turborepo.
stars forks issues prs created last-commit release-date version license
Basic Memory
by basicmachines-co		 CLAUDE.md Files Project Scaffolding & MCP Presents an innovative AI-human collaboration framework with Model Context Protocol for bidirectional LLM-markdown communication and flexible knowledge structure for complex projects.
stars forks issues prs created last-commit release-date version license
Pareto Mac
by ParetoSecurity		 CLAUDE.md Files Domain-Specific Serves as development guide for Mac security audit tool with build instructions, contribution guidelines, testing procedures, and workflow documentation.
stars forks issues prs created last-commit release-date version license
LangGraphJS
by langchain-ai		 CLAUDE.md Files Language-Specific Offers comprehensive build and test commands with detailed TypeScript style guidelines, layered library architecture, and monorepo structure using yarn workspaces.
stars forks issues prs created last-commit release-date version license
Giselle
by giselles-ai		 CLAUDE.md Files Language-Specific Provides detailed build and test commands using pnpm and Vitest with strict code formatting requirements and comprehensive naming conventions for code consistency.
stars forks issues prs created last-commit release-date version license
HASH
by hashintel		 CLAUDE.md Files Language-Specific Features comprehensive repository structure breakdown with strong emphasis on coding standards, detailed Rust documentation guidelines, and systematic PR review process.
stars forks issues prs created last-commit release-date version license
SPy
by spylang		 CLAUDE.md Files Language-Specific Enforces strict coding conventions with comprehensive testing guidelines, multiple code compilation options, and backend-specific test decorators for targeted filtering.
stars forks issues prs created last-commit release-date version license
pre-commit-hooks
by aRustyDev		 CLAUDE.md Files Domain-Specific This repository is about pre-commit-hooks in general, but the `CLAUDE.md` and related `.claude/` documentation is exemplary. Thorough but not verbose. Unlike a lot of `CLAUDE.md` files, it doesn't primarily consist in shouting at Claude in all-caps. Great learning resource. Also, hooks.
stars forks issues prs created last-commit release-date version license
JSBeeb
by mattgodbolt		 CLAUDE.md Files Language-Specific Provides development guide for JavaScript BBC Micro emulator with build and testing instructions, architecture documentation, and debugging workflows.
stars forks issues prs created last-commit release-date version license
Cursor Tools
by eastlondoner		 CLAUDE.md Files Domain-Specific Creates a versatile AI command interface supporting multiple providers and models with flexible command options and browser automation through "Stagehand" feature.
stars forks issues prs created last-commit release-date version license
Network Chronicles
by Fimeg		 CLAUDE.md Files Domain-Specific Presents detailed implementation plan for AI-driven game characters with technical specifications for LLM integration, character guidelines, and service discovery mechanics.
stars forks issues prs created last-commit release-date version license
claude-code-mcp-enhanced
by grahama1970		 CLAUDE.md Files Project Scaffolding & MCP Provides detailed and emphatic instructions for Claude to follow as a coding agent, with testing guidance, code examples, and compliance checks.
stars forks issues prs created last-commit release-date version license
SteadyStart
by steadycursor		 CLAUDE.md Files Domain-Specific Clear and direct instructives about style, permissions, Claude's "role", communications, and documentation of Claude Code sessions for other team members to stay abreast.
stars forks issues prs created last-commit release-date version license
Guitar
by soramimi		 CLAUDE.md Files Domain-Specific Serves as development guide for Guitar Git GUI Client with build commands for various platforms, code style guidelines for contributing, and project structure explanation.
stars forks issues prs created last-commit release-date version license
TPL
by KarpelesLab		 CLAUDE.md Files Language-Specific Details Go project conventions with comprehensive error handling recommendations, table-driven testing approach guidelines, and modernization suggestions for latest Go features.
stars forks issues prs created last-commit release-date version license
DroidconKotlin
by touchlab		 CLAUDE.md Files Language-Specific Delivers comprehensive Gradle commands for cross-platform Kotlin Multiplatform development with clear module structure and practical guidance for dependency injection.
stars forks issues prs created last-commit release-date version license
AI IntelliJ Plugin
by didalgolab		 CLAUDE.md Files Language-Specific Provides comprehensive Gradle commands for IntelliJ plugin development with platform-specific coding patterns, detailed package structure guidelines, and clear internationalization standards.
stars forks issues prs created last-commit release-date version license
Lamoom Python
by LamoomAI		 CLAUDE.md Files Language-Specific Serves as reference for production prompt engineering library with load balancing of AI Models, API documentation, and usage patterns with examples.
stars forks issues prs created last-commit release-date version license
Inkline
by inkline		 CLAUDE.md Files Language-Specific Structures development workflow using pnpm with emphasis on TypeScript and Vue 3 Composition API, detailed component creation process, and comprehensive testing recommendations.
stars forks issues prs created last-commit release-date version license
--- **Total Resources:** 23 **Last Generated:** 2026-03-02 ================================================ FILE: README_ALTERNATIVES/README_FLAT_CLIENTS_AZ.md ================================================

Pick Your Style:

Awesome Extra Classic Flat

# Awesome Claude Code (Flat) [![Awesome](https://awesome.re/badge-flat2.svg)](https://awesome.re) A flat list view of all resources. Category: **Clients** | Sorted: alphabetically by name --- ## Sort By:

A - Z UPDATED CREATED RELEASES

Category:

All Tooling Commands CLAUDE.md Workflows Hooks Skills Styles Status Docs Clients

Currently viewing: **Clients** sorted alphabetically by name

--- ## Resources
Resource Category Sub-Category Description
Claudable
by Ethan Park		 Alternative Clients General Claudable is an open-source web builder that leverages local CLI agents, such as Claude Code and Cursor Agent, to build and deploy products effortlessly.
stars forks issues prs created last-commit release-date version license
claude-esp
by phiat		 Alternative Clients General Go-based TUI that streams Claude Code's hidden output (thinking, tool calls, subagents) to a separate terminal. Watch multiple sessions simultaneously, filter by content type, and track background tasks. Ideal for debugging or understanding what Claude is doing under the hood without interrupting your main session.
stars forks issues prs created last-commit release-date version license
claude-tmux
by Niels Groeneveld		 Alternative Clients General Manage Claude Code within tmux. A tmux popup of all your Claude Code instances, enabling quick switching, status monitoring, session lifecycle management, with git worktree and pull request support.
stars forks issues prs created last-commit release-date version license
crystal
by stravu		 Alternative Clients General A full-fledged desktop application for orchestrating, monitoring, and interacting with Claude Code agents.
stars forks issues prs created last-commit release-date version license
Omnara
by Ishaan Sehgal		 Alternative Clients General A command center for AI agents that syncs Claude Code sessions across terminal, web, and mobile. Allows for remote monitoring, human-in-the-loop interaction, and team collaboration.
stars forks issues prs created last-commit release-date version license
--- **Total Resources:** 5 **Last Generated:** 2026-03-02 ================================================ FILE: README_ALTERNATIVES/README_FLAT_CLIENTS_CREATED.md ================================================

Pick Your Style:

Awesome Extra Classic Flat

# Awesome Claude Code (Flat) [![Awesome](https://awesome.re/badge-flat2.svg)](https://awesome.re) A flat list view of all resources. Category: **Clients** | Sorted: by date created --- ## Sort By:

A - Z UPDATED CREATED RELEASES

Category:

All Tooling Commands CLAUDE.md Workflows Hooks Skills Styles Status Docs Clients

Currently viewing: **Clients** sorted by date created

--- ## Resources
Resource Category Sub-Category Description
claude-tmux
by Niels Groeneveld		 Alternative Clients General Manage Claude Code within tmux. A tmux popup of all your Claude Code instances, enabling quick switching, status monitoring, session lifecycle management, with git worktree and pull request support.
stars forks issues prs created last-commit release-date version license
claude-esp
by phiat		 Alternative Clients General Go-based TUI that streams Claude Code's hidden output (thinking, tool calls, subagents) to a separate terminal. Watch multiple sessions simultaneously, filter by content type, and track background tasks. Ideal for debugging or understanding what Claude is doing under the hood without interrupting your main session.
stars forks issues prs created last-commit release-date version license
Claudable
by Ethan Park		 Alternative Clients General Claudable is an open-source web builder that leverages local CLI agents, such as Claude Code and Cursor Agent, to build and deploy products effortlessly.
stars forks issues prs created last-commit release-date version license
Omnara
by Ishaan Sehgal		 Alternative Clients General A command center for AI agents that syncs Claude Code sessions across terminal, web, and mobile. Allows for remote monitoring, human-in-the-loop interaction, and team collaboration.
stars forks issues prs created last-commit release-date version license
crystal
by stravu		 Alternative Clients General A full-fledged desktop application for orchestrating, monitoring, and interacting with Claude Code agents.
stars forks issues prs created last-commit release-date version license
--- **Total Resources:** 5 **Last Generated:** 2026-03-02 ================================================ FILE: README_ALTERNATIVES/README_FLAT_CLIENTS_RELEASES.md ================================================

Pick Your Style:

Awesome Extra Classic Flat

# Awesome Claude Code (Flat) [![Awesome](https://awesome.re/badge-flat2.svg)](https://awesome.re) A flat list view of all resources. Category: **Clients** | Sorted: by latest release (30 days) --- ## Sort By:

A - Z UPDATED CREATED RELEASES

Category:

All Tooling Commands CLAUDE.md Workflows Hooks Skills Styles Status Docs Clients

Currently viewing: **Clients** sorted by latest release (30 days) (past 30 days)

--- ## Resources > **Note:** Latest release data is pulled from GitHub Releases only. Projects without GitHub Releases will not show release info here. Please verify with the project directly.
Resource Version Source Release Date Description
claude-esp
by phiat		 v0.3.1 GitHub 2026-02-28 Go-based TUI that streams Claude Code's hidden output (thinking, tool calls, subagents) to a separate terminal. Watch multiple sessions simultaneously, filter by content type, and track background tasks. Ideal for debugging or understanding what Claude is doing under the hood without interrupting your main session.
stars forks issues prs created last-commit release-date version license
crystal
by stravu		 v0.3.5 GitHub 2026-02-26 A full-fledged desktop application for orchestrating, monitoring, and interacting with Claude Code agents.
stars forks issues prs created last-commit release-date version license
--- **Total Resources:** 2 **Last Generated:** 2026-03-02 ================================================ FILE: README_ALTERNATIVES/README_FLAT_CLIENTS_UPDATED.md ================================================

Pick Your Style:

Awesome Extra Classic Flat

# Awesome Claude Code (Flat) [![Awesome](https://awesome.re/badge-flat2.svg)](https://awesome.re) A flat list view of all resources. Category: **Clients** | Sorted: by last updated date --- ## Sort By:

A - Z UPDATED CREATED RELEASES

Category:

All Tooling Commands CLAUDE.md Workflows Hooks Skills Styles Status Docs Clients

Currently viewing: **Clients** sorted by last updated date

--- ## Resources
Resource Category Sub-Category Description
claude-esp
by phiat		 Alternative Clients General Go-based TUI that streams Claude Code's hidden output (thinking, tool calls, subagents) to a separate terminal. Watch multiple sessions simultaneously, filter by content type, and track background tasks. Ideal for debugging or understanding what Claude is doing under the hood without interrupting your main session.
stars forks issues prs created last-commit release-date version license
crystal
by stravu		 Alternative Clients General A full-fledged desktop application for orchestrating, monitoring, and interacting with Claude Code agents.
stars forks issues prs created last-commit release-date version license
claude-tmux
by Niels Groeneveld		 Alternative Clients General Manage Claude Code within tmux. A tmux popup of all your Claude Code instances, enabling quick switching, status monitoring, session lifecycle management, with git worktree and pull request support.
stars forks issues prs created last-commit release-date version license
Omnara
by Ishaan Sehgal		 Alternative Clients General A command center for AI agents that syncs Claude Code sessions across terminal, web, and mobile. Allows for remote monitoring, human-in-the-loop interaction, and team collaboration.
stars forks issues prs created last-commit release-date version license
Claudable
by Ethan Park		 Alternative Clients General Claudable is an open-source web builder that leverages local CLI agents, such as Claude Code and Cursor Agent, to build and deploy products effortlessly.
stars forks issues prs created last-commit release-date version license
--- **Total Resources:** 5 **Last Generated:** 2026-03-02 ================================================ FILE: README_ALTERNATIVES/README_FLAT_COMMANDS_AZ.md ================================================

Pick Your Style:

Awesome Extra Classic Flat

# Awesome Claude Code (Flat) [![Awesome](https://awesome.re/badge-flat2.svg)](https://awesome.re) A flat list view of all resources. Category: **Commands** | Sorted: alphabetically by name --- ## Sort By:

A - Z UPDATED CREATED RELEASES

Category:

All Tooling Commands CLAUDE.md Workflows Hooks Skills Styles Status Docs Clients

Currently viewing: **Commands** sorted alphabetically by name

--- ## Resources
Resource Category Sub-Category Description
/add-to-changelog
by berrydev-ai		 Slash-Commands Documentation & Changelogs Adds new entries to changelog files while maintaining format consistency, properly documenting changes, and following established project standards for version tracking.
stars forks issues prs created last-commit release-date version license
/analyze-issue
by jerseycheese		 Slash-Commands Version Control & Git Fetches GitHub issue details to create comprehensive implementation specifications, analyzing requirements and planning structured approach with clear implementation steps.
stars forks issues prs created last-commit release-date version license
/check
by rygwdn		 Slash-Commands Code Analysis & Testing Performs comprehensive code quality and security checks, featuring static analysis integration, security vulnerability scanning, code style enforcement, and detailed reporting.
stars forks issues prs created last-commit release-date version license
/code_analysis
by kingler		 Slash-Commands Code Analysis & Testing Provides a menu of advanced code analysis commands for deep inspection, including knowledge graph generation, optimization suggestions, and quality evaluation.
stars forks issues prs created last-commit release-date version license
/commit
by evmts		 Slash-Commands Version Control & Git Creates git commits using conventional commit format with appropriate emojis, following project standards and creating descriptive messages that explain the purpose of changes.
stars forks issues prs created last-commit release-date version license
/commit-fast
by steadycursor		 Slash-Commands Version Control & Git Automates git commit process by selecting the first suggested message, generating structured commits with consistent formatting while skipping manual confirmation and removing Claude co-Contributorship footer
stars forks issues prs created last-commit release-date version license
/context-prime
by elizaOS		 Slash-Commands Context Loading & Priming Primes Claude with comprehensive project understanding by loading repository structure, setting development context, establishing project goals, and defining collaboration parameters.
stars forks issues prs created last-commit release-date version license
/create-command
by scopecraft		 Slash-Commands Project & Task Management Guides Claude through creating new custom commands with proper structure by analyzing requirements, templating commands by category, enforcing command standards, and creating supporting documentation.
stars forks issues prs created last-commit release-date version license
/create-docs
by jerseycheese		 Slash-Commands Documentation & Changelogs Analyzes code structure and purpose to create comprehensive documentation detailing inputs/outputs, behavior, user interaction flows, and edge cases with error handling.
stars forks issues prs created last-commit release-date version license
/create-hook
by Omri Lavi		 Slash-Commands General Slash command for hook creation - intelligently prompts you through the creation process with smart suggestions based on your project setup (TS, Prettier, ESLint...).
stars forks issues prs created last-commit release-date version license
/create-plan
by taddyorg		 Slash-Commands Project & Task Management Generates comprehensive product requirement documents outlining detailed specifications, requirements, and features following standardized document structure and format.
stars forks issues prs created last-commit release-date version license
/create-pr
by toyamarinyon		 Slash-Commands Version Control & Git Streamlines pull request creation by handling the entire workflow: creating a new branch, committing changes, formatting modified files with Biome, and submitting the PR.
stars forks issues prs created last-commit release-date version license
/create-prp
by Wirasm		 Slash-Commands Project & Task Management Creates product requirement plans by reading PRP methodology, following template structure, creating comprehensive requirements, and structuring product definitions for development.
stars forks issues prs created last-commit release-date version license
/create-pull-request
by liam-hq		 Slash-Commands Version Control & Git Provides comprehensive PR creation guidance with GitHub CLI, enforcing title conventions, following template structure, and offering concrete command examples with best practices.
stars forks issues prs created last-commit release-date version license
/create-worktrees
by evmts		 Slash-Commands Version Control & Git Creates git worktrees for all open PRs or specific branches, handling branches with slashes, cleaning up stale worktrees, and supporting custom branch creation for development.
stars forks issues prs created last-commit release-date version license
/do-issue
by jerseycheese		 Slash-Commands Project & Task Management Implements GitHub issues with manual review points, following a structured approach with issue number parameter and offering alternative automated mode for efficiency.
stars forks issues prs created last-commit release-date version license
/docs
by slunsford		 Slash-Commands Documentation & Changelogs Generates comprehensive documentation that follows project structure, documenting APIs and usage patterns with consistent formatting for better user understanding.
stars forks issues prs created last-commit release-date version license
/explain-issue-fix
by hackdays-io		 Slash-Commands Documentation & Changelogs Documents solution approaches for GitHub issues, explaining technical decisions, detailing challenges overcome, and providing implementation context for better understanding.
stars forks issues prs created last-commit release-date version license
/fix-github-issue
by jeremymailen		 Slash-Commands Version Control & Git Analyzes and fixes GitHub issues using a structured approach with GitHub CLI for issue details, implementing necessary code changes, running tests, and creating proper commit messages.
stars forks issues prs created last-commit release-date version license
/fix-issue
by metabase		 Slash-Commands Version Control & Git Addresses GitHub issues by taking issue number as parameter, analyzing context, implementing solution, and testing/validating the fix for proper integration.
stars forks issues prs created last-commit release-date version license
/fix-pr
by metabase		 Slash-Commands Version Control & Git Fetches and fixes unresolved PR comments by automatically retrieving feedback, addressing reviewer concerns, making targeted code improvements, and streamlining the review process.
stars forks issues prs created last-commit release-date version license
/fixing_go_in_graph
by Mjvolk3		 Slash-Commands Miscellaneous Focuses on Gene Ontology annotation integration in graph databases, handling multiple data sources, addressing graph representation issues, and ensuring correct data incorporation.
stars forks issues prs created last-commit release-date version license
/husky
by evmts		 Slash-Commands Version Control & Git Sets up and manages Husky Git hooks by configuring pre-commit hooks, establishing commit message standards, integrating with linting tools, and ensuring code quality on commits.
stars forks issues prs created last-commit release-date version license
/initref
by okuvshynov		 Slash-Commands Context Loading & Priming Initializes reference documentation structure with standard doc templates, API reference setup, documentation conventions, and placeholder content generation.
stars forks issues prs created last-commit release-date version license
/linux-desktop-slash-commands
by Daniel Rosehill		 Slash-Commands General A library of slash commands intended specifically to facilitate common and advanced operations on Linux desktop environments (although many would also be useful on Linux servers). Command groups include hardware benchmarking, filesystem organisation, and security posture validation.
stars forks issues prs created last-commit release-date version license
/load-llms-txt
by ethpandaops		 Slash-Commands Context Loading & Priming Loads LLM configuration files to context, importing specific terminology, model configurations, and establishing baseline terminology for AI discussions.
stars forks issues prs created last-commit release-date version license
/load_coo_context
by Mjvolk3		 Slash-Commands Context Loading & Priming References specific files for sparse matrix operations, explains transform usage, compares with previous approaches, and sets data formatting context for development.
stars forks issues prs created last-commit release-date version license
/load_dango_pipeline
by Mjvolk3		 Slash-Commands Context Loading & Priming Sets context for model training by referencing pipeline files, establishing working context, and preparing for pipeline work with relevant documentation.
stars forks issues prs created last-commit release-date version license
/mermaid
by GaloyMoney		 Slash-Commands Miscellaneous Generates Mermaid diagrams from SQL schema files, creating entity relationship diagrams with table properties, validating diagram compilation, and ensuring complete entity coverage.
stars forks issues prs created last-commit release-date version license
/optimize
by to4iki		 Slash-Commands Code Analysis & Testing Analyzes code performance to identify bottlenecks, proposing concrete optimizations with implementation guidance for improved application performance.
stars forks issues prs created last-commit release-date version license
/prd-generator
by Denis Redozubov		 Slash-Commands Project & Task Management A Claude Code plugin that generates comprehensive Product Requirements Documents (PRDs) from conversation context. Invoke `/create-prd` after discussing requirements and it produces a complete PRD with all standard sections including Executive Summary, User Stories, MVP Scope, Architecture, Success Criteria, and Implementation Phases.
stars forks issues prs created last-commit release-date version license
/prime
by yzyydev		 Slash-Commands Context Loading & Priming Sets up initial project context by viewing directory structure and reading key files, creating standardized context with directory visualization and key documentation focus.
stars forks issues prs created last-commit release-date version license
/project_hello_w_name
by disler		 Slash-Commands Project & Task Management Creates customizable greeting components with name input, demonstrating argument passing, component reusability, state management, and user input handling.
stars forks issues prs created last-commit release-date version license
/release
by kelp		 Slash-Commands CI / Deployment Manages software releases by updating changelogs, reviewing README changes, evaluating version increments, and documenting release changes for better version tracking.
stars forks issues prs created last-commit release-date version license
/repro-issue
by rzykov		 Slash-Commands Code Analysis & Testing Creates reproducible test cases for GitHub issues, ensuring tests fail reliably and documenting clear reproduction steps for developers.
stars forks issues prs created last-commit release-date version license
/review_dcell_model
by Mjvolk3		 Slash-Commands Miscellaneous Reviews old Dcell implementation files, comparing with newer Dango model, noting changes over time, and analyzing refactoring approaches for better code organization.
stars forks issues prs created last-commit release-date version license
/rsi
by ddisisto		 Slash-Commands Context Loading & Priming Reads all commands and key project files to optimize AI-assisted development by streamlining the process, loading command context, and setting up for better development workflow.
stars forks issues prs created last-commit release-date version license
/run-ci
by hackdays-io		 Slash-Commands CI / Deployment Activates virtual environments, runs CI-compatible check scripts, iteratively fixes errors, and ensures all tests pass before completion.
stars forks issues prs created last-commit release-date version license
/tdd
by zscott		 Slash-Commands Code Analysis & Testing Guides development using Test-Driven Development principles, enforcing Red-Green-Refactor discipline, integrating with git workflow, and managing PR creation.
stars forks issues prs created last-commit release-date version license
/tdd-implement
by jerseycheese		 Slash-Commands Code Analysis & Testing Implements Test-Driven Development by analyzing feature requirements, creating tests first (red), implementing minimal passing code (green), and refactoring while maintaining tests.
stars forks issues prs created last-commit release-date version license
/todo
by chrisleyva		 Slash-Commands Project & Task Management A convenient command to quickly manage project todo items without leaving the Claude Code interface, featuring due dates, sorting, task prioritization, and comprehensive todo list management.
stars forks issues prs created last-commit release-date version license
/update-branch-name
by giselles-ai		 Slash-Commands Version Control & Git Updates branch names with proper prefixes and formats, enforcing naming conventions, supporting semantic prefixes, and managing remote branch updates.
stars forks issues prs created last-commit release-date version license
/update-docs
by Consiliency		 Slash-Commands Documentation & Changelogs Reviews current documentation status, updates implementation progress, reviews phase documents, and maintains documentation consistency across the project.
stars forks issues prs created last-commit release-date version license
/use-stepper
by zuplo		 Slash-Commands Miscellaneous Reformats documentation to use React Stepper component, transforming heading formats, applying proper indentation, and maintaining markdown compatibility with admonition formatting.
stars forks issues prs created last-commit release-date version license
--- **Total Resources:** 44 **Last Generated:** 2026-03-02 ================================================ FILE: README_ALTERNATIVES/README_FLAT_COMMANDS_CREATED.md ================================================

Pick Your Style:

Awesome Extra Classic Flat

# Awesome Claude Code (Flat) [![Awesome](https://awesome.re/badge-flat2.svg)](https://awesome.re) A flat list view of all resources. Category: **Commands** | Sorted: by date created --- ## Sort By:

A - Z UPDATED CREATED RELEASES

Category:

All Tooling Commands CLAUDE.md Workflows Hooks Skills Styles Status Docs Clients

Currently viewing: **Commands** sorted by date created

--- ## Resources
Resource Category Sub-Category Description
/prd-generator
by Denis Redozubov		 Slash-Commands Project & Task Management A Claude Code plugin that generates comprehensive Product Requirements Documents (PRDs) from conversation context. Invoke `/create-prd` after discussing requirements and it produces a complete PRD with all standard sections including Executive Summary, User Stories, MVP Scope, Architecture, Success Criteria, and Implementation Phases.
stars forks issues prs created last-commit release-date version license
/linux-desktop-slash-commands
by Daniel Rosehill		 Slash-Commands General A library of slash commands intended specifically to facilitate common and advanced operations on Linux desktop environments (although many would also be useful on Linux servers). Command groups include hardware benchmarking, filesystem organisation, and security posture validation.
stars forks issues prs created last-commit release-date version license
/create-hook
by Omri Lavi		 Slash-Commands General Slash command for hook creation - intelligently prompts you through the creation process with smart suggestions based on your project setup (TS, Prettier, ESLint...).
stars forks issues prs created last-commit release-date version license
/todo
by chrisleyva		 Slash-Commands Project & Task Management A convenient command to quickly manage project todo items without leaving the Claude Code interface, featuring due dates, sorting, task prioritization, and comprehensive todo list management.
stars forks issues prs created last-commit release-date version license
/rsi
by ddisisto		 Slash-Commands Context Loading & Priming Reads all commands and key project files to optimize AI-assisted development by streamlining the process, loading command context, and setting up for better development workflow.
stars forks issues prs created last-commit release-date version license
/code_analysis
by kingler		 Slash-Commands Code Analysis & Testing Provides a menu of advanced code analysis commands for deep inspection, including knowledge graph generation, optimization suggestions, and quality evaluation.
stars forks issues prs created last-commit release-date version license
/update-docs
by Consiliency		 Slash-Commands Documentation & Changelogs Reviews current documentation status, updates implementation progress, reviews phase documents, and maintains documentation consistency across the project.
stars forks issues prs created last-commit release-date version license
/create-prp
by Wirasm		 Slash-Commands Project & Task Management Creates product requirement plans by reading PRP methodology, following template structure, creating comprehensive requirements, and structuring product definitions for development.
stars forks issues prs created last-commit release-date version license
/create-command
by scopecraft		 Slash-Commands Project & Task Management Guides Claude through creating new custom commands with proper structure by analyzing requirements, templating commands by category, enforcing command standards, and creating supporting documentation.
stars forks issues prs created last-commit release-date version license
/prime
by yzyydev		 Slash-Commands Context Loading & Priming Sets up initial project context by viewing directory structure and reading key files, creating standardized context with directory visualization and key documentation focus.
stars forks issues prs created last-commit release-date version license
/create-plan
by taddyorg		 Slash-Commands Project & Task Management Generates comprehensive product requirement documents outlining detailed specifications, requirements, and features following standardized document structure and format.
stars forks issues prs created last-commit release-date version license
/analyze-issue
by jerseycheese		 Slash-Commands Version Control & Git Fetches GitHub issue details to create comprehensive implementation specifications, analyzing requirements and planning structured approach with clear implementation steps.
stars forks issues prs created last-commit release-date version license
/tdd-implement
by jerseycheese		 Slash-Commands Code Analysis & Testing Implements Test-Driven Development by analyzing feature requirements, creating tests first (red), implementing minimal passing code (green), and refactoring while maintaining tests.
stars forks issues prs created last-commit release-date version license
/create-docs
by jerseycheese		 Slash-Commands Documentation & Changelogs Analyzes code structure and purpose to create comprehensive documentation detailing inputs/outputs, behavior, user interaction flows, and edge cases with error handling.
stars forks issues prs created last-commit release-date version license
/do-issue
by jerseycheese		 Slash-Commands Project & Task Management Implements GitHub issues with manual review points, following a structured approach with issue number parameter and offering alternative automated mode for efficiency.
stars forks issues prs created last-commit release-date version license
/optimize
by to4iki		 Slash-Commands Code Analysis & Testing Analyzes code performance to identify bottlenecks, proposing concrete optimizations with implementation guidance for improved application performance.
stars forks issues prs created last-commit release-date version license
/explain-issue-fix
by hackdays-io		 Slash-Commands Documentation & Changelogs Documents solution approaches for GitHub issues, explaining technical decisions, detailing challenges overcome, and providing implementation context for better understanding.
stars forks issues prs created last-commit release-date version license
/run-ci
by hackdays-io		 Slash-Commands CI / Deployment Activates virtual environments, runs CI-compatible check scripts, iteratively fixes errors, and ensures all tests pass before completion.
stars forks issues prs created last-commit release-date version license
/check
by rygwdn		 Slash-Commands Code Analysis & Testing Performs comprehensive code quality and security checks, featuring static analysis integration, security vulnerability scanning, code style enforcement, and detailed reporting.
stars forks issues prs created last-commit release-date version license
/add-to-changelog
by berrydev-ai		 Slash-Commands Documentation & Changelogs Adds new entries to changelog files while maintaining format consistency, properly documenting changes, and following established project standards for version tracking.
stars forks issues prs created last-commit release-date version license
/project_hello_w_name
by disler		 Slash-Commands Project & Task Management Creates customizable greeting components with name input, demonstrating argument passing, component reusability, state management, and user input handling.
stars forks issues prs created last-commit release-date version license
/release
by kelp		 Slash-Commands CI / Deployment Manages software releases by updating changelogs, reviewing README changes, evaluating version increments, and documenting release changes for better version tracking.
stars forks issues prs created last-commit release-date version license
/tdd
by zscott		 Slash-Commands Code Analysis & Testing Guides development using Test-Driven Development principles, enforcing Red-Green-Refactor discipline, integrating with git workflow, and managing PR creation.
stars forks issues prs created last-commit release-date version license
/context-prime
by elizaOS		 Slash-Commands Context Loading & Priming Primes Claude with comprehensive project understanding by loading repository structure, setting development context, establishing project goals, and defining collaboration parameters.
stars forks issues prs created last-commit release-date version license
/create-pull-request
by liam-hq		 Slash-Commands Version Control & Git Provides comprehensive PR creation guidance with GitHub CLI, enforcing title conventions, following template structure, and offering concrete command examples with best practices.
stars forks issues prs created last-commit release-date version license
/mermaid
by GaloyMoney		 Slash-Commands Miscellaneous Generates Mermaid diagrams from SQL schema files, creating entity relationship diagrams with table properties, validating diagram compilation, and ensuring complete entity coverage.
stars forks issues prs created last-commit release-date version license
/commit-fast
by steadycursor		 Slash-Commands Version Control & Git Automates git commit process by selecting the first suggested message, generating structured commits with consistent formatting while skipping manual confirmation and removing Claude co-Contributorship footer
stars forks issues prs created last-commit release-date version license
/load-llms-txt
by ethpandaops		 Slash-Commands Context Loading & Priming Loads LLM configuration files to context, importing specific terminology, model configurations, and establishing baseline terminology for AI discussions.
stars forks issues prs created last-commit release-date version license
/create-pr
by toyamarinyon		 Slash-Commands Version Control & Git Streamlines pull request creation by handling the entire workflow: creating a new branch, committing changes, formatting modified files with Biome, and submitting the PR.
stars forks issues prs created last-commit release-date version license
/update-branch-name
by giselles-ai		 Slash-Commands Version Control & Git Updates branch names with proper prefixes and formats, enforcing naming conventions, supporting semantic prefixes, and managing remote branch updates.
stars forks issues prs created last-commit release-date version license
/docs
by slunsford		 Slash-Commands Documentation & Changelogs Generates comprehensive documentation that follows project structure, documenting APIs and usage patterns with consistent formatting for better user understanding.
stars forks issues prs created last-commit release-date version license
/load_coo_context
by Mjvolk3		 Slash-Commands Context Loading & Priming References specific files for sparse matrix operations, explains transform usage, compares with previous approaches, and sets data formatting context for development.
stars forks issues prs created last-commit release-date version license
/load_dango_pipeline
by Mjvolk3		 Slash-Commands Context Loading & Priming Sets context for model training by referencing pipeline files, establishing working context, and preparing for pipeline work with relevant documentation.
stars forks issues prs created last-commit release-date version license
/fixing_go_in_graph
by Mjvolk3		 Slash-Commands Miscellaneous Focuses on Gene Ontology annotation integration in graph databases, handling multiple data sources, addressing graph representation issues, and ensuring correct data incorporation.
stars forks issues prs created last-commit release-date version license
/review_dcell_model
by Mjvolk3		 Slash-Commands Miscellaneous Reviews old Dcell implementation files, comparing with newer Dango model, noting changes over time, and analyzing refactoring approaches for better code organization.
stars forks issues prs created last-commit release-date version license
/commit
by evmts		 Slash-Commands Version Control & Git Creates git commits using conventional commit format with appropriate emojis, following project standards and creating descriptive messages that explain the purpose of changes.
stars forks issues prs created last-commit release-date version license
/create-worktrees
by evmts		 Slash-Commands Version Control & Git Creates git worktrees for all open PRs or specific branches, handling branches with slashes, cleaning up stale worktrees, and supporting custom branch creation for development.
stars forks issues prs created last-commit release-date version license
/husky
by evmts		 Slash-Commands Version Control & Git Sets up and manages Husky Git hooks by configuring pre-commit hooks, establishing commit message standards, integrating with linting tools, and ensuring code quality on commits.
stars forks issues prs created last-commit release-date version license
/initref
by okuvshynov		 Slash-Commands Context Loading & Priming Initializes reference documentation structure with standard doc templates, API reference setup, documentation conventions, and placeholder content generation.
stars forks issues prs created last-commit release-date version license
/use-stepper
by zuplo		 Slash-Commands Miscellaneous Reformats documentation to use React Stepper component, transforming heading formats, applying proper indentation, and maintaining markdown compatibility with admonition formatting.
stars forks issues prs created last-commit release-date version license
/fix-github-issue
by jeremymailen		 Slash-Commands Version Control & Git Analyzes and fixes GitHub issues using a structured approach with GitHub CLI for issue details, implementing necessary code changes, running tests, and creating proper commit messages.
stars forks issues prs created last-commit release-date version license
/fix-issue
by metabase		 Slash-Commands Version Control & Git Addresses GitHub issues by taking issue number as parameter, analyzing context, implementing solution, and testing/validating the fix for proper integration.
stars forks issues prs created last-commit release-date version license
/fix-pr
by metabase		 Slash-Commands Version Control & Git Fetches and fixes unresolved PR comments by automatically retrieving feedback, addressing reviewer concerns, making targeted code improvements, and streamlining the review process.
stars forks issues prs created last-commit release-date version license
/repro-issue
by rzykov		 Slash-Commands Code Analysis & Testing Creates reproducible test cases for GitHub issues, ensuring tests fail reliably and documenting clear reproduction steps for developers.
stars forks issues prs created last-commit release-date version license
--- **Total Resources:** 44 **Last Generated:** 2026-03-02 ================================================ FILE: README_ALTERNATIVES/README_FLAT_COMMANDS_RELEASES.md ================================================

Pick Your Style:

Awesome Extra Classic Flat

# Awesome Claude Code (Flat) [![Awesome](https://awesome.re/badge-flat2.svg)](https://awesome.re) A flat list view of all resources. Category: **Commands** | Sorted: by latest release (30 days) --- ## Sort By:

A - Z UPDATED CREATED RELEASES

Category:

All Tooling Commands CLAUDE.md Workflows Hooks Skills Styles Status Docs Clients

Currently viewing: **Commands** sorted by latest release (30 days) (past 30 days)

--- ## Resources > **Note:** Latest release data is pulled from GitHub Releases only. Projects without GitHub Releases will not show release info here. Please verify with the project directly.
Resource Version Source Release Date Description
/update-branch-name
by giselles-ai		 v0.67.0 GitHub 2026-02-27 Updates branch names with proper prefixes and formats, enforcing naming conventions, supporting semantic prefixes, and managing remote branch updates.
stars forks issues prs created last-commit release-date version license
/fix-issue
by metabase		 v0.58.6 GitHub 2026-02-12 Addresses GitHub issues by taking issue number as parameter, analyzing context, implementing solution, and testing/validating the fix for proper integration.
stars forks issues prs created last-commit release-date version license
/fix-pr
by metabase		 v0.58.6 GitHub 2026-02-12 Fetches and fixes unresolved PR comments by automatically retrieving feedback, addressing reviewer concerns, making targeted code improvements, and streamlining the review process.
stars forks issues prs created last-commit release-date version license
/mermaid
by GaloyMoney		 0.40.1 GitHub 2026-02-12 Generates Mermaid diagrams from SQL schema files, creating entity relationship diagrams with table properties, validating diagram compilation, and ensuring complete entity coverage.
stars forks issues prs created last-commit release-date version license
/fix-github-issue
by jeremymailen		 5.4.2 GitHub 2026-02-10 Analyzes and fixes GitHub issues using a structured approach with GitHub CLI for issue details, implementing necessary code changes, running tests, and creating proper commit messages.
stars forks issues prs created last-commit release-date version license
--- **Total Resources:** 5 **Last Generated:** 2026-03-02 ================================================ FILE: README_ALTERNATIVES/README_FLAT_COMMANDS_UPDATED.md ================================================

Pick Your Style:

Awesome Extra Classic Flat

# Awesome Claude Code (Flat) [![Awesome](https://awesome.re/badge-flat2.svg)](https://awesome.re) A flat list view of all resources. Category: **Commands** | Sorted: by last updated date --- ## Sort By:

A - Z UPDATED CREATED RELEASES

Category:

All Tooling Commands CLAUDE.md Workflows Hooks Skills Styles Status Docs Clients

Currently viewing: **Commands** sorted by last updated date

--- ## Resources
Resource Category Sub-Category Description
/analyze-issue
by jerseycheese		 Slash-Commands Version Control & Git Fetches GitHub issue details to create comprehensive implementation specifications, analyzing requirements and planning structured approach with clear implementation steps.
stars forks issues prs created last-commit release-date version license
/tdd-implement
by jerseycheese		 Slash-Commands Code Analysis & Testing Implements Test-Driven Development by analyzing feature requirements, creating tests first (red), implementing minimal passing code (green), and refactoring while maintaining tests.
stars forks issues prs created last-commit release-date version license
/create-docs
by jerseycheese		 Slash-Commands Documentation & Changelogs Analyzes code structure and purpose to create comprehensive documentation detailing inputs/outputs, behavior, user interaction flows, and edge cases with error handling.
stars forks issues prs created last-commit release-date version license
/do-issue
by jerseycheese		 Slash-Commands Project & Task Management Implements GitHub issues with manual review points, following a structured approach with issue number parameter and offering alternative automated mode for efficiency.
stars forks issues prs created last-commit release-date version license
/create-plan
by taddyorg		 Slash-Commands Project & Task Management Generates comprehensive product requirement documents outlining detailed specifications, requirements, and features following standardized document structure and format.
stars forks issues prs created last-commit release-date version license
/prd-generator
by Denis Redozubov		 Slash-Commands Project & Task Management A Claude Code plugin that generates comprehensive Product Requirements Documents (PRDs) from conversation context. Invoke `/create-prd` after discussing requirements and it produces a complete PRD with all standard sections including Executive Summary, User Stories, MVP Scope, Architecture, Success Criteria, and Implementation Phases.
stars forks issues prs created last-commit release-date version license
/linux-desktop-slash-commands
by Daniel Rosehill		 Slash-Commands General A library of slash commands intended specifically to facilitate common and advanced operations on Linux desktop environments (although many would also be useful on Linux servers). Command groups include hardware benchmarking, filesystem organisation, and security posture validation.
stars forks issues prs created last-commit release-date version license
/create-hook
by Omri Lavi		 Slash-Commands General Slash command for hook creation - intelligently prompts you through the creation process with smart suggestions based on your project setup (TS, Prettier, ESLint...).
stars forks issues prs created last-commit release-date version license
/prime
by yzyydev		 Slash-Commands Context Loading & Priming Sets up initial project context by viewing directory structure and reading key files, creating standardized context with directory visualization and key documentation focus.
stars forks issues prs created last-commit release-date version license
/create-pull-request
by liam-hq		 Slash-Commands Version Control & Git Provides comprehensive PR creation guidance with GitHub CLI, enforcing title conventions, following template structure, and offering concrete command examples with best practices.
stars forks issues prs created last-commit release-date version license
/create-command
by scopecraft		 Slash-Commands Project & Task Management Guides Claude through creating new custom commands with proper structure by analyzing requirements, templating commands by category, enforcing command standards, and creating supporting documentation.
stars forks issues prs created last-commit release-date version license
/todo
by chrisleyva		 Slash-Commands Project & Task Management A convenient command to quickly manage project todo items without leaving the Claude Code interface, featuring due dates, sorting, task prioritization, and comprehensive todo list management.
stars forks issues prs created last-commit release-date version license
/docs
by slunsford		 Slash-Commands Documentation & Changelogs Generates comprehensive documentation that follows project structure, documenting APIs and usage patterns with consistent formatting for better user understanding.
stars forks issues prs created last-commit release-date version license
/create-prp
by Wirasm		 Slash-Commands Project & Task Management Creates product requirement plans by reading PRP methodology, following template structure, creating comprehensive requirements, and structuring product definitions for development.
stars forks issues prs created last-commit release-date version license
/update-docs
by Consiliency		 Slash-Commands Documentation & Changelogs Reviews current documentation status, updates implementation progress, reviews phase documents, and maintains documentation consistency across the project.
stars forks issues prs created last-commit release-date version license
/rsi
by ddisisto		 Slash-Commands Context Loading & Priming Reads all commands and key project files to optimize AI-assisted development by streamlining the process, loading command context, and setting up for better development workflow.
stars forks issues prs created last-commit release-date version license
/code_analysis
by kingler		 Slash-Commands Code Analysis & Testing Provides a menu of advanced code analysis commands for deep inspection, including knowledge graph generation, optimization suggestions, and quality evaluation.
stars forks issues prs created last-commit release-date version license
/fixing_go_in_graph
by Mjvolk3		 Slash-Commands Miscellaneous Focuses on Gene Ontology annotation integration in graph databases, handling multiple data sources, addressing graph representation issues, and ensuring correct data incorporation.
stars forks issues prs created last-commit release-date version license
/review_dcell_model
by Mjvolk3		 Slash-Commands Miscellaneous Reviews old Dcell implementation files, comparing with newer Dango model, noting changes over time, and analyzing refactoring approaches for better code organization.
stars forks issues prs created last-commit release-date version license
/load-llms-txt
by ethpandaops		 Slash-Commands Context Loading & Priming Loads LLM configuration files to context, importing specific terminology, model configurations, and establishing baseline terminology for AI discussions.
stars forks issues prs created last-commit release-date version license
/load_dango_pipeline
by Mjvolk3		 Slash-Commands Context Loading & Priming Sets context for model training by referencing pipeline files, establishing working context, and preparing for pipeline work with relevant documentation.
stars forks issues prs created last-commit release-date version license
/load_coo_context
by Mjvolk3		 Slash-Commands Context Loading & Priming References specific files for sparse matrix operations, explains transform usage, compares with previous approaches, and sets data formatting context for development.
stars forks issues prs created last-commit release-date version license
/check
by rygwdn		 Slash-Commands Code Analysis & Testing Performs comprehensive code quality and security checks, featuring static analysis integration, security vulnerability scanning, code style enforcement, and detailed reporting.
stars forks issues prs created last-commit release-date version license
/add-to-changelog
by berrydev-ai		 Slash-Commands Documentation & Changelogs Adds new entries to changelog files while maintaining format consistency, properly documenting changes, and following established project standards for version tracking.
stars forks issues prs created last-commit release-date version license
/optimize
by to4iki		 Slash-Commands Code Analysis & Testing Analyzes code performance to identify bottlenecks, proposing concrete optimizations with implementation guidance for improved application performance.
stars forks issues prs created last-commit release-date version license
/fix-github-issue
by jeremymailen		 Slash-Commands Version Control & Git Analyzes and fixes GitHub issues using a structured approach with GitHub CLI for issue details, implementing necessary code changes, running tests, and creating proper commit messages.
stars forks issues prs created last-commit release-date version license
/explain-issue-fix
by hackdays-io		 Slash-Commands Documentation & Changelogs Documents solution approaches for GitHub issues, explaining technical decisions, detailing challenges overcome, and providing implementation context for better understanding.
stars forks issues prs created last-commit release-date version license
/run-ci
by hackdays-io		 Slash-Commands CI / Deployment Activates virtual environments, runs CI-compatible check scripts, iteratively fixes errors, and ensures all tests pass before completion.
stars forks issues prs created last-commit release-date version license
/use-stepper
by zuplo		 Slash-Commands Miscellaneous Reformats documentation to use React Stepper component, transforming heading formats, applying proper indentation, and maintaining markdown compatibility with admonition formatting.
stars forks issues prs created last-commit release-date version license
/initref
by okuvshynov		 Slash-Commands Context Loading & Priming Initializes reference documentation structure with standard doc templates, API reference setup, documentation conventions, and placeholder content generation.
stars forks issues prs created last-commit release-date version license
/update-branch-name
by giselles-ai		 Slash-Commands Version Control & Git Updates branch names with proper prefixes and formats, enforcing naming conventions, supporting semantic prefixes, and managing remote branch updates.
stars forks issues prs created last-commit release-date version license
/fix-issue
by metabase		 Slash-Commands Version Control & Git Addresses GitHub issues by taking issue number as parameter, analyzing context, implementing solution, and testing/validating the fix for proper integration.
stars forks issues prs created last-commit release-date version license
/fix-pr
by metabase		 Slash-Commands Version Control & Git Fetches and fixes unresolved PR comments by automatically retrieving feedback, addressing reviewer concerns, making targeted code improvements, and streamlining the review process.
stars forks issues prs created last-commit release-date version license
/repro-issue
by rzykov		 Slash-Commands Code Analysis & Testing Creates reproducible test cases for GitHub issues, ensuring tests fail reliably and documenting clear reproduction steps for developers.
stars forks issues prs created last-commit release-date version license
/commit-fast
by steadycursor		 Slash-Commands Version Control & Git Automates git commit process by selecting the first suggested message, generating structured commits with consistent formatting while skipping manual confirmation and removing Claude co-Contributorship footer
stars forks issues prs created last-commit release-date version license
/create-pr
by toyamarinyon		 Slash-Commands Version Control & Git Streamlines pull request creation by handling the entire workflow: creating a new branch, committing changes, formatting modified files with Biome, and submitting the PR.
stars forks issues prs created last-commit release-date version license
/context-prime
by elizaOS		 Slash-Commands Context Loading & Priming Primes Claude with comprehensive project understanding by loading repository structure, setting development context, establishing project goals, and defining collaboration parameters.
stars forks issues prs created last-commit release-date version license
/mermaid
by GaloyMoney		 Slash-Commands Miscellaneous Generates Mermaid diagrams from SQL schema files, creating entity relationship diagrams with table properties, validating diagram compilation, and ensuring complete entity coverage.
stars forks issues prs created last-commit release-date version license
/commit
by evmts		 Slash-Commands Version Control & Git Creates git commits using conventional commit format with appropriate emojis, following project standards and creating descriptive messages that explain the purpose of changes.
stars forks issues prs created last-commit release-date version license
/release
by kelp		 Slash-Commands CI / Deployment Manages software releases by updating changelogs, reviewing README changes, evaluating version increments, and documenting release changes for better version tracking.
stars forks issues prs created last-commit release-date version license
/project_hello_w_name
by disler		 Slash-Commands Project & Task Management Creates customizable greeting components with name input, demonstrating argument passing, component reusability, state management, and user input handling.
stars forks issues prs created last-commit release-date version license
/create-worktrees
by evmts		 Slash-Commands Version Control & Git Creates git worktrees for all open PRs or specific branches, handling branches with slashes, cleaning up stale worktrees, and supporting custom branch creation for development.
stars forks issues prs created last-commit release-date version license
/husky
by evmts		 Slash-Commands Version Control & Git Sets up and manages Husky Git hooks by configuring pre-commit hooks, establishing commit message standards, integrating with linting tools, and ensuring code quality on commits.
stars forks issues prs created last-commit release-date version license
/tdd
by zscott		 Slash-Commands Code Analysis & Testing Guides development using Test-Driven Development principles, enforcing Red-Green-Refactor discipline, integrating with git workflow, and managing PR creation.
stars forks issues prs created last-commit release-date version license
--- **Total Resources:** 44 **Last Generated:** 2026-03-02 ================================================ FILE: README_ALTERNATIVES/README_FLAT_DOCS_AZ.md ================================================

Pick Your Style:

Awesome Extra Classic Flat

# Awesome Claude Code (Flat) [![Awesome](https://awesome.re/badge-flat2.svg)](https://awesome.re) A flat list view of all resources. Category: **Docs** | Sorted: alphabetically by name --- ## Sort By:

A - Z UPDATED CREATED RELEASES

Category:

All Tooling Commands CLAUDE.md Workflows Hooks Skills Styles Status Docs Clients

Currently viewing: **Docs** sorted alphabetically by name

--- ## Resources
Resource Category Sub-Category Description
Anthropic Documentation
by Anthropic		 Official Documentation General The official documentation for Claude Code, including installation instructions, usage guidelines, API references, tutorials, examples, loads of information that I won't list individually. Like Claude Code, the documentation is frequently updated.
Anthropic Quickstarts
by Anthropic		 Official Documentation General Offers comprehensive development guides for three distinct AI-powered demo projects with standardized workflows, strict code style guidelines, and containerization instructions.
stars forks issues prs created last-commit release-date version license
Claude Code GitHub Actions
by Anthropic		 Official Documentation General Official GitHub Actions integration for Claude Code with examples and documentation for automating AI-powered workflows in CI/CD pipelines.
stars forks issues prs created last-commit release-date version license
--- **Total Resources:** 3 **Last Generated:** 2026-03-02 ================================================ FILE: README_ALTERNATIVES/README_FLAT_DOCS_CREATED.md ================================================

Pick Your Style:

Awesome Extra Classic Flat

# Awesome Claude Code (Flat) [![Awesome](https://awesome.re/badge-flat2.svg)](https://awesome.re) A flat list view of all resources. Category: **Docs** | Sorted: by date created --- ## Sort By:

A - Z UPDATED CREATED RELEASES

Category:

All Tooling Commands CLAUDE.md Workflows Hooks Skills Styles Status Docs Clients

Currently viewing: **Docs** sorted by date created

--- ## Resources
Resource Category Sub-Category Description
Anthropic Documentation
by Anthropic		 Official Documentation General The official documentation for Claude Code, including installation instructions, usage guidelines, API references, tutorials, examples, loads of information that I won't list individually. Like Claude Code, the documentation is frequently updated.
Claude Code GitHub Actions
by Anthropic		 Official Documentation General Official GitHub Actions integration for Claude Code with examples and documentation for automating AI-powered workflows in CI/CD pipelines.
stars forks issues prs created last-commit release-date version license
Anthropic Quickstarts
by Anthropic		 Official Documentation General Offers comprehensive development guides for three distinct AI-powered demo projects with standardized workflows, strict code style guidelines, and containerization instructions.
stars forks issues prs created last-commit release-date version license
--- **Total Resources:** 3 **Last Generated:** 2026-03-02 ================================================ FILE: README_ALTERNATIVES/README_FLAT_DOCS_RELEASES.md ================================================

Pick Your Style:

Awesome Extra Classic Flat

# Awesome Claude Code (Flat) [![Awesome](https://awesome.re/badge-flat2.svg)](https://awesome.re) A flat list view of all resources. Category: **Docs** | Sorted: by latest release (30 days) --- ## Sort By:

A - Z UPDATED CREATED RELEASES

Category:

All Tooling Commands CLAUDE.md Workflows Hooks Skills Styles Status Docs Clients

Currently viewing: **Docs** sorted by latest release (30 days) (past 30 days)

--- ## Resources > **Note:** Latest release data is pulled from GitHub Releases only. Projects without GitHub Releases will not show release info here. Please verify with the project directly. *No releases in the past 30 days for this category.* --- **Total Resources:** 0 **Last Generated:** 2026-03-02 ================================================ FILE: README_ALTERNATIVES/README_FLAT_DOCS_UPDATED.md ================================================

Pick Your Style:

Awesome Extra Classic Flat

# Awesome Claude Code (Flat) [![Awesome](https://awesome.re/badge-flat2.svg)](https://awesome.re) A flat list view of all resources. Category: **Docs** | Sorted: by last updated date --- ## Sort By:

A - Z UPDATED CREATED RELEASES

Category:

All Tooling Commands CLAUDE.md Workflows Hooks Skills Styles Status Docs Clients

Currently viewing: **Docs** sorted by last updated date

--- ## Resources
Resource Category Sub-Category Description
Anthropic Documentation
by Anthropic		 Official Documentation General The official documentation for Claude Code, including installation instructions, usage guidelines, API references, tutorials, examples, loads of information that I won't list individually. Like Claude Code, the documentation is frequently updated.
Claude Code GitHub Actions
by Anthropic		 Official Documentation General Official GitHub Actions integration for Claude Code with examples and documentation for automating AI-powered workflows in CI/CD pipelines.
stars forks issues prs created last-commit release-date version license
Anthropic Quickstarts
by Anthropic		 Official Documentation General Offers comprehensive development guides for three distinct AI-powered demo projects with standardized workflows, strict code style guidelines, and containerization instructions.
stars forks issues prs created last-commit release-date version license
--- **Total Resources:** 3 **Last Generated:** 2026-03-02 ================================================ FILE: README_ALTERNATIVES/README_FLAT_HOOKS_AZ.md ================================================

Pick Your Style:

Awesome Extra Classic Flat

# Awesome Claude Code (Flat) [![Awesome](https://awesome.re/badge-flat2.svg)](https://awesome.re) A flat list view of all resources. Category: **Hooks** | Sorted: alphabetically by name --- ## Sort By:

A - Z UPDATED CREATED RELEASES

Category:

All Tooling Commands CLAUDE.md Workflows Hooks Skills Styles Status Docs Clients

Currently viewing: **Hooks** sorted alphabetically by name

--- ## Resources
Resource Category Sub-Category Description
Britfix
by Talieisin		 Hooks General Claude outputs American spellings by default, which can have an impact on: professional credibility, compliance, documentation, and more. Britfix converts to British English, with a Claude Code hook for automatic conversion as files are written. Context-aware: handles code files intelligently by only converting comments and docstrings, never identifiers or string literals.
stars forks issues prs created last-commit release-date version license
CC Notify
by dazuiba		 Hooks General CCNotify provides desktop notifications for Claude Code, alerting you to input needs or task completion, with one-click jumps back to VS Code and task duration display.
stars forks issues prs created last-commit release-date version license
cchooks
by GowayLee		 Hooks General A lightweight Python SDK with a clean API and good documentation; simplifies the process of writing hooks and integrating them into your codebase, providing a nice abstraction over the JSON configuration files.
stars forks issues prs created last-commit release-date version license
Claude Code Hook Comms (HCOM)
by aannoo		 Hooks General Lightweight CLI tool for real-time communication between Claude Code sub agents using hooks. Enables multi-agent collaboration with @-mention targeting, live dashboard monitoring, and zero-dependency implementation. [NOTE: At the time of posting, this resource is a little unstable - I'm sharing it anyway, because I think it's incredibly promising and creative. I hope by the time you read this, it is production-ready.]
stars forks issues prs created last-commit release-date version license
claude-code-hooks-sdk
by beyondcode		 Hooks General A Laravel-inspired PHP SDK for building Claude Code hook responses with a clean, fluent API. This SDK makes it easy to create structured JSON responses for Claude Code hooks using an expressive, chainable interface.
stars forks issues prs created last-commit release-date version license
claude-hooks
by John Lindquist		 Hooks General A TypeScript-based system for configuring and customizing Claude Code hooks with a powerful and flexible interface.
stars forks issues prs created last-commit release-date version license
Claudio
by Christopher Toth		 Hooks General A no-frills little library that adds delightful OS-native sounds to Claude Code via simple hooks. It really sparks joy.
stars forks issues prs created last-commit release-date version license
Dippy
by Lily Dayton		 Hooks General Auto-approve safe bash commands using AST-based parsing, while prompting for destructive operations. Solves permission fatigue without disabling safety. Supports Claude Code, Gemini CLI, and Cursor.
stars forks issues prs created last-commit release-date version license
parry
by Dmytro Onypko		 Hooks General Prompt injection scanner for Claude Code hooks. Scans tool inputs and outputs for injection attacks, secrets, and data exfiltration attempts. [NOTE: Early development phase but worth a look.]
stars forks issues prs created last-commit release-date version license
Plannotator
by backnotprop		 Hooks - Interactive plan review UI that intercepts ExitPlanMode via hooks, letting users visually annotate plans with comments, deletions, and replacements before approving or denying with detailed feedback.
stars forks issues prs created last-commit release-date version license
TDD Guard
by Nizar Selander		 Hooks General A hooks-driven system that monitors file operations in real-time and blocks changes that violate TDD principles.
stars forks issues prs created last-commit release-date version license
TypeScript Quality Hooks
by bartolli		 Hooks General Quality check hook for Node.js TypeScript projects with TypeScript compilation. ESLint auto-fixing, and Prettier formatting. Uses SHA256 config caching for < 5ms validation performance during real-time editing.
stars forks issues prs created last-commit release-date version license
--- **Total Resources:** 12 **Last Generated:** 2026-03-02 ================================================ FILE: README_ALTERNATIVES/README_FLAT_HOOKS_CREATED.md ================================================

Pick Your Style:

Awesome Extra Classic Flat

# Awesome Claude Code (Flat) [![Awesome](https://awesome.re/badge-flat2.svg)](https://awesome.re) A flat list view of all resources. Category: **Hooks** | Sorted: by date created --- ## Sort By:

A - Z UPDATED CREATED RELEASES

Category:

All Tooling Commands CLAUDE.md Workflows Hooks Skills Styles Status Docs Clients

Currently viewing: **Hooks** sorted by date created

--- ## Resources
Resource Category Sub-Category Description
parry
by Dmytro Onypko		 Hooks General Prompt injection scanner for Claude Code hooks. Scans tool inputs and outputs for injection attacks, secrets, and data exfiltration attempts. [NOTE: Early development phase but worth a look.]
stars forks issues prs created last-commit release-date version license
Dippy
by Lily Dayton		 Hooks General Auto-approve safe bash commands using AST-based parsing, while prompting for destructive operations. Solves permission fatigue without disabling safety. Supports Claude Code, Gemini CLI, and Cursor.
stars forks issues prs created last-commit release-date version license
Plannotator
by backnotprop		 Hooks - Interactive plan review UI that intercepts ExitPlanMode via hooks, letting users visually annotate plans with comments, deletions, and replacements before approving or denying with detailed feedback.
stars forks issues prs created last-commit release-date version license
Britfix
by Talieisin		 Hooks General Claude outputs American spellings by default, which can have an impact on: professional credibility, compliance, documentation, and more. Britfix converts to British English, with a Claude Code hook for automatic conversion as files are written. Context-aware: handles code files intelligently by only converting comments and docstrings, never identifiers or string literals.
stars forks issues prs created last-commit release-date version license
Claudio
by Christopher Toth		 Hooks General A no-frills little library that adds delightful OS-native sounds to Claude Code via simple hooks. It really sparks joy.
stars forks issues prs created last-commit release-date version license
CC Notify
by dazuiba		 Hooks General CCNotify provides desktop notifications for Claude Code, alerting you to input needs or task completion, with one-click jumps back to VS Code and task duration display.
stars forks issues prs created last-commit release-date version license
Claude Code Hook Comms (HCOM)
by aannoo		 Hooks General Lightweight CLI tool for real-time communication between Claude Code sub agents using hooks. Enables multi-agent collaboration with @-mention targeting, live dashboard monitoring, and zero-dependency implementation. [NOTE: At the time of posting, this resource is a little unstable - I'm sharing it anyway, because I think it's incredibly promising and creative. I hope by the time you read this, it is production-ready.]
stars forks issues prs created last-commit release-date version license
TypeScript Quality Hooks
by bartolli		 Hooks General Quality check hook for Node.js TypeScript projects with TypeScript compilation. ESLint auto-fixing, and Prettier formatting. Uses SHA256 config caching for < 5ms validation performance during real-time editing.
stars forks issues prs created last-commit release-date version license
cchooks
by GowayLee		 Hooks General A lightweight Python SDK with a clean API and good documentation; simplifies the process of writing hooks and integrating them into your codebase, providing a nice abstraction over the JSON configuration files.
stars forks issues prs created last-commit release-date version license
claude-hooks
by John Lindquist		 Hooks General A TypeScript-based system for configuring and customizing Claude Code hooks with a powerful and flexible interface.
stars forks issues prs created last-commit release-date version license
claude-code-hooks-sdk
by beyondcode		 Hooks General A Laravel-inspired PHP SDK for building Claude Code hook responses with a clean, fluent API. This SDK makes it easy to create structured JSON responses for Claude Code hooks using an expressive, chainable interface.
stars forks issues prs created last-commit release-date version license
TDD Guard
by Nizar Selander		 Hooks General A hooks-driven system that monitors file operations in real-time and blocks changes that violate TDD principles.
stars forks issues prs created last-commit release-date version license
--- **Total Resources:** 12 **Last Generated:** 2026-03-02 ================================================ FILE: README_ALTERNATIVES/README_FLAT_HOOKS_RELEASES.md ================================================

Pick Your Style:

Awesome Extra Classic Flat

# Awesome Claude Code (Flat) [![Awesome](https://awesome.re/badge-flat2.svg)](https://awesome.re) A flat list view of all resources. Category: **Hooks** | Sorted: by latest release (30 days) --- ## Sort By:

A - Z UPDATED CREATED RELEASES

Category:

All Tooling Commands CLAUDE.md Workflows Hooks Skills Styles Status Docs Clients

Currently viewing: **Hooks** sorted by latest release (30 days) (past 30 days)

--- ## Resources > **Note:** Latest release data is pulled from GitHub Releases only. Projects without GitHub Releases will not show release info here. Please verify with the project directly.
Resource Version Source Release Date Description
Plannotator
by backnotprop		 v0.9.3 GitHub 2026-02-27 Interactive plan review UI that intercepts ExitPlanMode via hooks, letting users visually annotate plans with comments, deletions, and replacements before approving or denying with detailed feedback.
stars forks issues prs created last-commit release-date version license
Claude Code Hook Comms (HCOM)
by aannoo		 v0.6.22 GitHub 2026-02-22 Lightweight CLI tool for real-time communication between Claude Code sub agents using hooks. Enables multi-agent collaboration with @-mention targeting, live dashboard monitoring, and zero-dependency implementation. [NOTE: At the time of posting, this resource is a little unstable - I'm sharing it anyway, because I think it's incredibly promising and creative. I hope by the time you read this, it is production-ready.]
stars forks issues prs created last-commit release-date version license
Dippy
by Lily Dayton		 v0.2.5 GitHub 2026-02-01 Auto-approve safe bash commands using AST-based parsing, while prompting for destructive operations. Solves permission fatigue without disabling safety. Supports Claude Code, Gemini CLI, and Cursor.
stars forks issues prs created last-commit release-date version license
--- **Total Resources:** 3 **Last Generated:** 2026-03-02 ================================================ FILE: README_ALTERNATIVES/README_FLAT_HOOKS_UPDATED.md ================================================

Pick Your Style:

Awesome Extra Classic Flat

# Awesome Claude Code (Flat) [![Awesome](https://awesome.re/badge-flat2.svg)](https://awesome.re) A flat list view of all resources. Category: **Hooks** | Sorted: by last updated date --- ## Sort By:

A - Z UPDATED CREATED RELEASES

Category:

All Tooling Commands CLAUDE.md Workflows Hooks Skills Styles Status Docs Clients

Currently viewing: **Hooks** sorted by last updated date

--- ## Resources
Resource Category Sub-Category Description
Plannotator
by backnotprop		 Hooks - Interactive plan review UI that intercepts ExitPlanMode via hooks, letting users visually annotate plans with comments, deletions, and replacements before approving or denying with detailed feedback.
stars forks issues prs created last-commit release-date version license
parry
by Dmytro Onypko		 Hooks General Prompt injection scanner for Claude Code hooks. Scans tool inputs and outputs for injection attacks, secrets, and data exfiltration attempts. [NOTE: Early development phase but worth a look.]
stars forks issues prs created last-commit release-date version license
TDD Guard
by Nizar Selander		 Hooks General A hooks-driven system that monitors file operations in real-time and blocks changes that violate TDD principles.
stars forks issues prs created last-commit release-date version license
Claude Code Hook Comms (HCOM)
by aannoo		 Hooks General Lightweight CLI tool for real-time communication between Claude Code sub agents using hooks. Enables multi-agent collaboration with @-mention targeting, live dashboard monitoring, and zero-dependency implementation. [NOTE: At the time of posting, this resource is a little unstable - I'm sharing it anyway, because I think it's incredibly promising and creative. I hope by the time you read this, it is production-ready.]
stars forks issues prs created last-commit release-date version license
Claudio
by Christopher Toth		 Hooks General A no-frills little library that adds delightful OS-native sounds to Claude Code via simple hooks. It really sparks joy.
stars forks issues prs created last-commit release-date version license
Dippy
by Lily Dayton		 Hooks General Auto-approve safe bash commands using AST-based parsing, while prompting for destructive operations. Solves permission fatigue without disabling safety. Supports Claude Code, Gemini CLI, and Cursor.
stars forks issues prs created last-commit release-date version license
Britfix
by Talieisin		 Hooks General Claude outputs American spellings by default, which can have an impact on: professional credibility, compliance, documentation, and more. Britfix converts to British English, with a Claude Code hook for automatic conversion as files are written. Context-aware: handles code files intelligently by only converting comments and docstrings, never identifiers or string literals.
stars forks issues prs created last-commit release-date version license
claude-code-hooks-sdk
by beyondcode		 Hooks General A Laravel-inspired PHP SDK for building Claude Code hook responses with a clean, fluent API. This SDK makes it easy to create structured JSON responses for Claude Code hooks using an expressive, chainable interface.
stars forks issues prs created last-commit release-date version license
cchooks
by GowayLee		 Hooks General A lightweight Python SDK with a clean API and good documentation; simplifies the process of writing hooks and integrating them into your codebase, providing a nice abstraction over the JSON configuration files.
stars forks issues prs created last-commit release-date version license
CC Notify
by dazuiba		 Hooks General CCNotify provides desktop notifications for Claude Code, alerting you to input needs or task completion, with one-click jumps back to VS Code and task duration display.
stars forks issues prs created last-commit release-date version license
TypeScript Quality Hooks
by bartolli		 Hooks General Quality check hook for Node.js TypeScript projects with TypeScript compilation. ESLint auto-fixing, and Prettier formatting. Uses SHA256 config caching for < 5ms validation performance during real-time editing.
stars forks issues prs created last-commit release-date version license
claude-hooks
by John Lindquist		 Hooks General A TypeScript-based system for configuring and customizing Claude Code hooks with a powerful and flexible interface.
stars forks issues prs created last-commit release-date version license
--- **Total Resources:** 12 **Last Generated:** 2026-03-02 ================================================ FILE: README_ALTERNATIVES/README_FLAT_SKILLS_AZ.md ================================================

Pick Your Style:

Awesome Extra Classic Flat

# Awesome Claude Code (Flat) [![Awesome](https://awesome.re/badge-flat2.svg)](https://awesome.re) A flat list view of all resources. Category: **Skills** | Sorted: alphabetically by name --- ## Sort By:

A - Z UPDATED CREATED RELEASES

Category:

All Tooling Commands CLAUDE.md Workflows Hooks Skills Styles Status Docs Clients

Currently viewing: **Skills** sorted alphabetically by name

--- ## Resources
Resource Category Sub-Category Description
AgentSys
by avifenesh		 Agent Skills General Workflow automation system for Claude with a group of useful plugins, agents, and skills. Automates task-to-production workflows, PR management, code cleanup, performance investigation, drift detection, and multi-agent code review. Includes [agnix](https://github.com/avifenesh/agnix) for linting agent configurations. Built on thousands of lines of code with thousands of tests. Uses deterministic detection (regex, AST) with LLM judgment for efficiency. Used on many production systems.
stars forks issues prs created last-commit release-date version license
AI Agent, AI Spy
by Whittaker & Tiwari		 Agent Skills General Members from the Signal Foundation with some really great tips and tricks on how to turn your operating system into an instrument of total surveillance, and why some companies are doing this really awesome thing. [warning: YouTube link]
Book Factory
by Robert Guss		 Agent Skills General A comprehensive pipeline of Skills that replicates traditional publishing infrastructure for nonfiction book creation using specialized Claude skills.
stars forks issues prs created last-commit release-date version license
cc-devops-skills
by akin-ozer		 Agent Skills General Immensely detailed set of skills for DevOps Engineers (or anyone who has to deploy code, really). Works with validations, generators, shell scripts and CLI tools to create high quality IaC code for about any platform you've ever struggled painfully to work with. Worth downloading even just as a source of documentation.
stars forks issues prs created last-commit release-date version license
Claude Code Agents
by Paul - UndeadList		 Agent Skills General Comprehensive E2E development workflow with helpful Claude Code subagent prompts for solo devs. Run multiple auditors in parallel, automate fix cycles with micro-checkpoint protocols, and do browser-based QA. Includes strict protocols to prevent AI going rogue.
stars forks issues prs created last-commit release-date version license
Claude Codex Settings
by fatih akyon		 Agent Skills General A well-organized, well-written set of plugins covering core developer activities, such as working with common cloud platforms like GitHub, Azure, MongoDB, and popular services such as Tavily, Playwright, and more. Clear, not overly-opinionated, and compatible with a few other providers.
stars forks issues prs created last-commit release-date version license
Claude Mountaineering Skills
by Dmytro Gaivoronsky		 Agent Skills General Claude Code skill that automates mountain route research for North American peaks. Aggregates data from 10+ mountaineering sources like Mountaineers.org, PeakBagger.com and SummitPost.com to generate detailed route beta reports with weather, avalanche conditions, and trip reports.
stars forks issues prs created last-commit release-date version license
Claude Scientific Skills
by K-Dense		 Agent Skills General "A set of ready-to-use Agent Skills for research, science, engineering, analysis, finance and writing." That's their description - modest, simple. That's how you can tell this is really one of the best skills repos on GitHub. If you've ever thought about getting a PhD... just read all of these documents instead. Also I think it IS an AI agent or something? Awesome.
stars forks issues prs created last-commit release-date version license
Codex Skill
by klaudworks		 Agent Skills General Enables users to prompt codex from claude code. Unlike the raw codex mcp server, this skill infers parameters such as model, reasoning effort, sandboxing from your prompt or asks you to specify them. It also simplifies continuing prior codex sessions so that codex can continue with the prior context.
stars forks issues prs created last-commit release-date version license
Compound Engineering Plugin
by EveryInc		 Agent Skills General A very pragmatic set of well-designed agents, skills, and commands, built around a discipline of turning past mistakes and errors into lessons and opportunities for future growth and improvement. Good documentation.
stars forks issues prs created last-commit release-date version license
Context Engineering Kit
by Vlad Goncharov		 Agent Skills General Hand-crafted collection of advanced context engineering techniques and patterns with minimal token footprint focused on improving agent result quality.
stars forks issues prs created last-commit release-date version license
Everything Claude Code
by Affaan Mustafa		 Agent Skills General Top-notch, well-written resources covering "just about everything" from core engineering domains. What's nice about this "everything-" store is most of the resources have significant standalone value and unlike some all-encompassing frameworks, although you can opt in to the author's own specific workflow patterns if you choose, the individual resources offer exemplary patterns in (just about) every Claude Code feature you can find (apologies to the Output Styles devotees).
stars forks issues prs created last-commit release-date version license
Fullstack Dev Skills
by jeffallan		 Agent Skills General A comprehensive Claude Code plugin with 65 specialized skills covering full-stack development across a wide range of specific frameworks. Features 9 project workflow commands for Jira/Confluence integration and, notably, an interesting approach to context engineering via a `/common-ground` command that surfaces Claude's hidden assumptions about your project. This is a smart thing to do.
stars forks issues prs created last-commit release-date version license
read-only-postgres
by jawwadfirdousi		 Agent Skills General Read-only PostgreSQL query skill for Claude Code. Executes SELECT/SHOW/EXPLAIN/WITH queries across configured databases with strict validation, timeouts, and row limits. Supports multiple connections with descriptions for database selection.
stars forks issues prs created last-commit release-date version license
Superpowers
by Jesse Vincent		 Agent Skills General A strong bundle of core competencies for software engineering, with good coverage of a large portion of the SDLC - from planning, reviewing, testing, debugging... Well written, well organized, and adaptable. The author refers to them as "superpowers", but many of them are just consolidating engineering best practices - which sometimes does feel like a superpower when working with Claude Code.
stars forks issues prs created last-commit release-date version license
Trail of Bits Security Skills
by Trail of Bits		 Agent Skills General A very professional collection of over a dozen security-focused skills for code auditing and vulnerability detection. Includes skills for static analysis with CodeQL and Semgrep, variant analysis across codebases, fix verification, and differential code review.
stars forks issues prs created last-commit release-date version license
TÂCHES Claude Code Resources
by TÂCHES		 Agent Skills General A well-balanced, "down-to-Earth" set of sub agents, skills, and commands, that are well-organized, easy to read, and a healthy focus on "meta"-skills/agents, like "skill-auditor", hook creation, etc. - the kind of things you can adapt to your workflow, and not the other way around.
stars forks issues prs created last-commit release-date version license
Web Assets Generator Skill
by Alon Wolenitz		 Agent Skills General Easily generate web assets from Claude Code including favicons, app icons (PWA), and social media meta images (Open Graph) for Facebook, Twitter, WhatsApp, and LinkedIn. Handles image resizing, text-to-image generation, emojis, and provides proper HTML meta tags.
stars forks issues prs created last-commit release-date version license
--- **Total Resources:** 18 **Last Generated:** 2026-03-02 ================================================ FILE: README_ALTERNATIVES/README_FLAT_SKILLS_CREATED.md ================================================

Pick Your Style:

Awesome Extra Classic Flat

# Awesome Claude Code (Flat) [![Awesome](https://awesome.re/badge-flat2.svg)](https://awesome.re) A flat list view of all resources. Category: **Skills** | Sorted: by date created --- ## Sort By:

A - Z UPDATED CREATED RELEASES

Category:

All Tooling Commands CLAUDE.md Workflows Hooks Skills Styles Status Docs Clients

Currently viewing: **Skills** sorted by date created

--- ## Resources
Resource Category Sub-Category Description
AI Agent, AI Spy
by Whittaker & Tiwari		 Agent Skills General Members from the Signal Foundation with some really great tips and tricks on how to turn your operating system into an instrument of total surveillance, and why some companies are doing this really awesome thing. [warning: YouTube link]
read-only-postgres
by jawwadfirdousi		 Agent Skills General Read-only PostgreSQL query skill for Claude Code. Executes SELECT/SHOW/EXPLAIN/WITH queries across configured databases with strict validation, timeouts, and row limits. Supports multiple connections with descriptions for database selection.
stars forks issues prs created last-commit release-date version license
Book Factory
by Robert Guss		 Agent Skills General A comprehensive pipeline of Skills that replicates traditional publishing infrastructure for nonfiction book creation using specialized Claude skills.
stars forks issues prs created last-commit release-date version license
Everything Claude Code
by Affaan Mustafa		 Agent Skills General Top-notch, well-written resources covering "just about everything" from core engineering domains. What's nice about this "everything-" store is most of the resources have significant standalone value and unlike some all-encompassing frameworks, although you can opt in to the author's own specific workflow patterns if you choose, the individual resources offer exemplary patterns in (just about) every Claude Code feature you can find (apologies to the Output Styles devotees).
stars forks issues prs created last-commit release-date version license
AgentSys
by avifenesh		 Agent Skills General Workflow automation system for Claude with a group of useful plugins, agents, and skills. Automates task-to-production workflows, PR management, code cleanup, performance investigation, drift detection, and multi-agent code review. Includes [agnix](https://github.com/avifenesh/agnix) for linting agent configurations. Built on thousands of lines of code with thousands of tests. Uses deterministic detection (regex, AST) with LLM judgment for efficiency. Used on many production systems.
stars forks issues prs created last-commit release-date version license
Trail of Bits Security Skills
by Trail of Bits		 Agent Skills General A very professional collection of over a dozen security-focused skills for code auditing and vulnerability detection. Includes skills for static analysis with CodeQL and Semgrep, variant analysis across codebases, fix verification, and differential code review.
stars forks issues prs created last-commit release-date version license
Claude Code Agents
by Paul - UndeadList		 Agent Skills General Comprehensive E2E development workflow with helpful Claude Code subagent prompts for solo devs. Run multiple auditors in parallel, automate fix cycles with micro-checkpoint protocols, and do browser-based QA. Includes strict protocols to prevent AI going rogue.
stars forks issues prs created last-commit release-date version license
cc-devops-skills
by akin-ozer		 Agent Skills General Immensely detailed set of skills for DevOps Engineers (or anyone who has to deploy code, really). Works with validations, generators, shell scripts and CLI tools to create high quality IaC code for about any platform you've ever struggled painfully to work with. Worth downloading even just as a source of documentation.
stars forks issues prs created last-commit release-date version license
Context Engineering Kit
by Vlad Goncharov		 Agent Skills General Hand-crafted collection of advanced context engineering techniques and patterns with minimal token footprint focused on improving agent result quality.
stars forks issues prs created last-commit release-date version license
TÂCHES Claude Code Resources
by TÂCHES		 Agent Skills General A well-balanced, "down-to-Earth" set of sub agents, skills, and commands, that are well-organized, easy to read, and a healthy focus on "meta"-skills/agents, like "skill-auditor", hook creation, etc. - the kind of things you can adapt to your workflow, and not the other way around.
stars forks issues prs created last-commit release-date version license
Codex Skill
by klaudworks		 Agent Skills General Enables users to prompt codex from claude code. Unlike the raw codex mcp server, this skill infers parameters such as model, reasoning effort, sandboxing from your prompt or asks you to specify them. It also simplifies continuing prior codex sessions so that codex can continue with the prior context.
stars forks issues prs created last-commit release-date version license
Web Assets Generator Skill
by Alon Wolenitz		 Agent Skills General Easily generate web assets from Claude Code including favicons, app icons (PWA), and social media meta images (Open Graph) for Facebook, Twitter, WhatsApp, and LinkedIn. Handles image resizing, text-to-image generation, emojis, and provides proper HTML meta tags.
stars forks issues prs created last-commit release-date version license
Claude Mountaineering Skills
by Dmytro Gaivoronsky		 Agent Skills General Claude Code skill that automates mountain route research for North American peaks. Aggregates data from 10+ mountaineering sources like Mountaineers.org, PeakBagger.com and SummitPost.com to generate detailed route beta reports with weather, avalanche conditions, and trip reports.
stars forks issues prs created last-commit release-date version license
Fullstack Dev Skills
by jeffallan		 Agent Skills General A comprehensive Claude Code plugin with 65 specialized skills covering full-stack development across a wide range of specific frameworks. Features 9 project workflow commands for Jira/Confluence integration and, notably, an interesting approach to context engineering via a `/common-ground` command that surfaces Claude's hidden assumptions about your project. This is a smart thing to do.
stars forks issues prs created last-commit release-date version license
Claude Scientific Skills
by K-Dense		 Agent Skills General "A set of ready-to-use Agent Skills for research, science, engineering, analysis, finance and writing." That's their description - modest, simple. That's how you can tell this is really one of the best skills repos on GitHub. If you've ever thought about getting a PhD... just read all of these documents instead. Also I think it IS an AI agent or something? Awesome.
stars forks issues prs created last-commit release-date version license
Compound Engineering Plugin
by EveryInc		 Agent Skills General A very pragmatic set of well-designed agents, skills, and commands, built around a discipline of turning past mistakes and errors into lessons and opportunities for future growth and improvement. Good documentation.
stars forks issues prs created last-commit release-date version license
Superpowers
by Jesse Vincent		 Agent Skills General A strong bundle of core competencies for software engineering, with good coverage of a large portion of the SDLC - from planning, reviewing, testing, debugging... Well written, well organized, and adaptable. The author refers to them as "superpowers", but many of them are just consolidating engineering best practices - which sometimes does feel like a superpower when working with Claude Code.
stars forks issues prs created last-commit release-date version license
Claude Codex Settings
by fatih akyon		 Agent Skills General A well-organized, well-written set of plugins covering core developer activities, such as working with common cloud platforms like GitHub, Azure, MongoDB, and popular services such as Tavily, Playwright, and more. Clear, not overly-opinionated, and compatible with a few other providers.
stars forks issues prs created last-commit release-date version license
--- **Total Resources:** 18 **Last Generated:** 2026-03-02 ================================================ FILE: README_ALTERNATIVES/README_FLAT_SKILLS_RELEASES.md ================================================

Pick Your Style:

Awesome Extra Classic Flat

# Awesome Claude Code (Flat) [![Awesome](https://awesome.re/badge-flat2.svg)](https://awesome.re) A flat list view of all resources. Category: **Skills** | Sorted: by latest release (30 days) --- ## Sort By:

A - Z UPDATED CREATED RELEASES

Category:

All Tooling Commands CLAUDE.md Workflows Hooks Skills Styles Status Docs Clients

Currently viewing: **Skills** sorted by latest release (30 days) (past 30 days)

--- ## Resources > **Note:** Latest release data is pulled from GitHub Releases only. Projects without GitHub Releases will not show release info here. Please verify with the project directly.
Resource Version Source Release Date Description
Claude Scientific Skills
by K-Dense		 v2.24.0 GitHub 2026-02-27 "A set of ready-to-use Agent Skills for research, science, engineering, analysis, finance and writing." That's their description - modest, simple. That's how you can tell this is really one of the best skills repos on GitHub. If you've ever thought about getting a PhD... just read all of these documents instead. Also I think it IS an AI agent or something? Awesome.
stars forks issues prs created last-commit release-date version license
Everything Claude Code
by Affaan Mustafa		 v1.7.0 GitHub 2026-02-27 Top-notch, well-written resources covering "just about everything" from core engineering domains. What's nice about this "everything-" store is most of the resources have significant standalone value and unlike some all-encompassing frameworks, although you can opt in to the author's own specific workflow patterns if you choose, the individual resources offer exemplary patterns in (just about) every Claude Code feature you can find (apologies to the Output Styles devotees).
stars forks issues prs created last-commit release-date version license
AgentSys
by avifenesh		 v5.2.0 GitHub 2026-02-27 Workflow automation system for Claude with a group of useful plugins, agents, and skills. Automates task-to-production workflows, PR management, code cleanup, performance investigation, drift detection, and multi-agent code review. Includes [agnix](https://github.com/avifenesh/agnix) for linting agent configurations. Built on thousands of lines of code with thousands of tests. Uses deterministic detection (regex, AST) with LLM judgment for efficiency. Used on many production systems.
stars forks issues prs created last-commit release-date version license
Context Engineering Kit
by Vlad Goncharov		 v2.1.1 GitHub 2026-02-24 Hand-crafted collection of advanced context engineering techniques and patterns with minimal token footprint focused on improving agent result quality.
stars forks issues prs created last-commit release-date version license
Fullstack Dev Skills
by jeffallan		 v0.4.9 GitHub 2026-02-24 A comprehensive Claude Code plugin with 65 specialized skills covering full-stack development across a wide range of specific frameworks. Features 9 project workflow commands for Jira/Confluence integration and, notably, an interesting approach to context engineering via a `/common-ground` command that surfaces Claude's hidden assumptions about your project. This is a smart thing to do.
stars forks issues prs created last-commit release-date version license
Compound Engineering Plugin
by EveryInc		 v0.8.0 GitHub 2026-02-17 A very pragmatic set of well-designed agents, skills, and commands, built around a discipline of turning past mistakes and errors into lessons and opportunities for future growth and improvement. Good documentation.
stars forks issues prs created last-commit release-date version license
Claude Codex Settings
by fatih akyon		 v2.1.0 GitHub 2026-02-04 A well-organized, well-written set of plugins covering core developer activities, such as working with common cloud platforms like GitHub, Azure, MongoDB, and popular services such as Tavily, Playwright, and more. Clear, not overly-opinionated, and compatible with a few other providers.
stars forks issues prs created last-commit release-date version license
--- **Total Resources:** 7 **Last Generated:** 2026-03-02 ================================================ FILE: README_ALTERNATIVES/README_FLAT_SKILLS_UPDATED.md ================================================

Pick Your Style:

Awesome Extra Classic Flat

# Awesome Claude Code (Flat) [![Awesome](https://awesome.re/badge-flat2.svg)](https://awesome.re) A flat list view of all resources. Category: **Skills** | Sorted: by last updated date --- ## Sort By:

A - Z UPDATED CREATED RELEASES

Category:

All Tooling Commands CLAUDE.md Workflows Hooks Skills Styles Status Docs Clients

Currently viewing: **Skills** sorted by last updated date

--- ## Resources
Resource Category Sub-Category Description
AI Agent, AI Spy
by Whittaker & Tiwari		 Agent Skills General Members from the Signal Foundation with some really great tips and tricks on how to turn your operating system into an instrument of total surveillance, and why some companies are doing this really awesome thing. [warning: YouTube link]
Claude Scientific Skills
by K-Dense		 Agent Skills General "A set of ready-to-use Agent Skills for research, science, engineering, analysis, finance and writing." That's their description - modest, simple. That's how you can tell this is really one of the best skills repos on GitHub. If you've ever thought about getting a PhD... just read all of these documents instead. Also I think it IS an AI agent or something? Awesome.
stars forks issues prs created last-commit release-date version license
Compound Engineering Plugin
by EveryInc		 Agent Skills General A very pragmatic set of well-designed agents, skills, and commands, built around a discipline of turning past mistakes and errors into lessons and opportunities for future growth and improvement. Good documentation.
stars forks issues prs created last-commit release-date version license
Everything Claude Code
by Affaan Mustafa		 Agent Skills General Top-notch, well-written resources covering "just about everything" from core engineering domains. What's nice about this "everything-" store is most of the resources have significant standalone value and unlike some all-encompassing frameworks, although you can opt in to the author's own specific workflow patterns if you choose, the individual resources offer exemplary patterns in (just about) every Claude Code feature you can find (apologies to the Output Styles devotees).
stars forks issues prs created last-commit release-date version license
AgentSys
by avifenesh		 Agent Skills General Workflow automation system for Claude with a group of useful plugins, agents, and skills. Automates task-to-production workflows, PR management, code cleanup, performance investigation, drift detection, and multi-agent code review. Includes [agnix](https://github.com/avifenesh/agnix) for linting agent configurations. Built on thousands of lines of code with thousands of tests. Uses deterministic detection (regex, AST) with LLM judgment for efficiency. Used on many production systems.
stars forks issues prs created last-commit release-date version license
Fullstack Dev Skills
by jeffallan		 Agent Skills General A comprehensive Claude Code plugin with 65 specialized skills covering full-stack development across a wide range of specific frameworks. Features 9 project workflow commands for Jira/Confluence integration and, notably, an interesting approach to context engineering via a `/common-ground` command that surfaces Claude's hidden assumptions about your project. This is a smart thing to do.
stars forks issues prs created last-commit release-date version license
Codex Skill
by klaudworks		 Agent Skills General Enables users to prompt codex from claude code. Unlike the raw codex mcp server, this skill infers parameters such as model, reasoning effort, sandboxing from your prompt or asks you to specify them. It also simplifies continuing prior codex sessions so that codex can continue with the prior context.
stars forks issues prs created last-commit release-date version license
Trail of Bits Security Skills
by Trail of Bits		 Agent Skills General A very professional collection of over a dozen security-focused skills for code auditing and vulnerability detection. Includes skills for static analysis with CodeQL and Semgrep, variant analysis across codebases, fix verification, and differential code review.
stars forks issues prs created last-commit release-date version license
Context Engineering Kit
by Vlad Goncharov		 Agent Skills General Hand-crafted collection of advanced context engineering techniques and patterns with minimal token footprint focused on improving agent result quality.
stars forks issues prs created last-commit release-date version license
Superpowers
by Jesse Vincent		 Agent Skills General A strong bundle of core competencies for software engineering, with good coverage of a large portion of the SDLC - from planning, reviewing, testing, debugging... Well written, well organized, and adaptable. The author refers to them as "superpowers", but many of them are just consolidating engineering best practices - which sometimes does feel like a superpower when working with Claude Code.
stars forks issues prs created last-commit release-date version license
Claude Codex Settings
by fatih akyon		 Agent Skills General A well-organized, well-written set of plugins covering core developer activities, such as working with common cloud platforms like GitHub, Azure, MongoDB, and popular services such as Tavily, Playwright, and more. Clear, not overly-opinionated, and compatible with a few other providers.
stars forks issues prs created last-commit release-date version license
Claude Mountaineering Skills
by Dmytro Gaivoronsky		 Agent Skills General Claude Code skill that automates mountain route research for North American peaks. Aggregates data from 10+ mountaineering sources like Mountaineers.org, PeakBagger.com and SummitPost.com to generate detailed route beta reports with weather, avalanche conditions, and trip reports.
stars forks issues prs created last-commit release-date version license
read-only-postgres
by jawwadfirdousi		 Agent Skills General Read-only PostgreSQL query skill for Claude Code. Executes SELECT/SHOW/EXPLAIN/WITH queries across configured databases with strict validation, timeouts, and row limits. Supports multiple connections with descriptions for database selection.
stars forks issues prs created last-commit release-date version license
cc-devops-skills
by akin-ozer		 Agent Skills General Immensely detailed set of skills for DevOps Engineers (or anyone who has to deploy code, really). Works with validations, generators, shell scripts and CLI tools to create high quality IaC code for about any platform you've ever struggled painfully to work with. Worth downloading even just as a source of documentation.
stars forks issues prs created last-commit release-date version license
Claude Code Agents
by Paul - UndeadList		 Agent Skills General Comprehensive E2E development workflow with helpful Claude Code subagent prompts for solo devs. Run multiple auditors in parallel, automate fix cycles with micro-checkpoint protocols, and do browser-based QA. Includes strict protocols to prevent AI going rogue.
stars forks issues prs created last-commit release-date version license
Web Assets Generator Skill
by Alon Wolenitz		 Agent Skills General Easily generate web assets from Claude Code including favicons, app icons (PWA), and social media meta images (Open Graph) for Facebook, Twitter, WhatsApp, and LinkedIn. Handles image resizing, text-to-image generation, emojis, and provides proper HTML meta tags.
stars forks issues prs created last-commit release-date version license
TÂCHES Claude Code Resources
by TÂCHES		 Agent Skills General A well-balanced, "down-to-Earth" set of sub agents, skills, and commands, that are well-organized, easy to read, and a healthy focus on "meta"-skills/agents, like "skill-auditor", hook creation, etc. - the kind of things you can adapt to your workflow, and not the other way around.
stars forks issues prs created last-commit release-date version license
Book Factory
by Robert Guss		 Agent Skills General A comprehensive pipeline of Skills that replicates traditional publishing infrastructure for nonfiction book creation using specialized Claude skills.
stars forks issues prs created last-commit release-date version license
--- **Total Resources:** 18 **Last Generated:** 2026-03-02 ================================================ FILE: README_ALTERNATIVES/README_FLAT_STATUSLINE_AZ.md ================================================

Pick Your Style:

Awesome Extra Classic Flat

# Awesome Claude Code (Flat) [![Awesome](https://awesome.re/badge-flat2.svg)](https://awesome.re) A flat list view of all resources. Category: **Status** | Sorted: alphabetically by name --- ## Sort By:

A - Z UPDATED CREATED RELEASES

Category:

All Tooling Commands CLAUDE.md Workflows Hooks Skills Styles Status Docs Clients

Currently viewing: **Status** sorted alphabetically by name

--- ## Resources
Resource Category Sub-Category Description
CCometixLine - Claude Code Statusline
by Haleclipse		 Status Lines General A high-performance Claude Code statusline tool written in Rust with Git integration, usage tracking, interactive TUI configuration, and Claude Code enhancement utilities.
stars forks issues prs created last-commit release-date version license
ccstatusline
by sirmalloc		 Status Lines General A highly customizable status line formatter for Claude Code CLI that displays model info, git branch, token usage, and other metrics in your terminal.
stars forks issues prs created last-commit release-date version license
claude-code-statusline
by rz1989s		 Status Lines General Enhanced 4-line statusline for Claude Code with themes, cost tracking, and MCP server monitoring
stars forks issues prs created last-commit release-date version license
claude-powerline
by Owloops		 Status Lines General A vim-style powerline statusline for Claude Code with real-time usage tracking, git integration, custom themes, and more
stars forks issues prs created last-commit release-date version license
claudia-statusline
by Hagan Franks		 Status Lines General High-performance Rust-based statusline for Claude Code with persistent stats tracking, progress bars, and optional cloud sync. Features SQLite-first persistence, git integration, context progress bars, burn rate calculation, XDG-compliant with theme support (dark/light, NO_COLOR).
stars forks issues prs created last-commit release-date version license
--- **Total Resources:** 5 **Last Generated:** 2026-03-02 ================================================ FILE: README_ALTERNATIVES/README_FLAT_STATUSLINE_CREATED.md ================================================

Pick Your Style:

Awesome Extra Classic Flat

# Awesome Claude Code (Flat) [![Awesome](https://awesome.re/badge-flat2.svg)](https://awesome.re) A flat list view of all resources. Category: **Status** | Sorted: by date created --- ## Sort By:

A - Z UPDATED CREATED RELEASES

Category:

All Tooling Commands CLAUDE.md Workflows Hooks Skills Styles Status Docs Clients

Currently viewing: **Status** sorted by date created

--- ## Resources
Resource Category Sub-Category Description
claudia-statusline
by Hagan Franks		 Status Lines General High-performance Rust-based statusline for Claude Code with persistent stats tracking, progress bars, and optional cloud sync. Features SQLite-first persistence, git integration, context progress bars, burn rate calculation, XDG-compliant with theme support (dark/light, NO_COLOR).
stars forks issues prs created last-commit release-date version license
claude-code-statusline
by rz1989s		 Status Lines General Enhanced 4-line statusline for Claude Code with themes, cost tracking, and MCP server monitoring
stars forks issues prs created last-commit release-date version license
CCometixLine - Claude Code Statusline
by Haleclipse		 Status Lines General A high-performance Claude Code statusline tool written in Rust with Git integration, usage tracking, interactive TUI configuration, and Claude Code enhancement utilities.
stars forks issues prs created last-commit release-date version license
claude-powerline
by Owloops		 Status Lines General A vim-style powerline statusline for Claude Code with real-time usage tracking, git integration, custom themes, and more
stars forks issues prs created last-commit release-date version license
ccstatusline
by sirmalloc		 Status Lines General A highly customizable status line formatter for Claude Code CLI that displays model info, git branch, token usage, and other metrics in your terminal.
stars forks issues prs created last-commit release-date version license
--- **Total Resources:** 5 **Last Generated:** 2026-03-02 ================================================ FILE: README_ALTERNATIVES/README_FLAT_STATUSLINE_RELEASES.md ================================================

Pick Your Style:

Awesome Extra Classic Flat

# Awesome Claude Code (Flat) [![Awesome](https://awesome.re/badge-flat2.svg)](https://awesome.re) A flat list view of all resources. Category: **Status** | Sorted: by latest release (30 days) --- ## Sort By:

A - Z UPDATED CREATED RELEASES

Category:

All Tooling Commands CLAUDE.md Workflows Hooks Skills Styles Status Docs Clients

Currently viewing: **Status** sorted by latest release (30 days) (past 30 days)

--- ## Resources > **Note:** Latest release data is pulled from GitHub Releases only. Projects without GitHub Releases will not show release info here. Please verify with the project directly.
Resource Version Source Release Date Description
claude-code-statusline
by rz1989s		 v2.19.0 GitHub 2026-02-28 Enhanced 4-line statusline for Claude Code with themes, cost tracking, and MCP server monitoring
stars forks issues prs created last-commit release-date version license
claude-powerline
by Owloops		 v1.19.0 GitHub 2026-02-27 A vim-style powerline statusline for Claude Code with real-time usage tracking, git integration, custom themes, and more
stars forks issues prs created last-commit release-date version license
CCometixLine - Claude Code Statusline
by Haleclipse		 v1.1.1 GitHub 2026-02-09 A high-performance Claude Code statusline tool written in Rust with Git integration, usage tracking, interactive TUI configuration, and Claude Code enhancement utilities.
stars forks issues prs created last-commit release-date version license
--- **Total Resources:** 3 **Last Generated:** 2026-03-02 ================================================ FILE: README_ALTERNATIVES/README_FLAT_STATUSLINE_UPDATED.md ================================================

Pick Your Style:

Awesome Extra Classic Flat

# Awesome Claude Code (Flat) [![Awesome](https://awesome.re/badge-flat2.svg)](https://awesome.re) A flat list view of all resources. Category: **Status** | Sorted: by last updated date --- ## Sort By:

A - Z UPDATED CREATED RELEASES

Category:

All Tooling Commands CLAUDE.md Workflows Hooks Skills Styles Status Docs Clients

Currently viewing: **Status** sorted by last updated date

--- ## Resources
Resource Category Sub-Category Description
claude-powerline
by Owloops		 Status Lines General A vim-style powerline statusline for Claude Code with real-time usage tracking, git integration, custom themes, and more
stars forks issues prs created last-commit release-date version license
claude-code-statusline
by rz1989s		 Status Lines General Enhanced 4-line statusline for Claude Code with themes, cost tracking, and MCP server monitoring
stars forks issues prs created last-commit release-date version license
ccstatusline
by sirmalloc		 Status Lines General A highly customizable status line formatter for Claude Code CLI that displays model info, git branch, token usage, and other metrics in your terminal.
stars forks issues prs created last-commit release-date version license
CCometixLine - Claude Code Statusline
by Haleclipse		 Status Lines General A high-performance Claude Code statusline tool written in Rust with Git integration, usage tracking, interactive TUI configuration, and Claude Code enhancement utilities.
stars forks issues prs created last-commit release-date version license
claudia-statusline
by Hagan Franks		 Status Lines General High-performance Rust-based statusline for Claude Code with persistent stats tracking, progress bars, and optional cloud sync. Features SQLite-first persistence, git integration, context progress bars, burn rate calculation, XDG-compliant with theme support (dark/light, NO_COLOR).
stars forks issues prs created last-commit release-date version license
--- **Total Resources:** 5 **Last Generated:** 2026-03-02 ================================================ FILE: README_ALTERNATIVES/README_FLAT_STYLES_AZ.md ================================================

Pick Your Style:

Awesome Extra Classic Flat

# Awesome Claude Code (Flat) [![Awesome](https://awesome.re/badge-flat2.svg)](https://awesome.re) A flat list view of all resources. Category: **Styles** | Sorted: alphabetically by name --- ## Sort By:

A - Z UPDATED CREATED RELEASES

Category:

All Tooling Commands CLAUDE.md Workflows Hooks Skills Styles Status Docs Clients

Currently viewing: **Styles** sorted alphabetically by name

--- ## Resources
Resource Category Sub-Category Description
Awesome Claude Code Output Styles (That I Really Like)
by Really Him		 Output Styles General A fun and moderately amusing collection of experimental output styles.
stars forks issues prs created last-commit release-date version license
ccoutputstyles
by Vivek Nair		 Output Styles General CLI tool and template gallery for customizing Claude Code output styles with pre-built templates. Features over 15 templates at the time of writing!
stars forks issues prs created last-commit release-date version license
Claude Code Output Styles - Debugging
by Jamie Matthews		 Output Styles General A small set of well-written output styles, specifically focused on debugging - root cause analysis, systematic, methodical debugging, encouraging a more careful approach to bug-squashing from Claude Code.
stars forks issues prs created last-commit release-date version license
Gen-Alpha Slang
by Steve Nims		 Output Styles General This is really... different. I don't know what to say about this one. It does what it says on the tin. You might find it funny, you might want throw up. I'll just say candidly this is included strictly for its potentially comedic awesomeness.
stars forks issues prs created last-commit release-date version license
--- **Total Resources:** 4 **Last Generated:** 2026-03-02 ================================================ FILE: README_ALTERNATIVES/README_FLAT_STYLES_CREATED.md ================================================

Pick Your Style:

Awesome Extra Classic Flat

# Awesome Claude Code (Flat) [![Awesome](https://awesome.re/badge-flat2.svg)](https://awesome.re) A flat list view of all resources. Category: **Styles** | Sorted: by date created --- ## Sort By:

A - Z UPDATED CREATED RELEASES

Category:

All Tooling Commands CLAUDE.md Workflows Hooks Skills Styles Status Docs Clients

Currently viewing: **Styles** sorted by date created

--- ## Resources
Resource Category Sub-Category Description
Gen-Alpha Slang
by Steve Nims		 Output Styles General This is really... different. I don't know what to say about this one. It does what it says on the tin. You might find it funny, you might want throw up. I'll just say candidly this is included strictly for its potentially comedic awesomeness.
stars forks issues prs created last-commit release-date version license
Awesome Claude Code Output Styles (That I Really Like)
by Really Him		 Output Styles General A fun and moderately amusing collection of experimental output styles.
stars forks issues prs created last-commit release-date version license
Claude Code Output Styles - Debugging
by Jamie Matthews		 Output Styles General A small set of well-written output styles, specifically focused on debugging - root cause analysis, systematic, methodical debugging, encouraging a more careful approach to bug-squashing from Claude Code.
stars forks issues prs created last-commit release-date version license
ccoutputstyles
by Vivek Nair		 Output Styles General CLI tool and template gallery for customizing Claude Code output styles with pre-built templates. Features over 15 templates at the time of writing!
stars forks issues prs created last-commit release-date version license
--- **Total Resources:** 4 **Last Generated:** 2026-03-02 ================================================ FILE: README_ALTERNATIVES/README_FLAT_STYLES_RELEASES.md ================================================

Pick Your Style:

Awesome Extra Classic Flat

# Awesome Claude Code (Flat) [![Awesome](https://awesome.re/badge-flat2.svg)](https://awesome.re) A flat list view of all resources. Category: **Styles** | Sorted: by latest release (30 days) --- ## Sort By:

A - Z UPDATED CREATED RELEASES

Category:

All Tooling Commands CLAUDE.md Workflows Hooks Skills Styles Status Docs Clients

Currently viewing: **Styles** sorted by latest release (30 days) (past 30 days)

--- ## Resources > **Note:** Latest release data is pulled from GitHub Releases only. Projects without GitHub Releases will not show release info here. Please verify with the project directly. *No releases in the past 30 days for this category.* --- **Total Resources:** 0 **Last Generated:** 2026-03-02 ================================================ FILE: README_ALTERNATIVES/README_FLAT_STYLES_UPDATED.md ================================================

Pick Your Style:

Awesome Extra Classic Flat

# Awesome Claude Code (Flat) [![Awesome](https://awesome.re/badge-flat2.svg)](https://awesome.re) A flat list view of all resources. Category: **Styles** | Sorted: by last updated date --- ## Sort By:

A - Z UPDATED CREATED RELEASES

Category:

All Tooling Commands CLAUDE.md Workflows Hooks Skills Styles Status Docs Clients

Currently viewing: **Styles** sorted by last updated date

--- ## Resources
Resource Category Sub-Category Description
Gen-Alpha Slang
by Steve Nims		 Output Styles General This is really... different. I don't know what to say about this one. It does what it says on the tin. You might find it funny, you might want throw up. I'll just say candidly this is included strictly for its potentially comedic awesomeness.
stars forks issues prs created last-commit release-date version license
Awesome Claude Code Output Styles (That I Really Like)
by Really Him		 Output Styles General A fun and moderately amusing collection of experimental output styles.
stars forks issues prs created last-commit release-date version license
Claude Code Output Styles - Debugging
by Jamie Matthews		 Output Styles General A small set of well-written output styles, specifically focused on debugging - root cause analysis, systematic, methodical debugging, encouraging a more careful approach to bug-squashing from Claude Code.
stars forks issues prs created last-commit release-date version license
ccoutputstyles
by Vivek Nair		 Output Styles General CLI tool and template gallery for customizing Claude Code output styles with pre-built templates. Features over 15 templates at the time of writing!
stars forks issues prs created last-commit release-date version license
--- **Total Resources:** 4 **Last Generated:** 2026-03-02 ================================================ FILE: README_ALTERNATIVES/README_FLAT_TOOLING_AZ.md ================================================

Pick Your Style:

Awesome Extra Classic Flat

# Awesome Claude Code (Flat) [![Awesome](https://awesome.re/badge-flat2.svg)](https://awesome.re) A flat list view of all resources. Category: **Tooling** | Sorted: alphabetically by name --- ## Sort By:

A - Z UPDATED CREATED RELEASES

Category:

All Tooling Commands CLAUDE.md Workflows Hooks Skills Styles Status Docs Clients

Currently viewing: **Tooling** sorted alphabetically by name

--- ## Resources
Resource Category Sub-Category Description
Auto-Claude
by AndyMik90		 Tooling Orchestrators Autonomous multi-agent coding framework for Claude Code (Claude Agent SDK) that integrates the full SDLC - "plans, builds, and validates software for you". Features a slick kanban-style UI and a well-designed but not over-engineered agent orchestration system.
stars forks issues prs created last-commit release-date version license
CC Usage
by ryoppippi		 Tooling Usage Monitors Handy CLI tool for managing and analyzing Claude Code usage, based on analyzing local Claude Code logs. Presents a nice dashboard regarding cost information, token consumption, etc.
stars forks issues prs created last-commit release-date version license
cc-sessions
by toastdev		 Tooling General An opinionated approach to productive development with Claude Code
stars forks issues prs created last-commit release-date version license
cc-tools
by Josh Symonds		 Tooling General High-performance Go implementation of Claude Code hooks and utilities. Provides smart linting, testing, and statusline generation with minimal overhead.
stars forks issues prs created last-commit release-date version license
ccexp
by nyatinte		 Tooling General Interactive CLI tool for discovering and managing Claude Code configuration files and slash commands with a beautiful terminal UI.
stars forks issues prs created last-commit release-date version license
ccflare
by snipeship		 Tooling Usage Monitors Claude Code usage dashboard with a web-UI that would put Tableau to shame. Thoroughly comprehensive metrics, frictionless setup, detailed logging, really really nice UI.
stars forks issues prs created last-commit release-date version license
ccflare -> **better-ccflare**
by tombii		 Tooling Usage Monitors A well-maintained and feature-enhanced fork of the glorious `ccflare` usage dashboard by @snipeship (which at the time of writing has not had an update in a few months). `better-ccflare` builds on this foundation with some performance enhancements, extended provider support, bug fixes, Docker deployment, and more.
stars forks issues prs created last-commit release-date version license
cchistory
by eckardt		 Tooling General Like the shell history command but for your Claude Code sessions. Easily list all Bash or "Bash-mode" (`!`) commands Claude Code ran in a session for reference.
stars forks issues prs created last-commit release-date version license
cclogviewer
by Brad S.		 Tooling General A humble but handy utility for viewing Claude Code `.jsonl` conversation files in a pretty HTML UI.
stars forks issues prs created last-commit release-date version license
Claude Code Chat
by andrepimenta		 Tooling IDE Integrations An elegant and user-friendly Claude Code chat interface for VS Code.
Claude Code Flow
by ruvnet		 Tooling Orchestrators This mode serves as a code-first orchestration layer, enabling Claude to write, edit, test, and optimize code autonomously across recursive agent cycles.
stars forks issues prs created last-commit release-date version license
Claude Code Templates
by Daniel Avila		 Tooling General Incredibly awesome collection of resources from every category in this list, presented with a neatly polished UI, great features like usage dashboard, analytics, and everything from slash commands to hooks to agents. An awesome companion for this awesome list.
stars forks issues prs created last-commit release-date version license
Claude Code Usage Monitor
by Maciek-roboblog		 Tooling Usage Monitors A real-time terminal-based tool for monitoring Claude Code token usage. It shows live token consumption, burn rate, and predictions for token depletion. Features include visual progress bars, session-aware analytics, and support for multiple subscription plans.
stars forks issues prs created last-commit release-date version license
Claude Composer
by Mike Bannister		 Tooling General A tool that adds small enhancements to Claude Code.
stars forks issues prs created last-commit release-date version license
Claude Hub
by Claude Did This		 Tooling General A webhook service that connects Claude Code to GitHub repositories, enabling AI-powered code assistance directly through pull requests and issues. This integration allows Claude to analyze repositories, answer technical questions, and help developers understand and improve their codebase through simple @mentions.
stars forks issues prs created last-commit release-date version license
Claude Session Restore
by ZENG3LD		 Tooling General Efficiently restore context from previous Claude Code sessions by analyzing session files and git history. Features multi-factor data collection across numerous Claude Code capacities with time-based filtering. Uses tail-based parsing for efficient handling of large session files up to 2GB. Includes both a CLI tool for manual analysis and a Claude Code skill for automatic session restoration.
stars forks issues prs created last-commit release-date version license
Claude Squad
by smtg-ai		 Tooling Orchestrators Claude Squad is a terminal app that manages multiple Claude Code, Codex (and other local agents including Aider) in separate workspaces, allowing you to work on multiple tasks simultaneously.
stars forks issues prs created last-commit release-date version license
Claude Swarm
by parruda		 Tooling Orchestrators Launch Claude Code session that is connected to a swarm of Claude Code Agents.
stars forks issues prs created last-commit release-date version license
Claude Task Master
by eyaltoledano		 Tooling Orchestrators A task management system for AI-driven development with Claude, designed to work seamlessly with Cursor AI.
stars forks issues prs created last-commit release-date version license
Claude Task Runner
by grahama1970		 Tooling Orchestrators A specialized tool to manage context isolation and focused task execution with Claude Code, solving the critical challenge of context length limitations and task focus when working with Claude on complex, multi-step projects.
stars forks issues prs created last-commit release-date version license
claude-code-ide.el
by manzaltu		 Tooling IDE Integrations claude-code-ide.el integrates Claude Code with Emacs, like Anthropic’s VS Code/IntelliJ extensions. It shows ediff-based code suggestions, pulls LSP/flymake/flycheck diagnostics, and tracks buffer context. It adds an extensible MCP tool support for symbol refs/defs, project metadata, and tree-sitter AST queries.
stars forks issues prs created last-commit release-date version license
claude-code-tools
by Prasad Chalasani		 Tooling General Well-crafted toolset for session continuity, featuring skills/commands to avoid compaction and recover context across sessions with cross-agent handoff between Claude Code and Codex CLI. Includes a fast Rust/Tantivy-powered full-text session search (TUI for humans, skill/CLI for agents), tmux-cli skill + command for interacting with scripts and CLI agents, and safety hooks to block dangerous commands.
stars forks issues prs created last-commit release-date version license
claude-code.el
by stevemolitor		 Tooling IDE Integrations An Emacs interface for Claude Code CLI.
stars forks issues prs created last-commit release-date version license
claude-code.nvim
by greggh		 Tooling IDE Integrations A seamless integration between Claude Code AI assistant and Neovim.
stars forks issues prs created last-commit release-date version license
claude-rules-doctor
by nulone		 Tooling Config Managers CLI that detects dead `.claude/rules/` files by checking if `paths:` globs actually match files in your repo. Catches silent rule failures where renamed directories or typos in glob patterns cause rules to never apply. Features CI mode (exit 1 on dead rules), JSON output, and verbose mode showing matched files.
stars forks issues prs created last-commit release-date version license
claude-starter-kit
by serpro69		 Tooling General This is a starter template repository designed to provide a complete development environment for Claude-Code with pre-configured MCP servers and tools for AI-powered development workflows. The repository is intentionally minimal, containing only configuration templates for three primary systems: Claude Code, Serena, and Task Master.
stars forks issues prs created last-commit release-date version license
ClaudeCTX
by John Fox		 Tooling Config Managers claudectx lets you switch your entire Claude Code configuration with a single command.
stars forks issues prs created last-commit release-date version license
claudekit
by Carl Rannaberg		 Tooling General Impressive CLI toolkit providing auto-save checkpointing, code quality hooks, specification generation and execution, and 20+ specialized subagents including oracle (gpt-5), code-reviewer (6-aspect deep analysis), ai-sdk-expert (Vercel AI SDK), typescript-expert and many more for Claude Code workflows.
stars forks issues prs created last-commit release-date version license
Claudex
by Kunwar Shah		 Tooling Usage Monitors Claudex - A web-based browser for exploring your Claude Code conversation history across projects. Indexes your codebase for full-text search. Nice, easy-to-navigate UI. Simple dashboard interface for high-level analytics, and multiple export options as well. (And completely local w/ no telemetry!)
stars forks issues prs created last-commit release-date version license
Claudix - Claude Code for VSCode
by Haleclipse		 Tooling IDE Integrations A VSCode extension that brings Claude Code directly into your editor with interactive chat interface, session management, intelligent file operations, terminal execution, and real-time streaming responses. Built with Vue 3, TypeScript.
stars forks issues prs created last-commit release-date version license
Container Use
by dagger		 Tooling General Development environments for coding agents. Enable multiple agents to work safely and independently with your preferred stack.
stars forks issues prs created last-commit release-date version license
ContextKit
by Cihat Gündüz		 Tooling General A systematic development framework that transforms Claude Code into a proactive development partner. Features 4-phase planning methodology, specialized quality agents, and structured workflows that help AI produce production-ready code on first try.
stars forks issues prs created last-commit release-date version license
Happy Coder
by GrocerPublishAgent		 Tooling Orchestrators Spawn and control multiple Claude Codes in parallel from your phone or desktop. Happy Coder runs Claude Code on your hardware, sends push notifications when Claude needs more input or permission, and costs nothing.
stars forks issues prs created last-commit release-date version license
recall
by zippoxer		 Tooling General Full-text search your Claude Code sessions. Run `recall` in terminal, type to search, Enter to resume. Alternative to `claude --resume`.
stars forks issues prs created last-commit release-date version license
Rulesync
by dyoshikawa		 Tooling General A Node.js CLI tool that automatically generates configs (rules, ignore files, MCP servers, commands, and subagents) for various AI coding agents. Rulesync can convert configs between Claude Code and other AI agents in both directions.
stars forks issues prs created last-commit release-date version license
run-claude-docker
by Jonas		 Tooling General A self-contained Docker runner that forwards your current workspace into a safe(r) isolated docker container, where you still have access to your Claude Code settings, authentication, ssh agent, pgp, optionally aws keys etc.
stars forks issues prs created last-commit release-date version license
stt-mcp-server-linux
by marcindulak		 Tooling General A push-to-talk speech transcription setup for Linux using a Python MCP server. Runs locally in Docker with no external API calls. Your speech is recorded, transcribed into text, and then sent to Claude running in a Tmux session.
stars forks issues prs created last-commit release-date version license
sudocode
by ssh-randy		 Tooling Orchestrators Lightweight agent orchestration dev tool that lives in your repo. Integrates with various specification frameworks. It's giving Jira.
stars forks issues prs created last-commit release-date version license
SuperClaude
by SuperClaude-Org		 Tooling General A versatile configuration framework that enhances Claude Code with specialized commands, cognitive personas, and development methodologies, such as "Introspection" and "Orchestration".
stars forks issues prs created last-commit release-date version license
The Agentic Startup
by Rudolf Schmidt		 Tooling Orchestrators Yet Another Claude Orchestrator - a collection of agents, commands, etc., for shipping production code - but I like this because it's comprehensive, well-written, and one of the few resources that actually uses Output Styles! +10 points!
stars forks issues prs created last-commit release-date version license
TSK - AI Agent Task Manager and Sandbox
by dtormoen		 Tooling Orchestrators A Rust CLI tool that lets you delegate development tasks to AI agents running in sandboxed Docker environments. Multiple agents work in parallel, returning git branches for human review.
stars forks issues prs created last-commit release-date version license
tweakcc
by Piebald-AI		 Tooling General Command-line tool to customize your Claude Code styling.
stars forks issues prs created last-commit release-date version license
Vibe-Log
by Vibe-Log		 Tooling General Analyzes your Claude Code prompts locally (using CC), provides intelligent session analysis and actionable strategic guidance - works in the statusline and produces very pretty HTML reports as well. Easy to install and remove.
stars forks issues prs created last-commit release-date version license
viberank
by nikshepsvn		 Tooling Usage Monitors A community-driven leaderboard tool that enables developers to visualize, track, and compete based on their Claude Code usage statistics. It features robust data analytics, GitHub OAuth, data validation, and user-friendly CLI/web submission methods.
stars forks issues prs created last-commit release-date version license
viwo-cli
by Hal Shin		 Tooling General Run Claude Code in a Docker container with git worktrees as volume mounts to enable safer usage of `--dangerously-skip-permissions` for frictionless one-shotting prompts. Allows users to spin up multiple instances of Claude Code in the background easily with reduced permission fatigue.
stars forks issues prs created last-commit release-date version license
VoiceMode MCP
by Mike Bailey		 Tooling General VoiceMode MCP brings natural conversations to Claude Code. It supports any OpenAI API compatible voice services and installs free and open source voice services (Whisper.cpp and Kokoro-FastAPI).
stars forks issues prs created last-commit release-date version license
--- **Total Resources:** 46 **Last Generated:** 2026-03-02 ================================================ FILE: README_ALTERNATIVES/README_FLAT_TOOLING_CREATED.md ================================================

Pick Your Style:

Awesome Extra Classic Flat

# Awesome Claude Code (Flat) [![Awesome](https://awesome.re/badge-flat2.svg)](https://awesome.re) A flat list view of all resources. Category: **Tooling** | Sorted: by date created --- ## Sort By:

A - Z UPDATED CREATED RELEASES

Category:

All Tooling Commands CLAUDE.md Workflows Hooks Skills Styles Status Docs Clients

Currently viewing: **Tooling** sorted by date created

--- ## Resources
Resource Category Sub-Category Description
Claude Code Chat
by andrepimenta		 Tooling IDE Integrations An elegant and user-friendly Claude Code chat interface for VS Code.
ClaudeCTX
by John Fox		 Tooling Config Managers claudectx lets you switch your entire Claude Code configuration with a single command.
stars forks issues prs created last-commit release-date version license
claude-rules-doctor
by nulone		 Tooling Config Managers CLI that detects dead `.claude/rules/` files by checking if `paths:` globs actually match files in your repo. Catches silent rule failures where renamed directories or typos in glob patterns cause rules to never apply. Features CI mode (exit 1 on dead rules), JSON output, and verbose mode showing matched files.
stars forks issues prs created last-commit release-date version license
Claude Session Restore
by ZENG3LD		 Tooling General Efficiently restore context from previous Claude Code sessions by analyzing session files and git history. Features multi-factor data collection across numerous Claude Code capacities with time-based filtering. Uses tail-based parsing for efficient handling of large session files up to 2GB. Includes both a CLI tool for manual analysis and a Claude Code skill for automatic session restoration.
stars forks issues prs created last-commit release-date version license
Auto-Claude
by AndyMik90		 Tooling Orchestrators Autonomous multi-agent coding framework for Claude Code (Claude Agent SDK) that integrates the full SDLC - "plans, builds, and validates software for you". Features a slick kanban-style UI and a well-designed but not over-engineered agent orchestration system.
stars forks issues prs created last-commit release-date version license
recall
by zippoxer		 Tooling General Full-text search your Claude Code sessions. Run `recall` in terminal, type to search, Enter to resume. Alternative to `claude --resume`.
stars forks issues prs created last-commit release-date version license
Claudix - Claude Code for VSCode
by Haleclipse		 Tooling IDE Integrations A VSCode extension that brings Claude Code directly into your editor with interactive chat interface, session management, intelligent file operations, terminal execution, and real-time streaming responses. Built with Vue 3, TypeScript.
stars forks issues prs created last-commit release-date version license
claude-starter-kit
by serpro69		 Tooling General This is a starter template repository designed to provide a complete development environment for Claude-Code with pre-configured MCP servers and tools for AI-powered development workflows. The repository is intentionally minimal, containing only configuration templates for three primary systems: Claude Code, Serena, and Task Master.
stars forks issues prs created last-commit release-date version license
sudocode
by ssh-randy		 Tooling Orchestrators Lightweight agent orchestration dev tool that lives in your repo. Integrates with various specification frameworks. It's giving Jira.
stars forks issues prs created last-commit release-date version license
ContextKit
by Cihat Gündüz		 Tooling General A systematic development framework that transforms Claude Code into a proactive development partner. Features 4-phase planning methodology, specialized quality agents, and structured workflows that help AI produce production-ready code on first try.
stars forks issues prs created last-commit release-date version license
Claudex
by Kunwar Shah		 Tooling Usage Monitors Claudex - A web-based browser for exploring your Claude Code conversation history across projects. Indexes your codebase for full-text search. Nice, easy-to-navigate UI. Simple dashboard interface for high-level analytics, and multiple export options as well. (And completely local w/ no telemetry!)
stars forks issues prs created last-commit release-date version license
stt-mcp-server-linux
by marcindulak		 Tooling General A push-to-talk speech transcription setup for Linux using a Python MCP server. Runs locally in Docker with no external API calls. Your speech is recorded, transcribed into text, and then sent to Claude running in a Tmux session.
stars forks issues prs created last-commit release-date version license
viwo-cli
by Hal Shin		 Tooling General Run Claude Code in a Docker container with git worktrees as volume mounts to enable safer usage of `--dangerously-skip-permissions` for frictionless one-shotting prompts. Allows users to spin up multiple instances of Claude Code in the background easily with reduced permission fatigue.
stars forks issues prs created last-commit release-date version license
cc-sessions
by toastdev		 Tooling General An opinionated approach to productive development with Claude Code
stars forks issues prs created last-commit release-date version license
cc-tools
by Josh Symonds		 Tooling General High-performance Go implementation of Claude Code hooks and utilities. Provides smart linting, testing, and statusline generation with minimal overhead.
stars forks issues prs created last-commit release-date version license
Vibe-Log
by Vibe-Log		 Tooling General Analyzes your Claude Code prompts locally (using CC), provides intelligent session analysis and actionable strategic guidance - works in the statusline and produces very pretty HTML reports as well. Easy to install and remove.
stars forks issues prs created last-commit release-date version license
run-claude-docker
by Jonas		 Tooling General A self-contained Docker runner that forwards your current workspace into a safe(r) isolated docker container, where you still have access to your Claude Code settings, authentication, ssh agent, pgp, optionally aws keys etc.
stars forks issues prs created last-commit release-date version license
The Agentic Startup
by Rudolf Schmidt		 Tooling Orchestrators Yet Another Claude Orchestrator - a collection of agents, commands, etc., for shipping production code - but I like this because it's comprehensive, well-written, and one of the few resources that actually uses Output Styles! +10 points!
stars forks issues prs created last-commit release-date version license
claude-code-tools
by Prasad Chalasani		 Tooling General Well-crafted toolset for session continuity, featuring skills/commands to avoid compaction and recover context across sessions with cross-agent handoff between Claude Code and Codex CLI. Includes a fast Rust/Tantivy-powered full-text session search (TUI for humans, skill/CLI for agents), tmux-cli skill + command for interacting with scripts and CLI agents, and safety hooks to block dangerous commands.
stars forks issues prs created last-commit release-date version license
cclogviewer
by Brad S.		 Tooling General A humble but handy utility for viewing Claude Code `.jsonl` conversation files in a pretty HTML UI.
stars forks issues prs created last-commit release-date version license
ccflare
by snipeship		 Tooling Usage Monitors Claude Code usage dashboard with a web-UI that would put Tableau to shame. Thoroughly comprehensive metrics, frictionless setup, detailed logging, really really nice UI.
stars forks issues prs created last-commit release-date version license
ccflare -> **better-ccflare**
by tombii		 Tooling Usage Monitors A well-maintained and feature-enhanced fork of the glorious `ccflare` usage dashboard by @snipeship (which at the time of writing has not had an update in a few months). `better-ccflare` builds on this foundation with some performance enhancements, extended provider support, bug fixes, Docker deployment, and more.
stars forks issues prs created last-commit release-date version license
tweakcc
by Piebald-AI		 Tooling General Command-line tool to customize your Claude Code styling.
stars forks issues prs created last-commit release-date version license
SuperClaude
by SuperClaude-Org		 Tooling General A versatile configuration framework that enhances Claude Code with specialized commands, cognitive personas, and development methodologies, such as "Introspection" and "Orchestration".
stars forks issues prs created last-commit release-date version license
Happy Coder
by GrocerPublishAgent		 Tooling Orchestrators Spawn and control multiple Claude Codes in parallel from your phone or desktop. Happy Coder runs Claude Code on your hardware, sends push notifications when Claude needs more input or permission, and costs nothing.
stars forks issues prs created last-commit release-date version license
claudekit
by Carl Rannaberg		 Tooling General Impressive CLI toolkit providing auto-save checkpointing, code quality hooks, specification generation and execution, and 20+ specialized subagents including oracle (gpt-5), code-reviewer (6-aspect deep analysis), ai-sdk-expert (Vercel AI SDK), typescript-expert and many more for Claude Code workflows.
stars forks issues prs created last-commit release-date version license
Claude Code Templates
by Daniel Avila		 Tooling General Incredibly awesome collection of resources from every category in this list, presented with a neatly polished UI, great features like usage dashboard, analytics, and everything from slash commands to hooks to agents. An awesome companion for this awesome list.
stars forks issues prs created last-commit release-date version license
viberank
by nikshepsvn		 Tooling Usage Monitors A community-driven leaderboard tool that enables developers to visualize, track, and compete based on their Claude Code usage statistics. It features robust data analytics, GitHub OAuth, data validation, and user-friendly CLI/web submission methods.
stars forks issues prs created last-commit release-date version license
ccexp
by nyatinte		 Tooling General Interactive CLI tool for discovering and managing Claude Code configuration files and slash commands with a beautiful terminal UI.
stars forks issues prs created last-commit release-date version license
claude-code-ide.el
by manzaltu		 Tooling IDE Integrations claude-code-ide.el integrates Claude Code with Emacs, like Anthropic’s VS Code/IntelliJ extensions. It shows ediff-based code suggestions, pulls LSP/flymake/flycheck diagnostics, and tracks buffer context. It adds an extensible MCP tool support for symbol refs/defs, project metadata, and tree-sitter AST queries.
stars forks issues prs created last-commit release-date version license
Claude Code Usage Monitor
by Maciek-roboblog		 Tooling Usage Monitors A real-time terminal-based tool for monitoring Claude Code token usage. It shows live token consumption, burn rate, and predictions for token depletion. Features include visual progress bars, session-aware analytics, and support for multiple subscription plans.
stars forks issues prs created last-commit release-date version license
Rulesync
by dyoshikawa		 Tooling General A Node.js CLI tool that automatically generates configs (rules, ignore files, MCP servers, commands, and subagents) for various AI coding agents. Rulesync can convert configs between Claude Code and other AI agents in both directions.
stars forks issues prs created last-commit release-date version license
VoiceMode MCP
by Mike Bailey		 Tooling General VoiceMode MCP brings natural conversations to Claude Code. It supports any OpenAI API compatible voice services and installs free and open source voice services (Whisper.cpp and Kokoro-FastAPI).
stars forks issues prs created last-commit release-date version license
cchistory
by eckardt		 Tooling General Like the shell history command but for your Claude Code sessions. Easily list all Bash or "Bash-mode" (`!`) commands Claude Code ran in a session for reference.
stars forks issues prs created last-commit release-date version license
Claude Code Flow
by ruvnet		 Tooling Orchestrators This mode serves as a code-first orchestration layer, enabling Claude to write, edit, test, and optimize code autonomously across recursive agent cycles.
stars forks issues prs created last-commit release-date version license
TSK - AI Agent Task Manager and Sandbox
by dtormoen		 Tooling Orchestrators A Rust CLI tool that lets you delegate development tasks to AI agents running in sandboxed Docker environments. Multiple agents work in parallel, returning git branches for human review.
stars forks issues prs created last-commit release-date version license
CC Usage
by ryoppippi		 Tooling Usage Monitors Handy CLI tool for managing and analyzing Claude Code usage, based on analyzing local Claude Code logs. Presents a nice dashboard regarding cost information, token consumption, etc.
stars forks issues prs created last-commit release-date version license
Claude Swarm
by parruda		 Tooling Orchestrators Launch Claude Code session that is connected to a swarm of Claude Code Agents.
stars forks issues prs created last-commit release-date version license
Claude Composer
by Mike Bannister		 Tooling General A tool that adds small enhancements to Claude Code.
stars forks issues prs created last-commit release-date version license
Container Use
by dagger		 Tooling General Development environments for coding agents. Enable multiple agents to work safely and independently with your preferred stack.
stars forks issues prs created last-commit release-date version license
Claude Hub
by Claude Did This		 Tooling General A webhook service that connects Claude Code to GitHub repositories, enabling AI-powered code assistance directly through pull requests and issues. This integration allows Claude to analyze repositories, answer technical questions, and help developers understand and improve their codebase through simple @mentions.
stars forks issues prs created last-commit release-date version license
Claude Task Runner
by grahama1970		 Tooling Orchestrators A specialized tool to manage context isolation and focused task execution with Claude Code, solving the critical challenge of context length limitations and task focus when working with Claude on complex, multi-step projects.
stars forks issues prs created last-commit release-date version license
claude-code.el
by stevemolitor		 Tooling IDE Integrations An Emacs interface for Claude Code CLI.
stars forks issues prs created last-commit release-date version license
Claude Squad
by smtg-ai		 Tooling Orchestrators Claude Squad is a terminal app that manages multiple Claude Code, Codex (and other local agents including Aider) in separate workspaces, allowing you to work on multiple tasks simultaneously.
stars forks issues prs created last-commit release-date version license
Claude Task Master
by eyaltoledano		 Tooling Orchestrators A task management system for AI-driven development with Claude, designed to work seamlessly with Cursor AI.
stars forks issues prs created last-commit release-date version license
claude-code.nvim
by greggh		 Tooling IDE Integrations A seamless integration between Claude Code AI assistant and Neovim.
stars forks issues prs created last-commit release-date version license
--- **Total Resources:** 46 **Last Generated:** 2026-03-02 ================================================ FILE: README_ALTERNATIVES/README_FLAT_TOOLING_RELEASES.md ================================================

Pick Your Style:

Awesome Extra Classic Flat

# Awesome Claude Code (Flat) [![Awesome](https://awesome.re/badge-flat2.svg)](https://awesome.re) A flat list view of all resources. Category: **Tooling** | Sorted: by latest release (30 days) --- ## Sort By:

A - Z UPDATED CREATED RELEASES

Category:

All Tooling Commands CLAUDE.md Workflows Hooks Skills Styles Status Docs Clients

Currently viewing: **Tooling** sorted by latest release (30 days) (past 30 days)

--- ## Resources > **Note:** Latest release data is pulled from GitHub Releases only. Projects without GitHub Releases will not show release info here. Please verify with the project directly.
Resource Version Source Release Date Description
The Agentic Startup
by Rudolf Schmidt		 v3.4.0 GitHub 2026-02-28 Yet Another Claude Orchestrator - a collection of agents, commands, etc., for shipping production code - but I like this because it's comprehensive, well-written, and one of the few resources that actually uses Output Styles! +10 points!
stars forks issues prs created last-commit release-date version license
tweakcc
by Piebald-AI		 v4.0.10 GitHub 2026-02-28 Command-line tool to customize your Claude Code styling.
stars forks issues prs created last-commit release-date version license
TSK - AI Agent Task Manager and Sandbox
by dtormoen		 v0.10.1 GitHub 2026-02-27 A Rust CLI tool that lets you delegate development tasks to AI agents running in sandboxed Docker environments. Multiple agents work in parallel, returning git branches for human review.
stars forks issues prs created last-commit release-date version license
Rulesync
by dyoshikawa		 v7.10.0 GitHub 2026-02-27 A Node.js CLI tool that automatically generates configs (rules, ignore files, MCP servers, commands, and subagents) for various AI coding agents. Rulesync can convert configs between Claude Code and other AI agents in both directions.
stars forks issues prs created last-commit release-date version license
ccflare -> **better-ccflare**
by tombii		 v3.2.2 GitHub 2026-02-25 A well-maintained and feature-enhanced fork of the glorious `ccflare` usage dashboard by @snipeship (which at the time of writing has not had an update in a few months). `better-ccflare` builds on this foundation with some performance enhancements, extended provider support, bug fixes, Docker deployment, and more.
stars forks issues prs created last-commit release-date version license
CC Usage
by ryoppippi		 v18.0.8 GitHub 2026-02-24 Handy CLI tool for managing and analyzing Claude Code usage, based on analyzing local Claude Code logs. Presents a nice dashboard regarding cost information, token consumption, etc.
stars forks issues prs created last-commit release-date version license
VoiceMode MCP
by Mike Bailey		 v8.3.0 GitHub 2026-02-24 VoiceMode MCP brings natural conversations to Claude Code. It supports any OpenAI API compatible voice services and installs free and open source voice services (Whisper.cpp and Kokoro-FastAPI).
stars forks issues prs created last-commit release-date version license
sudocode
by ssh-randy		 v0.1.25 GitHub 2026-02-23 Lightweight agent orchestration dev tool that lives in your repo. Integrates with various specification frameworks. It's giving Jira.
stars forks issues prs created last-commit release-date version license
Auto-Claude
by AndyMik90		 v2.7.6 GitHub 2026-02-20 Autonomous multi-agent coding framework for Claude Code (Claude Agent SDK) that integrates the full SDLC - "plans, builds, and validates software for you". Features a slick kanban-style UI and a well-designed but not over-engineered agent orchestration system.
stars forks issues prs created last-commit release-date version license
claude-code-tools
by Prasad Chalasani		 v1.10.7 GitHub 2026-02-19 Well-crafted toolset for session continuity, featuring skills/commands to avoid compaction and recover context across sessions with cross-agent handoff between Claude Code and Codex CLI. Includes a fast Rust/Tantivy-powered full-text session search (TUI for humans, skill/CLI for agents), tmux-cli skill + command for interacting with scripts and CLI agents, and safety hooks to block dangerous commands.
stars forks issues prs created last-commit release-date version license
Claudex
by Kunwar Shah		 v1.3.0 GitHub 2026-02-12 Claudex - A web-based browser for exploring your Claude Code conversation history across projects. Indexes your codebase for full-text search. Nice, easy-to-navigate UI. Simple dashboard interface for high-level analytics, and multiple export options as well. (And completely local w/ no telemetry!)
stars forks issues prs created last-commit release-date version license
Claude Swarm
by parruda		 swarm_sdk-v2.7.15 GitHub 2026-02-12 Launch Claude Code session that is connected to a swarm of Claude Code Agents.
stars forks issues prs created last-commit release-date version license
Claude Task Master
by eyaltoledano		 task-master-ai@0.43.0 GitHub 2026-02-04 A task management system for AI-driven development with Claude, designed to work seamlessly with Cursor AI.
stars forks issues prs created last-commit release-date version license
claude-starter-kit
by serpro69		 v0.2.0 GitHub 2026-02-01 This is a starter template repository designed to provide a complete development environment for Claude-Code with pre-configured MCP servers and tools for AI-powered development workflows. The repository is intentionally minimal, containing only configuration templates for three primary systems: Claude Code, Serena, and Task Master.
stars forks issues prs created last-commit release-date version license
--- **Total Resources:** 14 **Last Generated:** 2026-03-02 ================================================ FILE: README_ALTERNATIVES/README_FLAT_TOOLING_UPDATED.md ================================================

Pick Your Style:

Awesome Extra Classic Flat

# Awesome Claude Code (Flat) [![Awesome](https://awesome.re/badge-flat2.svg)](https://awesome.re) A flat list view of all resources. Category: **Tooling** | Sorted: by last updated date --- ## Sort By:

A - Z UPDATED CREATED RELEASES

Category:

All Tooling Commands CLAUDE.md Workflows Hooks Skills Styles Status Docs Clients

Currently viewing: **Tooling** sorted by last updated date

--- ## Resources
Resource Category Sub-Category Description
Claude Code Chat
by andrepimenta		 Tooling IDE Integrations An elegant and user-friendly Claude Code chat interface for VS Code.
Rulesync
by dyoshikawa		 Tooling General A Node.js CLI tool that automatically generates configs (rules, ignore files, MCP servers, commands, and subagents) for various AI coding agents. Rulesync can convert configs between Claude Code and other AI agents in both directions.
stars forks issues prs created last-commit release-date version license
Claude Code Templates
by Daniel Avila		 Tooling General Incredibly awesome collection of resources from every category in this list, presented with a neatly polished UI, great features like usage dashboard, analytics, and everything from slash commands to hooks to agents. An awesome companion for this awesome list.
stars forks issues prs created last-commit release-date version license
TSK - AI Agent Task Manager and Sandbox
by dtormoen		 Tooling Orchestrators A Rust CLI tool that lets you delegate development tasks to AI agents running in sandboxed Docker environments. Multiple agents work in parallel, returning git branches for human review.
stars forks issues prs created last-commit release-date version license
Claude Squad
by smtg-ai		 Tooling Orchestrators Claude Squad is a terminal app that manages multiple Claude Code, Codex (and other local agents including Aider) in separate workspaces, allowing you to work on multiple tasks simultaneously.
stars forks issues prs created last-commit release-date version license
VoiceMode MCP
by Mike Bailey		 Tooling General VoiceMode MCP brings natural conversations to Claude Code. It supports any OpenAI API compatible voice services and installs free and open source voice services (Whisper.cpp and Kokoro-FastAPI).
stars forks issues prs created last-commit release-date version license
claude-code-tools
by Prasad Chalasani		 Tooling General Well-crafted toolset for session continuity, featuring skills/commands to avoid compaction and recover context across sessions with cross-agent handoff between Claude Code and Codex CLI. Includes a fast Rust/Tantivy-powered full-text session search (TUI for humans, skill/CLI for agents), tmux-cli skill + command for interacting with scripts and CLI agents, and safety hooks to block dangerous commands.
stars forks issues prs created last-commit release-date version license
Claude Code Flow
by ruvnet		 Tooling Orchestrators This mode serves as a code-first orchestration layer, enabling Claude to write, edit, test, and optimize code autonomously across recursive agent cycles.
stars forks issues prs created last-commit release-date version license
tweakcc
by Piebald-AI		 Tooling General Command-line tool to customize your Claude Code styling.
stars forks issues prs created last-commit release-date version license
The Agentic Startup
by Rudolf Schmidt		 Tooling Orchestrators Yet Another Claude Orchestrator - a collection of agents, commands, etc., for shipping production code - but I like this because it's comprehensive, well-written, and one of the few resources that actually uses Output Styles! +10 points!
stars forks issues prs created last-commit release-date version license
Happy Coder
by GrocerPublishAgent		 Tooling Orchestrators Spawn and control multiple Claude Codes in parallel from your phone or desktop. Happy Coder runs Claude Code on your hardware, sends push notifications when Claude needs more input or permission, and costs nothing.
stars forks issues prs created last-commit release-date version license
ccflare -> **better-ccflare**
by tombii		 Tooling Usage Monitors A well-maintained and feature-enhanced fork of the glorious `ccflare` usage dashboard by @snipeship (which at the time of writing has not had an update in a few months). `better-ccflare` builds on this foundation with some performance enhancements, extended provider support, bug fixes, Docker deployment, and more.
stars forks issues prs created last-commit release-date version license
SuperClaude
by SuperClaude-Org		 Tooling General A versatile configuration framework that enhances Claude Code with specialized commands, cognitive personas, and development methodologies, such as "Introspection" and "Orchestration".
stars forks issues prs created last-commit release-date version license
claude-rules-doctor
by nulone		 Tooling Config Managers CLI that detects dead `.claude/rules/` files by checking if `paths:` globs actually match files in your repo. Catches silent rule failures where renamed directories or typos in glob patterns cause rules to never apply. Features CI mode (exit 1 on dead rules), JSON output, and verbose mode showing matched files.
stars forks issues prs created last-commit release-date version license
CC Usage
by ryoppippi		 Tooling Usage Monitors Handy CLI tool for managing and analyzing Claude Code usage, based on analyzing local Claude Code logs. Presents a nice dashboard regarding cost information, token consumption, etc.
stars forks issues prs created last-commit release-date version license
sudocode
by ssh-randy		 Tooling Orchestrators Lightweight agent orchestration dev tool that lives in your repo. Integrates with various specification frameworks. It's giving Jira.
stars forks issues prs created last-commit release-date version license
claude-starter-kit
by serpro69		 Tooling General This is a starter template repository designed to provide a complete development environment for Claude-Code with pre-configured MCP servers and tools for AI-powered development workflows. The repository is intentionally minimal, containing only configuration templates for three primary systems: Claude Code, Serena, and Task Master.
stars forks issues prs created last-commit release-date version license
Container Use
by dagger		 Tooling General Development environments for coding agents. Enable multiple agents to work safely and independently with your preferred stack.
stars forks issues prs created last-commit release-date version license
Auto-Claude
by AndyMik90		 Tooling Orchestrators Autonomous multi-agent coding framework for Claude Code (Claude Agent SDK) that integrates the full SDLC - "plans, builds, and validates software for you". Features a slick kanban-style UI and a well-designed but not over-engineered agent orchestration system.
stars forks issues prs created last-commit release-date version license
Claudex
by Kunwar Shah		 Tooling Usage Monitors Claudex - A web-based browser for exploring your Claude Code conversation history across projects. Indexes your codebase for full-text search. Nice, easy-to-navigate UI. Simple dashboard interface for high-level analytics, and multiple export options as well. (And completely local w/ no telemetry!)
stars forks issues prs created last-commit release-date version license
Claude Swarm
by parruda		 Tooling Orchestrators Launch Claude Code session that is connected to a swarm of Claude Code Agents.
stars forks issues prs created last-commit release-date version license
claude-code.nvim
by greggh		 Tooling IDE Integrations A seamless integration between Claude Code AI assistant and Neovim.
stars forks issues prs created last-commit release-date version license
Claude Task Master
by eyaltoledano		 Tooling Orchestrators A task management system for AI-driven development with Claude, designed to work seamlessly with Cursor AI.
stars forks issues prs created last-commit release-date version license
claude-code-ide.el
by manzaltu		 Tooling IDE Integrations claude-code-ide.el integrates Claude Code with Emacs, like Anthropic’s VS Code/IntelliJ extensions. It shows ediff-based code suggestions, pulls LSP/flymake/flycheck diagnostics, and tracks buffer context. It adds an extensible MCP tool support for symbol refs/defs, project metadata, and tree-sitter AST queries.
stars forks issues prs created last-commit release-date version license
ContextKit
by Cihat Gündüz		 Tooling General A systematic development framework that transforms Claude Code into a proactive development partner. Features 4-phase planning methodology, specialized quality agents, and structured workflows that help AI produce production-ready code on first try.
stars forks issues prs created last-commit release-date version license
ClaudeCTX
by John Fox		 Tooling Config Managers claudectx lets you switch your entire Claude Code configuration with a single command.
stars forks issues prs created last-commit release-date version license
Claude Session Restore
by ZENG3LD		 Tooling General Efficiently restore context from previous Claude Code sessions by analyzing session files and git history. Features multi-factor data collection across numerous Claude Code capacities with time-based filtering. Uses tail-based parsing for efficient handling of large session files up to 2GB. Includes both a CLI tool for manual analysis and a Claude Code skill for automatic session restoration.
stars forks issues prs created last-commit release-date version license
viberank
by nikshepsvn		 Tooling Usage Monitors A community-driven leaderboard tool that enables developers to visualize, track, and compete based on their Claude Code usage statistics. It features robust data analytics, GitHub OAuth, data validation, and user-friendly CLI/web submission methods.
stars forks issues prs created last-commit release-date version license
cc-tools
by Josh Symonds		 Tooling General High-performance Go implementation of Claude Code hooks and utilities. Provides smart linting, testing, and statusline generation with minimal overhead.
stars forks issues prs created last-commit release-date version license
claudekit
by Carl Rannaberg		 Tooling General Impressive CLI toolkit providing auto-save checkpointing, code quality hooks, specification generation and execution, and 20+ specialized subagents including oracle (gpt-5), code-reviewer (6-aspect deep analysis), ai-sdk-expert (Vercel AI SDK), typescript-expert and many more for Claude Code workflows.
stars forks issues prs created last-commit release-date version license
recall
by zippoxer		 Tooling General Full-text search your Claude Code sessions. Run `recall` in terminal, type to search, Enter to resume. Alternative to `claude --resume`.
stars forks issues prs created last-commit release-date version license
stt-mcp-server-linux
by marcindulak		 Tooling General A push-to-talk speech transcription setup for Linux using a Python MCP server. Runs locally in Docker with no external API calls. Your speech is recorded, transcribed into text, and then sent to Claude running in a Tmux session.
stars forks issues prs created last-commit release-date version license
viwo-cli
by Hal Shin		 Tooling General Run Claude Code in a Docker container with git worktrees as volume mounts to enable safer usage of `--dangerously-skip-permissions` for frictionless one-shotting prompts. Allows users to spin up multiple instances of Claude Code in the background easily with reduced permission fatigue.
stars forks issues prs created last-commit release-date version license
claude-code.el
by stevemolitor		 Tooling IDE Integrations An Emacs interface for Claude Code CLI.
stars forks issues prs created last-commit release-date version license
Vibe-Log
by Vibe-Log		 Tooling General Analyzes your Claude Code prompts locally (using CC), provides intelligent session analysis and actionable strategic guidance - works in the statusline and produces very pretty HTML reports as well. Easy to install and remove.
stars forks issues prs created last-commit release-date version license
Claudix - Claude Code for VSCode
by Haleclipse		 Tooling IDE Integrations A VSCode extension that brings Claude Code directly into your editor with interactive chat interface, session management, intelligent file operations, terminal execution, and real-time streaming responses. Built with Vue 3, TypeScript.
stars forks issues prs created last-commit release-date version license
ccexp
by nyatinte		 Tooling General Interactive CLI tool for discovering and managing Claude Code configuration files and slash commands with a beautiful terminal UI.
stars forks issues prs created last-commit release-date version license
cchistory
by eckardt		 Tooling General Like the shell history command but for your Claude Code sessions. Easily list all Bash or "Bash-mode" (`!`) commands Claude Code ran in a session for reference.
stars forks issues prs created last-commit release-date version license
cc-sessions
by toastdev		 Tooling General An opinionated approach to productive development with Claude Code
stars forks issues prs created last-commit release-date version license
ccflare
by snipeship		 Tooling Usage Monitors Claude Code usage dashboard with a web-UI that would put Tableau to shame. Thoroughly comprehensive metrics, frictionless setup, detailed logging, really really nice UI.
stars forks issues prs created last-commit release-date version license
run-claude-docker
by Jonas		 Tooling General A self-contained Docker runner that forwards your current workspace into a safe(r) isolated docker container, where you still have access to your Claude Code settings, authentication, ssh agent, pgp, optionally aws keys etc.
stars forks issues prs created last-commit release-date version license
cclogviewer
by Brad S.		 Tooling General A humble but handy utility for viewing Claude Code `.jsonl` conversation files in a pretty HTML UI.
stars forks issues prs created last-commit release-date version license
Claude Composer
by Mike Bannister		 Tooling General A tool that adds small enhancements to Claude Code.
stars forks issues prs created last-commit release-date version license
Claude Code Usage Monitor
by Maciek-roboblog		 Tooling Usage Monitors A real-time terminal-based tool for monitoring Claude Code token usage. It shows live token consumption, burn rate, and predictions for token depletion. Features include visual progress bars, session-aware analytics, and support for multiple subscription plans.
stars forks issues prs created last-commit release-date version license
Claude Hub
by Claude Did This		 Tooling General A webhook service that connects Claude Code to GitHub repositories, enabling AI-powered code assistance directly through pull requests and issues. This integration allows Claude to analyze repositories, answer technical questions, and help developers understand and improve their codebase through simple @mentions.
stars forks issues prs created last-commit release-date version license
Claude Task Runner
by grahama1970		 Tooling Orchestrators A specialized tool to manage context isolation and focused task execution with Claude Code, solving the critical challenge of context length limitations and task focus when working with Claude on complex, multi-step projects.
stars forks issues prs created last-commit release-date version license
--- **Total Resources:** 46 **Last Generated:** 2026-03-02 ================================================ FILE: README_ALTERNATIVES/README_FLAT_WORKFLOWS_AZ.md ================================================

Pick Your Style:

Awesome Extra Classic Flat

# Awesome Claude Code (Flat) [![Awesome](https://awesome.re/badge-flat2.svg)](https://awesome.re) A flat list view of all resources. Category: **Workflows** | Sorted: alphabetically by name --- ## Sort By:

A - Z UPDATED CREATED RELEASES

Category:

All Tooling Commands CLAUDE.md Workflows Hooks Skills Styles Status Docs Clients

Currently viewing: **Workflows** sorted alphabetically by name

--- ## Resources
Resource Category Sub-Category Description
AB Method
by Ayoub Bensalah		 Workflows & Knowledge Guides General A principled, spec-driven workflow that transforms large problems into focused, incremental missions using Claude Code's specialized sub agents. Includes slash-commands, sub agents, and specialized workflows designed for specific parts of the SDLC.
stars forks issues prs created last-commit release-date version license
Agentic Workflow Patterns
by ThibautMelen		 Workflows & Knowledge Guides General A comprehensive and well-documented collection of agentic patterns from Anthropic docs, with colorful Mermaid diagrams and code examples for each pattern. Covers Subagent Orchestration, Progressive Skills, Parallel Tool Calling, Master-Clone Architecture, Wizard Workflows, and more. Also compatible with other providers.
stars forks issues prs created last-commit release-date version license
awesome-ralph
by Martin Joly		 Workflows & Knowledge Guides Ralph Wiggum A curated list of resources about Ralph, the AI coding technique that runs AI coding agents in automated loops until specifications are fulfilled.
stars forks issues prs created last-commit release-date version license
Blogging Platform Instructions
by cloudartisan		 Workflows & Knowledge Guides General Provides a well-structured set of commands for publishing and maintaining a blogging platform, including commands for creating posts, managing categories, and handling media files.
stars forks issues prs created last-commit release-date version license
Claude Code Documentation Mirror
by Eric Buess		 Workflows & Knowledge Guides General A mirror of the Anthropic © PBC documentation pages for Claude Code, updated every few hours. Can come in handy when trying to stay on top of the ever-expanding feature-set of Dr. Claw D. Code, Ph.D.
stars forks issues prs created last-commit release-date version license
Claude Code Handbook
by nikiforovall		 Workflows & Knowledge Guides General Collection of best practices, tips, and techniques for Claude Code development workflows, enhanced with distributable plugins
Claude Code Infrastructure Showcase
by diet103		 Workflows & Knowledge Guides General A remarkably innovative approach to working with Skills, the centerpiece of which being a technique that leverages hooks to ensure that Claude intelligently selects and activates the appropriate Skill given the current context. Well-documented and adaptable to different projects and workflows.
stars forks issues prs created last-commit release-date version license
Claude Code PM
by Ran Aroussi		 Workflows & Knowledge Guides General Really comprehensive and feature-packed project-management workflow for Claude Code. Numerous specialized agents, slash-commands, and strong documentation.
stars forks issues prs created last-commit release-date version license
Claude Code Repos Index
by Daniel Rosehill		 Workflows & Knowledge Guides General This is either the work of a prolific genius, or a very clever bot (or both), although it hardly matters because the quality is so good - an index of 75+ Claude Code repositories published by the author - and I'm not talking about slop. CMS, system design, deep research, IoT, agentic workflows, server management, personal health... If you spot the lie, let me know, otherwise please check these out.
stars forks issues prs created last-commit release-date version license
Claude Code System Prompts
by Piebald AI		 Workflows & Knowledge Guides General All parts of Claude Code's system prompt, including builtin tool descriptions, sub agent prompts (Plan/Explore/Task), utility prompts (CLAUDE.md, compact, Bash cmd, security review, agent creation, etc.). Updated for each Claude Code version.
stars forks issues prs created last-commit release-date version license
Claude Code Tips
by ykdojo		 Workflows & Knowledge Guides General A nice variety of 35+ brief but information-dense Claude Code tips covering voice input, system prompt patching, container workflows for risky tasks, conversation cloning(!), multi-model orchestration with Gemini CLI, and plenty more. Nice demos, working scripts, a plugin, I'd say this probably has a little something for everyone.
stars forks issues prs created last-commit release-date version license
Claude Code Ultimate Guide
by Florian BRUNIAUX		 Workflows & Knowledge Guides General A tremendous feat of documentation, this guide covers Claude Code from beginner to power user, with production-ready templates for Claude Code features, guides on agentic workflows, and a lot of great learning materials, including quizzes and a handy "cheatsheet". Whether it's the "ultimate" guide to Claude Code will be up to the reader, but a valuable resource nonetheless (as with all documentation sites, make sure it's up to date before you bet the farm).
stars forks issues prs created last-commit release-date version license
Claude CodePro
by Max Ritter		 Workflows & Knowledge Guides General Professional development environment for Claude Code with spec-driven workflow, TDD enforcement, cross-session memory, semantic search, quality hooks, and modular rules integration. A bit "heavyweight" but feature-packed and has wide coverage.
stars forks issues prs created last-commit release-date version license
claude-code-docs
by Constantin Shafranski		 Workflows & Knowledge Guides General A mirror of the Anthropic© PBC documentation site for Claude/Code, but with bonus features like full-text search and query-time updates - a nice companion to `claude-code-docs` for up-to-the-minute, fully-indexed information so that Claude Code can read about itself.
stars forks issues prs created last-commit release-date version license
ClaudoPro Directory
by ghost		 Workflows & Knowledge Guides General Well-crafted, wide selection of Claude Code hooks, slash commands, subagent files, and more, covering a range of specialized tasks and workflows. Better resources than your average "Claude-template-for-everything" site.
stars forks issues prs created last-commit release-date version license
Context Priming
by disler		 Workflows & Knowledge Guides General Provides a systematic approach to priming Claude Code with comprehensive project context through specialized commands for different project scenarios and development contexts.
stars forks issues prs created last-commit release-date version license
Design Review Workflow
by Patrick Ellis		 Workflows & Knowledge Guides General A tailored workflow for enabling automated UI/UX design review, including specialized sub agents, slash commands, `CLAUDE.md` excerpts, and more. Covers a broad range of criteria from responsive design to accessibility.
stars forks issues prs created last-commit release-date version license
Laravel TALL Stack AI Development Starter Kit
by tott		 Workflows & Knowledge Guides General Transform your Laravel TALL (Tailwind, AlpineJS, Laravel, Livewire) stack development with comprehensive Claude Code configurations that provide intelligent assistance, systematic workflows, and domain expert consultation.
stars forks issues prs created last-commit release-date version license
Learn Claude Code
by shareAI-Lab		 Workflows & Knowledge Guides General A really interesting analysis of how coding agents like Claude Code are designed. It attempts to break an agent down into its fundamental parts and reconstruct it with minimal code. Great learning resource. Final product is a rudimentary agent with skills, sub-agents, and a todo-list in roughly a few hundred lines of Python.
stars forks issues prs created last-commit release-date version license
learn-faster-kit
by Hugo Lau		 Workflows & Knowledge Guides General A creative educational framework for Claude Code, inspired by the "FASTER" approach to self-teaching. Ships with a variety of agents, slash commands, and tools that enable Claude Code to help you progress at your own pace, employing well-established pedagogical techniques like active learning and spaced repetition.
stars forks issues prs created last-commit release-date version license
n8n_agent
by kingler		 Workflows & Knowledge Guides General Amazing comprehensive set of comments for code analysis, QA, design, documentation, project structure, project management, optimization, and many more.
stars forks issues prs created last-commit release-date version license
Project Bootstrapping and Task Management
by steadycursor		 Workflows & Knowledge Guides General Provides a structured set of commands for bootstrapping and managing a new project, including meta-commands for creating and editing custom slash-commands.
stars forks issues prs created last-commit release-date version license
Project Management, Implementation, Planning, and Release
by scopecraft		 Workflows & Knowledge Guides General Really comprehensive set of commands for all aspects of SDLC.
stars forks issues prs created last-commit release-date version license
Project Workflow System
by harperreed		 Workflows & Knowledge Guides General A set of commands that provide a comprehensive workflow system for managing projects, including task management, code review, and deployment processes.
stars forks issues prs created last-commit release-date version license
Ralph for Claude Code
by Frank Bria		 Workflows & Knowledge Guides Ralph Wiggum An autonomous AI development framework that enables Claude Code to work iteratively on projects until completion. Features intelligent exit detection, rate limiting, circuit breaker patterns, and comprehensive safety guardrails to prevent infinite loops and API overuse. Built with Bash, integrated with tmux for live monitoring, and includes 75+ comprehensive tests.
stars forks issues prs created last-commit release-date version license
Ralph Wiggum Marketer
by Muratcan Koylan		 Workflows & Knowledge Guides Ralph Wiggum A Claude Code plugin that provides an autonomous AI copywriter, integrating the Ralph loop with customized knowledge bases for market research agents. The agents do the research, Ralph writes the copy, you stay in bed. Whether or not you practice Ralph-Driven Development (RDD), I think these projects are interesting and creative explorations of general agentic patterns.
stars forks issues prs created last-commit release-date version license
ralph-orchestrator
by mikeyobrien		 Workflows & Knowledge Guides Ralph Wiggum Ralph Orchestrator implements the simple but effective "Ralph Wiggum" technique for autonomous task completion, continuously running an AI agent against a prompt file until the task is marked as complete or limits are reached. This implementation provides a robust, well-tested, and feature-complete orchestration system for AI-driven development. Also cited in the Anthropic Ralph plugin documentation.
stars forks issues prs created last-commit release-date version license
ralph-wiggum-bdd
by marcindulak		 Workflows & Knowledge Guides Ralph Wiggum A standalone Bash script for Behavior-Driven Development with Ralph Wiggum Loop. In principle, while running unattended, the script can keep code and requirements in sync, but in practice it still requires interactive human supervision, so it supports both modes. The script is standalone and can be modified and committed into your project.
stars forks issues prs created last-commit release-date version license
RIPER Workflow
by Tony Narlock		 Workflows & Knowledge Guides General Structured development workflow enforcing separation between Research, Innovate, Plan, Execute, and Review phases. Features consolidated subagents for context-efficiency, branch-aware memory bank, and strict mode enforcement for guided development.
stars forks issues prs created last-commit release-date version license
Shipping Real Code w/ Claude
by Diwank		 Workflows & Knowledge Guides General A detailed blog post explaining the author's process for shipping a product with Claude Code, including CLAUDE.md files and other interesting resources.
Simone
by Helmi		 Workflows & Knowledge Guides General A broader project management workflow for Claude Code that encompasses not just a set of commands, but a system of documents, guidelines, and processes to facilitate project planning and execution.
stars forks issues prs created last-commit release-date version license
The Ralph Playbook
by Clayton Farr		 Workflows & Knowledge Guides Ralph Wiggum A remarkably detailed and comprehensive guide to the Ralph Wiggum technique, featuring well-written theoretical commentary paired with practical guidelines and advice.
stars forks issues prs created last-commit release-date version license
--- **Total Resources:** 32 **Last Generated:** 2026-03-02 ================================================ FILE: README_ALTERNATIVES/README_FLAT_WORKFLOWS_CREATED.md ================================================

Pick Your Style:

Awesome Extra Classic Flat

# Awesome Claude Code (Flat) [![Awesome](https://awesome.re/badge-flat2.svg)](https://awesome.re) A flat list view of all resources. Category: **Workflows** | Sorted: by date created --- ## Sort By:

A - Z UPDATED CREATED RELEASES

Category:

All Tooling Commands CLAUDE.md Workflows Hooks Skills Styles Status Docs Clients

Currently viewing: **Workflows** sorted by date created

--- ## Resources
Resource Category Sub-Category Description
Claude Code Handbook
by nikiforovall		 Workflows & Knowledge Guides General Collection of best practices, tips, and techniques for Claude Code development workflows, enhanced with distributable plugins
Shipping Real Code w/ Claude
by Diwank		 Workflows & Knowledge Guides General A detailed blog post explaining the author's process for shipping a product with Claude Code, including CLAUDE.md files and other interesting resources.
ralph-wiggum-bdd
by marcindulak		 Workflows & Knowledge Guides Ralph Wiggum A standalone Bash script for Behavior-Driven Development with Ralph Wiggum Loop. In principle, while running unattended, the script can keep code and requirements in sync, but in practice it still requires interactive human supervision, so it supports both modes. The script is standalone and can be modified and committed into your project.
stars forks issues prs created last-commit release-date version license
awesome-ralph
by Martin Joly		 Workflows & Knowledge Guides Ralph Wiggum A curated list of resources about Ralph, the AI coding technique that runs AI coding agents in automated loops until specifications are fulfilled.
stars forks issues prs created last-commit release-date version license
The Ralph Playbook
by Clayton Farr		 Workflows & Knowledge Guides Ralph Wiggum A remarkably detailed and comprehensive guide to the Ralph Wiggum technique, featuring well-written theoretical commentary paired with practical guidelines and advice.
stars forks issues prs created last-commit release-date version license
Claude Code Ultimate Guide
by Florian BRUNIAUX		 Workflows & Knowledge Guides General A tremendous feat of documentation, this guide covers Claude Code from beginner to power user, with production-ready templates for Claude Code features, guides on agentic workflows, and a lot of great learning materials, including quizzes and a handy "cheatsheet". Whether it's the "ultimate" guide to Claude Code will be up to the reader, but a valuable resource nonetheless (as with all documentation sites, make sure it's up to date before you bet the farm).
stars forks issues prs created last-commit release-date version license
Ralph Wiggum Marketer
by Muratcan Koylan		 Workflows & Knowledge Guides Ralph Wiggum A Claude Code plugin that provides an autonomous AI copywriter, integrating the Ralph loop with customized knowledge bases for market research agents. The agents do the research, Ralph writes the copy, you stay in bed. Whether or not you practice Ralph-Driven Development (RDD), I think these projects are interesting and creative explorations of general agentic patterns.
stars forks issues prs created last-commit release-date version license
Claude Code Tips
by ykdojo		 Workflows & Knowledge Guides General A nice variety of 35+ brief but information-dense Claude Code tips covering voice input, system prompt patching, container workflows for risky tasks, conversation cloning(!), multi-model orchestration with Gemini CLI, and plenty more. Nice demos, working scripts, a plugin, I'd say this probably has a little something for everyone.
stars forks issues prs created last-commit release-date version license
Agentic Workflow Patterns
by ThibautMelen		 Workflows & Knowledge Guides General A comprehensive and well-documented collection of agentic patterns from Anthropic docs, with colorful Mermaid diagrams and code examples for each pattern. Covers Subagent Orchestration, Progressive Skills, Parallel Tool Calling, Master-Clone Architecture, Wizard Workflows, and more. Also compatible with other providers.
stars forks issues prs created last-commit release-date version license
Claude Code System Prompts
by Piebald AI		 Workflows & Knowledge Guides General All parts of Claude Code's system prompt, including builtin tool descriptions, sub agent prompts (Plan/Explore/Task), utility prompts (CLAUDE.md, compact, Bash cmd, security review, agent creation, etc.). Updated for each Claude Code version.
stars forks issues prs created last-commit release-date version license
learn-faster-kit
by Hugo Lau		 Workflows & Knowledge Guides General A creative educational framework for Claude Code, inspired by the "FASTER" approach to self-teaching. Ships with a variety of agents, slash commands, and tools that enable Claude Code to help you progress at your own pace, employing well-established pedagogical techniques like active learning and spaced repetition.
stars forks issues prs created last-commit release-date version license
Claude Code Infrastructure Showcase
by diet103		 Workflows & Knowledge Guides General A remarkably innovative approach to working with Skills, the centerpiece of which being a technique that leverages hooks to ensure that Claude intelligently selects and activates the appropriate Skill given the current context. Well-documented and adaptable to different projects and workflows.
stars forks issues prs created last-commit release-date version license
Claude CodePro
by Max Ritter		 Workflows & Knowledge Guides General Professional development environment for Claude Code with spec-driven workflow, TDD enforcement, cross-session memory, semantic search, quality hooks, and modular rules integration. A bit "heavyweight" but feature-packed and has wide coverage.
stars forks issues prs created last-commit release-date version license
Claude Code Repos Index
by Daniel Rosehill		 Workflows & Knowledge Guides General This is either the work of a prolific genius, or a very clever bot (or both), although it hardly matters because the quality is so good - an index of 75+ Claude Code repositories published by the author - and I'm not talking about slop. CMS, system design, deep research, IoT, agentic workflows, server management, personal health... If you spot the lie, let me know, otherwise please check these out.
stars forks issues prs created last-commit release-date version license
ClaudoPro Directory
by ghost		 Workflows & Knowledge Guides General Well-crafted, wide selection of Claude Code hooks, slash commands, subagent files, and more, covering a range of specialized tasks and workflows. Better resources than your average "Claude-template-for-everything" site.
stars forks issues prs created last-commit release-date version license
ralph-orchestrator
by mikeyobrien		 Workflows & Knowledge Guides Ralph Wiggum Ralph Orchestrator implements the simple but effective "Ralph Wiggum" technique for autonomous task completion, continuously running an AI agent against a prompt file until the task is marked as complete or limits are reached. This implementation provides a robust, well-tested, and feature-complete orchestration system for AI-driven development. Also cited in the Anthropic Ralph plugin documentation.
stars forks issues prs created last-commit release-date version license
RIPER Workflow
by Tony Narlock		 Workflows & Knowledge Guides General Structured development workflow enforcing separation between Research, Innovate, Plan, Execute, and Review phases. Features consolidated subagents for context-efficiency, branch-aware memory bank, and strict mode enforcement for guided development.
stars forks issues prs created last-commit release-date version license
Ralph for Claude Code
by Frank Bria		 Workflows & Knowledge Guides Ralph Wiggum An autonomous AI development framework that enables Claude Code to work iteratively on projects until completion. Features intelligent exit detection, rate limiting, circuit breaker patterns, and comprehensive safety guardrails to prevent infinite loops and API overuse. Built with Bash, integrated with tmux for live monitoring, and includes 75+ comprehensive tests.
stars forks issues prs created last-commit release-date version license
Claude Code PM
by Ran Aroussi		 Workflows & Knowledge Guides General Really comprehensive and feature-packed project-management workflow for Claude Code. Numerous specialized agents, slash-commands, and strong documentation.
stars forks issues prs created last-commit release-date version license
Design Review Workflow
by Patrick Ellis		 Workflows & Knowledge Guides General A tailored workflow for enabling automated UI/UX design review, including specialized sub agents, slash commands, `CLAUDE.md` excerpts, and more. Covers a broad range of criteria from responsive design to accessibility.
stars forks issues prs created last-commit release-date version license
AB Method
by Ayoub Bensalah		 Workflows & Knowledge Guides General A principled, spec-driven workflow that transforms large problems into focused, incremental missions using Claude Code's specialized sub agents. Includes slash-commands, sub agents, and specialized workflows designed for specific parts of the SDLC.
stars forks issues prs created last-commit release-date version license
Laravel TALL Stack AI Development Starter Kit
by tott		 Workflows & Knowledge Guides General Transform your Laravel TALL (Tailwind, AlpineJS, Laravel, Livewire) stack development with comprehensive Claude Code configurations that provide intelligent assistance, systematic workflows, and domain expert consultation.
stars forks issues prs created last-commit release-date version license
Claude Code Documentation Mirror
by Eric Buess		 Workflows & Knowledge Guides General A mirror of the Anthropic © PBC documentation pages for Claude Code, updated every few hours. Can come in handy when trying to stay on top of the ever-expanding feature-set of Dr. Claw D. Code, Ph.D.
stars forks issues prs created last-commit release-date version license
claude-code-docs
by Constantin Shafranski		 Workflows & Knowledge Guides General A mirror of the Anthropic© PBC documentation site for Claude/Code, but with bonus features like full-text search and query-time updates - a nice companion to `claude-code-docs` for up-to-the-minute, fully-indexed information so that Claude Code can read about itself.
stars forks issues prs created last-commit release-date version license
Learn Claude Code
by shareAI-Lab		 Workflows & Knowledge Guides General A really interesting analysis of how coding agents like Claude Code are designed. It attempts to break an agent down into its fundamental parts and reconstruct it with minimal code. Great learning resource. Final product is a rudimentary agent with skills, sub-agents, and a todo-list in roughly a few hundred lines of Python.
stars forks issues prs created last-commit release-date version license
Simone
by Helmi		 Workflows & Knowledge Guides General A broader project management workflow for Claude Code that encompasses not just a set of commands, but a system of documents, guidelines, and processes to facilitate project planning and execution.
stars forks issues prs created last-commit release-date version license
n8n_agent
by kingler		 Workflows & Knowledge Guides General Amazing comprehensive set of comments for code analysis, QA, design, documentation, project structure, project management, optimization, and many more.
stars forks issues prs created last-commit release-date version license
Project Management, Implementation, Planning, and Release
by scopecraft		 Workflows & Knowledge Guides General Really comprehensive set of commands for all aspects of SDLC.
stars forks issues prs created last-commit release-date version license
Context Priming
by disler		 Workflows & Knowledge Guides General Provides a systematic approach to priming Claude Code with comprehensive project context through specialized commands for different project scenarios and development contexts.
stars forks issues prs created last-commit release-date version license
Project Bootstrapping and Task Management
by steadycursor		 Workflows & Knowledge Guides General Provides a structured set of commands for bootstrapping and managing a new project, including meta-commands for creating and editing custom slash-commands.
stars forks issues prs created last-commit release-date version license
Blogging Platform Instructions
by cloudartisan		 Workflows & Knowledge Guides General Provides a well-structured set of commands for publishing and maintaining a blogging platform, including commands for creating posts, managing categories, and handling media files.
stars forks issues prs created last-commit release-date version license
Project Workflow System
by harperreed		 Workflows & Knowledge Guides General A set of commands that provide a comprehensive workflow system for managing projects, including task management, code review, and deployment processes.
stars forks issues prs created last-commit release-date version license
--- **Total Resources:** 32 **Last Generated:** 2026-03-02 ================================================ FILE: README_ALTERNATIVES/README_FLAT_WORKFLOWS_RELEASES.md ================================================

Pick Your Style:

Awesome Extra Classic Flat

# Awesome Claude Code (Flat) [![Awesome](https://awesome.re/badge-flat2.svg)](https://awesome.re) A flat list view of all resources. Category: **Workflows** | Sorted: by latest release (30 days) --- ## Sort By:

A - Z UPDATED CREATED RELEASES

Category:

All Tooling Commands CLAUDE.md Workflows Hooks Skills Styles Status Docs Clients

Currently viewing: **Workflows** sorted by latest release (30 days) (past 30 days)

--- ## Resources > **Note:** Latest release data is pulled from GitHub Releases only. Projects without GitHub Releases will not show release info here. Please verify with the project directly.
Resource Version Source Release Date Description
Claude Code System Prompts
by Piebald AI		 v2.1.63 GitHub 2026-02-28 All parts of Claude Code's system prompt, including builtin tool descriptions, sub agent prompts (Plan/Explore/Task), utility prompts (CLAUDE.md, compact, Bash cmd, security review, agent creation, etc.). Updated for each Claude Code version.
stars forks issues prs created last-commit release-date version license
claude-code-docs
by Constantin Shafranski		 v0.6.0 GitHub 2026-02-28 A mirror of the Anthropic© PBC documentation site for Claude/Code, but with bonus features like full-text search and query-time updates - a nice companion to `claude-code-docs` for up-to-the-minute, fully-indexed information so that Claude Code can read about itself.
stars forks issues prs created last-commit release-date version license
Claude CodePro
by Max Ritter		 v7.0.6 GitHub 2026-02-26 Professional development environment for Claude Code with spec-driven workflow, TDD enforcement, cross-session memory, semantic search, quality hooks, and modular rules integration. A bit "heavyweight" but feature-packed and has wide coverage.
stars forks issues prs created last-commit release-date version license
ralph-orchestrator
by mikeyobrien		 v2.6.0 GitHub 2026-02-25 Ralph Orchestrator implements the simple but effective "Ralph Wiggum" technique for autonomous task completion, continuously running an AI agent against a prompt file until the task is marked as complete or limits are reached. This implementation provides a robust, well-tested, and feature-complete orchestration system for AI-driven development. Also cited in the Anthropic Ralph plugin documentation.
stars forks issues prs created last-commit release-date version license
Claude Code Tips
by ykdojo		 v0.25.1 GitHub 2026-02-22 A nice variety of 35+ brief but information-dense Claude Code tips covering voice input, system prompt patching, container workflows for risky tasks, conversation cloning(!), multi-model orchestration with Gemini CLI, and plenty more. Nice demos, working scripts, a plugin, I'd say this probably has a little something for everyone.
stars forks issues prs created last-commit release-date version license
--- **Total Resources:** 5 **Last Generated:** 2026-03-02 ================================================ FILE: README_ALTERNATIVES/README_FLAT_WORKFLOWS_UPDATED.md ================================================

Pick Your Style:

Awesome Extra Classic Flat

# Awesome Claude Code (Flat) [![Awesome](https://awesome.re/badge-flat2.svg)](https://awesome.re) A flat list view of all resources. Category: **Workflows** | Sorted: by last updated date --- ## Sort By:

A - Z UPDATED CREATED RELEASES

Category:

All Tooling Commands CLAUDE.md Workflows Hooks Skills Styles Status Docs Clients

Currently viewing: **Workflows** sorted by last updated date

--- ## Resources
Resource Category Sub-Category Description
Claude Code Handbook
by nikiforovall		 Workflows & Knowledge Guides General Collection of best practices, tips, and techniques for Claude Code development workflows, enhanced with distributable plugins
Shipping Real Code w/ Claude
by Diwank		 Workflows & Knowledge Guides General A detailed blog post explaining the author's process for shipping a product with Claude Code, including CLAUDE.md files and other interesting resources.
claude-code-docs
by Constantin Shafranski		 Workflows & Knowledge Guides General A mirror of the Anthropic© PBC documentation site for Claude/Code, but with bonus features like full-text search and query-time updates - a nice companion to `claude-code-docs` for up-to-the-minute, fully-indexed information so that Claude Code can read about itself.
stars forks issues prs created last-commit release-date version license
Claude Code Documentation Mirror
by Eric Buess		 Workflows & Knowledge Guides General A mirror of the Anthropic © PBC documentation pages for Claude Code, updated every few hours. Can come in handy when trying to stay on top of the ever-expanding feature-set of Dr. Claw D. Code, Ph.D.
stars forks issues prs created last-commit release-date version license
Blogging Platform Instructions
by cloudartisan		 Workflows & Knowledge Guides General Provides a well-structured set of commands for publishing and maintaining a blogging platform, including commands for creating posts, managing categories, and handling media files.
stars forks issues prs created last-commit release-date version license
ralph-orchestrator
by mikeyobrien		 Workflows & Knowledge Guides Ralph Wiggum Ralph Orchestrator implements the simple but effective "Ralph Wiggum" technique for autonomous task completion, continuously running an AI agent against a prompt file until the task is marked as complete or limits are reached. This implementation provides a robust, well-tested, and feature-complete orchestration system for AI-driven development. Also cited in the Anthropic Ralph plugin documentation.
stars forks issues prs created last-commit release-date version license
Claude CodePro
by Max Ritter		 Workflows & Knowledge Guides General Professional development environment for Claude Code with spec-driven workflow, TDD enforcement, cross-session memory, semantic search, quality hooks, and modular rules integration. A bit "heavyweight" but feature-packed and has wide coverage.
stars forks issues prs created last-commit release-date version license
Claude Code Tips
by ykdojo		 Workflows & Knowledge Guides General A nice variety of 35+ brief but information-dense Claude Code tips covering voice input, system prompt patching, container workflows for risky tasks, conversation cloning(!), multi-model orchestration with Gemini CLI, and plenty more. Nice demos, working scripts, a plugin, I'd say this probably has a little something for everyone.
stars forks issues prs created last-commit release-date version license
Claude Code Ultimate Guide
by Florian BRUNIAUX		 Workflows & Knowledge Guides General A tremendous feat of documentation, this guide covers Claude Code from beginner to power user, with production-ready templates for Claude Code features, guides on agentic workflows, and a lot of great learning materials, including quizzes and a handy "cheatsheet". Whether it's the "ultimate" guide to Claude Code will be up to the reader, but a valuable resource nonetheless (as with all documentation sites, make sure it's up to date before you bet the farm).
stars forks issues prs created last-commit release-date version license
Claude Code System Prompts
by Piebald AI		 Workflows & Knowledge Guides General All parts of Claude Code's system prompt, including builtin tool descriptions, sub agent prompts (Plan/Explore/Task), utility prompts (CLAUDE.md, compact, Bash cmd, security review, agent creation, etc.). Updated for each Claude Code version.
stars forks issues prs created last-commit release-date version license
Learn Claude Code
by shareAI-Lab		 Workflows & Knowledge Guides General A really interesting analysis of how coding agents like Claude Code are designed. It attempts to break an agent down into its fundamental parts and reconstruct it with minimal code. Great learning resource. Final product is a rudimentary agent with skills, sub-agents, and a todo-list in roughly a few hundred lines of Python.
stars forks issues prs created last-commit release-date version license
Ralph for Claude Code
by Frank Bria		 Workflows & Knowledge Guides Ralph Wiggum An autonomous AI development framework that enables Claude Code to work iteratively on projects until completion. Features intelligent exit detection, rate limiting, circuit breaker patterns, and comprehensive safety guardrails to prevent infinite loops and API overuse. Built with Bash, integrated with tmux for live monitoring, and includes 75+ comprehensive tests.
stars forks issues prs created last-commit release-date version license
Project Workflow System
by harperreed		 Workflows & Knowledge Guides General A set of commands that provide a comprehensive workflow system for managing projects, including task management, code review, and deployment processes.
stars forks issues prs created last-commit release-date version license
The Ralph Playbook
by Clayton Farr		 Workflows & Knowledge Guides Ralph Wiggum A remarkably detailed and comprehensive guide to the Ralph Wiggum technique, featuring well-written theoretical commentary paired with practical guidelines and advice.
stars forks issues prs created last-commit release-date version license
Claude Code Repos Index
by Daniel Rosehill		 Workflows & Knowledge Guides General This is either the work of a prolific genius, or a very clever bot (or both), although it hardly matters because the quality is so good - an index of 75+ Claude Code repositories published by the author - and I'm not talking about slop. CMS, system design, deep research, IoT, agentic workflows, server management, personal health... If you spot the lie, let me know, otherwise please check these out.
stars forks issues prs created last-commit release-date version license
RIPER Workflow
by Tony Narlock		 Workflows & Knowledge Guides General Structured development workflow enforcing separation between Research, Innovate, Plan, Execute, and Review phases. Features consolidated subagents for context-efficiency, branch-aware memory bank, and strict mode enforcement for guided development.
stars forks issues prs created last-commit release-date version license
ralph-wiggum-bdd
by marcindulak		 Workflows & Knowledge Guides Ralph Wiggum A standalone Bash script for Behavior-Driven Development with Ralph Wiggum Loop. In principle, while running unattended, the script can keep code and requirements in sync, but in practice it still requires interactive human supervision, so it supports both modes. The script is standalone and can be modified and committed into your project.
stars forks issues prs created last-commit release-date version license
awesome-ralph
by Martin Joly		 Workflows & Knowledge Guides Ralph Wiggum A curated list of resources about Ralph, the AI coding technique that runs AI coding agents in automated loops until specifications are fulfilled.
stars forks issues prs created last-commit release-date version license
Ralph Wiggum Marketer
by Muratcan Koylan		 Workflows & Knowledge Guides Ralph Wiggum A Claude Code plugin that provides an autonomous AI copywriter, integrating the Ralph loop with customized knowledge bases for market research agents. The agents do the research, Ralph writes the copy, you stay in bed. Whether or not you practice Ralph-Driven Development (RDD), I think these projects are interesting and creative explorations of general agentic patterns.
stars forks issues prs created last-commit release-date version license
Agentic Workflow Patterns
by ThibautMelen		 Workflows & Knowledge Guides General A comprehensive and well-documented collection of agentic patterns from Anthropic docs, with colorful Mermaid diagrams and code examples for each pattern. Covers Subagent Orchestration, Progressive Skills, Parallel Tool Calling, Master-Clone Architecture, Wizard Workflows, and more. Also compatible with other providers.
stars forks issues prs created last-commit release-date version license
ClaudoPro Directory
by ghost		 Workflows & Knowledge Guides General Well-crafted, wide selection of Claude Code hooks, slash commands, subagent files, and more, covering a range of specialized tasks and workflows. Better resources than your average "Claude-template-for-everything" site.
stars forks issues prs created last-commit release-date version license
learn-faster-kit
by Hugo Lau		 Workflows & Knowledge Guides General A creative educational framework for Claude Code, inspired by the "FASTER" approach to self-teaching. Ships with a variety of agents, slash commands, and tools that enable Claude Code to help you progress at your own pace, employing well-established pedagogical techniques like active learning and spaced repetition.
stars forks issues prs created last-commit release-date version license
AB Method
by Ayoub Bensalah		 Workflows & Knowledge Guides General A principled, spec-driven workflow that transforms large problems into focused, incremental missions using Claude Code's specialized sub agents. Includes slash-commands, sub agents, and specialized workflows designed for specific parts of the SDLC.
stars forks issues prs created last-commit release-date version license
Project Management, Implementation, Planning, and Release
by scopecraft		 Workflows & Knowledge Guides General Really comprehensive set of commands for all aspects of SDLC.
stars forks issues prs created last-commit release-date version license
Claude Code Infrastructure Showcase
by diet103		 Workflows & Knowledge Guides General A remarkably innovative approach to working with Skills, the centerpiece of which being a technique that leverages hooks to ensure that Claude intelligently selects and activates the appropriate Skill given the current context. Well-documented and adaptable to different projects and workflows.
stars forks issues prs created last-commit release-date version license
Claude Code PM
by Ran Aroussi		 Workflows & Knowledge Guides General Really comprehensive and feature-packed project-management workflow for Claude Code. Numerous specialized agents, slash-commands, and strong documentation.
stars forks issues prs created last-commit release-date version license
Design Review Workflow
by Patrick Ellis		 Workflows & Knowledge Guides General A tailored workflow for enabling automated UI/UX design review, including specialized sub agents, slash commands, `CLAUDE.md` excerpts, and more. Covers a broad range of criteria from responsive design to accessibility.
stars forks issues prs created last-commit release-date version license
Simone
by Helmi		 Workflows & Knowledge Guides General A broader project management workflow for Claude Code that encompasses not just a set of commands, but a system of documents, guidelines, and processes to facilitate project planning and execution.
stars forks issues prs created last-commit release-date version license
Context Priming
by disler		 Workflows & Knowledge Guides General Provides a systematic approach to priming Claude Code with comprehensive project context through specialized commands for different project scenarios and development contexts.
stars forks issues prs created last-commit release-date version license
Laravel TALL Stack AI Development Starter Kit
by tott		 Workflows & Knowledge Guides General Transform your Laravel TALL (Tailwind, AlpineJS, Laravel, Livewire) stack development with comprehensive Claude Code configurations that provide intelligent assistance, systematic workflows, and domain expert consultation.
stars forks issues prs created last-commit release-date version license
Project Bootstrapping and Task Management
by steadycursor		 Workflows & Knowledge Guides General Provides a structured set of commands for bootstrapping and managing a new project, including meta-commands for creating and editing custom slash-commands.
stars forks issues prs created last-commit release-date version license
n8n_agent
by kingler		 Workflows & Knowledge Guides General Amazing comprehensive set of comments for code analysis, QA, design, documentation, project structure, project management, optimization, and many more.
stars forks issues prs created last-commit release-date version license
--- **Total Resources:** 32 **Last Generated:** 2026-03-02 ================================================ FILE: THE_RESOURCES_TABLE.csv ================================================ ID,Display Name,Category,Sub-Category,Primary Link,Secondary Link,Author Name,Author Link,Active,Date Added,Last Modified,Last Checked,License,Description,Removed From Origin,Stale,Repo Created,Latest Release,Release Version,Release Source skill-ca8cbc21,AgentSys,Agent Skills,General,https://github.com/avifenesh/agentsys,,avifenesh,https://github.com/avifenesh,TRUE,2026-02-13:20-35-26,2026-03-14:22-56-36,2026-03-02:01-53-27,MIT,"Workflow automation system for Claude with a group of useful plugins, agents, and skills. Automates task-to-production workflows, PR management, code cleanup, performance investigation, drift detection, and multi-agent code review. Includes [agnix](https://github.com/avifenesh/agnix) for linting agent configurations. Built on thousands of lines of code with thousands of tests. Uses deterministic detection (regex, AST) with LLM judgment for efficiency. Used on many production systems.",FALSE,FALSE,2026-01-15:09-32-54,2026-03-10:11-26-39,v5.4.1,github-releases skill-bd56dc67,"AI Agent, AI Spy",Agent Skills,General,https://youtu.be/0ANECpNdt-4,,Whittaker & Tiwari,https://signalfoundation.org/,TRUE,2026-01-27:18-06-06,,2026-03-02:01-53-29,No License / Not Specified,"Members from the Signal Foundation with some really great tips and tricks on how to turn your operating system into an instrument of total surveillance, and why some companies are doing this really awesome thing. [warning: YouTube link]",FALSE,FALSE,,,, skill-35039a54,Book Factory,Agent Skills,General,https://github.com/robertguss/claude-skills,https://robertguss.github.io/claude-skills/,Robert Guss,https://github.com/robertguss,TRUE,2026-02-08:14-56-56,2026-03-13:23-20-35,2026-03-02:01-53-32,MIT,A comprehensive pipeline of Skills that replicates traditional publishing infrastructure for nonfiction book creation using specialized Claude skills.,FALSE,FALSE,2026-01-19:17-01-57,,, skill-a9ada349,cc-devops-skills,Agent Skills,General,https://github.com/akin-ozer/cc-devops-skills,,akin-ozer,https://github.com/akin-ozer,TRUE,2026-01-30:13-53-47,2026-03-03:20-07-08,2026-03-02:01-53-34,Apache-2.0,"Immensely detailed set of skills for DevOps Engineers (or anyone who has to deploy code, really). Works with validations, generators, shell scripts and CLI tools to create high quality IaC code for about any platform you've ever struggled painfully to work with. Worth downloading even just as a source of documentation.",FALSE,FALSE,2025-12-05:11-53-24,2026-03-04:06-44-32,v1.0.0,github-releases skill-448a4572,Claude Code Agents,Agent Skills,General,https://github.com/undeadlist/claude-code-agents,,Paul - UndeadList,https://github.com/undeadlist,TRUE,2026-02-11:20-41-43,2026-03-12:15-38-13,2026-03-02:01-53-37,MIT,"Comprehensive E2E development workflow with helpful Claude Code subagent prompts for solo devs. Run multiple auditors in parallel, automate fix cycles with micro-checkpoint protocols, and do browser-based QA. Includes strict protocols to prevent AI going rogue.",FALSE,FALSE,2025-12-24:06-47-31,,, skill-50f919d5,Claude Codex Settings,Agent Skills,General,https://github.com/fcakyon/claude-codex-settings,,fatih akyon,https://github.com/fcakyon,TRUE,2025-12-18:05-04-59,2026-03-14:01-13-40,2026-03-02:01-53-40,Apache-2.0,"A well-organized, well-written set of plugins covering core developer activities, such as working with common cloud platforms like GitHub, Azure, MongoDB, and popular services such as Tavily, Playwright, and more. Clear, not overly-opinionated, and compatible with a few other providers.",FALSE,FALSE,2025-07-09:07-46-08,2026-03-06:02-54-14,v2.2.0,github-releases skill-aeb4b7fa,Claude Mountaineering Skills,Agent Skills,General,https://github.com/dreamiurg/claude-mountaineering-skills,,Dmytro Gaivoronsky,https://github.com/dreamiurg,TRUE,2025-12-18:05-53-27,2026-02-18:00-08-08,2026-03-02:01-53-43,MIT,"Claude Code skill that automates mountain route research for North American peaks. Aggregates data from 10+ mountaineering sources like Mountaineers.org, PeakBagger.com and SummitPost.com to generate detailed route beta reports with weather, avalanche conditions, and trip reports.",FALSE,FALSE,2025-10-21:04-45-27,2026-01-30:09-50-19,v4.0.2,github-releases skill-53ad2e70,Claude Scientific Skills,Agent Skills,General,https://github.com/K-Dense-AI/claude-scientific-skills,,K-Dense,https://github.com/K-Dense-AI/,TRUE,2026-03-02:13-30-22,2026-03-11:16-59-08,2026-03-02:13-30-22,MIT,"""A set of ready-to-use Agent Skills for research, science, engineering, analysis, finance and writing."" That's their description - modest, simple. That's how you can tell this is really one of the best skills repos on GitHub. If you've ever thought about getting a PhD... just read all of these documents instead. Also I think it IS an AI agent or something? Awesome.",FALSE,FALSE,2025-10-19:20-54-16,2026-03-05:16-01-48,v2.27.0,github-releases skill-faba0faa,Codex Skill,Agent Skills,General,https://github.com/skills-directory/skill-codex,,klaudworks,https://github.com/klaudworks,TRUE,2025-10-27:13-24-10,2026-03-01:08-47-25,2026-03-02:01-53-45,MIT,"Enables users to prompt codex from claude code. Unlike the raw codex mcp server, this skill infers parameters such as model, reasoning effort, sandboxing from your prompt or asks you to specify them. It also simplifies continuing prior codex sessions so that codex can continue with the prior context.",FALSE,FALSE,2025-10-21:19-38-10,,, skill-bff92ab6,Compound Engineering Plugin,Agent Skills,General,https://github.com/EveryInc/compound-engineering-plugin,,EveryInc,https://github.com/EveryInc,TRUE,2026-01-22:13-46-43,2026-03-15:03-10-26,2026-03-02:01-53-48,MIT,"A very pragmatic set of well-designed agents, skills, and commands, built around a discipline of turning past mistakes and errors into lessons and opportunities for future growth and improvement. Good documentation.",FALSE,FALSE,2025-10-09:20-37-38,2026-03-15:03-10-33,v2.37.0,github-releases skill-e5b92436,Context Engineering Kit,Agent Skills,General,https://github.com/NeoLabHQ/context-engineering-kit,https://github.com/NeoLabHQ/context-engineering-kit?tab=readme-ov-file#reflexion,Vlad Goncharov,https://github.com/LeoVS09,TRUE,2025-12-06:14-29-49,2026-03-13:10-24-15,2026-03-02:01-53-51,GPL-3.0,Hand-crafted collection of advanced context engineering techniques and patterns with minimal token footprint focused on improving agent result quality.,FALSE,FALSE,2025-11-13:23-23-04,2026-02-24:22-32-05,v2.1.1,github-releases skill-3b08df01,Everything Claude Code,Agent Skills,General,https://github.com/affaan-m/everything-claude-code,,Affaan Mustafa,https://github.com/affaan-m/,TRUE,2026-01-24:17-41-01,2026-03-15:02-09-26,2026-03-02:01-53-54,MIT,"Top-notch, well-written resources covering ""just about everything"" from core engineering domains. What's nice about this ""everything-"" store is most of the resources have significant standalone value and unlike some all-encompassing frameworks, although you can opt in to the author's own specific workflow patterns if you choose, the individual resources offer exemplary patterns in (just about) every Claude Code feature you can find (apologies to the Output Styles devotees).",FALSE,FALSE,2026-01-18:01-49-33,2026-03-05:20-50-57,v1.8.0,github-releases skill-d69e3bc4,Fullstack Dev Skills,Agent Skills,General,https://github.com/jeffallan/claude-skills,,jeffallan,https://github.com/jeffallan,TRUE,2026-02-05:03-33-57,2026-03-06:21-28-38,2026-03-02:01-53-56,MIT,"A comprehensive Claude Code plugin with 65 specialized skills covering full-stack development across a wide range of specific frameworks. Features 9 project workflow commands for Jira/Confluence integration and, notably, an interesting approach to context engineering via a `/common-ground` command that surfaces Claude's hidden assumptions about your project. This is a smart thing to do.",FALSE,FALSE,2025-10-20:17-46-41,2026-03-06:21-29-39,v0.4.10,github-releases skill-cf9ee629,read-only-postgres,Agent Skills,General,https://github.com/jawwadfirdousi/agent-skills,,jawwadfirdousi,https://github.com/jawwadfirdousi,TRUE,2026-02-04:13-50-06,2026-03-08:19-42-23,2026-03-02:01-53-59,NOT_FOUND,"Read-only PostgreSQL query skill for Claude Code. Executes SELECT/SHOW/EXPLAIN/WITH queries across configured databases with strict validation, timeouts, and row limits. Supports multiple connections with descriptions for database selection.",FALSE,FALSE,2026-02-02:21-31-52,,, skill-294cc93f,Superpowers,Agent Skills,General,https://github.com/obra/superpowers,,Jesse Vincent,https://github.com/obra,TRUE,2025-12-22:07-20-47,2026-03-12:04-47-04,2026-03-02:01-54-02,MIT,"A strong bundle of core competencies for software engineering, with good coverage of a large portion of the SDLC - from planning, reviewing, testing, debugging... Well written, well organized, and adaptable. The author refers to them as ""superpowers"", but many of them are just consolidating engineering best practices - which sometimes does feel like a superpower when working with Claude Code.",FALSE,FALSE,2025-10-09:19-57-31,,, skill-17aac0cc,Trail of Bits Security Skills,Agent Skills,General,https://github.com/trailofbits/skills,,Trail of Bits,https://github.com/trailofbits,TRUE,2026-01-19:01-35-02,2026-03-04:05-24-19,2026-03-02:01-54-05,CC-BY-SA-4.0,"A very professional collection of over a dozen security-focused skills for code auditing and vulnerability detection. Includes skills for static analysis with CodeQL and Semgrep, variant analysis across codebases, fix verification, and differential code review.",FALSE,FALSE,2026-01-14:20-24-03,,, skill-bc4e0f53,TÂCHES Claude Code Resources,Agent Skills,General,https://github.com/glittercowboy/taches-cc-resources,,TÂCHES,https://github.com/glittercowboy,TRUE,2025-12-21:22-59-37,2026-01-26:02-10-29,2026-03-02:01-54-07,MIT,"A well-balanced, ""down-to-Earth"" set of sub agents, skills, and commands, that are well-organized, easy to read, and a healthy focus on ""meta""-skills/agents, like ""skill-auditor"", hook creation, etc. - the kind of things you can adapt to your workflow, and not the other way around.",FALSE,FALSE,2025-11-13:18-01-51,,, skill-1fc653a0,Web Assets Generator Skill,Agent Skills,General,https://github.com/alonw0/web-asset-generator,,Alon Wolenitz,https://github.com/alonw0,TRUE,2025-10-28:10-03-26,2026-01-28:09-11-01,2026-03-02:01-54-10,MIT,"Easily generate web assets from Claude Code including favicons, app icons (PWA), and social media meta images (Open Graph) for Facebook, Twitter, WhatsApp, and LinkedIn. Handles image resizing, text-to-image generation, emojis, and provides proper HTML meta tags.",FALSE,FALSE,2025-10-21:07-41-31,,, wf-996c4dd3,AB Method,Workflows & Knowledge Guides,General,https://github.com/ayoubben18/ab-method,,Ayoub Bensalah,https://github.com/ayoubben18,TRUE,2025-09-12:15-03-57,2025-11-10:21-57-15,2026-03-02:01-54-13,MIT,"A principled, spec-driven workflow that transforms large problems into focused, incremental missions using Claude Code's specialized sub agents. Includes slash-commands, sub agents, and specialized workflows designed for specific parts of the SDLC.",FALSE,TRUE,2025-08-10:15-41-14,2025-11-10:21-57-20,v2.3.0,github-releases wf-7d4f4706,Agentic Workflow Patterns,Workflows & Knowledge Guides,General,https://github.com/ThibautMelen/agentic-workflow-patterns,,ThibautMelen,https://github.com/ThibautMelen,TRUE,2025-11-26:16-41-49,2025-12-08:13-09-58,2026-03-02:01-54-17,NOT_FOUND,"A comprehensive and well-documented collection of agentic patterns from Anthropic docs, with colorful Mermaid diagrams and code examples for each pattern. Covers Subagent Orchestration, Progressive Skills, Parallel Tool Calling, Master-Clone Architecture, Wizard Workflows, and more. Also compatible with other providers.",FALSE,FALSE,2025-11-25:12-38-17,,, wf-8376d518,Blogging Platform Instructions,Workflows & Knowledge Guides,General,https://github.com/cloudartisan/cloudartisan.github.io/tree/main/.claude/commands,,cloudartisan,https://github.com/cloudartisan,TRUE,2025-07-29,2026-03-02:02-49-52,2026-03-02:01-54-19,CC-BY-SA-4.0,"Provides a well-structured set of commands for publishing and maintaining a blogging platform, including commands for creating posts, managing categories, and handling media files.",FALSE,FALSE,2022-08-30:06-33-20,,, wf-af6dda20,Claude Code Documentation Mirror,Workflows & Knowledge Guides,General,https://github.com/ericbuess/claude-code-docs,,Eric Buess,https://github.com/ericbuess,TRUE,2025-11-14:06-01-47,2026-03-15:03-56-19,2026-03-02:01-54-22,NOASSERTION,"A mirror of the Anthropic © PBC documentation pages for Claude Code, updated every few hours. Can come in handy when trying to stay on top of the ever-expanding feature-set of Dr. Claw D. Code, Ph.D.",FALSE,FALSE,2025-07-09:14-15-29,2025-11-14:21-55-13,v0.3.3,github-releases wf-fd5a0e6b,Claude Code Handbook,Workflows & Knowledge Guides,General,https://nikiforovall.blog/claude-code-rules/,,nikiforovall,https://github.com/nikiforovall,TRUE,2025-12-06:14-34-58,,2026-03-02:01-54-23,MIT,"Collection of best practices, tips, and techniques for Claude Code development workflows, enhanced with distributable plugins",FALSE,,,,, wf-82428576,Claude Code Infrastructure Showcase,Workflows & Knowledge Guides,General,https://github.com/diet103/claude-code-infrastructure-showcase,,diet103,https://github.com/diet103,TRUE,2025-11-06:03-29-17,2025-10-31:01-41-24,2026-03-02:01-54-25,MIT,"A remarkably innovative approach to working with Skills, the centerpiece of which being a technique that leverages hooks to ensure that Claude intelligently selects and activates the appropriate Skill given the current context. Well-documented and adaptable to different projects and workflows.",FALSE,TRUE,2025-10-29:21-54-53,,, wf-a59ba559,Claude Code PM,Workflows & Knowledge Guides,General,https://github.com/automazeio/ccpm,,Ran Aroussi,https://github.com/ranaroussi,TRUE,2025-09-01:07-52-50,2025-09-24:21-32-39,2026-03-02:01-54-28,MIT,"Really comprehensive and feature-packed project-management workflow for Claude Code. Numerous specialized agents, slash-commands, and strong documentation.",FALSE,TRUE,2025-08-18:23-20-08,,, wf-fc9e9c97,Claude Code Repos Index,Workflows & Knowledge Guides,General,https://github.com/danielrosehill/Claude-Code-Repos-Index,,Daniel Rosehill,https://github.com/danielrosehill,TRUE,2025-12-30:22-26-20,2026-03-14:17-04-42,2026-03-02:01-54-30,NOT_FOUND,"This is either the work of a prolific genius, or a very clever bot (or both), although it hardly matters because the quality is so good - an index of 75+ Claude Code repositories published by the author - and I'm not talking about slop. CMS, system design, deep research, IoT, agentic workflows, server management, personal health... If you spot the lie, let me know, otherwise please check these out.",FALSE,FALSE,2025-10-11:21-40-41,,, wf-b3c6f3e1,Claude Code System Prompts,Workflows & Knowledge Guides,General,https://github.com/Piebald-AI/claude-code-system-prompts,,Piebald AI,https://github.com/Piebald-AI,TRUE,2025-12-18:05-38-00,2026-03-14:01-12-48,2026-03-02:01-54-33,MIT,"All parts of Claude Code's system prompt, including builtin tool descriptions, sub agent prompts (Plan/Explore/Task), utility prompts (CLAUDE.md, compact, Bash cmd, security review, agent creation, etc.). Updated for each Claude Code version.",FALSE,FALSE,2025-11-19:04-50-55,2026-03-14:01-12-59,v2.1.76,github-releases wf-cb2d350a,Claude Code Tips,Workflows & Knowledge Guides,General,https://github.com/ykdojo/claude-code-tips,,ykdojo,https://github.com/ykdojo,TRUE,2025-12-29:17-30-42,2026-03-10:07-09-29,2026-03-02:01-54-36,NOASSERTION,"A nice variety of 35+ brief but information-dense Claude Code tips covering voice input, system prompt patching, container workflows for risky tasks, conversation cloning(!), multi-model orchestration with Gemini CLI, and plenty more. Nice demos, working scripts, a plugin, I'd say this probably has a little something for everyone.",FALSE,FALSE,2025-11-28:00-51-36,2026-03-07:02-59-47,v0.26.0,github-releases wf-918b0d98,Claude Code Ultimate Guide,Workflows & Knowledge Guides,General,https://github.com/FlorianBruniaux/claude-code-ultimate-guide,,Florian BRUNIAUX,https://www.linkedin.com/in/florian-bruniaux-43408b83/,TRUE,2026-02-11:18-31-46,2026-03-14:17-44-21,2026-03-02:01-54-38,CC-BY-SA-4.0,"A tremendous feat of documentation, this guide covers Claude Code from beginner to power user, with production-ready templates for Claude Code features, guides on agentic workflows, and a lot of great learning materials, including quizzes and a handy ""cheatsheet"". Whether it's the ""ultimate"" guide to Claude Code will be up to the reader, but a valuable resource nonetheless (as with all documentation sites, make sure it's up to date before you bet the farm).",FALSE,FALSE,2026-01-09:13-42-10,,, wf-84b47071,Claude CodePro,Workflows & Knowledge Guides,General,https://github.com/maxritter/claude-codepro,,Max Ritter,https://www.maxritter.net,TRUE,2025-12-18:06-16-04,2026-03-14:20-12-42,2026-03-02:01-54-42,NOASSERTION,"Professional development environment for Claude Code with spec-driven workflow, TDD enforcement, cross-session memory, semantic search, quality hooks, and modular rules integration. A bit ""heavyweight"" but feature-packed and has wide coverage.",FALSE,FALSE,2025-10-24:05-48-02,2026-03-14:20-12-44,v7.5.7,github-releases wf-dfd3f3db,claude-code-docs,Workflows & Knowledge Guides,General,https://github.com/costiash/claude-code-docs,https://github.com/costiash/claude-code-docs/blob/main/enhancements%2FCAPABILITIES.md,Constantin Shafranski,https://github.com/costiash,TRUE,2025-11-15:14-18-57,2026-03-15:00-43-33,2026-03-02:01-54-45,MIT,"A mirror of the Anthropic© PBC documentation site for Claude/Code, but with bonus features like full-text search and query-time updates - a nice companion to `claude-code-docs` for up-to-the-minute, fully-indexed information so that Claude Code can read about itself.",FALSE,FALSE,2025-07-09:14-15-29,2026-02-28:00-12-28,v0.6.0,github-releases wf-666ef1b9,ClaudoPro Directory,Workflows & Knowledge Guides,General,https://github.com/JSONbored/claudepro-directory,https://claudepro.directory/,ghost,https://github.com/JSONbored,TRUE,2025-09-25:13-57-35,2025-12-05:09-22-05,2026-03-02:01-54-47,MIT,"Well-crafted, wide selection of Claude Code hooks, slash commands, subagent files, and more, covering a range of specialized tasks and workflows. Better resources than your average ""Claude-template-for-everything"" site.",FALSE,FALSE,2025-09-15:01-34-08,,, wf-b98b3b2d,Context Priming,Workflows & Knowledge Guides,General,https://github.com/disler/just-prompt/tree/main/.claude/commands,,disler,https://github.com/disler,TRUE,,2025-08-10:19-05-50,2026-03-02:01-54-50,NOT_FOUND,Provides a systematic approach to priming Claude Code with comprehensive project context through specialized commands for different project scenarios and development contexts.,FALSE,TRUE,2025-03-20:17-36-32,,, wf-f9bf0f75,Design Review Workflow,Workflows & Knowledge Guides,General,https://github.com/OneRedOak/claude-code-workflows/tree/main/design-review,,Patrick Ellis,https://github.com/OneRedOak,TRUE,2025-09-11:20-01-42,2025-09-14:07-33-27,2026-03-02:01-54-52,MIT,"A tailored workflow for enabling automated UI/UX design review, including specialized sub agents, slash commands, `CLAUDE.md` excerpts, and more. Covers a broad range of criteria from responsive design to accessibility.",FALSE,TRUE,2025-08-12:03-34-54,,, wf-28d0fc92,Laravel TALL Stack AI Development Starter Kit,Workflows & Knowledge Guides,General,https://github.com/tott/laravel-tall-claude-ai-configs,,tott,https://github.com/tott,TRUE,2025-08-17:12-59-22,2025-08-08:14-35-05,2026-03-02:01-54-55,MIT,"Transform your Laravel TALL (Tailwind, AlpineJS, Laravel, Livewire) stack development with comprehensive Claude Code configurations that provide intelligent assistance, systematic workflows, and domain expert consultation.",FALSE,TRUE,2025-08-08:13-08-59,,, wf-98ee6249,Learn Claude Code,Workflows & Knowledge Guides,General,https://github.com/shareAI-lab/learn-claude-code,,shareAI-Lab,https://github.com/shareAI-lab/,TRUE,2026-01-27:20-55-32,2026-03-14:15-50-32,2026-03-02:01-54-58,MIT,"A really interesting analysis of how coding agents like Claude Code are designed. It attempts to break an agent down into its fundamental parts and reconstruct it with minimal code. Great learning resource. Final product is a rudimentary agent with skills, sub-agents, and a todo-list in roughly a few hundred lines of Python.",FALSE,FALSE,2025-06-29:15-34-15,,, wf-a50134d3,learn-faster-kit,Workflows & Knowledge Guides,General,https://github.com/cheukyin175/learn-faster-kit,,Hugo Lau,https://github.com/cheukyin175,TRUE,2025-12-03:07-10-47,2025-12-04:05-33-17,2026-03-02:01-55-02,MIT,"A creative educational framework for Claude Code, inspired by the ""FASTER"" approach to self-teaching. Ships with a variety of agents, slash commands, and tools that enable Claude Code to help you progress at your own pace, employing well-established pedagogical techniques like active learning and spaced repetition.",FALSE,FALSE,2025-11-10:08-22-09,,, wf-43a18fc2,n8n_agent,Workflows & Knowledge Guides,General,https://github.com/kingler/n8n_agent/tree/main/.claude/commands,,kingler,https://github.com/kingler,TRUE,,2025-05-16:17-30-29,2026-03-02:01-55-05,NOT_FOUND,"Amazing comprehensive set of comments for code analysis, QA, design, documentation, project structure, project management, optimization, and many more.",FALSE,TRUE,2025-05-16:17-30-29,,, wf-1fddaad0,Project Bootstrapping and Task Management,Workflows & Knowledge Guides,General,https://github.com/steadycursor/steadystart/tree/main/.claude/commands,,steadycursor,https://github.com/steadycursor,TRUE,,2025-08-03:20-24-42,2026-03-02:01-55-08,NOT_FOUND,"Provides a structured set of commands for bootstrapping and managing a new project, including meta-commands for creating and editing custom slash-commands.",FALSE,TRUE,2024-05-14:22-13-33,,, wf-bdb46cd1,"Project Management, Implementation, Planning, and Release",Workflows & Knowledge Guides,General,https://github.com/scopecraft/command/tree/main/.claude/commands,,scopecraft,https://github.com/scopecraft,TRUE,,2025-11-09:12-20-07,2026-03-02:01-55-10,NOT_FOUND,Really comprehensive set of commands for all aspects of SDLC.,FALSE,TRUE,2025-05-10:17-23-27,2025-06-06:04-25-20,v0.16.0,github-releases wf-42a8d5a5,Project Workflow System,Workflows & Knowledge Guides,General,https://github.com/harperreed/dotfiles/tree/master/.claude/commands,,harperreed,https://github.com/harperreed,TRUE,2025-07-29,2026-03-09:16-12-45,2026-03-02:01-55-13,NOT_FOUND,"A set of commands that provide a comprehensive workflow system for managing projects, including task management, code review, and deployment processes.",FALSE,FALSE,2020-08-29:19-56-31,,, wf-291eeb4a,RIPER Workflow,Workflows & Knowledge Guides,General,https://github.com/tony/claude-code-riper-5,,Tony Narlock,https://tony.sh,TRUE,2025-10-10:09-52-21,2026-02-08:00-06-34,2026-03-02:01-55-16,MIT,"Structured development workflow enforcing separation between Research, Innovate, Plan, Execute, and Review phases. Features consolidated subagents for context-efficiency, branch-aware memory bank, and strict mode enforcement for guided development.",FALSE,FALSE,2025-09-06:18-05-26,,, wf-eee9a073,Shipping Real Code w/ Claude,Workflows & Knowledge Guides,General,https://diwank.space/field-notes-from-shipping-real-code-with-claude,,Diwank,https://github.com/creatorrr,TRUE,,,2026-03-02:01-55-16,NOT_FOUND,"A detailed blog post explaining the author's process for shipping a product with Claude Code, including CLAUDE.md files and other interesting resources.",FALSE,,,,, wf-b4fe16fa,Simone,Workflows & Knowledge Guides,General,https://github.com/Helmi/claude-simone,,Helmi,https://github.com/Helmi,TRUE,2025-07-29,2025-08-26:12-11-04,2026-03-02:01-55-19,MIT,"A broader project management workflow for Claude Code that encompasses not just a set of commands, but a system of documents, guidelines, and processes to facilitate project planning and execution.",FALSE,TRUE,2025-05-23:12-05-25,2025-08-19:11-27-06,simone-mcp/v0.4.0,github-releases wf-b6f047e2,Slash-commands megalist,Workflows & Knowledge Guides,General,https://github.com/wcygan/dotfiles/tree/d8ab6b9f5a7a81007b7f5fa3025d4f83ce12cc02/claude/commands,,wcygan,https://github.com/wcygan,FALSE,2025-07-29,,2026-03-02:01-55-19,NOT_FOUND,"A pretty stunning list (88 at the time of this post!) of slash-commands ranging from agent orchestration, code review, project management, security, documentation, self-assessment, almost anything you can dream of.",FALSE,,2023-03-10:04-05-48,,, wf-61bd7b69,awesome-ralph,Workflows & Knowledge Guides,Ralph Wiggum,https://github.com/snwfdhmp/awesome-ralph,,Martin Joly,https://github.com/snwfdhmp,TRUE,2026-02-04:13-24-10,2026-02-03:08-34-42,2026-03-02:01-55-22,NOT_FOUND,"A curated list of resources about Ralph, the AI coding technique that runs AI coding agents in automated loops until specifications are fulfilled.",FALSE,FALSE,2026-01-19:08-42-54,,, wf-8ceac0c4,Ralph for Claude Code,Workflows & Knowledge Guides,Ralph Wiggum,https://github.com/frankbria/ralph-claude-code,,Frank Bria,https://github.com/frankbria,TRUE,2026-01-09:16-32-31,2026-02-25:22-56-55,2026-03-02:01-55-25,MIT,"An autonomous AI development framework that enables Claude Code to work iteratively on projects until completion. Features intelligent exit detection, rate limiting, circuit breaker patterns, and comprehensive safety guardrails to prevent infinite loops and API overuse. Built with Bash, integrated with tmux for live monitoring, and includes 75+ comprehensive tests.",FALSE,FALSE,2025-08-27:16-03-46,,, wf-2fdeff7e,Ralph Wiggum Marketer,Workflows & Knowledge Guides,Ralph Wiggum,https://github.com/muratcankoylan/ralph-wiggum-marketer,,Muratcan Koylan,https://github.com/muratcankoylan,TRUE,2026-01-13:14-06-16,2026-02-01:23-16-28,2026-03-02:01-55-27,NOT_FOUND,"A Claude Code plugin that provides an autonomous AI copywriter, integrating the Ralph loop with customized knowledge bases for market research agents. The agents do the research, Ralph writes the copy, you stay in bed. Whether or not you practice Ralph-Driven Development (RDD), I think these projects are interesting and creative explorations of general agentic patterns.",FALSE,FALSE,2026-01-07:07-49-14,,, wf-5e01a9a6,Ralph Wiggum Plugin,Workflows & Knowledge Guides,Ralph Wiggum,https://github.com/anthropics/claude-code/tree/4f18698a9ed25517861a75125b526e319bcf8354/plugins/ralph-wiggum,,Anthropic PBC,https://github.com/anthropics,FALSE,2026-01-10:21-13-16,2026-01-14:00-03-57,2026-01-14:16-36-08,©,"The official Anthropic implementation of the Ralph Wiggum technique for iterative, self-referential AI development loops in Claude Code.",FALSE,FALSE,2025-02-22:17-29-29,2026-01-14:00-04-17,v2.1.7,github-releases wf-bc51a50b,ralph-orchestrator,Workflows & Knowledge Guides,Ralph Wiggum,https://github.com/mikeyobrien/ralph-orchestrator,https://mikeyobrien.github.io/ralph-orchestrator/,mikeyobrien,https://github.com/mikeyobrien,TRUE,2026-01-10:19-24-51,2026-03-14:17-13-04,2026-03-02:01-55-30,MIT,"Ralph Orchestrator implements the simple but effective ""Ralph Wiggum"" technique for autonomous task completion, continuously running an AI agent against a prompt file until the task is marked as complete or limits are reached. This implementation provides a robust, well-tested, and feature-complete orchestration system for AI-driven development. Also cited in the Anthropic Ralph plugin documentation.",FALSE,FALSE,2025-09-07:16-55-41,2026-03-10:02-15-32,v2.8.0,github-releases wf-316367ff,ralph-wiggum-bdd,Workflows & Knowledge Guides,Ralph Wiggum,https://github.com/marcindulak/ralph-wiggum-bdd,,marcindulak,https://github.com/marcindulak,TRUE,2026-02-03:05-23-14,2026-03-13:19-30-52,2026-03-02:01-55-33,Apache-2.0,"A standalone Bash script for Behavior-Driven Development with Ralph Wiggum Loop. In principle, while running unattended, the script can keep code and requirements in sync, but in practice it still requires interactive human supervision, so it supports both modes. The script is standalone and can be modified and committed into your project.",FALSE,FALSE,2026-01-20:03-11-32,,, wf-aa051a6c,The Ralph Playbook,Workflows & Knowledge Guides,Ralph Wiggum,https://github.com/ClaytonFarr/ralph-playbook,,Clayton Farr,https://github.com/ClaytonFarr,TRUE,2026-01-13:04-31-02,2026-03-06:21-56-54,2026-03-02:01-55-35,NOT_FOUND,"A remarkably detailed and comprehensive guide to the Ralph Wiggum technique, featuring well-written theoretical commentary paired with practical guidelines and advice.",FALSE,FALSE,2026-01-09:21-54-12,,, tool-9f8d507e,cc-sessions,Tooling,General,https://github.com/GWUDCAP/cc-sessions,,toastdev,https://github.com/satoastshi,TRUE,2025-10-24:22-04-36,2025-10-17:14-50-52,2026-03-02:01-55-38,MIT,An opinionated approach to productive development with Claude Code,FALSE,TRUE,2025-08-26:17-02-09,2025-10-17:13-34-37,v0.3.6,github-releases hook-edd83641,cc-tools,Tooling,General,https://github.com/Veraticus/cc-tools,,Josh Symonds,https://github.com/Veraticus,TRUE,2025-07-29,2026-01-22:00-17-15,2026-03-02:01-55-42,NOT_FOUND,"High-performance Go implementation of Claude Code hooks and utilities. Provides smart linting, testing, and statusline generation with minimal overhead.",FALSE,FALSE,2025-08-25:23-40-18,,, tool-b7bb841e,ccexp,Tooling,General,https://github.com/nyatinte/ccexp,https://www.npmjs.com/package/ccexp,nyatinte,https://github.com/nyatinte,TRUE,2025-07-29,2025-11-08:18-40-34,2026-03-02:01-55-44,MIT,Interactive CLI tool for discovering and managing Claude Code configuration files and slash commands with a beautiful terminal UI.,FALSE,TRUE,2025-06-30:16-28-36,2025-07-30:12-59-21,v4.0.0,github-releases tool-d9c9bde8,cchistory,Tooling,General,https://github.com/eckardt/cchistory,,eckardt,https://github.com/eckardt,TRUE,2025-08-30:01-30-34,2025-10-23:11-41-46,2026-03-02:01-55-47,MIT,"Like the shell history command but for your Claude Code sessions. Easily list all Bash or ""Bash-mode"" (`!`) commands Claude Code ran in a session for reference.",FALSE,TRUE,2025-06-07:16-37-43,2025-09-10:18-14-40,v0.2.1,github-releases tool-48212d39,cclogviewer,Tooling,General,https://github.com/Brads3290/cclogviewer,,Brad S.,https://github.com/Brads3290,TRUE,2025-08-05:11-48-39,2025-08-08:08-12-45,2026-03-02:01-55-49,MIT,A humble but handy utility for viewing Claude Code `.jsonl` conversation files in a pretty HTML UI.,FALSE,TRUE,2025-07-27:23-02-49,,, tool-d95e578f,Claude Code Templates,Tooling,General,https://github.com/davila7/claude-code-templates,https://www.npmjs.com/package/claude-code-templates,Daniel Avila,https://github.com/davila7,TRUE,2025-08-24:09-32-10,2026-03-14:03-50-31,2026-03-02:01-55-52,MIT,"Incredibly awesome collection of resources from every category in this list, presented with a neatly polished UI, great features like usage dashboard, analytics, and everything from slash commands to hooks to agents. An awesome companion for this awesome list.",FALSE,FALSE,2025-07-04:01-35-24,2025-11-15:20-41-43,v1.28.3,github-releases tool-552cdcdf,Claude Composer,Tooling,General,https://github.com/possibilities/claude-composer,,Mike Bannister,https://github.com/possibilities,TRUE,2025-07-29,2025-07-31:02-29-50,2026-03-02:01-55-54,Unlicense,A tool that adds small enhancements to Claude Code.,FALSE,TRUE,2025-05-28:13-05-08,,, tool-ca25af98,Claude Hub,Tooling,General,https://github.com/claude-did-this/claude-hub,,Claude Did This,https://github.com/claude-did-this,TRUE,2025-07-29,2025-06-20:16-16-08,2026-03-02:01-55-57,NOT_FOUND,"A webhook service that connects Claude Code to GitHub repositories, enabling AI-powered code assistance directly through pull requests and issues. This integration allows Claude to analyze repositories, answer technical questions, and help developers understand and improve their codebase through simple @mentions.",FALSE,TRUE,2025-05-20:17-01-59,2025-05-31:18-48-30,v0.1.1,github-releases tool-0b63bd5f,Claude Session Restore,Tooling,General,https://github.com/ZENG3LD/claude-session-restore,,ZENG3LD,https://github.com/ZENG3LD,TRUE,2026-01-29:01-51-46,2026-01-26:07-54-17,2026-03-02:01-56-00,NOASSERTION,Efficiently restore context from previous Claude Code sessions by analyzing session files and git history. Features multi-factor data collection across numerous Claude Code capacities with time-based filtering. Uses tail-based parsing for efficient handling of large session files up to 2GB. Includes both a CLI tool for manual analysis and a Claude Code skill for automatic session restoration.,FALSE,FALSE,2026-01-26:07-13-54,,, tool-3bb5a470,claude-code-tools,Tooling,General,https://github.com/pchalasani/claude-code-tools,,Prasad Chalasani,https://github.com/pchalasani,TRUE,2025-08-05:12-08-07,2026-03-09:21-47-49,2026-03-02:01-56-02,MIT,"Well-crafted toolset for session continuity, featuring skills/commands to avoid compaction and recover context across sessions with cross-agent handoff between Claude Code and Codex CLI. Includes a fast Rust/Tantivy-powered full-text session search (TUI for humans, skill/CLI for agents), tmux-cli skill + command for interacting with scripts and CLI agents, and safety hooks to block dangerous commands.",FALSE,FALSE,2025-07-31:11-39-16,2026-03-09:16-25-22,v1.10.8,github-releases tool-8b0193b7,claude-starter-kit,Tooling,General,https://github.com/serpro69/claude-starter-kit,,serpro69,https://github.com/serpro69,TRUE,2025-12-06:09-40-40,2026-03-12:15-05-22,2026-03-02:01-56-05,MIT,"This is a starter template repository designed to provide a complete development environment for Claude-Code with pre-configured MCP servers and tools for AI-powered development workflows. The repository is intentionally minimal, containing only configuration templates for three primary systems: Claude Code, Serena, and Task Master.",FALSE,FALSE,2025-10-17:10-31-30,2026-03-11:10-12-45,v0.3.0,github-releases tool-1cbdd0fb,claudekit,Tooling,General,https://github.com/carlrannaberg/claudekit,https://www.npmjs.com/package/claudekit,Carl Rannaberg,https://github.com/carlrannaberg,TRUE,2025-08-24:07-25-28,2026-01-15:07-30-07,2026-03-02:01-56-08,MIT,"Impressive CLI toolkit providing auto-save checkpointing, code quality hooks, specification generation and execution, and 20+ specialized subagents including oracle (gpt-5), code-reviewer (6-aspect deep analysis), ai-sdk-expert (Vercel AI SDK), typescript-expert and many more for Claude Code workflows.",FALSE,FALSE,2025-07-11:19-10-32,2025-09-28:22-17-04,v0.9.4,github-releases tool-af235370,Container Use,Tooling,General,https://github.com/dagger/container-use,,dagger,https://github.com/dagger,TRUE,2025-07-29,2026-02-23:12-37-45,2026-03-02:01-56-11,Apache-2.0,Development environments for coding agents. Enable multiple agents to work safely and independently with your preferred stack.,FALSE,FALSE,2025-05-27:17-37-49,2025-08-19:22-31-40,v0.4.2,github-releases tool-b3562922,ContextKit,Tooling,General,https://github.com/FlineDev/ContextKit,,Cihat Gündüz,https://github.com/Jeehut,TRUE,2025-10-10:09-45-34,2026-03-10:00-49-40,2026-03-02:01-56-14,MIT,"A systematic development framework that transforms Claude Code into a proactive development partner. Features 4-phase planning methodology, specialized quality agents, and structured workflows that help AI produce production-ready code on first try.",FALSE,FALSE,2025-09-12:09-49-38,2025-10-17:14-33-20,0.2.0,github-releases tool-6e6f1ae1,recall,Tooling,General,https://github.com/zippoxer/recall,,zippoxer,https://github.com/zippoxer,TRUE,2025-12-03:07-17-55,2026-01-14:07-49-55,2026-03-02:01-56-16,MIT,"Full-text search your Claude Code sessions. Run `recall` in terminal, type to search, Enter to resume. Alternative to `claude --resume`.",FALSE,FALSE,2025-11-28:03-10-12,2026-01-13:18-50-54,v0.5.0,github-releases tool-5845fda0,Rulesync,Tooling,General,https://github.com/dyoshikawa/rulesync,,dyoshikawa,https://github.com/dyoshikawa,TRUE,2025-10-16:13-16-02,2026-03-13:09-27-19,2026-03-02:01-56-19,MIT,"A Node.js CLI tool that automatically generates configs (rules, ignore files, MCP servers, commands, and subagents) for various AI coding agents. Rulesync can convert configs between Claude Code and other AI agents in both directions.",FALSE,FALSE,2025-06-18:13-17-53,2026-03-13:09-25-25,v7.18.2,github-releases tool-a5798d4b,run-claude-docker,Tooling,General,https://github.com/icanhasjonas/run-claude-docker,,Jonas,https://github.com/icanhasjonas/,TRUE,2025-09-26:05-55-44,2025-08-14:21-00-39,2026-03-02:01-56-21,MIT,"A self-contained Docker runner that forwards your current workspace into a safe(r) isolated docker container, where you still have access to your Claude Code settings, authentication, ssh agent, pgp, optionally aws keys etc.",FALSE,TRUE,2025-08-13:19-28-10,,, tool-4a5cf064,stt-mcp-server-linux,Tooling,General,https://github.com/marcindulak/stt-mcp-server-linux,,marcindulak,https://github.com/marcindulak,TRUE,2025-09-13:02-17-09,2026-01-10:20-37-37,2026-03-02:01-56-24,Apache-2.0,"A push-to-talk speech transcription setup for Linux using a Python MCP server. Runs locally in Docker with no external API calls. Your speech is recorded, transcribed into text, and then sent to Claude running in a Tmux session.",FALSE,FALSE,2025-09-07:00-38-51,,, tool-5f5d572e,SuperClaude,Tooling,General,https://github.com/SuperClaude-Org/SuperClaude_Framework,https://superclaude.netlify.app/,SuperClaude-Org,https://github.com/SuperClaude-Org,TRUE,2025-09-11:13-42-12,2026-02-25:09-14-50,2026-03-02:01-56-26,MIT,"A versatile configuration framework that enhances Claude Code with specialized commands, cognitive personas, and development methodologies, such as ""Introspection"" and ""Orchestration"".",FALSE,FALSE,2025-07-14:12-28-11,2026-01-18:13-12-50,v4.2.0,github-releases tool-8d2e7868,tweakcc,Tooling,General,https://github.com/Piebald-AI/tweakcc,,Piebald-AI,https://github.com/Piebald-AI,TRUE,,2026-03-13:16-35-10,2026-03-02:01-56-29,MIT,Command-line tool to customize your Claude Code styling.,FALSE,FALSE,2025-07-20:21-30-47,2026-03-05:19-05-20,v4.0.11,github-releases tool-0b63c72c,Vibe-Log,Tooling,General,https://github.com/vibe-log/vibe-log-cli,,Vibe-Log,https://github.com/vibe-log,TRUE,2025-10-10:10-38-18,2025-12-10:22-44-22,2026-03-02:01-56-32,MIT,"Analyzes your Claude Code prompts locally (using CC), provides intelligent session analysis and actionable strategic guidance - works in the statusline and produces very pretty HTML reports as well. Easy to install and remove.",FALSE,FALSE,2025-08-15:18-42-36,2025-12-05:16-47-32,v0.8.6,github-releases tool-fcf2812e,viwo-cli,Tooling,General,https://github.com/OverseedAI/viwo,,Hal Shin,https://github.com/hal-shin,TRUE,2025-12-06:09-03-50,2026-01-09:05-24-30,2026-03-02:01-56-34,MIT,Run Claude Code in a Docker container with git worktrees as volume mounts to enable safer usage of `--dangerously-skip-permissions` for frictionless one-shotting prompts. Allows users to spin up multiple instances of Claude Code in the background easily with reduced permission fatigue.,FALSE,FALSE,2025-09-04:17-05-44,2026-01-05:22-16-44,v0.5.0,github-releases tool-1e4657fd,VoiceMode MCP,Tooling,General,https://github.com/mbailey/voicemode,https://getvoicemode.com,Mike Bailey,https://github.com/mbailey,TRUE,2025-10-16:12-54-25,2026-03-14:22-14-11,2026-03-02:01-56-37,MIT,VoiceMode MCP brings natural conversations to Claude Code. It supports any OpenAI API compatible voice services and installs free and open source voice services (Whisper.cpp and Kokoro-FastAPI).,FALSE,FALSE,2025-06-08:16-20-50,2026-03-13:14-49-26,v8.5.1,github-releases tool-984936a7,Claude Code Chat,Tooling,IDE Integrations,https://marketplace.visualstudio.com/items?itemName=AndrePimenta.claude-code-chat,,andrepimenta,https://github.com/andrepimenta,TRUE,,,2025-07-18:02-03-39,©,An elegant and user-friendly Claude Code chat interface for VS Code.,FALSE,,,,, tool-5ab1a854,claude-code-ide.el,Tooling,IDE Integrations,https://github.com/manzaltu/claude-code-ide.el,,manzaltu,https://github.com/manzaltu,TRUE,2025-08-07:18-26-57,2026-02-02:15-47-13,2026-03-02:01-56-40,GPL-3.0,"claude-code-ide.el integrates Claude Code with Emacs, like Anthropic’s VS Code/IntelliJ extensions. It shows ediff-based code suggestions, pulls LSP/flymake/flycheck diagnostics, and tracks buffer context. It adds an extensible MCP tool support for symbol refs/defs, project metadata, and tree-sitter AST queries.",FALSE,FALSE,2025-06-23:21-33-22,,, tool-941ef941,claude-code.el,Tooling,IDE Integrations,https://github.com/stevemolitor/claude-code.el,,stevemolitor,https://github.com/stevemolitor,TRUE,2025-07-29,2025-12-18:22-56-06,2026-03-02:01-56-42,Apache-2.0,An Emacs interface for Claude Code CLI.,FALSE,FALSE,2025-03-13:04-40-23,,, tool-0607ef06,claude-code.nvim,Tooling,IDE Integrations,https://github.com/greggh/claude-code.nvim,,greggh,https://github.com/greggh,TRUE,2025-07-29,2026-02-04:14-44-50,2026-03-02:01-56-45,MIT,A seamless integration between Claude Code AI assistant and Neovim.,FALSE,FALSE,2025-02-24:21-33-14,2025-03-21:14-43-57,v0.4.3,github-releases tool-7e19bf77,Claudix - Claude Code for VSCode,Tooling,IDE Integrations,https://github.com/Haleclipse/Claudix,,Haleclipse,https://github.com/Haleclipse,TRUE,2025-12-06:14-05-06,2025-12-08:18-25-11,2026-03-02:01-56-47,AGPL-3.0,"A VSCode extension that brings Claude Code directly into your editor with interactive chat interface, session management, intelligent file operations, terminal execution, and real-time streaming responses. Built with Vue 3, TypeScript.",FALSE,FALSE,2025-11-13:12-04-40,2026-03-13:02-33-48,0.3.9-dev,github-releases tool-631dbe0f,CC Usage,Tooling,Usage Monitors,https://github.com/ryoppippi/ccusage,,ryoppippi,https://github.com/ryoppippi,TRUE,2025-07-29,2026-03-10:14-48-40,2026-03-02:01-56-50,NOASSERTION,"Handy CLI tool for managing and analyzing Claude Code usage, based on analyzing local Claude Code logs. Presents a nice dashboard regarding cost information, token consumption, etc.",FALSE,FALSE,2025-05-29:17-51-05,2026-03-10:06-30-56,v18.0.10,github-releases tool-ec858306,ccflare,Tooling,Usage Monitors,https://github.com/snipeship/ccflare,https://ccflare.com/,snipeship,https://github.com/snipeship,TRUE,2025-08-19:01-02-03,2025-08-24:20-28-28,2026-03-02:01-56-52,MIT,"Claude Code usage dashboard with a web-UI that would put Tableau to shame. Thoroughly comprehensive metrics, frictionless setup, detailed logging, really really nice UI.",FALSE,TRUE,2025-07-25:08-34-30,,, tool-fe142d2f,ccflare -> **better-ccflare**,Tooling,Usage Monitors,https://github.com/tombii/better-ccflare/,,tombii,https://github.com/tombii,TRUE,2025-12-05:14-19-09,2026-03-14:21-46-04,2026-03-02:01-56-55,MIT,"A well-maintained and feature-enhanced fork of the glorious `ccflare` usage dashboard by @snipeship (which at the time of writing has not had an update in a few months). `better-ccflare` builds on this foundation with some performance enhancements, extended provider support, bug fixes, Docker deployment, and more.",FALSE,FALSE,2025-07-25:08-34-30,2026-03-14:21-47-08,v3.3.10,github-releases tool-ca599740,Claude Code Usage Monitor,Tooling,Usage Monitors,https://github.com/Maciek-roboblog/Claude-Code-Usage-Monitor,,Maciek-roboblog,https://github.com/Maciek-roboblog,TRUE,2025-07-29,2025-07-23:22-21-42,2026-03-02:01-56-57,MIT,"A real-time terminal-based tool for monitoring Claude Code token usage. It shows live token consumption, burn rate, and predictions for token depletion. Features include visual progress bars, session-aware analytics, and support for multiple subscription plans.",FALSE,TRUE,2025-06-18:23-56-54,2025-07-23:22-13-19,v3.1.0,github-releases tool-61d0c1d6,Claudex,Tooling,Usage Monitors,https://github.com/kunwar-shah/claudex,https://kunwar-shah.github.io/claudex/#/,Kunwar Shah,https://github.com/kunwar-shah,TRUE,2025-11-01:06-27-56,2026-02-14:18-09-14,2026-03-02:01-57-00,MIT,"Claudex - A web-based browser for exploring your Claude Code conversation history across projects. Indexes your codebase for full-text search. Nice, easy-to-navigate UI. Simple dashboard interface for high-level analytics, and multiple export options as well. (And completely local w/ no telemetry!)",FALSE,FALSE,2025-09-12:08-30-58,2026-02-12:13-09-53,v1.3.0,github-releases tool-a375ba14,viberank,Tooling,Usage Monitors,https://github.com/sculptdotfun/viberank,,nikshepsvn,https://github.com/nikshepsvn,TRUE,2025-08-07:18-55-54,2026-01-26:03-24-16,2026-03-02:01-57-03,MIT,"A community-driven leaderboard tool that enables developers to visualize, track, and compete based on their Claude Code usage statistics. It features robust data analytics, GitHub OAuth, data validation, and user-friendly CLI/web submission methods.",FALSE,FALSE,2025-07-02:22-48-41,,, tool-8d6f8d23,Auto-Claude,Tooling,Orchestrators,https://github.com/AndyMik90/Auto-Claude,,AndyMik90,https://github.com/AndyMik90,TRUE,2026-02-13:20-02-48,2026-03-14:08-15-03,2026-03-02:01-57-05,AGPL-3.0,"Autonomous multi-agent coding framework for Claude Code (Claude Agent SDK) that integrates the full SDLC - ""plans, builds, and validates software for you"". Features a slick kanban-style UI and a well-designed but not over-engineered agent orchestration system.",FALSE,FALSE,2025-12-04:22-10-40,2026-02-20:11-47-15,v2.7.6,github-releases tool-3b3bedca,Claude Code Flow,Tooling,Orchestrators,https://github.com/ruvnet/claude-code-flow,,ruvnet,https://github.com/ruvnet,TRUE,2025-07-29,2026-03-09:15-59-17,2026-03-02:01-57-09,MIT,"This mode serves as a code-first orchestration layer, enabling Claude to write, edit, test, and optimize code autonomously across recursive agent cycles.",FALSE,FALSE,2025-06-02:21-24-20,2026-03-09:15-59-33,v3.5.15,github-releases tool-5d0685f2,Claude Squad,Tooling,Orchestrators,https://github.com/smtg-ai/claude-squad,,smtg-ai,https://github.com/smtg-ai,TRUE,2025-07-29,2026-03-12:07-38-42,2026-03-02:01-57-11,AGPL-3.0,"Claude Squad is a terminal app that manages multiple Claude Code, Codex (and other local agents including Aider) in separate workspaces, allowing you to work on multiple tasks simultaneously.",FALSE,FALSE,2025-03-09:21-02-23,2026-03-12:07-40-53,v1.0.17,github-releases tool-1af2fe4c,Claude Swarm,Tooling,Orchestrators,https://github.com/parruda/claude-swarm,,parruda,https://github.com/parruda,TRUE,2025-07-29,2026-02-12:01-56-02,2026-03-02:01-57-15,MIT,Launch Claude Code session that is connected to a swarm of Claude Code Agents.,FALSE,FALSE,2025-05-28:21-09-56,2026-02-12:02-02-31,swarm_sdk-v2.7.15,github-releases tool-a1e3d643,Claude Task Master,Tooling,Orchestrators,https://github.com/eyaltoledano/claude-task-master,,eyaltoledano,https://github.com/eyaltoledano,TRUE,2025-07-29,2026-02-04:13-54-29,2026-03-02:01-57-17,NOASSERTION,"A task management system for AI-driven development with Claude, designed to work seamlessly with Cursor AI.",FALSE,FALSE,2025-03-04:18-55-17,2026-02-04:13-56-27,task-master-ai@0.43.0,github-releases tool-f81477b3,Claude Task Runner,Tooling,Orchestrators,https://github.com/grahama1970/claude-task-runner,,grahama1970,https://github.com/grahama1970,TRUE,2025-07-29,2025-05-13:23-08-49,2026-03-02:01-57-20,NOT_FOUND,"A specialized tool to manage context isolation and focused task execution with Claude Code, solving the critical challenge of context length limitations and task focus when working with Claude on complex, multi-step projects.",FALSE,TRUE,2025-05-13:13-31-23,,, tool-b4facb98,Happy Coder,Tooling,Orchestrators,https://github.com/slopus/happy,https://happy.engineering/docs,GrocerPublishAgent,https://peoplesgrocers.com/en/projects,TRUE,2025-08-29:11-57-49,2026-02-26:07-05-55,2026-03-02:01-57-23,MIT,"Spawn and control multiple Claude Codes in parallel from your phone or desktop. Happy Coder runs Claude Code on your hardware, sends push notifications when Claude needs more input or permission, and costs nothing.",FALSE,FALSE,2025-07-13:02-09-56,,, tool-f660ade2,sudocode,Tooling,Orchestrators,https://github.com/sudocode-ai/sudocode,,ssh-randy,https://github.com/ssh-randy,TRUE,2026-02-26:09-28-31,2026-03-07:07-02-46,2026-03-02:01-57-26,Apache-2.0,Lightweight agent orchestration dev tool that lives in your repo. Integrates with various specification frameworks. It's giving Jira.,FALSE,FALSE,2025-10-15:23-36-20,2026-03-07:07-10-48,v0.1.26,github-releases tool-9c3f497a,The Agentic Startup,Tooling,Orchestrators,https://github.com/rsmdt/the-startup,,Rudolf Schmidt,https://github.com/rsmdt,TRUE,2025-09-28:14-25-25,2026-02-28:12-50-54,2026-03-02:01-57-28,MIT,"Yet Another Claude Orchestrator - a collection of agents, commands, etc., for shipping production code - but I like this because it's comprehensive, well-written, and one of the few resources that actually uses Output Styles! +10 points!",FALSE,FALSE,2025-08-03:15-01-03,2026-02-28:12-54-35,v3.4.0,github-releases tool-5fb873b1,TSK - AI Agent Task Manager and Sandbox,Tooling,Orchestrators,https://github.com/dtormoen/tsk,,dtormoen,https://github.com/dtormoen,TRUE,,2026-03-14:23-02-51,2026-03-02:01-57-32,MIT,"A Rust CLI tool that lets you delegate development tasks to AI agents running in sandboxed Docker environments. Multiple agents work in parallel, returning git branches for human review.",FALSE,FALSE,2025-05-31:18-27-41,2026-03-14:23-04-32,v0.10.4,github-releases tool-df3ddc27,claude-rules-doctor,Tooling,Config Managers,https://github.com/nulone/claude-rules-doctor,,nulone,https://github.com/nulone,TRUE,2026-02-15:00-50-56,2026-02-25:02-41-47,2026-03-02:01-57-35,MIT,"CLI that detects dead `.claude/rules/` files by checking if `paths:` globs actually match files in your repo. Catches silent rule failures where renamed directories or typos in glob patterns cause rules to never apply. Features CI mode (exit 1 on dead rules), JSON output, and verbose mode showing matched files.",FALSE,FALSE,2026-01-28:14-16-00,2026-01-28:23-46-17,v0.2.2,github-releases tool-7c53b5cb,ClaudeCTX,Tooling,Config Managers,https://github.com/foxj77/claudectx,,John Fox,https://github.com/foxj77,TRUE,2026-02-14:00-00-00,2026-01-26:20-39-06,2026-03-02:01-57-37,MIT,claudectx lets you switch your entire Claude Code configuration with a single command.,FALSE,FALSE,,2026-01-02:22-50-20,v1.2.0,github-releases status-d69e91f3,CCometixLine - Claude Code Statusline,Status Lines,General,https://github.com/Haleclipse/CCometixLine,,Haleclipse,https://github.com/Haleclipse,TRUE,2025-12-06:14-50-30,2026-03-14:17-54-39,2026-03-02:01-57-40,NOT_FOUND,"A high-performance Claude Code statusline tool written in Rust with Git integration, usage tracking, interactive TUI configuration, and Claude Code enhancement utilities.",FALSE,FALSE,2025-08-11:16-23-41,2026-03-14:18-05-45,v1.1.2,github-releases status-4e8a47cf,ccstatusline,Status Lines,General,https://github.com/sirmalloc/ccstatusline,https://www.npmjs.com/package/ccstatusline,sirmalloc,https://github.com/sirmalloc,TRUE,2025-08-12:19-47-59,2026-03-15:03-06-44,2026-03-02:01-57-42,MIT,"A highly customizable status line formatter for Claude Code CLI that displays model info, git branch, token usage, and other metrics in your terminal.",FALSE,FALSE,2025-08-08:11-20-28,,, status-83779330,claude-code-statusline,Status Lines,General,https://github.com/rz1989s/claude-code-statusline,,rz1989s,https://github.com/rz1989s,TRUE,2025-09-01:14-56-40,2026-03-14:07-08-12,2026-03-02:01-57-45,MIT,"Enhanced 4-line statusline for Claude Code with themes, cost tracking, and MCP server monitoring",FALSE,FALSE,2025-08-18:06-45-07,2026-03-14:07-08-33,v2.21.5,github-releases status-e3a9d274,claude-powerline,Status Lines,General,https://github.com/Owloops/claude-powerline,https://www.npmjs.com/package/@owloops/claude-powerline,Owloops,https://github.com/Owloops,TRUE,2025-08-16:06-23-25,2026-03-12:16-03-56,2026-03-02:01-57-48,MIT,"A vim-style powerline statusline for Claude Code with real-time usage tracking, git integration, custom themes, and more",FALSE,FALSE,2025-08-10:08-11-34,2026-03-12:16-04-07,v1.19.6,github-releases status-bb559460,claudia-statusline,Status Lines,General,https://github.com/hagan/claudia-statusline,,Hagan Franks,https://github.com/hagan,TRUE,2025-10-10:09-41-03,2026-01-17:23-15-29,2026-03-02:01-57-51,MIT,"High-performance Rust-based statusline for Claude Code with persistent stats tracking, progress bars, and optional cloud sync. Features SQLite-first persistence, git integration, context progress bars, burn rate calculation, XDG-compliant with theme support (dark/light, NO_COLOR).",FALSE,FALSE,2025-08-23:03-03-49,2026-01-17:23-22-57,v2.22.1,github-releases hook-73da34c7,Britfix,Hooks,General,https://github.com/Talieisin/britfix,,Talieisin,https://github.com/Talieisin,TRUE,2025-12-03:07-30-41,2026-03-12:08-24-57,2026-03-02:01-57-53,MIT,"Claude outputs American spellings by default, which can have an impact on: professional credibility, compliance, documentation, and more. Britfix converts to British English, with a Claude Code hook for automatic conversion as files are written. Context-aware: handles code files intelligently by only converting comments and docstrings, never identifiers or string literals.",FALSE,FALSE,2025-12-01:06-50-17,,, hook-37bef012,CC Notify,Hooks,General,https://github.com/dazuiba/CCNotify,,dazuiba,https://github.com/dazuiba,TRUE,,2025-10-14:02-26-09,2026-03-02:01-57-56,MIT,"CCNotify provides desktop notifications for Claude Code, alerting you to input needs or task completion, with one-click jumps back to VS Code and task duration display.",FALSE,TRUE,2025-07-24:12-57-26,,, hook-26657310,cchooks,Hooks,General,https://github.com/GowayLee/cchooks,https://pypi.org/project/cchooks/,GowayLee,https://github.com/GowayLee,TRUE,2025-07-29,2025-11-12:04-26-29,2026-03-02:01-57-58,MIT,"A lightweight Python SDK with a clean API and good documentation; simplifies the process of writing hooks and integrating them into your codebase, providing a nice abstraction over the JSON configuration files.",FALSE,TRUE,2025-07-16:11-47-14,2025-11-12:04-35-09,v0.1.5,github-releases hook-4b08835a,Claude Code Hook Comms (HCOM),Hooks,General,https://github.com/aannoo/claude-hook-comms,https://pypi.org/project/hcom,aannoo,https://github.com/aannoo,TRUE,2025-12-18:06-06-18,2026-03-14:07-22-37,2026-03-02:01-58-02,MIT,"Lightweight CLI tool for real-time communication between Claude Code sub agents using hooks. Enables multi-agent collaboration with @-mention targeting, live dashboard monitoring, and zero-dependency implementation. [NOTE: At the time of posting, this resource is a little unstable - I'm sharing it anyway, because I think it's incredibly promising and creative. I hope by the time you read this, it is production-ready.]",FALSE,FALSE,2025-07-21:02-09-06,2026-03-11:05-40-14,v0.7.4,github-releases hook-61fc561a,claude-code-hooks-sdk,Hooks,General,https://github.com/beyondcode/claude-hooks-sdk,,beyondcode,https://github.com/beyondcode,TRUE,2025-07-29,2026-01-12:05-58-06,2026-03-02:01-58-05,MIT,"A Laravel-inspired PHP SDK for building Claude Code hook responses with a clean, fluent API. This SDK makes it easy to create structured JSON responses for Claude Code hooks using an expressive, chainable interface.",FALSE,FALSE,2025-07-03:19-44-53,2025-07-03:20-17-57,0.1.0,github-releases hook-ff4a072b,claude-hooks,Hooks,General,https://github.com/johnlindquist/claude-hooks,,John Lindquist,https://github.com/johnlindquist,TRUE,2025-07-29,2025-08-01:14-42-26,2026-03-02:01-58-07,MIT,A TypeScript-based system for configuring and customizing Claude Code hooks with a powerful and flexible interface.,FALSE,TRUE,2025-07-03:22-10-15,2025-08-01:14-45-16,v2.4.0,github-releases hook-9cfa9465,Claudio,Hooks,General,https://github.com/ctoth/claudio,,Christopher Toth,https://github.com/ctoth,TRUE,2025-09-30:14-44-46,2026-02-18:06-48-20,2026-03-02:01-58-10,NOT_FOUND,A no-frills little library that adds delightful OS-native sounds to Claude Code via simple hooks. It really sparks joy.,FALSE,FALSE,2025-07-26:21-45-51,,, hook-48393ed3,Dippy,Hooks,General,https://github.com/ldayton/Dippy,,Lily Dayton,https://github.com/ldayton,TRUE,2026-02-26:09-48-46,2026-03-09:10-50-02,2026-03-02:01-58-12,MIT,"Auto-approve safe bash commands using AST-based parsing, while prompting for destructive operations. Solves permission fatigue without disabling safety. Supports Claude Code, Gemini CLI, and Cursor.",FALSE,FALSE,2026-01-07:15-11-57,2026-03-09:10-50-28,v0.2.6,github-releases hook-fb83c94c,fcakyon Collection (Code Quality and Tool Usage),Hooks,General,https://github.com/fcakyon/claude-codex-settings/tree/main/.claude/hooks,,Fatih Akyon,https://github.com/fcakyon,FALSE,2025-10-24:21-52-56,,2026-03-02:01-58-13,Apache-2.0,Very well-written set of hooks for code quality and tool usage regulation (e.g. force Tavily over WebFetch tool).,FALSE,,2025-07-09:07-46-08,,, hook-c8d81568,parry,Hooks,General,https://github.com/vaporif/parry,,Dmytro Onypko,https://github.com/vaporif,TRUE,2026-03-02:07-24-03,2026-03-14:16-11-16,2026-03-02:07-24-03,MIT,"Prompt injection scanner for Claude Code hooks. Scans tool inputs and outputs for injection attacks, secrets, and data exfiltration attempts. [NOTE: Early development phase but worth a look.]",FALSE,FALSE,2026-02-23:05-57-41,2026-03-14:15-40-42,v0.1.0-alpha.2,github-releases hook-2b995e52,TDD Guard,Hooks,General,https://github.com/nizos/tdd-guard,,Nizar Selander,https://github.com/nizos,TRUE,2025-07-29,2026-03-01:08-39-57,2026-03-02:01-58-15,MIT,A hooks-driven system that monitors file operations in real-time and blocks changes that violate TDD principles.,FALSE,FALSE,2025-07-03:06-11-29,2026-01-30:12-53-47,storybook-v0.1.0,github-releases hook-3ca1f52e,TypeScript Quality Hooks,Hooks,General,https://github.com/bartolli/claude-code-typescript-hooks,,bartolli,https://github.com/bartolli,TRUE,2025-08-23:23-46-33,2025-08-26:17-11-20,2026-03-02:01-58-18,MIT,"Quality check hook for Node.js TypeScript projects with TypeScript compilation. ESLint auto-fixing, and Prettier formatting. Uses SHA256 config caching for < 5ms validation performance during real-time editing.",FALSE,TRUE,2025-07-21:01-19-57,,, hook-7dbcf415,Plannotator,Hooks,,https://github.com/backnotprop/plannotator,https://plannotator.ai,backnotprop,https://github.com/backnotprop,TRUE,2026-01-17:04-22-43,2026-03-15:00-58-57,2026-03-02:01-58-21,Apache-2.0,"Interactive plan review UI that intercepts ExitPlanMode via hooks, letting users visually annotate plans with comments, deletions, and replacements before approving or denying with detailed feedback.",FALSE,FALSE,2025-12-28:02-14-10,2026-03-12:08-11-39,v0.12.0,github-releases cmd-d4f9e2a5,/create-hook,Slash-Commands,General,https://github.com/omril321/automated-notebooklm/blob/main/.claude/commands/create-hook.md,,Omri Lavi,https://github.com/omril321,TRUE,2025-10-01:17-06-21,2026-02-07:09-45-14,2026-03-02:01-58-23,Apache-2.0,"Slash command for hook creation - intelligently prompts you through the creation process with smart suggestions based on your project setup (TS, Prettier, ESLint...).",FALSE,TRUE,2025-07-24:11-37-46,,, cmd-b37060d6,/linux-desktop-slash-commands,Slash-Commands,General,https://github.com/danielrosehill/Claude-Code-Linux-Desktop-Slash-Commands,,Daniel Rosehill,https://github.com/danielrosehill,TRUE,2025-10-22:12-06-56,2025-10-31:22-31-20,2026-03-02:01-58-26,NOT_FOUND,"A library of slash commands intended specifically to facilitate common and advanced operations on Linux desktop environments (although many would also be useful on Linux servers). Command groups include hardware benchmarking, filesystem organisation, and security posture validation.",FALSE,TRUE,2025-10-21:08-14-40,2025-10-25:23-17-06,25-10-2025,github-releases cmd-9d234db1,/analyze-issue,Slash-Commands,Version Control & Git,https://github.com/jerseycheese/Narraitor/blob/feature/issue-227-ai-suggestions/.claude/commands/analyze-issue.md,,jerseycheese,https://github.com/jerseycheese,TRUE,,2026-02-06:21-14-20,2026-03-02:01-58-29,MIT,"Fetches GitHub issue details to create comprehensive implementation specifications, analyzing requirements and planning structured approach with clear implementation steps.",FALSE,FALSE,2025-04-28:17-05-33,,, cmd-4a72b306,/bug-fix,Slash-Commands,Version Control & Git,https://github.com/danielscholl/mvn-mcp-server/blob/main/.claude/commands/bug-fix.md,,danielscholl,https://github.com/danielscholl,FALSE,2025-07-29,2025-05-06:23-07-03,2026-03-02:01-58-29,NOT_FOUND,"Streamlines bug fixing by creating a GitHub issue first, then a feature branch for implementing and thoroughly testing the solution before merging.",TRUE,,2025-10-03:22-02-03,,, cmd-b6a797df,/commit,Slash-Commands,Version Control & Git,https://github.com/evmts/tevm-monorepo/blob/main/.claude/commands/commit.md,,evmts,https://github.com/evmts,TRUE,,2026-02-09:21-00-27,2026-03-02:01-58-32,MIT,"Creates git commits using conventional commit format with appropriate emojis, following project standards and creating descriptive messages that explain the purpose of changes.",FALSE,TRUE,2023-02-14:18-40-46,2025-10-04:11-25-52,v1.0.0-next.148,github-releases cmd-6aeeadd6,/commit-fast,Slash-Commands,Version Control & Git,https://github.com/steadycursor/steadystart/blob/main/.claude/commands/2-commit-fast.md,,steadycursor,https://github.com/steadycursor,TRUE,,2025-08-03:20-24-42,2026-03-02:01-58-35,NOT_FOUND,"Automates git commit process by selecting the first suggested message, generating structured commits with consistent formatting while skipping manual confirmation and removing Claude co-Contributorship footer",FALSE,TRUE,2024-05-14:22-13-33,,, cmd-2f41bf88,/create-pr,Slash-Commands,Version Control & Git,https://github.com/toyamarinyon/giselle/blob/main/.claude/commands/create-pr.md,,toyamarinyon,https://github.com/toyamarinyon,TRUE,2025-07-29,2025-04-04:14-05-50,2026-03-02:01-58-37,Apache-2.0,"Streamlines pull request creation by handling the entire workflow: creating a new branch, committing changes, formatting modified files with Biome, and submitting the PR.",FALSE,TRUE,2023-12-21:04-25-41,,, cmd-6f066b19,/create-pull-request,Slash-Commands,Version Control & Git,https://github.com/liam-hq/liam/blob/main/.claude/commands/create-pull-request.md,,liam-hq,https://github.com/liam-hq,TRUE,2025-07-29,2026-03-01:19-19-02,2026-03-02:01-58-40,Apache-2.0,"Provides comprehensive PR creation guidance with GitHub CLI, enforcing title conventions, following template structure, and offering concrete command examples with best practices.",FALSE,TRUE,2024-08-08:02-58-32,2025-11-25:02-37-34,@liam-hq/cli@0.7.24,github-releases cmd-54c60a04,/create-worktrees,Slash-Commands,Version Control & Git,https://github.com/evmts/tevm-monorepo/blob/main/.claude/commands/create-worktrees.md,,evmts,https://github.com/evmts,TRUE,,2026-02-09:21-00-27,2026-03-02:01-58-43,MIT,"Creates git worktrees for all open PRs or specific branches, handling branches with slashes, cleaning up stale worktrees, and supporting custom branch creation for development.",FALSE,TRUE,2023-02-14:18-40-46,2025-10-04:11-25-52,v1.0.0-next.148,github-releases cmd-d39b623d,/fix-github-issue,Slash-Commands,Version Control & Git,https://github.com/jeremymailen/kotlinter-gradle/blob/master/.claude/commands/fix-github-issue.md,,jeremymailen,https://github.com/jeremymailen,TRUE,2025-07-29,2026-03-10:03-59-54,2026-03-02:01-58-46,Apache-2.0,"Analyzes and fixes GitHub issues using a structured approach with GitHub CLI for issue details, implementing necessary code changes, running tests, and creating proper commit messages.",FALSE,TRUE,2017-05-07:06-42-09,2026-02-10:23-36-31,5.4.2,github-releases cmd-85f39721,/fix-issue,Slash-Commands,Version Control & Git,https://github.com/metabase/metabase/blob/master/.claude/commands/fix-issue.md,,metabase,https://github.com/metabase,TRUE,,2026-03-13:23-22-45,2026-03-02:01-58-49,NOASSERTION,"Addresses GitHub issues by taking issue number as parameter, analyzing context, implementing solution, and testing/validating the fix for proper integration.",FALSE,TRUE,2015-02-02:19-28-24,2026-03-12:21-42-12,v0.59.2,github-releases cmd-16c71a8c,/fix-pr,Slash-Commands,Version Control & Git,https://github.com/metabase/metabase/blob/master/.claude/commands/fix-pr.md,,metabase,https://github.com/metabase,TRUE,,2026-03-13:23-22-45,2026-03-02:01-58-51,NOASSERTION,"Fetches and fixes unresolved PR comments by automatically retrieving feedback, addressing reviewer concerns, making targeted code improvements, and streamlining the review process.",FALSE,TRUE,2015-02-02:19-28-24,2026-03-12:21-42-12,v0.59.2,github-releases cmd-a1042630,/husky,Slash-Commands,Version Control & Git,https://github.com/evmts/tevm-monorepo/blob/main/.claude/commands/husky.md,,evmts,https://github.com/evmts,TRUE,2025-07-29,2026-02-09:21-00-27,2026-03-02:01-58-54,MIT,"Sets up and manages Husky Git hooks by configuring pre-commit hooks, establishing commit message standards, integrating with linting tools, and ensuring code quality on commits.",FALSE,TRUE,2023-02-14:18-40-46,2025-10-04:11-25-52,v1.0.0-next.148,github-releases cmd-7f51ad4d,/pr-review,Slash-Commands,Version Control & Git,https://github.com/hesreallyhim/awesome-claude-code/blob/923ddf1c3dba0413ecae1c6c2921a1607dc5911d/resources/slash-commands/pr-review/pr-review.md,,arkavo-org,https://github.com/arkavo-org,FALSE,2025-07-29,2025-04-03:01-10-13,2026-03-02:01-58-55,MIT,"Reviews pull request changes to provide feedback, check for issues, and suggest improvements before merging into the main codebase.",TRUE,,2025-04-19:21-00-28,,, cmd-d32f827c,/update-branch-name,Slash-Commands,Version Control & Git,https://github.com/giselles-ai/giselle/blob/main/.claude/commands/update-branch-name.md,,giselles-ai,https://github.com/giselles-ai,TRUE,,2026-03-13:08-59-42,2026-03-02:01-58-58,Apache-2.0,"Updates branch names with proper prefixes and formats, enforcing naming conventions, supporting semantic prefixes, and managing remote branch updates.",FALSE,TRUE,2023-12-21:04-25-41,2026-03-13:00-14-30,v0.72.0,github-releases cmd-884d2f7b,/analyze-code,Slash-Commands,Code Analysis & Testing,https://github.com/Hkgstax/VALUGATOR/blob/main/.claude/commands/analyze-code.md,,Hkgstax,https://github.com/Hkgstax,FALSE,,,2026-03-02:01-58-58,NOT_FOUND,"Reviews code structure and identifies key components, mapping relationships between elements and suggesting targeted improvements for better architecture and performance.",FALSE,,,,, cmd-193fe5e1,/check,Slash-Commands,Code Analysis & Testing,https://github.com/rygwdn/slack-tools/blob/main/.claude/commands/check.md,,rygwdn,https://github.com/rygwdn,TRUE,2025-07-29,2025-05-30:20-29-46,2026-03-02:01-59-01,NOT_FOUND,"Performs comprehensive code quality and security checks, featuring static analysis integration, security vulnerability scanning, code style enforcement, and detailed reporting.",FALSE,TRUE,2025-03-27:18-56-11,,, cmd-9944dc47,/clean,Slash-Commands,Code Analysis & Testing,https://github.com/Graphlet-AI/eridu/blob/main/.claude/commands/clean.md,,Graphlet-AI,https://github.com/Graphlet-AI,FALSE,2025-07-29,2025-05-16:04-28-34,2025-11-02:18-36-47,Apache-2.0,"Addresses code formatting and quality issues by fixing black formatting problems, organizing imports with isort, resolving flake8 linting issues, and correcting mypy type errors.",FALSE,,2025-03-25:18-33-44,,, cmd-f77c03b5,/code_analysis,Slash-Commands,Code Analysis & Testing,https://github.com/kingler/n8n_agent/blob/main/.claude/commands/code_analysis.md,,kingler,https://github.com/kingler,TRUE,2025-07-29,2025-05-16:17-30-29,2026-03-02:01-59-03,NOT_FOUND,"Provides a menu of advanced code analysis commands for deep inspection, including knowledge graph generation, optimization suggestions, and quality evaluation.",FALSE,TRUE,2025-05-16:17-30-29,,, cmd-e6804b12,/implement-issue,Slash-Commands,Code Analysis & Testing,https://github.com/cmxela/thinkube/blob/main/.claude/commands/implement-issue.md,,cmxela,https://github.com/cmxela,FALSE,,,2026-03-02:01-59-04,NOT_FOUND,"Implements GitHub issues following strict project guidelines, complete implementation checklists, variable naming conventions, testing procedures, and documentation requirements.",FALSE,,,,, cmd-0ff45c34,/implement-task,Slash-Commands,Code Analysis & Testing,https://github.com/Hkgstax/VALUGATOR/blob/main/.claude/commands/implement-task.md,,Hkgstax,https://github.com/Hkgstax,FALSE,,,2026-03-02:01-59-05,NOT_FOUND,"Approaches task implementation methodically by thinking through strategy step-by-step, evaluating different approaches, considering tradeoffs, and implementing the best solution.",FALSE,,,,, cmd-c76ed84c,/optimize,Slash-Commands,Code Analysis & Testing,https://github.com/to4iki/ai-project-rules/blob/main/.claude/commands/optimize.md,,to4iki,https://github.com/to4iki,TRUE,2025-07-29,2025-04-24:16-18-21,2026-03-02:01-59-07,MIT,"Analyzes code performance to identify bottlenecks, proposing concrete optimizations with implementation guidance for improved application performance.",FALSE,TRUE,2025-04-24:16-18-21,,, cmd-3c922eaa,/repro-issue,Slash-Commands,Code Analysis & Testing,https://github.com/rzykov/metabase/blob/master/.claude/commands/repro-issue.md,,rzykov,https://github.com/rzykov,TRUE,2025-07-29,2025-05-16:07-51-12,2026-03-02:01-59-10,NOASSERTION,"Creates reproducible test cases for GitHub issues, ensuring tests fail reliably and documenting clear reproduction steps for developers.",FALSE,TRUE,2015-02-02:19-28-24,,, cmd-1ba4d44c,/task-breakdown,Slash-Commands,Code Analysis & Testing,https://github.com/Hkgstax/VALUGATOR/blob/main/.claude/commands/task-breakdown.md,,Hkgstax,https://github.com/Hkgstax,FALSE,,,2026-03-02:01-59-11,NOT_FOUND,"Analyzes feature requirements, identifies components and dependencies, creates manageable tasks, and sets priorities for efficient feature implementation.",FALSE,,,,, cmd-051321ab,/tdd,Slash-Commands,Code Analysis & Testing,https://github.com/zscott/pane/blob/main/.claude/commands/tdd.md,,zscott,https://github.com/zscott,TRUE,2025-07-29,2025-03-07:16-35-10,2026-03-02:01-59-13,NOT_FOUND,"Guides development using Test-Driven Development principles, enforcing Red-Green-Refactor discipline, integrating with git workflow, and managing PR creation.",FALSE,TRUE,2025-03-05:17-52-00,2025-03-05:18-00-20,v0.1.1,github-releases cmd-cccacca2,/tdd-implement,Slash-Commands,Code Analysis & Testing,https://github.com/jerseycheese/Narraitor/blob/feature/issue-227-ai-suggestions/.claude/commands/tdd-implement.md,,jerseycheese,https://github.com/jerseycheese,TRUE,,2026-02-06:21-14-20,2026-03-02:01-59-16,MIT,"Implements Test-Driven Development by analyzing feature requirements, creating tests first (red), implementing minimal passing code (green), and refactoring while maintaining tests.",FALSE,FALSE,2025-04-28:17-05-33,,, cmd-7991e9fb,/testing_plan_integration,Slash-Commands,Code Analysis & Testing,https://github.com/buster-so/buster/blob/main/api/.claude/commands/testing_plan_integration.md,,buster-so,https://github.com/buster-so,FALSE,,,2026-03-02:01-59-17,NOASSERTION,"Creates inline Rust-style tests, suggests refactoring for testability, analyzes code challenges, and creates comprehensive test coverage for robust code.",FALSE,,,,, cmd-01b57069,/context-prime,Slash-Commands,Context Loading & Priming,https://github.com/elizaOS/elizaos.github.io/blob/main/.claude/commands/context-prime.md,,elizaOS,https://github.com/elizaOS,TRUE,2025-07-29,2026-02-16:01-17-20,2026-03-02:01-59-19,MIT,"Primes Claude with comprehensive project understanding by loading repository structure, setting development context, establishing project goals, and defining collaboration parameters.",FALSE,TRUE,2024-11-10:03-44-30,,, cmd-82556482,/initref,Slash-Commands,Context Loading & Priming,https://github.com/okuvshynov/cubestat/blob/main/.claude/commands/initref.md,,okuvshynov,https://github.com/okuvshynov,TRUE,2025-07-29,2025-08-11:02-27-35,2026-03-02:01-59-22,MIT,"Initializes reference documentation structure with standard doc templates, API reference setup, documentation conventions, and placeholder content generation.",FALSE,TRUE,2023-02-08:15-30-18,2025-03-04:14-34-45,v0.3.4,github-releases cmd-e7fde689,/load-llms-txt,Slash-Commands,Context Loading & Priming,https://github.com/ethpandaops/xatu-data/blob/master/.claude/commands/load-llms-txt.md,,ethpandaops,https://github.com/ethpandaops,TRUE,2025-07-29,2026-03-15:00-10-30,2026-03-02:01-59-25,MIT,"Loads LLM configuration files to context, importing specific terminology, model configurations, and establishing baseline terminology for AI discussions.",FALSE,TRUE,2024-03-26:00-43-31,,, cmd-cc5f7cd3,/load_coo_context,Slash-Commands,Context Loading & Priming,https://github.com/Mjvolk3/torchcell/blob/main/.claude/commands/load_coo_context.md,,Mjvolk3,https://github.com/Mjvolk3,TRUE,,2026-01-27:17-11-51,2026-03-02:01-59-27,NOT_FOUND,"References specific files for sparse matrix operations, explains transform usage, compares with previous approaches, and sets data formatting context for development.",FALSE,TRUE,2023-07-24:22-56-56,2025-08-07:03-40-40,v1.1.0,github-releases cmd-63a682e3,/load_dango_pipeline,Slash-Commands,Context Loading & Priming,https://github.com/Mjvolk3/torchcell/blob/main/.claude/commands/load_dango_pipeline.md,,Mjvolk3,https://github.com/Mjvolk3,TRUE,,2026-01-27:17-11-51,2026-03-02:01-59-30,NOT_FOUND,"Sets context for model training by referencing pipeline files, establishing working context, and preparing for pipeline work with relevant documentation.",FALSE,TRUE,2023-07-24:22-56-56,2025-08-07:03-40-40,v1.1.0,github-releases cmd-f4c7bb3c,/prime,Slash-Commands,Context Loading & Priming,https://github.com/yzyydev/AI-Engineering-Structure/blob/main/.claude/commands/prime.md,,yzyydev,https://github.com/yzyydev,TRUE,2025-07-29,2025-09-15:14-45-35,2026-03-02:01-59-33,NOT_FOUND,"Sets up initial project context by viewing directory structure and reading key files, creating standardized context with directory visualization and key documentation focus.",FALSE,TRUE,2025-05-08:10-26-38,,, cmd-6467d59f,/reminder,Slash-Commands,Context Loading & Priming,https://github.com/cmxela/thinkube/blob/main/.claude/commands/reminder.md,,cmxela,https://github.com/cmxela,FALSE,,,2026-03-02:01-59-34,NOT_FOUND,"Re-establishes project context after conversation breaks or compaction, restoring context and fixing guideline inconsistencies for complex implementations.",FALSE,,,,, cmd-acaa3ecd,/rsi,Slash-Commands,Context Loading & Priming,https://github.com/ddisisto/si/blob/main/.claude/commands/rsi.md,,ddisisto,https://github.com/ddisisto,TRUE,2025-07-29,2025-05-20:01-27-49,2026-03-02:01-59-36,NOT_FOUND,"Reads all commands and key project files to optimize AI-assisted development by streamlining the process, loading command context, and setting up for better development workflow.",FALSE,TRUE,2025-05-17:02-27-16,,, cmd-989ec43f,/add-to-changelog,Slash-Commands,Documentation & Changelogs,https://github.com/berrydev-ai/blockdoc-python/blob/main/.claude/commands/add-to-changelog.md,,berrydev-ai,https://github.com/berrydev-ai,TRUE,2025-07-29,2025-04-28:15-54-32,2026-03-02:01-59-39,MIT,"Adds new entries to changelog files while maintaining format consistency, properly documenting changes, and following established project standards for version tracking.",FALSE,TRUE,2025-03-23:18-25-35,2025-04-25:23-49-58,1.1.0,github-releases cmd-416793e8,/create-docs,Slash-Commands,Documentation & Changelogs,https://github.com/jerseycheese/Narraitor/blob/feature/issue-227-ai-suggestions/.claude/commands/create-docs.md,,jerseycheese,https://github.com/jerseycheese,TRUE,2025-07-29,2026-02-06:21-14-20,2026-03-02:01-59-41,MIT,"Analyzes code structure and purpose to create comprehensive documentation detailing inputs/outputs, behavior, user interaction flows, and edge cases with error handling.",FALSE,FALSE,2025-04-28:17-05-33,,, cmd-4d612ab9,/docs,Slash-Commands,Documentation & Changelogs,https://github.com/slunsford/coffee-analytics/blob/main/.claude/commands/docs.md,,slunsford,https://github.com/slunsford,TRUE,2025-07-29,2025-11-13:18-34-17,2026-03-02:01-59-45,NOT_FOUND,"Generates comprehensive documentation that follows project structure, documenting APIs and usage patterns with consistent formatting for better user understanding.",FALSE,TRUE,2023-08-22:19-12-06,,, cmd-7c4c3c47,/explain-issue-fix,Slash-Commands,Documentation & Changelogs,https://github.com/hackdays-io/toban-contribution-viewer/blob/main/.claude/commands/explain-issue-fix.md,,hackdays-io,https://github.com/hackdays-io,TRUE,2025-07-29,2025-05-17:15-04-46,2026-03-02:01-59-48,NOT_FOUND,"Documents solution approaches for GitHub issues, explaining technical decisions, detailing challenges overcome, and providing implementation context for better understanding.",FALSE,TRUE,2025-03-30:07-41-02,,, cmd-7767f28f,/update-docs,Slash-Commands,Documentation & Changelogs,https://github.com/Consiliency/Flutter-Structurizr/blob/main/.claude/commands/update-docs.md,,Consiliency,https://github.com/Consiliency,TRUE,2025-07-29,2025-05-22:23-41-19,2026-03-02:01-59-51,MIT,"Reviews current documentation status, updates implementation progress, reviews phase documents, and maintains documentation consistency across the project.",FALSE,TRUE,2025-05-12:23-16-35,,, cmd-19f297bd,/build-react-app,Slash-Commands,CI / Deployment,https://github.com/wmjones/wyatt-personal-aws/blob/main/.claude/commands/build-react-app.md,,wmjones,https://github.com/wmjones,FALSE,,,2026-03-02:01-59-52,NOT_FOUND,"Builds React applications locally with intelligent error handling, creating specific tasks for build failures and providing appropriate server commands based on build results.",FALSE,,,,, cmd-39a87802,/release,Slash-Commands,CI / Deployment,https://github.com/kelp/webdown/blob/main/.claude/commands/release.md,,kelp,https://github.com/kelp,TRUE,2025-07-29,2025-12-11:00-34-45,2026-03-02:01-59-55,MIT,"Manages software releases by updating changelogs, reviewing README changes, evaluating version increments, and documenting release changes for better version tracking.",FALSE,TRUE,2025-03-15:18-37-39,2025-12-11:00-36-52,v0.8.1,github-releases cmd-88d84cb6,/run-ci,Slash-Commands,CI / Deployment,https://github.com/hackdays-io/toban-contribution-viewer/blob/main/.claude/commands/run-ci.md,,hackdays-io,https://github.com/hackdays-io,TRUE,,2025-05-17:15-04-46,2026-03-02:01-59-57,NOT_FOUND,"Activates virtual environments, runs CI-compatible check scripts, iteratively fixes errors, and ensures all tests pass before completion.",FALSE,TRUE,2025-03-30:07-41-02,,, cmd-fdc46b4a,/run-pre-commit,Slash-Commands,CI / Deployment,https://github.com/wmjones/wyatt-personal-aws/blob/main/.claude/commands/run-pre-commit.md,,wmjones,https://github.com/wmjones,FALSE,,,2026-03-02:01-59-58,NOT_FOUND,"Runs pre-commit checks with intelligent results handling, analyzing outputs, creating tasks for issue fixing, and integrating with task management systems.",FALSE,,,,, cmd-8856ecb4,/create-command,Slash-Commands,Project & Task Management,https://github.com/scopecraft/command/blob/main/.claude/commands/create-command.md,,scopecraft,https://github.com/scopecraft,TRUE,2025-07-29,2025-11-09:12-20-07,2026-03-02:02-00-01,NOT_FOUND,"Guides Claude through creating new custom commands with proper structure by analyzing requirements, templating commands by category, enforcing command standards, and creating supporting documentation.",FALSE,TRUE,2025-05-10:17-23-27,2025-06-06:04-25-20,v0.16.0,github-releases cmd-0420f9cb,/create-plan,Slash-Commands,Project & Task Management,https://github.com/hesreallyhim/inkverse-fork/blob/preserve-claude-resources/.claude/commands/create-plan.md,,taddyorg,https://github.com/taddyorg,TRUE,2025-07-29,2026-01-28:06-09-49,2026-01-20:01-15-59,AGPL-3.0,"Generates comprehensive product requirement documents outlining detailed specifications, requirements, and features following standardized document structure and format.",TRUE,TRUE,2025-05-06:21-28-47,,, cmd-ec48035a,/create-prp,Slash-Commands,Project & Task Management,https://github.com/Wirasm/claudecode-utils/blob/main/.claude/commands/create-prp.md,,Wirasm,https://github.com/Wirasm,TRUE,2025-07-29,2025-05-21:11-01-32,2026-03-02:02-00-05,MIT,"Creates product requirement plans by reading PRP methodology, following template structure, creating comprehensive requirements, and structuring product definitions for development.",FALSE,TRUE,2025-05-11:18-23-30,,, cmd-2981aaf0,/do-issue,Slash-Commands,Project & Task Management,https://github.com/jerseycheese/Narraitor/blob/feature/issue-227-ai-suggestions/.claude/commands/do-issue.md,,jerseycheese,https://github.com/jerseycheese,TRUE,,2026-02-06:21-14-20,2026-03-02:02-00-08,MIT,"Implements GitHub issues with manual review points, following a structured approach with issue number parameter and offering alternative automated mode for efficiency.",FALSE,FALSE,2025-04-28:17-05-33,,, cmd-f5425f91,/next-task,Slash-Commands,Project & Task Management,https://github.com/wmjones/wyatt-personal-aws/blob/main/.claude/commands/next-task.md,,wmjones,https://github.com/wmjones,FALSE,,,2026-03-02:02-00-08,NOT_FOUND,"Gets the next task from TaskMaster and creates a branch for it, integrating with task management systems, automating branch creation, and enforcing naming conventions.",FALSE,,,,, cmd-a8870199,/prd-generator,Slash-Commands,Project & Task Management,https://github.com/dredozubov/prd-generator,,Denis Redozubov,https://github.com/dredozubov,TRUE,2026-01-30:02-03-18,2026-01-14:10-29-44,2026-03-02:02-00-11,MIT,"A Claude Code plugin that generates comprehensive Product Requirements Documents (PRDs) from conversation context. Invoke `/create-prd` after discussing requirements and it produces a complete PRD with all standard sections including Executive Summary, User Stories, MVP Scope, Architecture, Success Criteria, and Implementation Phases.",FALSE,FALSE,2026-01-14:10-27-43,,, cmd-80018864,/project_hello_w_name,Slash-Commands,Project & Task Management,https://github.com/disler/just-prompt/blob/main/.claude/commands/project_hello_w_name.md,,disler,https://github.com/disler,TRUE,2025-07-29,2025-08-10:19-05-50,2026-03-02:02-00-13,NOT_FOUND,"Creates customizable greeting components with name input, demonstrating argument passing, component reusability, state management, and user input handling.",FALSE,TRUE,2025-03-20:17-36-32,,, cmd-1bc55517,/todo,Slash-Commands,Project & Task Management,https://github.com/chrisleyva/todo-slash-command/blob/main/todo.md,,chrisleyva,https://github.com/chrisleyva,TRUE,2025-07-29,2025-06-25:23-12-56,2026-03-02:02-00-16,MIT,"A convenient command to quickly manage project todo items without leaving the Claude Code interface, featuring due dates, sorting, task prioritization, and comprehensive todo list management.",FALSE,TRUE,2025-06-23:19-31-31,,, cmd-089f917a,/act,Slash-Commands,Miscellaneous,https://github.com/sotayamashita/dotfiles/blob/main/.claude/commands/act.md,,sotayamashita,https://github.com/sotayamashita,FALSE,,2025-06-29:06-25-59,2026-03-02:02-00-17,MIT,"Generates React components with proper accessibility, creating ARIA-compliant components with keyboard navigation that follow React best practices and include comprehensive accessibility testing.",FALSE,,2016-02-11:09-53-28,,, cmd-48cb3d9e,/dump,Slash-Commands,Miscellaneous,https://gist.github.com/fumito-ito/77c308e0382e06a9c16b22619f8a2f83#file-dump-md,,fumito-ito,https://github.com/fumito-ito,FALSE,,,2026-03-02:02-00-18,NOT_FOUND,Dumps the current Claude Code conversation to a markdown file in `.claude/logs/` with timestamped files that include session details and preserve full conversation history.,FALSE,,,,, cmd-6581d11f,/five,Slash-Commands,Miscellaneous,https://github.com/TuckerTucker/tkr-portfolio/blob/main/.claude/commands/five.md,,TuckerTucker,https://github.com/TuckerTucker,FALSE,2025-07-29,2025-06-25:06-46-24,2026-03-02:02-00-18,NOT_FOUND,"Applies the ""five whys"" methodology to perform root cause analysis, identify underlying issues, and create solution approaches for complex problems.",FALSE,,,,, cmd-a0a98a9e,/fixing_go_in_graph,Slash-Commands,Miscellaneous,https://github.com/Mjvolk3/torchcell/blob/main/.claude/commands/fixing_go_in_graph.md,,Mjvolk3,https://github.com/Mjvolk3,TRUE,,2026-01-27:17-11-51,2026-03-02:02-00-21,NOT_FOUND,"Focuses on Gene Ontology annotation integration in graph databases, handling multiple data sources, addressing graph representation issues, and ensuring correct data incorporation.",FALSE,TRUE,2023-07-24:22-56-56,2025-08-07:03-40-40,v1.1.0,github-releases cmd-40432dca,/mermaid,Slash-Commands,Miscellaneous,https://github.com/GaloyMoney/lana-bank/blob/main/.claude/commands/mermaid.md,,GaloyMoney,https://github.com/GaloyMoney,TRUE,2025-07-29,2026-03-14:22-04-25,2026-03-02:02-00-23,NOASSERTION,"Generates Mermaid diagrams from SQL schema files, creating entity relationship diagrams with table properties, validating diagram compilation, and ensuring complete entity coverage.",FALSE,TRUE,2024-05-17:07-25-09,2026-03-10:10-49-48,0.47.0,github-releases cmd-dc2a5edd,/review_dcell_model,Slash-Commands,Miscellaneous,https://github.com/Mjvolk3/torchcell/blob/main/.claude/commands/review_dcell_model.md,,Mjvolk3,https://github.com/Mjvolk3,TRUE,2025-07-29,2026-01-27:17-11-51,2026-03-02:02-00-26,NOT_FOUND,"Reviews old Dcell implementation files, comparing with newer Dango model, noting changes over time, and analyzing refactoring approaches for better code organization.",FALSE,TRUE,2023-07-24:22-56-56,2025-08-07:03-40-40,v1.1.0,github-releases cmd-0a1fa75a,/use-stepper,Slash-Commands,Miscellaneous,https://github.com/zuplo/docs/blob/main/.claude/commands/use-stepper.md,,zuplo,https://github.com/zuplo,TRUE,2025-07-29,2026-03-13:10-40-42,2026-03-02:02-00-28,NOT_FOUND,"Reformats documentation to use React Stepper component, transforming heading formats, applying proper indentation, and maintaining markdown compatibility with admonition formatting.",FALSE,TRUE,2021-08-03:14-14-19,,, claude-ac32c909,AI IntelliJ Plugin,CLAUDE.md Files,Language-Specific,https://github.com/didalgolab/ai-intellij-plugin/blob/main/CLAUDE.md,,didalgolab,https://github.com/didalgolab,TRUE,2025-07-29,2025-03-26:22-20-18,2026-03-02:02-00-31,Apache-2.0,"Provides comprehensive Gradle commands for IntelliJ plugin development with platform-specific coding patterns, detailed package structure guidelines, and clear internationalization standards.",FALSE,TRUE,2023-05-04:01-47-31,2024-10-03:20-16-25,v1.1.1,github-releases claude-bbaa0c15,AWS MCP Server,CLAUDE.md Files,Language-Specific,https://github.com/alexei-led/aws-mcp-server/blob/main/CLAUDE.md,,alexei-led,https://github.com/alexei-led,TRUE,2025-07-29,2026-02-27:14-31-23,2026-03-02:02-00-33,MIT,"Features multiple Python environment setup options with detailed code style guidelines, comprehensive error handling recommendations, and security considerations for AWS CLI interactions.",FALSE,FALSE,2025-03-11:19-44-05,2026-02-27:14-31-51,v1.7.0,github-releases claude-e130a9c3,DroidconKotlin,CLAUDE.md Files,Language-Specific,https://github.com/touchlab/DroidconKotlin/blob/main/CLAUDE.md,,touchlab,https://github.com/touchlab,TRUE,2025-07-29,2025-12-10:14-29-37,2026-03-02:02-00-36,Apache-2.0,Delivers comprehensive Gradle commands for cross-platform Kotlin Multiplatform development with clear module structure and practical guidance for dependency injection.,FALSE,TRUE,2018-07-13:12-15-58,,, claude-1279cf13,EDSL,CLAUDE.md Files,Language-Specific,https://github.com/hesreallyhim/awesome-claude-code/blob/main/resources/claude.md-files/EDSL/CLAUDE.md,,expectedparrot,https://github.com/expectedparrot,TRUE,2025-07-29,2026-03-15:00-39-26,2025-09-21:08-04-24,MIT,"Offers detailed build and test commands with strict code style enforcement, comprehensive testing requirements, and standardized development workflow using Black and mypy.",TRUE,,2025-04-19:21-00-28,,, claude-3ae444b3,Giselle,CLAUDE.md Files,Language-Specific,https://github.com/giselles-ai/giselle/blob/main/CLAUDE.md,,giselles-ai,https://github.com/giselles-ai,TRUE,2025-07-29,2026-03-13:08-59-42,2026-03-02:02-00-39,Apache-2.0,Provides detailed build and test commands using pnpm and Vitest with strict code formatting requirements and comprehensive naming conventions for code consistency.,FALSE,FALSE,2023-12-21:04-25-41,2026-03-13:00-14-30,v0.72.0,github-releases claude-b302b042,HASH,CLAUDE.md Files,Language-Specific,https://github.com/hashintel/hash/blob/main/CLAUDE.md,,hashintel,https://github.com/hashintel,TRUE,2025-07-29,2026-03-13:21-13-27,2026-03-02:02-00-42,NOASSERTION,"Features comprehensive repository structure breakdown with strong emphasis on coding standards, detailed Rust documentation guidelines, and systematic PR review process.",FALSE,FALSE,2019-07-15:16-19-37,2026-01-28:16-10-17,@hashintel/petrinaut@0.0.8,github-releases claude-6dc32b06,Inkline,CLAUDE.md Files,Language-Specific,https://github.com/inkline/inkline/blob/main/CLAUDE.md,,inkline,https://github.com/inkline,TRUE,2025-07-29,2025-05-18:14-06-27,2026-03-02:02-00-45,NOASSERTION,"Structures development workflow using pnpm with emphasis on TypeScript and Vue 3 Composition API, detailed component creation process, and comprehensive testing recommendations.",FALSE,TRUE,2018-02-07:12-58-42,2024-11-18:06-40-57,v4.7.2,github-releases claude-1821727a,JSBeeb,CLAUDE.md Files,Language-Specific,https://github.com/mattgodbolt/jsbeeb/blob/main/CLAUDE.md,,mattgodbolt,https://github.com/mattgodbolt,TRUE,2025-07-29,2026-03-14:16-55-14,2026-03-02:02-00-47,GPL-3.0,"Provides development guide for JavaScript BBC Micro emulator with build and testing instructions, architecture documentation, and debugging workflows.",FALSE,TRUE,2011-10-03:11-26-13,2026-02-23:17-01-58,v1.4.0,github-releases claude-3591a3e4,Lamoom Python,CLAUDE.md Files,Language-Specific,https://github.com/LamoomAI/lamoom-python/blob/main/CLAUDE.md,,LamoomAI,https://github.com/LamoomAI,TRUE,2025-07-29,2025-08-28:13-38-23,2026-03-02:02-00-50,Apache-2.0,"Serves as reference for production prompt engineering library with load balancing of AI Models, API documentation, and usage patterns with examples.",FALSE,TRUE,2024-02-09:12-08-20,,, claude-2a18266c,LangGraphJS,CLAUDE.md Files,Language-Specific,https://github.com/langchain-ai/langgraphjs/blob/main/CLAUDE.md,,langchain-ai,https://github.com/langchain-ai,TRUE,2025-07-29,2026-03-13:15-09-35,2026-03-02:02-00-53,MIT,"Offers comprehensive build and test commands with detailed TypeScript style guidelines, layered library architecture, and monorepo structure using yarn workspaces.",FALSE,FALSE,2024-01-09:17-40-46,2026-03-11:06-49-43,@langchain/langgraph-sdk@1.7.2,github-releases claude-38b6b458,Metabase,CLAUDE.md Files,Language-Specific,https://github.com/metabase/metabase/blob/master/CLAUDE.md,,metabase,https://github.com/metabase,TRUE,2025-07-29,2026-03-13:23-22-45,2026-03-02:02-00-55,NOASSERTION,"Details workflow for REPL-driven development in Clojure/ClojureScript with emphasis on incremental development, testing, and step-by-step approach for feature implementation.",FALSE,FALSE,2015-02-02:19-28-24,2026-03-12:21-42-12,v0.59.2,github-releases claude-8ff859d0,SG Cars Trends Backend,CLAUDE.md Files,Language-Specific,https://github.com/sgcarstrends/backend/blob/main/CLAUDE.md,,sgcarstrends,https://github.com/sgcarstrends,TRUE,2025-07-29,2026-03-14:18-49-45,2026-03-02:02-00-59,MIT,"Provides comprehensive structure for TypeScript monorepo projects with detailed commands for development, testing, deployment, and AWS/Cloudflare integration.",FALSE,FALSE,2023-10-29:20-23-43,2026-03-07:02-27-35,v4.64.0,github-releases claude-28de7758,SPy,CLAUDE.md Files,Language-Specific,https://github.com/spylang/spy/blob/main/CLAUDE.md,,spylang,https://github.com/spylang,TRUE,2025-07-29,2026-03-13:10-45-54,2026-03-02:02-01-02,MIT,"Enforces strict coding conventions with comprehensive testing guidelines, multiple code compilation options, and backend-specific test decorators for targeted filtering.",FALSE,FALSE,2023-05-19:14-23-13,2026-01-08:16-43-33,v0.0.0,github-releases claude-724817c4,TPL,CLAUDE.md Files,Language-Specific,https://github.com/KarpelesLab/tpl/blob/master/CLAUDE.md,,KarpelesLab,https://github.com/KarpelesLab,TRUE,2025-07-29,2026-01-18:06-24-26,2026-03-02:02-01-05,MIT,"Details Go project conventions with comprehensive error handling recommendations, table-driven testing approach guidelines, and modernization suggestions for latest Go features.",FALSE,TRUE,2020-01-17:17-16-35,,, claude-6348c9dd,AVS Vibe Developer Guide,CLAUDE.md Files,Domain-Specific,https://github.com/Layr-Labs/avs-vibe-developer-guide/blob/master/CLAUDE.md,,Layr-Labs,https://github.com/Layr-Labs,FALSE,2025-07-29,2025-04-09:18-03-54,2026-03-02:02-01-08,MIT,Structures AI-assisted EigenLayer AVS development workflow with consistent naming conventions for prompt files and established terminology standards for blockchain concepts.,FALSE,TRUE,2025-04-09:00-10-34,,, claude-d8f940fa,Comm,CLAUDE.md Files,Domain-Specific,https://github.com/CommE2E/comm/blob/master/CLAUDE.md,,CommE2E,https://github.com/CommE2E,FALSE,2025-07-29,2026-02-28:02-34-32,2026-03-02:02-01-09,BSD-3-Clause,"Serves as a development reference for E2E-encrypted messaging applications with code organization architecture, security implementation details, and testing procedures.",FALSE,TRUE,2015-12-02:05-12-05,2026-01-22:17-42-30,mobile-v1.0.562,github-releases claude-d0e5c826,Course Builder,CLAUDE.md Files,Domain-Specific,https://github.com/badass-courses/course-builder/blob/main/CLAUDE.md,,badass-courses,https://github.com/badass-courses,TRUE,2025-07-29,2026-03-09:10-45-52,2026-03-02:02-01-12,MIT,Enables real-time multiplayer capabilities for collaborative course creation with diverse tech stack integration and monorepo architecture using Turborepo.,FALSE,FALSE,2023-11-05:17-37-04,,, claude-3b207e6e,Cursor Tools,CLAUDE.md Files,Domain-Specific,https://github.com/eastlondoner/cursor-tools/blob/main/CLAUDE.md,,eastlondoner,https://github.com/eastlondoner,TRUE,2025-07-29,2025-08-22:08-32-22,2026-03-02:02-01-16,MIT,"Creates a versatile AI command interface supporting multiple providers and models with flexible command options and browser automation through ""Stagehand"" feature.",FALSE,TRUE,2025-01-13:15-05-28,,, claude-0ce42e78,Guitar,CLAUDE.md Files,Domain-Specific,https://github.com/soramimi/Guitar/blob/master/CLAUDE.md,,soramimi,https://github.com/soramimi,TRUE,2025-07-29,2026-03-14:18-35-39,2026-03-02:02-01-19,GPL-2.0,"Serves as development guide for Guitar Git GUI Client with build commands for various platforms, code style guidelines for contributing, and project structure explanation.",FALSE,TRUE,2016-12-23:16-20-14,2025-11-01:02-46-41,v1.3.1,github-releases claude-4a956e32,Network Chronicles,CLAUDE.md Files,Domain-Specific,https://github.com/Fimeg/NetworkChronicles/blob/legacy-v1/CLAUDE.md,,Fimeg,https://github.com/Fimeg,TRUE,2025-07-29,2025-08-08:20-07-58,2026-03-02:02-01-21,MIT,"Presents detailed implementation plan for AI-driven game characters with technical specifications for LLM integration, character guidelines, and service discovery mechanics.",FALSE,TRUE,2025-03-05:16-05-30,,, claude-d97bf254,Note Companion,CLAUDE.md Files,Domain-Specific,https://github.com/different-ai/note-companion/blob/master/CLAUDE.md,,different-ai,https://github.com/different-ai,FALSE,2025-07-29,2025-03-11:08-16-20,2026-03-02:02-01-22,MIT,Provides detailed styling isolation techniques for Obsidian plugins using Tailwind with custom prefix to prevent style conflicts and practical troubleshooting steps.,FALSE,,2023-09-10:20-33-22,,, claude-5479b4e8,Pareto Mac,CLAUDE.md Files,Domain-Specific,https://github.com/ParetoSecurity/pareto-mac/blob/main/CLAUDE.md,,ParetoSecurity,https://github.com/ParetoSecurity,TRUE,2025-07-29,2026-03-12:19-12-55,2026-03-02:02-01-25,GPL-3.0,"Serves as development guide for Mac security audit tool with build instructions, contribution guidelines, testing procedures, and workflow documentation.",FALSE,FALSE,2021-07-12:19-50-40,2026-03-13:09-31-01,1.24.0,github-releases claude-1d359140,pre-commit-hooks,CLAUDE.md Files,Domain-Specific,https://github.com/aRustyDev/pre-commit-hooks,,aRustyDev,https://github.com/aRustyDev,TRUE,2026-02-07:02-15-05,2025-11-24:05-32-40,2026-03-02:02-01-27,AGPL-3.0,"This repository is about pre-commit-hooks in general, but the `CLAUDE.md` and related `.claude/` documentation is exemplary. Thorough but not verbose. Unlike a lot of `CLAUDE.md` files, it doesn't primarily consist in shouting at Claude in all-caps. Great learning resource. Also, hooks.",FALSE,TRUE,2024-07-21:21-44-30,2025-07-08:04-22-32,v0.3.0,github-releases claude-2659fc4a,SteadyStart,CLAUDE.md Files,Domain-Specific,https://github.com/steadycursor/steadystart/blob/main/CLAUDE.md,,steadycursor,https://github.com/steadycursor,TRUE,2025-07-29,2025-08-03:20-24-42,2026-03-02:02-01-30,NOT_FOUND,"Clear and direct instructives about style, permissions, Claude's ""role"", communications, and documentation of Claude Code sessions for other team members to stay abreast.",FALSE,TRUE,2024-05-14:22-13-33,,, claude-14f59511,Basic Memory,CLAUDE.md Files,Project Scaffolding & MCP,https://github.com/basicmachines-co/basic-memory/blob/main/CLAUDE.md,,basicmachines-co,https://github.com/basicmachines-co,TRUE,2025-07-29,2026-03-11:04-13-59,2026-03-02:02-01-33,AGPL-3.0,Presents an innovative AI-human collaboration framework with Model Context Protocol for bidirectional LLM-markdown communication and flexible knowledge structure for complex projects.,FALSE,FALSE,2024-12-02:22-40-44,2026-03-11:04-14-47,v0.20.2,github-releases claude-65aa541a,claude-code-mcp-enhanced,CLAUDE.md Files,Project Scaffolding & MCP,https://github.com/grahama1970/claude-code-mcp-enhanced/blob/main/CLAUDE.md,,grahama1970,https://github.com/grahama1970,TRUE,2025-07-29,2025-05-16:16-57-57,2026-03-02:02-01-36,MIT,"Provides detailed and emphatic instructions for Claude to follow as a coding agent, with testing guidance, code examples, and compliance checks.",FALSE,TRUE,2025-05-15:22-30-08,,, claude-36517eea,MCP Engine,CLAUDE.md Files,Project Scaffolding & MCP,https://github.com/featureform/mcp-engine/blob/main/CLAUDE.md,,featureform,https://github.com/featureform,FALSE,,,2026-03-02:02-01-36,Apache-2.0,"Enforces strict package management with comprehensive type checking rules, explicit PR description guidelines, and systematic approach to resolving CI failures.",FALSE,,2025-05-29:01-31-49,,, claude-4a53c9e8,Perplexity MCP,CLAUDE.md Files,Project Scaffolding & MCP,https://github.com/Family-IT-Guy/perplexity-mcp/blob/main/CLAUDE.md,,Family-IT-Guy,https://github.com/Family-IT-Guy,FALSE,2025-07-29,2025-03-20:04-04-46,2026-03-02:02-01-37,ISC,"Offers clear step-by-step installation instructions with multiple configuration options, detailed troubleshooting guidance, and concise architecture overview of the MCP protocol.",FALSE,TRUE,2025-03-20:04-04-46,,, client-5cae6333,Claudable,Alternative Clients,General,https://github.com/opactorai/Claudable,,Ethan Park,https://www.linkedin.com/in/seongil-park/,TRUE,2025-11-01:06-11-51,2026-03-04:11-14-44,2026-03-02:02-01-40,MIT,"Claudable is an open-source web builder that leverages local CLI agents, such as Claude Code and Cursor Agent, to build and deploy products effortlessly.",FALSE,FALSE,2025-08-20:23-21-13,2025-08-30:21-23-05,v1.0.0,github-releases client-10858fb6,claude-esp,Alternative Clients,General,https://github.com/phiat/claude-esp,,phiat,https://github.com/phiat,TRUE,2026-02-26:09-00-06,2026-02-28:18-53-29,2026-03-02:02-01-43,MIT,"Go-based TUI that streams Claude Code's hidden output (thinking, tool calls, subagents) to a separate terminal. Watch multiple sessions simultaneously, filter by content type, and track background tasks. Ideal for debugging or understanding what Claude is doing under the hood without interrupting your main session.",FALSE,FALSE,2026-01-09:02-29-43,2026-02-28:18-53-39,v0.3.1,github-releases client-29b7453b,claude-tmux,Alternative Clients,General,https://github.com/nielsgroen/claude-tmux,,Niels Groeneveld,https://github.com/nielsgroen,TRUE,2026-02-26:09-15-28,2026-01-13:17-17-51,2026-03-02:02-01-45,NOASSERTION,"Manage Claude Code within tmux. A tmux popup of all your Claude Code instances, enabling quick switching, status monitoring, session lifecycle management, with git worktree and pull request support.",FALSE,FALSE,2026-01-12:13-31-48,,, tool-1c31f36c,crystal,Alternative Clients,General,https://github.com/stravu/crystal,,stravu,https://github.com/stravu,TRUE,2025-07-29,2026-02-26:21-44-09,2026-03-02:02-01-48,MIT,"A full-fledged desktop application for orchestrating, monitoring, and interacting with Claude Code agents.",FALSE,FALSE,2025-06-12:15-54-26,2026-02-26:22-26-05,v0.3.5,github-releases client-b6c9db9e,Omnara,Alternative Clients,General,https://github.com/omnara-ai/omnara,https://omnara.com,Ishaan Sehgal,https://github.com/ishaansehgal99,TRUE,2025-11-01:06-18-53,2025-12-27:20-48-56,2026-03-02:02-01-51,Apache-2.0,"A command center for AI agents that syncs Claude Code sessions across terminal, web, and mobile. Allows for remote monitoring, human-in-the-loop interaction, and team collaboration.",FALSE,FALSE,2025-07-09:02-17-44,2025-11-09:08-02-17,v1.7.0,github-releases doc-93f22142,Anthropic Documentation,Official Documentation,General,https://docs.claude.com/en/home,,Anthropic,https://github.com/anthropics,TRUE,,,2026-03-02:02-01-52,©,"The official documentation for Claude Code, including installation instructions, usage guidelines, API references, tutorials, examples, loads of information that I won't list individually. Like Claude Code, the documentation is frequently updated.",FALSE,,,,, doc-b71240b4,Anthropic Quickstarts,Official Documentation,General,https://github.com/anthropics/claude-quickstarts,,Anthropic,https://github.com/anthropics,TRUE,2025-07-29,2026-02-05:20-47-08,2026-03-02:02-01-55,MIT,"Offers comprehensive development guides for three distinct AI-powered demo projects with standardized workflows, strict code style guidelines, and containerization instructions.",FALSE,FALSE,2024-09-03:06-33-15,,, doc-9703ea36,Claude Code GitHub Actions,Official Documentation,General,https://github.com/anthropics/claude-code-action/tree/main/examples,,Anthropic,https://github.com/anthropics,TRUE,2025-07-29,2026-03-14:01-29-31,2026-03-02:02-01-57,MIT,Official GitHub Actions integration for Claude Code with examples and documentation for automating AI-powered workflows in CI/CD pipelines.,FALSE,FALSE,2025-05-19:15-32-32,2025-08-26:17-01-10,v1,github-releases output-447d1481,Awesome Claude Code Output Styles (That I Really Like),Output Styles,General,https://github.com/hesreallyhim/awesome-claude-code-output-styles-that-i-really-like,,Really Him,https://github.com/hesreallyhim/,TRUE,2025-11-21:21-57-16,2025-11-21:22-36-37,2026-03-02:02-02-00,MIT,A fun and moderately amusing collection of experimental output styles.,FALSE,TRUE,2025-11-21:17-25-13,,, output-2d98cb4f,ccoutputstyles,Output Styles,General,https://github.com/viveknair/ccoutputstyles,,Vivek Nair,https://github.com/viveknair,TRUE,2025-09-21:13-11-39,2025-09-02:19-09-24,2026-03-02:02-02-03,MIT,CLI tool and template gallery for customizing Claude Code output styles with pre-built templates. Features over 15 templates at the time of writing!,FALSE,TRUE,2025-08-22:16-22-49,,, output-ca5630d6,Claude Code Output Styles - Debugging,Output Styles,General,https://github.com/JamieM0/claude-output-styles,,Jamie Matthews,https://github.com/JamieM0,TRUE,2025-12-06:18-14-46,2025-09-18:18-14-32,2026-03-02:02-02-06,MIT,"A small set of well-written output styles, specifically focused on debugging - root cause analysis, systematic, methodical debugging, encouraging a more careful approach to bug-squashing from Claude Code.",FALSE,TRUE,2025-09-18:16-55-27,,, output-ade86de0,Gen-Alpha Slang,Output Styles,General,https://github.com/sjnims/gen-alpha-output-style,,Steve Nims,https://github.com/sjnims,TRUE,2025-11-25:08-16-31,2026-01-12:22-39-03,2026-03-02:02-02-08,MIT,"This is really... different. I don't know what to say about this one. It does what it says on the tin. You might find it funny, you might want throw up. I'll just say candidly this is included strictly for its potentially comedic awesomeness.",FALSE,FALSE,2025-11-25:02-46-08,,, ================================================ FILE: acc-config.yaml ================================================ # Awesome Claude Code Configuration # This file controls various aspects of README generation and repository behavior. # ============================================================================= # README Generation Settings # ============================================================================= readme: # Which README style should be the root (lives at repo root as README.md) # Options: extra, classic, awesome, flat root_style: awesome # ============================================================================= # Style Selector Configuration # ============================================================================= # Defines the styles shown in the "Pick Your Style" selector across all READMEs. # Each style has: # - name: Display name for the badge alt text # - badge: SVG badge filename (without path) # - highlight_color: Border color when this style is selected # - filename: README variant filename stored under README_ALTERNATIVES/ styles: extra: name: Extra badge: badge-style-extra.svg highlight_color: "#6a6a8a" filename: README_EXTRA.md classic: name: Classic badge: badge-style-classic.svg highlight_color: "#c9a227" filename: README_CLASSIC.md awesome: name: Awesome badge: badge-style-awesome.svg highlight_color: "#cc3366" filename: README_AWESOME.md flat: name: Flat badge: badge-style-flat.svg highlight_color: "#71717a" filename: README_FLAT_ALL_AZ.md # Order in which styles appear in the selector (left to right) style_order: - awesome - extra - classic - flat ================================================ FILE: data/repo-ticker-previous.csv ================================================ full_name,stars,watchers,forks,stars_delta,watchers_delta,forks_delta,url anthropics/claude-code,80099,80099,6616,70,70,10,https://github.com/anthropics/claude-code affaan-m/everything-claude-code,88216,88216,11540,670,670,66,https://github.com/affaan-m/everything-claude-code shareAI-lab/learn-claude-code,33599,33599,5470,145,145,14,https://github.com/shareAI-lab/learn-claude-code musistudio/claude-code-router,30021,30021,2307,3,3,0,https://github.com/musistudio/claude-code-router davila7/claude-code-templates,23229,23229,2223,13,13,3,https://github.com/davila7/claude-code-templates hesreallyhim/awesome-claude-code,29213,29213,1969,57,57,6,https://github.com/hesreallyhim/awesome-claude-code shanraisshan/claude-code-best-practice,18981,18981,1663,113,113,9,https://github.com/shanraisshan/claude-code-best-practice anthropics/claude-code-action,6385,6385,1570,1,1,1,https://github.com/anthropics/claude-code-action VoltAgent/awesome-claude-code-subagents,14426,14426,1600,27,27,1,https://github.com/VoltAgent/awesome-claude-code-subagents diet103/claude-code-infrastructure-showcase,9284,9284,1195,1,1,-1,https://github.com/diet103/claude-code-infrastructure-showcase frankbria/ralph-claude-code,8021,8021,574,6,6,1,https://github.com/frankbria/ralph-claude-code Piebald-AI/claude-code-system-prompts,6183,6183,853,9,9,1,https://github.com/Piebald-AI/claude-code-system-prompts OneRedOak/claude-code-workflows,3720,3720,547,-1,-1,0,https://github.com/OneRedOak/claude-code-workflows ChrisWiles/claude-code-showcase,5546,5546,482,3,3,3,https://github.com/ChrisWiles/claude-code-showcase ykdojo/claude-code-tips,6019,6019,406,82,82,4,https://github.com/ykdojo/claude-code-tips 1rgs/claude-code-proxy,3266,3266,429,3,3,0,https://github.com/1rgs/claude-code-proxy pedrohcgs/claude-code-my-workflow,691,691,1252,0,0,8,https://github.com/pedrohcgs/claude-code-my-workflow disler/claude-code-hooks-mastery,3341,3341,579,1,1,0,https://github.com/disler/claude-code-hooks-mastery zebbern/claude-code-guide,3669,3669,339,1,1,0,https://github.com/zebbern/claude-code-guide kodu-ai/claude-coder,5287,5287,197,-1,-1,0,https://github.com/kodu-ai/claude-coder Yuyz0112/claude-code-reverse,2208,2208,367,0,0,0,https://github.com/Yuyz0112/claude-code-reverse anthropics/skills,97800,97800,10588,99,99,18,https://github.com/anthropics/skills Maciek-roboblog/Claude-Code-Usage-Monitor,7027,7027,340,1,1,0,https://github.com/Maciek-roboblog/Claude-Code-Usage-Monitor qwibitai/nanoclaw,24359,24359,7083,40,40,62,https://github.com/qwibitai/nanoclaw fuergaosi233/claude-code-proxy,2190,2190,314,3,3,0,https://github.com/fuergaosi233/claude-code-proxy RichardAtCT/claude-code-telegram,2155,2155,281,5,5,3,https://github.com/RichardAtCT/claude-code-telegram anthropics/claude-code-security-review,3879,3879,322,9,9,0,https://github.com/anthropics/claude-code-security-review Cranot/claude-code-guide,2502,2502,262,0,0,0,https://github.com/Cranot/claude-code-guide anthropics/claude-code-base-action,613,613,590,1,1,0,https://github.com/anthropics/claude-code-base-action sickn33/antigravity-awesome-skills,25928,25928,4434,52,52,7,https://github.com/sickn33/antigravity-awesome-skills https-deeplearning-ai/sc-claude-code-files,455,455,618,0,0,0,https://github.com/https-deeplearning-ai/sc-claude-code-files ding113/claude-code-hub,1975,1975,236,0,0,0,https://github.com/ding113/claude-code-hub edmund-io/edmunds-claude-code,1338,1338,277,0,0,1,https://github.com/edmund-io/edmunds-claude-code router-for-me/CLIProxyAPI,18295,18295,2963,75,75,4,https://github.com/router-for-me/CLIProxyAPI FlorianBruniaux/claude-code-ultimate-guide,1993,1993,312,6,6,2,https://github.com/FlorianBruniaux/claude-code-ultimate-guide wshobson/agents,31736,31736,3469,17,17,4,https://github.com/wshobson/agents Pimzino/claude-code-spec-workflow,3557,3557,249,1,1,0,https://github.com/Pimzino/claude-code-spec-workflow snarktank/ralph,13302,13302,1389,15,15,0,https://github.com/snarktank/ralph EveryInc/compound-engineering-plugin,10628,10628,854,7,7,1,https://github.com/EveryInc/compound-engineering-plugin eyaltoledano/claude-task-master,25992,25992,2449,1,1,0,https://github.com/eyaltoledano/claude-task-master feiskyer/claude-code-settings,1328,1328,197,2,2,1,https://github.com/feiskyer/claude-code-settings carlvellotti/claude-code-pm-course,1645,1645,246,0,0,0,https://github.com/carlvellotti/claude-code-pm-course siteboon/claudecodeui,8656,8656,1105,6,6,3,https://github.com/siteboon/claudecodeui sugyan/claude-code-webui,969,969,222,0,0,0,https://github.com/sugyan/claude-code-webui obra/superpowers,99156,99156,7897,430,430,31,https://github.com/obra/superpowers zhukunpenglinyutong/idea-claude-code-gui,2019,2019,225,1,1,0,https://github.com/zhukunpenglinyutong/idea-claude-code-gui centminmod/my-claude-code-setup,2086,2086,208,3,3,1,https://github.com/centminmod/my-claude-code-setup lst97/claude-code-sub-agents,1479,1479,236,3,3,0,https://github.com/lst97/claude-code-sub-agents ghuntley/claude-code-source-code-deobfuscation,864,864,422,0,0,0,https://github.com/ghuntley/claude-code-source-code-deobfuscation nishimoto265/Claude-Code-Communication,495,495,237,0,0,0,https://github.com/nishimoto265/Claude-Code-Communication bfly123/claude_code_bridge,1696,1696,153,4,4,1,https://github.com/bfly123/claude_code_bridge darcyegb/ClaudeCodeAgents,608,608,53,2,2,0,https://github.com/darcyegb/ClaudeCodeAgents slopus/happy,15755,15755,1239,6,6,5,https://github.com/slopus/happy anthropics/claude-plugins-official,12836,12836,1253,71,71,6,https://github.com/anthropics/claude-plugins-official andrepimenta/claude-code-chat,1003,1003,155,0,0,0,https://github.com/andrepimenta/claude-code-chat rizethereum/claude-code-requirements-builder,1759,1759,173,0,0,0,https://github.com/rizethereum/claude-code-requirements-builder Njengah/claude-code-cheat-sheet,1451,1451,183,0,0,0,https://github.com/Njengah/claude-code-cheat-sheet trailofbits/claude-code-config,1627,1627,125,2,2,1,https://github.com/trailofbits/claude-code-config farion1231/cc-switch,30522,30522,1839,18,18,1,https://github.com/farion1231/cc-switch steipete/claude-code-mcp,1181,1181,144,2,2,0,https://github.com/steipete/claude-code-mcp catlog22/Claude-Code-Workflow,1500,1500,123,0,0,0,https://github.com/catlog22/Claude-Code-Workflow disler/claude-code-hooks-multi-agent-observability,1280,1280,356,1,1,1,https://github.com/disler/claude-code-hooks-multi-agent-observability KimYx0207/Claude-Code-x-OpenClaw-Guide-Zh,2154,2154,356,1,1,0,https://github.com/KimYx0207/Claude-Code-x-OpenClaw-Guide-Zh jeremylongshore/claude-code-plugins-plus-skills,1656,1656,207,5,5,0,https://github.com/jeremylongshore/claude-code-plugins-plus-skills simonw/claude-code-transcripts,1146,1146,131,1,1,1,https://github.com/simonw/claude-code-transcripts 0xfurai/claude-code-subagents,783,783,144,1,1,0,https://github.com/0xfurai/claude-code-subagents JessyTsui/Claude-Code-Remote,1171,1171,124,0,0,0,https://github.com/JessyTsui/Claude-Code-Remote wanshuiyin/Auto-claude-code-research-in-sleep,2593,2593,224,12,12,2,https://github.com/wanshuiyin/Auto-claude-code-research-in-sleep Alishahryar1/free-claude-code,1042,1042,127,6,6,1,https://github.com/Alishahryar1/free-claude-code winfunc/opcode,21013,21013,1618,3,3,0,https://github.com/winfunc/opcode jarrodwatts/claude-code-config,981,981,125,0,0,0,https://github.com/jarrodwatts/claude-code-config cixingguangming55555/wechat-bot,2533,2533,664,0,0,0,https://github.com/cixingguangming55555/wechat-bot peterkrueck/Claude-Code-Development-Kit,1328,1328,153,0,0,0,https://github.com/peterkrueck/Claude-Code-Development-Kit github/spec-kit,78624,78624,6674,61,61,10,https://github.com/github/spec-kit alirezarezvani/claude-skills,5972,5972,696,26,26,3,https://github.com/alirezarezvani/claude-skills pchalasani/claude-code-tools,1595,1595,100,1,1,0,https://github.com/pchalasani/claude-code-tools alirezarezvani/claude-code-tresor,630,630,142,1,1,1,https://github.com/alirezarezvani/claude-code-tresor d-kimuson/claude-code-viewer,984,984,115,0,0,0,https://github.com/d-kimuson/claude-code-viewer revfactory/claude-code-mastering,762,762,124,0,0,0,https://github.com/revfactory/claude-code-mastering wasabeef/claude-code-cookbook,1044,1044,111,0,0,0,https://github.com/wasabeef/claude-code-cookbook rohitg00/awesome-claude-code-toolkit,857,857,161,0,0,1,https://github.com/rohitg00/awesome-claude-code-toolkit ComposioHQ/awesome-claude-skills,46127,46127,4688,67,67,7,https://github.com/ComposioHQ/awesome-claude-skills anthropics/claude-agent-sdk-demos,1762,1762,272,4,4,2,https://github.com/anthropics/claude-agent-sdk-demos Yeachan-Heo/oh-my-claudecode,10475,10475,731,19,19,1,https://github.com/Yeachan-Heo/oh-my-claudecode code-yeongyu/oh-my-openagent,41583,41583,3107,44,44,2,https://github.com/code-yeongyu/oh-my-openagent OthmanAdi/planning-with-files,16558,16558,1514,8,8,1,https://github.com/OthmanAdi/planning-with-files ericbuess/claude-code-docs,743,743,104,-1,-1,0,https://github.com/ericbuess/claude-code-docs severity1/claude-code-prompt-improver,1295,1295,111,1,1,0,https://github.com/severity1/claude-code-prompt-improver numman-ali/openskills,9109,9109,584,5,5,0,https://github.com/numman-ali/openskills anomalyco/opencode,125538,125538,13227,122,122,26,https://github.com/anomalyco/opencode daymade/claude-code-skills,689,689,106,0,0,0,https://github.com/daymade/claude-code-skills MadAppGang/claude-code,248,248,25,1,1,0,https://github.com/MadAppGang/claude-code lyconear/Claude-Code,4,4,149,0,0,0,https://github.com/lyconear/Claude-Code ccplugins/awesome-claude-code-plugins,636,636,140,0,0,0,https://github.com/ccplugins/awesome-claude-code-plugins anthropics/claude-agent-sdk-python,5594,5594,748,5,5,0,https://github.com/anthropics/claude-agent-sdk-python greggh/claude-code.nvim,1934,1934,62,1,1,0,https://github.com/greggh/claude-code.nvim opactorai/Claudable,3819,3819,570,0,0,0,https://github.com/opactorai/Claudable disler/pi-vs-claude-code,504,504,147,4,4,0,https://github.com/disler/pi-vs-claude-code PleasePrompto/notebooklm-skill,4714,4714,487,6,6,1,https://github.com/PleasePrompto/notebooklm-skill timothywarner-org/claude-code,201,201,28,0,0,0,https://github.com/timothywarner-org/claude-code ================================================ FILE: data/repo-ticker.csv ================================================ full_name,stars,watchers,forks,stars_delta,watchers_delta,forks_delta,url anthropics/claude-code,80263,80263,6631,164,164,15,https://github.com/anthropics/claude-code affaan-m/everything-claude-code,88877,88877,11637,661,661,97,https://github.com/affaan-m/everything-claude-code shareAI-lab/learn-claude-code,34027,34027,5525,428,428,55,https://github.com/shareAI-lab/learn-claude-code musistudio/claude-code-router,30040,30040,2307,19,19,0,https://github.com/musistudio/claude-code-router davila7/claude-code-templates,23243,23243,2223,14,14,0,https://github.com/davila7/claude-code-templates hesreallyhim/awesome-claude-code,29262,29262,1974,49,49,5,https://github.com/hesreallyhim/awesome-claude-code shanraisshan/claude-code-best-practice,19099,19099,1668,118,118,5,https://github.com/shanraisshan/claude-code-best-practice anthropics/claude-code-action,6393,6393,1570,8,8,0,https://github.com/anthropics/claude-code-action VoltAgent/awesome-claude-code-subagents,14449,14449,1602,23,23,2,https://github.com/VoltAgent/awesome-claude-code-subagents diet103/claude-code-infrastructure-showcase,9289,9289,1195,5,5,0,https://github.com/diet103/claude-code-infrastructure-showcase frankbria/ralph-claude-code,8028,8028,576,7,7,2,https://github.com/frankbria/ralph-claude-code Piebald-AI/claude-code-system-prompts,6201,6201,853,18,18,0,https://github.com/Piebald-AI/claude-code-system-prompts OneRedOak/claude-code-workflows,3721,3721,547,1,1,0,https://github.com/OneRedOak/claude-code-workflows ChrisWiles/claude-code-showcase,5546,5546,482,0,0,0,https://github.com/ChrisWiles/claude-code-showcase ykdojo/claude-code-tips,6194,6194,417,175,175,11,https://github.com/ykdojo/claude-code-tips 1rgs/claude-code-proxy,3268,3268,428,2,2,-1,https://github.com/1rgs/claude-code-proxy pedrohcgs/claude-code-my-workflow,696,696,1268,5,5,16,https://github.com/pedrohcgs/claude-code-my-workflow disler/claude-code-hooks-mastery,3341,3341,579,0,0,0,https://github.com/disler/claude-code-hooks-mastery zebbern/claude-code-guide,3672,3672,339,3,3,0,https://github.com/zebbern/claude-code-guide kodu-ai/claude-coder,5287,5287,197,0,0,0,https://github.com/kodu-ai/claude-coder Maciek-roboblog/Claude-Code-Usage-Monitor,7030,7030,340,3,3,0,https://github.com/Maciek-roboblog/Claude-Code-Usage-Monitor anthropics/skills,98070,98070,10618,270,270,30,https://github.com/anthropics/skills Yuyz0112/claude-code-reverse,2210,2210,367,2,2,0,https://github.com/Yuyz0112/claude-code-reverse qwibitai/nanoclaw,24412,24412,7137,53,53,54,https://github.com/qwibitai/nanoclaw fuergaosi233/claude-code-proxy,2193,2193,314,3,3,0,https://github.com/fuergaosi233/claude-code-proxy RichardAtCT/claude-code-telegram,2159,2159,281,4,4,0,https://github.com/RichardAtCT/claude-code-telegram anthropics/claude-code-security-review,3881,3881,322,2,2,0,https://github.com/anthropics/claude-code-security-review Cranot/claude-code-guide,2503,2503,262,1,1,0,https://github.com/Cranot/claude-code-guide anthropics/claude-code-base-action,614,614,590,1,1,0,https://github.com/anthropics/claude-code-base-action sickn33/antigravity-awesome-skills,25993,25993,4439,65,65,5,https://github.com/sickn33/antigravity-awesome-skills https-deeplearning-ai/sc-claude-code-files,455,455,618,0,0,0,https://github.com/https-deeplearning-ai/sc-claude-code-files ding113/claude-code-hub,1987,1987,235,12,12,-1,https://github.com/ding113/claude-code-hub edmund-io/edmunds-claude-code,1340,1340,277,2,2,0,https://github.com/edmund-io/edmunds-claude-code router-for-me/CLIProxyAPI,18428,18428,2986,133,133,23,https://github.com/router-for-me/CLIProxyAPI FlorianBruniaux/claude-code-ultimate-guide,1999,1999,313,6,6,1,https://github.com/FlorianBruniaux/claude-code-ultimate-guide wshobson/agents,31772,31772,3471,36,36,2,https://github.com/wshobson/agents Pimzino/claude-code-spec-workflow,3559,3559,249,2,2,0,https://github.com/Pimzino/claude-code-spec-workflow snarktank/ralph,13318,13318,1390,16,16,1,https://github.com/snarktank/ralph EveryInc/compound-engineering-plugin,10655,10655,855,27,27,1,https://github.com/EveryInc/compound-engineering-plugin eyaltoledano/claude-task-master,25996,25996,2449,4,4,0,https://github.com/eyaltoledano/claude-task-master feiskyer/claude-code-settings,1330,1330,197,2,2,0,https://github.com/feiskyer/claude-code-settings siteboon/claudecodeui,8671,8671,1106,15,15,1,https://github.com/siteboon/claudecodeui carlvellotti/claude-code-pm-course,1646,1646,247,1,1,1,https://github.com/carlvellotti/claude-code-pm-course zhukunpenglinyutong/idea-claude-code-gui,2032,2032,227,13,13,2,https://github.com/zhukunpenglinyutong/idea-claude-code-gui obra/superpowers,99946,99946,7975,790,790,78,https://github.com/obra/superpowers sugyan/claude-code-webui,970,970,222,1,1,0,https://github.com/sugyan/claude-code-webui centminmod/my-claude-code-setup,2086,2086,208,0,0,0,https://github.com/centminmod/my-claude-code-setup lst97/claude-code-sub-agents,1480,1480,236,1,1,0,https://github.com/lst97/claude-code-sub-agents ghuntley/claude-code-source-code-deobfuscation,864,864,422,0,0,0,https://github.com/ghuntley/claude-code-source-code-deobfuscation nishimoto265/Claude-Code-Communication,495,495,237,0,0,0,https://github.com/nishimoto265/Claude-Code-Communication bfly123/claude_code_bridge,1704,1704,153,8,8,0,https://github.com/bfly123/claude_code_bridge darcyegb/ClaudeCodeAgents,610,610,53,2,2,0,https://github.com/darcyegb/ClaudeCodeAgents anthropics/claude-plugins-official,13040,13040,1274,204,204,21,https://github.com/anthropics/claude-plugins-official slopus/happy,15778,15778,1241,23,23,2,https://github.com/slopus/happy rizethereum/claude-code-requirements-builder,1759,1759,173,0,0,0,https://github.com/rizethereum/claude-code-requirements-builder andrepimenta/claude-code-chat,1002,1002,155,-1,-1,0,https://github.com/andrepimenta/claude-code-chat trailofbits/claude-code-config,1629,1629,125,2,2,0,https://github.com/trailofbits/claude-code-config Njengah/claude-code-cheat-sheet,1452,1452,183,1,1,0,https://github.com/Njengah/claude-code-cheat-sheet farion1231/cc-switch,30734,30734,1847,212,212,8,https://github.com/farion1231/cc-switch steipete/claude-code-mcp,1181,1181,144,0,0,0,https://github.com/steipete/claude-code-mcp catlog22/Claude-Code-Workflow,1503,1503,123,3,3,0,https://github.com/catlog22/Claude-Code-Workflow disler/claude-code-hooks-multi-agent-observability,1280,1280,356,0,0,0,https://github.com/disler/claude-code-hooks-multi-agent-observability KimYx0207/Claude-Code-x-OpenClaw-Guide-Zh,2167,2167,358,13,13,2,https://github.com/KimYx0207/Claude-Code-x-OpenClaw-Guide-Zh simonw/claude-code-transcripts,1146,1146,131,0,0,0,https://github.com/simonw/claude-code-transcripts jeremylongshore/claude-code-plugins-plus-skills,1664,1664,207,8,8,0,https://github.com/jeremylongshore/claude-code-plugins-plus-skills 0xfurai/claude-code-subagents,783,783,144,0,0,0,https://github.com/0xfurai/claude-code-subagents JessyTsui/Claude-Code-Remote,1172,1172,125,1,1,1,https://github.com/JessyTsui/Claude-Code-Remote wanshuiyin/Auto-claude-code-research-in-sleep,2661,2661,229,68,68,5,https://github.com/wanshuiyin/Auto-claude-code-research-in-sleep Alishahryar1/free-claude-code,1044,1044,128,2,2,1,https://github.com/Alishahryar1/free-claude-code jarrodwatts/claude-code-config,982,982,125,1,1,0,https://github.com/jarrodwatts/claude-code-config winfunc/opcode,21020,21020,1619,7,7,1,https://github.com/winfunc/opcode peterkrueck/Claude-Code-Development-Kit,1329,1329,154,1,1,1,https://github.com/peterkrueck/Claude-Code-Development-Kit alirezarezvani/claude-skills,6008,6008,699,36,36,3,https://github.com/alirezarezvani/claude-skills cixingguangming55555/wechat-bot,2533,2533,664,0,0,0,https://github.com/cixingguangming55555/wechat-bot github/spec-kit,78706,78706,6676,82,82,2,https://github.com/github/spec-kit pchalasani/claude-code-tools,1594,1594,100,-1,-1,0,https://github.com/pchalasani/claude-code-tools alirezarezvani/claude-code-tresor,631,631,142,1,1,0,https://github.com/alirezarezvani/claude-code-tresor d-kimuson/claude-code-viewer,984,984,115,0,0,0,https://github.com/d-kimuson/claude-code-viewer revfactory/claude-code-mastering,762,762,124,0,0,0,https://github.com/revfactory/claude-code-mastering rohitg00/awesome-claude-code-toolkit,859,859,162,2,2,1,https://github.com/rohitg00/awesome-claude-code-toolkit wasabeef/claude-code-cookbook,1044,1044,111,0,0,0,https://github.com/wasabeef/claude-code-cookbook ComposioHQ/awesome-claude-skills,46214,46214,4701,87,87,13,https://github.com/ComposioHQ/awesome-claude-skills anthropics/claude-agent-sdk-demos,1765,1765,272,3,3,0,https://github.com/anthropics/claude-agent-sdk-demos Yeachan-Heo/oh-my-claudecode,10572,10572,735,97,97,4,https://github.com/Yeachan-Heo/oh-my-claudecode code-yeongyu/oh-my-openagent,41705,41705,3117,122,122,10,https://github.com/code-yeongyu/oh-my-openagent ericbuess/claude-code-docs,743,743,104,0,0,0,https://github.com/ericbuess/claude-code-docs OthmanAdi/planning-with-files,16594,16594,1518,36,36,4,https://github.com/OthmanAdi/planning-with-files severity1/claude-code-prompt-improver,1295,1295,111,0,0,0,https://github.com/severity1/claude-code-prompt-improver numman-ali/openskills,9118,9118,585,9,9,1,https://github.com/numman-ali/openskills anomalyco/opencode,125774,125774,13268,236,236,41,https://github.com/anomalyco/opencode daymade/claude-code-skills,689,689,106,0,0,0,https://github.com/daymade/claude-code-skills MadAppGang/claude-code,248,248,25,0,0,0,https://github.com/MadAppGang/claude-code lyconear/Claude-Code,4,4,149,0,0,0,https://github.com/lyconear/Claude-Code ccplugins/awesome-claude-code-plugins,636,636,140,0,0,0,https://github.com/ccplugins/awesome-claude-code-plugins anthropics/claude-agent-sdk-python,5603,5603,748,9,9,0,https://github.com/anthropics/claude-agent-sdk-python greggh/claude-code.nvim,1934,1934,62,0,0,0,https://github.com/greggh/claude-code.nvim opactorai/Claudable,3819,3819,570,0,0,0,https://github.com/opactorai/Claudable disler/pi-vs-claude-code,504,504,147,0,0,0,https://github.com/disler/pi-vs-claude-code PleasePrompto/notebooklm-skill,4725,4725,487,11,11,0,https://github.com/PleasePrompto/notebooklm-skill timothywarner-org/claude-code,201,201,28,0,0,0,https://github.com/timothywarner-org/claude-code ================================================ FILE: docs/CODE_OF_CONDUCT.md ================================================ # Contributor Covenant Code of Conduct ## Our Pledge We as members, contributors, and leaders pledge to make participation in our community a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, caste, color, religion, or sexual identity and orientation. We pledge to act and interact in ways that contribute to an open, welcoming, diverse, inclusive, and healthy community. ## Our Standards Examples of behavior that contributes to a positive environment for our community include: - Demonstrating empathy and kindness toward other people - Being respectful of differing opinions, viewpoints, and experiences - Giving and gracefully accepting constructive feedback - Accepting responsibility and apologizing to those affected by our mistakes, and learning from the experience - Focusing on what is best not just for us as individuals, but for the overall community Examples of unacceptable behavior include: - The use of sexualized language or imagery, and sexual attention or advances of any kind - Trolling, insulting or derogatory comments, and personal or political attacks - Public or private harassment - Publishing others' private information, such as a physical or email address, without their explicit permission - Other conduct which could reasonably be considered inappropriate in a professional setting - Use of this community resource for the purposes of: (i) spreading malware, spyware, and/or adware; (ii) attempting to promote proprietary, commercial offerings under the guise of, and at the expense of, the communal, informational purposes of this list. ## Enforcement Responsibilities Community leaders are responsible for clarifying and enforcing our standards of acceptable behavior and will take appropriate and fair corrective action in response to any behavior that they deem inappropriate, threatening, offensive, or harmful. Community leaders have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, and will communicate reasons for moderation decisions when appropriate. ## Scope This Code of Conduct applies within all community spaces, and also applies when an individual is officially representing the community in public spaces. Examples of representing our community include using an official email address, posting via an official social media account, or acting as an appointed representative at an online or offline event. ## Enforcement Instances of abusive, harassing, or otherwise unacceptable behavior may be reported to the community leaders responsible for enforcement at awesome-conduct@hesreallyhim.com. All complaints will be reviewed and investigated promptly and fairly. All community leaders are obligated to respect the privacy and security of the reporter of any incident. ## Enforcement Guidelines Community leaders will follow these Community Impact Guidelines in determining the consequences for any action they deem in violation of this Code of Conduct: ### 1. Correction **Community Impact**: Use of inappropriate language or other behavior deemed unprofessional or unwelcome in the community. **Consequence**: A private, written warning from community leaders, providing clarity around the nature of the violation and an explanation of why the behavior was inappropriate. A public apology may be requested. ### 2. Warning **Community Impact**: A violation through a single incident or series of actions. **Consequence**: A warning with consequences for continued behavior. No interaction with the people involved, including unsolicited interaction with those enforcing the Code of Conduct, for a specified period of time. This includes avoiding interactions in community spaces as well as external channels like social media. Violating these terms may lead to a temporary or permanent ban. ### 3. Temporary Ban **Community Impact**: A serious violation of community standards, including sustained inappropriate behavior. **Consequence**: A temporary ban from any sort of interaction or public communication with the community for a specified period of time. No public or private interaction with the people involved, including unsolicited interaction with those enforcing the Code of Conduct, is allowed during this period. Violating these terms may lead to a permanent ban. ### 4. Permanent Ban **Community Impact**: Demonstrating a pattern of violation of community standards, including sustained inappropriate behavior, harassment of an individual, or aggression toward or disparagement of classes of individuals. **Consequence**: A permanent ban from any sort of public interaction within the community. ## Attribution This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 2.1, available at [https://www.contributor-covenant.org/version/2/1/code_of_conduct.html][v2.1]. Community Impact Guidelines were inspired by [Mozilla's code of conduct enforcement ladder][Mozilla CoC]. For answers to common questions about this code of conduct, see the FAQ at [https://www.contributor-covenant.org/faq][FAQ]. Translations are available at [https://www.contributor-covenant.org/translations][translations]. [homepage]: https://www.contributor-covenant.org [v2.1]: https://www.contributor-covenant.org/version/2/1/code_of_conduct.html [Mozilla CoC]: https://github.com/mozilla/diversity [FAQ]: https://www.contributor-covenant.org/faq [translations]: https://www.contributor-covenant.org/translations ================================================ FILE: docs/CONTRIBUTING.md ================================================ # Contributing to Awesome Claude Code Please take a moment to read through this docoument if you plan to submit something for recommendation. > [!WARNING] > Due to aggressive spamming of the repository's recommendation system, strict measures are in place to ensure that submissions are made accoring to the requirements stated in this document. The penalties are harsh, but compliance is very easy, and any well-meaning user who reads this document is unlikely to be affected. In additiion, please note that a temporary ban is also in place for any submissions relating to OpenClaw. I hope that these incidents were the result of a few irresponsible users, and not reflective of the OpenClaw community as a whole, and I'm sure this will be removed in the near future, but it is deemed necessary as a palliative measure. - I am very grateful to receive recommendations from the visitors to this list. But be aware that there is no formal submission/review process at the moment. My responsibility is to share links to awesome things. One way I find out about awesome things is via the repo's issues, and I'm very grateful to everyone who shares their amazing work. But it's not the only way, and creating an issue does not represent any sort of contract. - Bear in mind that the point of an Awesome List is to be *selective* - I cannot recommend every single resource that is submitted. - Although many awesome resources are inter-operable, we especially welcome and invite recommendations of resources that focus on the unique features and functionality of Claude Code. This is not a hard requirement but it is a guideline. - I'm constantly trying to improve the way in which recommendations can be submitted, and to provide clear guidance to users who wish to share their work. Here are some of those guidelines: - security is of the utmost importance. I'm unlikely to install any software unless I have high confidence that it is free of malware, spyware, adware, or bloat. If a resource involves executing a shell script, for example, it is recommended to supply clear and thorough comments explaining exactly what it does. - If your library makes any network calls except to Anthropic servers; modifies shared system files; involves any form of telemetry; or requires "bypass-permissions" mode, this must be stated very clearly. - Do not submit resources that do not comply with the licensing rights of other developers. Make sure you understand what OSS licenses require. - I value _focused_ resources with a clear purpose and use value. Even if you have a marketplace full of awesome plugins, you are encouraged to select one, or a small subset. - Claims about what a resource does have to be evidence-based - and you should not expect me, or probably any user, to do the work of proving it themselves. If you can provide a video demonstrating the effectiveness of a skill, e.g., this is tremendously helpful. Otherwise, provide instructions for validating the claims made in the description, and make them as detailed as possible. "Install this library into your favorite project and watch the magic happen" - no. "Clone this demo repository and install the plugin; give Claude the following prompt: ..." - yes. - Put a tiny bit of time and effort into your README. It's a shame that developers will put so much effort into a project and then let an agent write the README and hardly give it any thought. ## How to Recommend a Resource **NOTE: ALL RECOMMENDATIONS MUST BE MADE USING THE WEB UI ISSUE FORM TEMPLATE, OR YOU RISK BEING BANNED FROM INTERACTING WITH THIS REPOSITORY TEMPORARILY OR PERMANENTLY.** First, make sure you've read the above information. Second, make sure you've read, and agree with, the [Code of Conduct](./CODE_OF_CONDUCT.md). Then: ### **[Click here to submit a new resource](https://github.com/hesreallyhim/awesome-claude-code/issues/new?template=recommend-resource.yml)** Do not open a PR. Just fill out the form. If there are any issues with the form, the bot will notify you. (A notification from the bot that your recommendation needs some changes in formatting are not related to the warning above, which mainly applies to submissions that attempt to bypass the GitHub Web UI issue form entirely. You need not worry that formatting errors alone will incur a ban.) > [!Warning] > It is **not** possible to submit a resource recommendation using the `gh` CLI. Although resources themselves may be partially or entirely written by a coding agent, resource recommendations must be created by human beings. ### The Recommendation Process The entire recommendation process is managed via automation - even the maintainer does not use PRs to add entries to the list. The bot is really good at it. Here's what happens when you submit a resource for recommendation: ```mermaid graph TD A[📝 Fill out recommendation form] --> B[🤖 Automated validation] B --> C{Valid?} C -->|❌ No| D[Bot comments with issues] D --> E[Edit your submission] E --> B C -->|✅ Yes| F[Awaits maintainer review] F --> G{Decision} G -->|👍 Approved| H[Bot creates PR automatically] G -->|🔄 Changes requested| I[Maintainer requests changes] G -->|👎 Rejected| J[Issue closed] I --> E H --> K[PR merged] K --> L[🎉 Resource goes live!] L --> M[You receive notification] ``` ### What the Bot Validates When you submit a resource, the bot checks: - All required fields are filled - URLs are valid and accessible - No duplicate resources exist - License information (when available) - Description length and quality The bot's validation is not any sort of review. It's merely a formal check. ## Other Contributions ### Suggesting Improvements For suggestions about the repository structure, new categories, or other enhancements: 1. **[Open a general issue](https://github.com/hesreallyhim/awesome-claude-code/issues/new)** 2. Describe your suggestion clearly 3. Explain the benefit to the community Or, alternatively, start a thread in the [Discussions](https://github.com/hesreallyhim/awesome-claude-code/discussions) tab. All opinions are welcome in this repo so long as they are expressed in accordance with the Code of Conduct. It's very nice to interact with people who visit the list. ## Badges If your submission is approved, you are invited to add a badge to your project's README: [![Mentioned in Awesome Claude Code](https://awesome.re/mentioned-badge.svg)](https://github.com/hesreallyhim/awesome-claude-code) ```markdown [![Mentioned in Awesome Claude Code](https://awesome.re/mentioned-badge.svg)](https://github.com/hesreallyhim/awesome-claude-code) ``` Or the flat version: [![Mentioned in Awesome Claude Code](https://awesome.re/mentioned-badge-flat.svg)](https://github.com/hesreallyhim/awesome-claude-code) ```markdown [![Mentioned in Awesome Claude Code](https://awesome.re/mentioned-badge-flat.svg)](https://github.com/hesreallyhim/awesome-claude-code) ``` ## GitHub Repository Notifications If your resource is on GitHub, our automated system will create a friendly notification issue on your repository informing you of the inclusion and providing badge options. ## Technical Details For more information about how the repository works, including the automated systems, validation processes, the "multi-list design and technical architecture, see the documents in `docs/` - in particular `README_GENERATION`. --- Thank you for taking the time to read this and to share your project (or any project). ================================================ FILE: docs/COOLDOWN.md ================================================ # Cooldown Protocol The following protocol exists to ensure fairness for all visitors that wish to be featured on the list, and to protect the repository from spam and other interactions which compromise the maintainer's ability to serve the needs of GitHub users. ## The GOLDEN Rule: Recommendations MUST be submitted by human beings using the Resource Recommendation Issue form template via the GitHub Web UI Submissions that do not satisfy this very reasonable requirement violate the [CONRIBUTING](https://github.com/hesreallyhim/awesome-claude-code?tab=contributing-ov-file) guidelines and the corresponding [CODE_OF_CONDUCT](https://github.com/hesreallyhim/awesome-claude-code?tab=coc-ov-file). As maintainer, it is my [responsibility](https://github.com/hesreallyhim/awesome-claude-code?tab=coc-ov-file#enforcement-responsibilities) to make sure these guidelines are being upheld, and to do so in a way that reflects the [requirements](https://github.com/hesreallyhim/awesome-claude-code?tab=coc-ov-file#enforcement-guidelines) in the Code of Conduct. The ones reading this are probably those least likely to be impacted by it. I'd like to thank everyone who supports this repository and makes a good-faith effort to contribute to it. If you believe that the automated processes that implement this protocol are unfairly or inaccurately affecting you, please leave a comment in the relevant issue (you don't need to re-open it), or contact the maintainer directly at awesome-conduct @ hesreallyhim.com ## Violations of The GOLDEN Rule Violating "The GOLDEN Rule" will (a) cause the issue to be immediately closed; (b) initiate an automatically enforced "cooldown" policy for the account that created the issue. **Users are personally responsible for the activity of AI agents that they have instructed, or permitted, to act on their behalf.** This is something that is true in general, and is also a consequence of GitHub's policy regarding access tokens. Violations include: * Submitting a resource recommendation without using the required Resource Recommendation issue template. * Submitting a resource via the `gh` CLI. Alas, the CLI does not presently supopport the creation of issues using issue templates, which carry the labels that are used to manage the processing of issues. If this happens to serve as a deterrent against bot submissions, I can't say I'm terribly despondent about that. * Although I have a lot of respect for some bots, only human beings are permitted to open issues in this repo. First of all, it's direspectful to Claude, who is supposed to be the star of the show; second of all, it is extremely obvious, and embarrassing. * You may not recommend a repo unless it is at least 7 days since the first public commit. What happens if any of the above requirements are violated: 1st Time: 1-day cooldown period (no more posts during this time) \ 2nd Time: 2-day cooldown period \ 3rd TIme: 4-day cooldown period \ 4th Time: 8-day cooldown period \ 5th Time: 16-day cooldown period \ 5th Time: 32-day cooldown period \ 6th Time: Permanent Ban **"Cooldown"** - no interactions with the respository during this time. It corresponds to a temporary ban such as described in the Code of Conduct, and reflects the seriousness of respecting the Community Guidelines and Contributing Guidelines of any repository whatsoever. The conditions I've laid out are not hard to comply with by anyone who has visited the repository and read the CONTRIBUTING doc, which is, as a matter of course, your obligation to do before enngaging with a repository. GitHub is a very nice place, where people are held to a somewhat higher standard, and it's my responsibility to follow the rules of conduct that I have set out. Violating the cooldown protocol will result in a ban that is deemed appropriate given the circumstances. I hope other visitors and developers will support this stance, and may have seen how disruptive it can be when basic standards of conduct are not met. ================================================ FILE: docs/HOW_IT_LOOKS.md ================================================ # How It Looks (WIP) Amazing, obviously. But there's more to it than pure visual stimulation - there's _numbers_ and... stuff. ## Why I Decided to Turn Awesome Claude Code into "90's MySpace Aesthetic" Because it looks incredible, obviously. **TODO:** - [ ] Add to `.gitignore` ================================================ FILE: docs/HOW_IT_WORKS.md ================================================ # How Awesome Claude Code Works This document provides assorted technical details about the repository structure, automated systems, and processes that power Awesome Claude Code. It's mostly superceded by [README-GENERATION](./README-GENERATION.md), but, for one reason or another, it's still here, for now. ### GitHub Labels The submission system uses several labels to track issue state: #### Resource Submission Labels - **`resource-submission`** - Applied automatically to issues created via the submission form - **`validation-passed`** - Applied when submission passes all validation checks - **`validation-failed`** - Applied when submission fails validation - **`approved`** - Applied when maintainer approves submission with `/approve` - **`pr-created`** - Applied after PR is successfully created - **`error-creating-pr`** - Applied if PR creation fails - **`rejected`** - Applied when maintainer rejects with `/reject` - **`changes-requested`** - Applied when maintainer requests changes with `/request-changes` #### Other Labels - **`broken-links`** - Applied by scheduled link validation when resources become unavailable - **`automated`** - Applied alongside `broken-links` to indicate automated detection - **`do-not-disturb`** - Apply to a resource PR before merging to skip the badge notification to the resource author's repository #### Label State Transitions 1. New submission → `resource-submission` 2. After validation → adds `validation-passed` OR `validation-failed` 3. If changes requested → adds `changes-requested` 4. When user edits and validation passes → removes `changes-requested` 5. On approval → adds `approved` + `pr-created` (or `error-creating-pr`) 6. On rejection → adds `rejected` ## The Submission Flow ### 1. User Submits Issue When a user submits a resource via the issue form: ```yaml # .github/ISSUE_TEMPLATE/submit-resource.yml - Structured form with all required fields - Auto-labels with "resource-submission" - Validates input formats ``` ### 2. Automated Validation The validation workflow triggers immediately: ```python # Simplified validation flow 1. Parse issue body → extract form data 2. Validate required fields 3. Check URL accessibility 4. Verify no duplicates exist 5. Post results as comment 6. Update issue labels ``` **Validation includes:** - URL validation (200 OK response) - License detection from GitHub API - Duplicate checking against existing CSV - Field format validation ### 3. Maintainer Review Once validation passes, maintainers can: - `/approve` - Triggers PR creation - `/request-changes [reason]` - Asks for modifications - `/reject [reason]` - Closes the submission **Notification System:** - When changes are requested, the maintainer is @-mentioned in the comment - When the user edits their issue, the maintainer receives a notification if: - It's the first edit after requesting changes - The validation status changes (pass→fail or fail→pass) - Multiple rapid edits won't spam the maintainer with notifications ### 4. Automated PR Creation Upon approval: ```bash 1. Checkout fresh main branch 2. Create unique branch: add-resource/category/name-timestamp 3. Add resource to CSV with generated ID 4. Run generate_readme.py 5. Commit changes 6. Push branch 7. Create PR via GitHub CLI 8. Link back to original issue 9. Close submission issue ``` ### 5. Final Steps - Maintainer merges PR - Badge notification system runs (if enabled) - Submitter receives GitHub notifications ## Resource ID Generation IDs follow the format: `{prefix}-{hash}` ```python prefixes = { "Agent Skills": "skill", "Slash-Commands": "cmd", "Workflows & Knowledge Guides": "wf", "Tooling": "tool", "CLAUDE.md Files": "claude", "Hooks": "hook", "Official Documentation": "doc", } # Hash is first 8 chars of SHA256(display_name + primary_link) ``` ### Collapsible Sections The generated README uses HTML `
` elements for improved navigation: - **Categories without subcategories**: Wrapped in `
` (fully collapsible) - **Categories with subcategories**: Regular headers (subcategories are collapsible) - **All subcategories**: Wrapped in `
` elements - **Table of Contents**: Collapsible with nested sections for categories with subcategories - All collapsible sections are open by default for easy browsing **Design Note**: Initially attempted to make all categories collapsible with nested subcategories, but this caused anchor link navigation issues - links from the Table of Contents couldn't reach subcategories when their parent category was collapsed. The current design balances navigation functionality with collapsibility. ### GitHub Stats Integration Each GitHub resource in the README automatically includes a collapsible statistics section: - **Automatic Detection**: The `parse_github_url` function from `validate_links.py` identifies GitHub repositories - **Stats Display**: Uses the GitHub Stats API to generate an SVG badge with repository metrics - **Collapsible Design**: Stats are hidden by default in a `
` element to keep the main list clean - **Universal Support**: Works with all GitHub URL formats (repository root, blob URLs, tree URLs, etc.) Example output for a GitHub resource: ```markdown [`resource-name`](https://github.com/owner/repo) Description of the resource
📊 GitHub Stats
![GitHub Stats for repo](https://github-readme-stats-plus-theta.vercel.app/api/pin/?repo=repo&username=owner&all_stats=true&stats_only=true)
``` ## Alternative README Views The repository offers multiple README styles to suit different preferences, all generated from the same CSV source of truth. ### Style Options Users can switch between four presentation styles via navigation badges at the top of each page: | Style | Description | Location | |-------|-------------|----------| | **Extra** | Visual/themed with SVG assets, collapsible sections, GitHub stats | `README_ALTERNATIVES/README_EXTRA.md` (and `README.md` when `root_style: extra`) | | **Classic** | Clean markdown, minimal styling, traditional awesome-list format | `README_ALTERNATIVES/README_CLASSIC.md` (and `README.md` when `root_style: classic`) | | **Awesome** | Clean awesome-list style with minimal embellishment | `README_ALTERNATIVES/README_AWESOME.md` (and `README.md` when `root_style: awesome`) | | **Flat** | Sortable/filterable table view with category filters | `README_ALTERNATIVES/README_FLAT_*.md` (and `README.md` when `root_style: flat`) | ### File Structure Alternative views are in the `README_ALTERNATIVES/` folder to keep the root clean: ``` README.md # Root README (root_style) README_ALTERNATIVES/ ├── README_EXTRA.md # Extra visual view ├── README_CLASSIC.md # Classic markdown view ├── README_AWESOME.md # Awesome list view ├── README_FLAT_ALL_AZ.md # Flat: All resources, A-Z ├── README_FLAT_ALL_UPDATED.md # Flat: All resources, by updated ├── README_FLAT_ALL_CREATED.md # Flat: All resources, by created ├── README_FLAT_ALL_RELEASES.md # Flat: All resources, recent releases ├── README_FLAT_TOOLING_AZ.md # Flat: Tooling only, A-Z ├── README_FLAT_HOOKS_UPDATED.md # Flat: Hooks only, by updated └── ... (44 flat views total: 11 categories × 4 sort types) ``` ### Flat List System The flat view provides a searchable table with dual navigation: #### Sort Options - **A-Z** - Alphabetical by resource name - **Updated** - By last modified date (most recent first) - **Created** - By repository creation date (newest first) - **Releases** - Resources with releases in past 30 days #### Category Filters - **All** - All 164+ resources - **Tooling**, **Commands**, **CLAUDE.md**, **Workflows**, **Hooks**, **Skills**, **Styles**, **Status**, **Docs**, **Clients** #### Table Format Resources are displayed with stacked name/author format to maximize description space: ```markdown | Resource | Category | Sub-Category | Description | |----------|----------|--------------|-------------| | [**Resource Name**](link)
by [Author](link) | Category | Sub-Cat | Full description... | ``` ### Release Detection The "Releases" sort option shows resources with published releases in the past 30 days. Release information is fetched from GitHub Releases only. ### Generator Architecture The `generate_readme.py` script uses generator classes under `scripts/readme/generators/`: ```python ReadmeGenerator (ABC) ├── VisualReadmeGenerator # README_ALTERNATIVES/README_EXTRA.md ├── MinimalReadmeGenerator # README_ALTERNATIVES/README_CLASSIC.md ├── AwesomeReadmeGenerator # README_ALTERNATIVES/README_AWESOME.md └── ParameterizedFlatListGenerator # README_ALTERNATIVES/README_FLAT_*.md ``` The `ParameterizedFlatListGenerator` takes `category_slug` and `sort_type` parameters, enabling generation of all 44 combinations from a single class. The configured `root_style` is additionally generated as `README.md`. ### Navigation Badges SVG badges are generated dynamically in `assets/`: - `badge-style-*.svg` - Style selector (Extra, Classic, Awesome, Flat) - `badge-sort-*.svg` - Sort options (A-Z, Updated, Created, Releases) - `badge-cat-*.svg` - Category filters (All, Tooling, Hooks, etc.) Current selections are highlighted with colored borders matching each badge's theme color. ### Adding/Removing Flat List Categories To add a new category filter to flat list views: 1. **Update `FLAT_CATEGORIES`** in `scripts/readme/generators/flat.py`: ```python FLAT_CATEGORIES = { # ... existing categories ... "new-category": ("CSV Category Value", "Display Name", "#hexcolor"), } ``` - First value: Exact match for the `Category` column in CSV (or `None` for "all") - Second value: Display name shown on badge - Third value: Hex color for badge accent and selection border 2. **Regenerate READMEs**: Run `python scripts/readme/generate_readme.py` - Creates new files: `README_ALTERNATIVES/README_FLAT_NEWCATEGORY_*.md` - Generates badge: `assets/badge-cat-new-category.svg` - Updates navigation in all 44+ flat views To remove a category: Delete its entry from `FLAT_CATEGORIES` and run the generator. Manually delete the orphaned `.md` files from `README_ALTERNATIVES/`. ### Adding/Removing Sort Types To add a new sort option: 1. **Update `FLAT_SORT_TYPES`** in `scripts/readme/generators/flat.py`: ```python FLAT_SORT_TYPES = { # ... existing sorts ... "newsort": ("DISPLAY", "#hexcolor", "description for status text"), } ``` 2. **Implement sorting logic** in `ParameterizedFlatListGenerator.sort_resources()`: ```python elif self.sort_type == "newsort": # Custom sorting logic return sorted(resources, key=lambda x: ...) ``` 3. **Regenerate READMEs**: Creates new views for all categories × new sort type. ### Adding/Removing README Styles The main README styles are defined as generator classes: | Style | Generator Class | Template | Output | |-------|----------------|----------|--------| | Extra | `VisualReadmeGenerator` | `README_EXTRA.template.md` | `README_ALTERNATIVES/README_EXTRA.md` | | Classic | `MinimalReadmeGenerator` | `README_CLASSIC.template.md` | `README_ALTERNATIVES/README_CLASSIC.md` | | Awesome | `AwesomeReadmeGenerator` | `README_AWESOME.template.md` | `README_ALTERNATIVES/README_AWESOME.md` | | Flat | `ParameterizedFlatListGenerator` | (built-in) | `README_ALTERNATIVES/README_FLAT_*.md` | The configured `root_style` is additionally written to `README.md`. **To add a new README style:** 1. **Create a generator class** extending `ReadmeGenerator` under `scripts/readme/generators/`: ```python class NewStyleReadmeGenerator(ReadmeGenerator): @property def template_filename(self) -> str: return "README_NEWSTYLE.template.md" @property def output_filename(self) -> str: return "README_ALTERNATIVES/README_NEWSTYLE.md" # Implement abstract methods... ``` 2. **Create template** in `templates/README_NEWSTYLE.template.md` (include `{{STYLE_SELECTOR}}`). 3. **Register the generator** in `STYLE_GENERATORS` inside `scripts/readme/generate_readme.py`. 4. **Create style badge** `assets/badge-style-newstyle.svg`. 5. **Update config** in `acc-config.yaml`: - add a new entry under `styles:` - append the style ID to `style_order:` **To remove a style:** Delete the generator class, template, badge asset, and config entry, then remove the style from `STYLE_GENERATORS` and `style_order`. ### Announcements System Announcements are stored in `templates/announcements.yaml`: - YAML format for structured data - Renders as nested collapsible sections - Each date group is collapsible - Individual items can be simple text or collapsible with summary/text - Falls back to `.md` file if YAML doesn't exist ================================================ FILE: docs/README-GENERATION.md ================================================ # README Generation & Asset Management This document explains how the README and its visual assets are generated and maintained. It's mostly a reference document for development purposes, written and maintained by the coding agents who write most of the code, with some commentary sprinkled in. ## Overview The repository implements a "multi-list" pattern, with one centralized "list" (which is effectively a kind of backend) and numerous "views" that are strictly generated from the central data source. In that sense, it's maybe the only "full-stack" Awesome list on GitHub - maybe that's a sign that it's a silly thing to do, but I figured if I was going to spend so much time maintaining a list, I had better do something interesting with it. To my knowledge, it's one of the few "full-stack applications" that's entirely hosted on GitHub.com (i.e. not a GitHub Pages site). (Yes, there are others. And yes, calling this an "application" is obviously a little bit of a stretch.) - **`THE_RESOURCES_TABLE.csv`** - The master data file containing all resources (repo root) - **`acc-config.yaml`** - Global configuration (root style, style selector settings) - **`templates/categories.yaml`** - Category and subcategory definitions - **`scripts/readme/generate_readme.py`** - The generator script (class-based architecture) - **`scripts/readme/helpers/readme_config.py`** - Config loader and style path helpers - **`scripts/readme/helpers/readme_utils.py`** - Shared parsing/anchor utilities - **`scripts/readme/helpers/readme_assets.py`** - SVG asset writers (badges, TOC rows, headers) - **`scripts/readme/markup/`** - Markdown/HTML renderers by style - **`scripts/readme/svg_templates/`** - SVG renderers used by the generator - **`assets/`** - SVG visual assets (badges, headers, dividers, etc.) The multi-list is maintained via a single source of truth, combined with generators that take templates (which implement the various styles), and generate all the READMEs. The complexity is mostly self-inflicted, and is an artefact of platform-specific features of GitHub. ### Generated README Styles | Style | Primary Output | Template | Description | |-------|-------------|----------|-------------| | Extra (Visual) | `README_ALTERNATIVES/README_EXTRA.md` | `README_EXTRA.template.md` | Full visual theme with SVG badges, CRT-style TOC | | Classic | `README_ALTERNATIVES/README_CLASSIC.md` | `README_CLASSIC.template.md` | Plain markdown with collapsible sections | | Awesome | `README_ALTERNATIVES/README_AWESOME.md` | `README_AWESOME.template.md` | Clean awesome-list style | | Flat | `README_ALTERNATIVES/README_FLAT_*.md` | Built-in template (optional `templates/README_FLAT.template.md`) | 44 table views (category × sort combinations) | All styles are always generated under `README_ALTERNATIVES/`. The `root_style` is additionally written to `README.md`. #### Etymology - **Classic:** The style of the list as it was initially maintained and iterated upon, before the "multi-list" pattern was adopted. - ***Extra:*** Heightened visual style, consisting almost entirely of SVG assets - "extra" does not mean "additional", it means _extra_. - **Flat:** Lacks internal structure or visual hierarchy; the "flat" views are basically just a dump of the CSV data with shields.io badges - information-dense and straightforward. This was implemented due to a single user's request, but it became a more interesting problem when the user asked for dynamic table features like sorting and filtering. This is "not possible" with Markdown, which is why I decided to do it - since you can't have any JavaScript on a README, the sorting and filtering functionality is simulated by generating every permutation of Sort x Filter as a separate file, and so the table operations become navigation. - **Awesome:** The style that is more or less compliant with the Awesome List style guide. Generation runs in two phases: 1. Generate all styles under `README_ALTERNATIVES/`. 2. Generate `README.md` using the configured `root_style`. If everything lived at the repo root, this would be a very easy thing to build, but then the user would have to scroll a lot before they even hit the first `h1`. So the whole complexity is due to the necessity of supporting multiple generated README files at two different paths. I'm not even sure if many people enjoy the "Flat" view, and without the 44 permutations, it probably wouldn't be a big deal at all to just put everything at the root... Hm. Nevertheless, I'm grateful to that user for giving me the opportunity to learn some new things, and to build this ridiculous Titanic just to host a list, and I hope the "curiosity" of it compensates for any aesthetic crimes that I've committed in building it. ## Configuration (`acc-config.yaml`) The `acc-config.yaml` file at the repository root controls global README generation settings. ### Root Style The `readme.root_style` setting determines which README style is additionally written to the repo root (`README.md`). All styles are always generated in `README_ALTERNATIVES/`. ```yaml readme: root_style: extra # Options: extra, classic, awesome, flat ``` Changing this value and regenerating will: - Write the new root style to `README.md` - Keep all styles (including the root) in `README_ALTERNATIVES/` - Update the style selector links to reflect which style is root ### Style Selector Configuration The `styles` section defines each README style's metadata for the style selector: ```yaml styles: extra: name: Extra # Display name for badge alt text badge: badge-style-extra.svg # Badge filename in assets/ highlight_color: "#6a6a8a" # Border color when selected filename: README_EXTRA.md classic: name: Classic badge: badge-style-classic.svg highlight_color: "#c9a227" filename: README_CLASSIC.md # ... other styles ``` `filename` is the README variant filename under `README_ALTERNATIVES/` used for selector links and references. The `style_order` list controls the left-to-right order of badges in the selector: ```yaml style_order: - extra - classic - flat - awesome ``` ## Quick Reference | Task | Automated? | What to do | |------|------------|------------| | Add a new resource | Yes | Add row to CSV, run `make generate` | | Add a new category | Yes | Use `make add-category` or edit `categories.yaml` | | Add a new subcategory | Yes | Edit `categories.yaml`, run `make generate-toc-assets`, run generator | | Update resource info | Yes | Edit CSV, run `make generate` | | Customize asset style | Manual | Edit generator templates or asset files | ## Backups (README Outputs) The README generators create a backup of the existing output file before overwriting it. - Location: `.myob/backups/` at repo root - Naming: `{basename}.{YYYYMMDD_HHMMSS}.bak` (e.g., `README.md.20250105_154233.bak`) - Behavior: only created when the target file already exists - Coverage: applies to README outputs written by `scripts/readme/generate_readme.py` - Retention: keeps the most recent backup per output file; older backups are pruned ## Adding a New Resource This process is now handled entirely by GitHub workflows. Due to the intricate, not-at-all-over-engineered design ~~mistakes~~ choices, having people submit PRs became unmanageable. Instead, all of the data that goes into a resource entry is processed as a "form" using GitHub's Issue form templates. That makes the shape of an Issue predictable, and the different fields are machine-readable. Since the resources table is the single source of truth for the list entries, the goal is just to get the necessary data points into the CSV, and everything else is controlled by the template/generator system. This eliminated any problems around merge conflicts, stale resource PRs, etc. (Trying to fix merge conflicts in a CSV file is not a good way to spend an afternoon.) The _state_ of resource recommendation Issues is managed by (i) labels (`pending-validation`, `validation-passed`, `approved`, etc.), which indicate the current state; (ii) "slash commands" (`/approve`, `/request-changes`, etc.), which trigger a workflow that transitions the state (if they're written by the maintainer). This is a simplified piecture of what the GitHub bot does once a resource is approved: 1. **Edit `THE_RESOURCES_TABLE.csv`** - Add a new row with these columns: - `Display Name` - The resource name shown in the README - `Primary Link` - URL to the resource (usually GitHub) - `Author Name` - Creator's name (optional but recommended) - `Author Link` - URL to author's profile - `Description` - Brief description of the resource - `Category` - Must match a category name in `categories.yaml` - `Sub-Category` - Must match a subcategory in `categories.yaml` - `Active` - Set to `TRUE` to include in README - `Removed From Origin` - Set to `TRUE` if the original repo/resource was deleted The reason for the last field is due to the fact that (i) well, it's good to know if you're sharing a link that's dead; (ii) for a while, I was maintaing copies of the third-party authors' resources on the list (when it was licensed in a way that allowed me to do that), but that was when the resource were usually a bit of plaintext. Most entries are full repositories, and re-hosting entire repositories is out of scope. That directory is still present, but it's not currently maintained, and may become deprecated. 2. **Run the generator:** ```bash make generate # or directly: python3 scripts/readme/generate_readme.py ``` 3. **What gets auto-generated:** - `assets/badge-{resource-name}.svg` - Theme-adaptive badge with initials box - Entry in all README styles ## Adding a New Category 1. **Use the interactive tool:** ```bash make add-category # or with arguments: make add-category ARGS='--name "My Category" --prefix mycat --icon "🎯"' ``` Note: `make add-category` uses `scripts/categories/add_category.py` (experimental). It rewrites `templates/categories.yaml` via PyYAML and updates `.github/ISSUE_TEMPLATE/recommend-resource.yml`, so review the diff after running it. 2. **Or manually edit `templates/categories.yaml`:** ```yaml categories: - id: my-category name: My Category icon: "🎯" description: Description of this category order: 10 subcategories: - id: general name: General ``` 3. **Run the generator:** ```bash make generate ``` 4. **What gets auto-generated:** - `assets/header_{category}.svg` - Dark mode category header (CRT style) - `assets/header_{category}-light-v3.svg` - Light mode category header - `assets/subheader_{subcat}.svg` - Subcategory header (when resources exist) - Section in all README styles 5. **Regenerate subcategory TOC SVGs** (if subcategories were added): ```bash make generate-toc-assets ``` This creates/updates `assets/toc-sub-{subcat}.svg` and `assets/toc-sub-{subcat}-light-anim-scanline.svg` files for all subcategories. 6. **What needs manual creation:** - `assets/toc-row-{category}.svg` and `assets/toc-row-{category}-light-anim-scanline.svg` - TOC row assets (category-level) - Card assets if using the EXTRA style navigation grid ## Adding a New Subcategory Subcategories can be added to any category. 1. **Edit `templates/categories.yaml`:** ```yaml categories: - id: tooling name: Tooling subcategories: - id: general name: General - id: my-new-subcat # Add new subcategory name: My New Subcat ``` 2. **Regenerate subcategory TOC SVGs:** ```bash make generate-toc-assets ``` This creates/updates the `toc-sub-*.svg` and `toc-sub-*-light-anim-scanline.svg` files in `assets/` for all subcategories. 3. **Run the generator** - Subcategory headers are auto-generated alongside the README content ## If You Change Category IDs or Names Update these locations: 1. `templates/categories.yaml` - Category definitions 2. Card-grid anchors in `templates/README_EXTRA.template.md` (they use trailing `-` anchors) 3. Any static assets that embed text (for example, card SVGs) ## Adding a New README Style 1. Create a template file in `templates/` (for example, `README_NEWSTYLE.template.md`) 2. Add a generator class extending `ReadmeGenerator` under `scripts/readme/generators/` 3. Register the class in `STYLE_GENERATORS` in `scripts/readme/generate_readme.py` 4. Create a style selector badge in `assets/badge-style-newstyle.svg` 5. Add the style to `acc-config.yaml`: - Add an entry under `styles:` with name, badge, highlight_color, filename - Add the style ID to `style_order:` 6. Ensure your template includes `{{STYLE_SELECTOR}}` ## Generator Architecture The generator uses a class-based architecture with the Template Method pattern. Generator classes live under `scripts/readme/generators/` and are wired in `scripts/readme/generate_readme.py`: ``` ReadmeGenerator (ABC) ├── VisualReadmeGenerator → README_ALTERNATIVES/README_EXTRA.md ├── MinimalReadmeGenerator → README_ALTERNATIVES/README_CLASSIC.md ├── AwesomeReadmeGenerator → README_ALTERNATIVES/README_AWESOME.md └── ParameterizedFlatListGenerator → README_ALTERNATIVES/README_FLAT_*.md (44 files) The `root_style` also gets an additional copy written to `README.md`. ``` ### Category Management Categories can be managed via `scripts/categories/category_utils.py` (experimental): ```python from scripts.categories.category_utils import category_manager # Get all categories categories = category_manager.get_categories_for_readme() # Get category by name cat = category_manager.get_category_by_name("Tooling") ``` ### Template Placeholders Templates use `{{PLACEHOLDER}}` syntax for dynamic content. Key placeholders: | Placeholder | Description | Generator Method | |-------------|-------------|------------------| | `{{ASSET_PATH('file.svg')}}` | Tokenized asset path resolved per output location | `resolve_asset_tokens()` | | `{{STYLE_SELECTOR}}` | "Pick Your Style" badge row linking to all README variants | `get_style_selector()` | | `{{REPO_TICKER}}` | Animated SVG ticker showing featured projects | `generate_repo_ticker()` | | `{{ANNOUNCEMENTS}}` | Latest announcements from `templates/announcements.yaml` | `load_announcements()` | | `{{WEEKLY_SECTION}}` | Latest additions section | `generate_weekly_section()` | | `{{TABLE_OF_CONTENTS}}` | Table of contents | `generate_toc()` | | `{{BODY_SECTIONS}}` | Main resource listings | `generate_section_content()` | | `{{FOOTER}}` | Footer template content | `load_footer()` | Template content outside these placeholders is treated as manual copy and is not regenerated. Asset references use token placeholders (e.g. `{{ASSET_PATH('logo.svg')}}`) that are resolved after templating based on the destination README path. Resolution walks upward to the repo root (`pyproject.toml`) and computes a relative path to `/assets` for each output file. Generated outputs are prefixed with `` as a reminder that edits belong in templates and source data. ## Repo Ticker System The repo ticker displays an animated scrolling banner of featured Claude Code projects with live GitHub stats. ### Components | File | Purpose | |------|---------| | `scripts/ticker/fetch_repo_ticker_data.py` | Fetches GitHub stats for tracked repos | | `scripts/ticker/generate_ticker_svg.py` | Generates animated SVG tickers | | `data/repo-ticker.csv` | Current repo stats (stars, forks, deltas) | | `data/repo-ticker-previous.csv` | Previous stats for delta calculation | ### Generated Tickers | Theme | Output File | Used By | |-------|-------------|---------| | Dark (CRT) | `assets/repo-ticker.svg` | Extra style (dark mode) | | Light (Vintage) | `assets/repo-ticker-light.svg` | Extra style (light mode) | | Awesome | `assets/repo-ticker-awesome.svg` | Awesome style | ### Ticker Generation ```bash # Fetch latest repo stats (requires GITHUB_TOKEN) python scripts/ticker/fetch_repo_ticker_data.py # Generate ticker SVGs from current data python scripts/ticker/generate_ticker_svg.py ``` The tickers: - Sample 10 random repos from the CSV - Display repo name, owner, stars, and daily delta - Animate with seamless horizontal scrolling - Use theme-appropriate styling (CRT glow for dark, muted colors for awesome) ## Asset Types ### Auto-Generated Assets | Asset | Filename Pattern | Generator Function | |-------|------------------|-------------------| | Resource badges | `badge-{name}.svg` | `scripts/readme/svg_templates/badges.py:generate_resource_badge_svg()` | | Entry separators | `entry-separator-light-animated.svg` | `scripts/readme/svg_templates/dividers.py:generate_entry_separator_svg()` | | Category headers (dark/light) | `header_{cat}.svg`, `header_{cat}-light-v3.svg` | `scripts/readme/helpers/readme_assets.py:ensure_category_header_exists()` | | Subcategory headers | `subheader_{subcat}.svg` | `scripts/readme/helpers/readme_assets.py:create_h3_svg_file()` | | Section dividers (light) | `section-divider-light-manual-v{1,2,3}.svg` | `scripts/readme/svg_templates/dividers.py:generate_section_divider_light_svg()` | | Desc boxes (light) | `desc-box-{top,bottom}-light.svg` | `scripts/readme/svg_templates/dividers.py:generate_desc_box_light_svg()` | | Sort badges | `badge-sort-{type}.svg` | `scripts/readme/helpers/readme_assets.py:generate_flat_badges()` | | Category filter badges | `badge-cat-{slug}.svg` | `scripts/readme/helpers/readme_assets.py:generate_flat_badges()` | | Repo tickers | `repo-ticker*.svg` | `generate_ticker_svg()` / `generate_awesome_ticker_svg()` | | Subcategory TOC rows | `toc-sub-{subcat}.svg`, `toc-sub-{subcat}-light-anim-scanline.svg` | `scripts/readme/helpers/readme_assets.py:regenerate_sub_toc_svgs()` via `make generate-toc-assets` | | Style selector badges | `badge-style-{style}.svg` | Manual | ### Pre-Made Assets (Manual) | Asset | Purpose | |-------|---------| | `section-divider-alt2.svg` | Dark mode section divider | | `desc-box-{top,bottom}.svg` | Dark mode description boxes | | `toc-row-*.svg` | Category-level TOC row assets (light variants use `-light-anim-scanline`) | | `toc-header*.svg` | TOC header assets (light variants use `-light-anim-scanline`) | | `card-*.svg` | Terminal Navigation grid cards | | `badge-style-*.svg` | Style selector badges | | Hero banners, logos | Top-of-README branding | ## Visual Styles ### Light Mode: "Vintage Technical Manual" - Muted brown/sepia tones (`#5c5247`, `#3d3530`) - Coral accent (`#c96442`) - "Layered drafts" effect - doubled lines, ghost shadows - L-shaped corner brackets - Tick marks and circle clusters ### Dark Mode: "CRT Terminal" - Green phosphor colors (`#33ff33`, `#66ff66`) - Scanline overlay effect - Subtle glow filter - Monospace fonts - Animated flicker effects ## Generator Functions Key SVG renderers in `scripts/readme/svg_templates/`: ```python # Badge for each resource entry generate_resource_badge_svg(display_name, author_name) # Category section header generate_category_header_light_svg(title, section_number) # Horizontal dividers between sections generate_section_divider_light_svg(variant) # 1, 2, or 3 # Description box frames generate_desc_box_light_svg(position) # "top" or "bottom" # TOC directory listing rows generate_toc_row_svg(directory_name, description) generate_toc_row_light_svg(directory_name, description) generate_toc_sub_svg(directory_name, description) ``` Key markup helpers in `scripts/readme/markup/`: ```python # Style selector (dynamically generated) generate_style_selector(current_style, output_path, repo_root=None) ``` Key asset writers in `scripts/readme/helpers/readme_assets.py`: ```python # Flat list badges (writes SVGs using scripts/readme/svg_templates/badges.py) generate_flat_badges(assets_dir, sort_types, categories) # Regenerate subcategory TOC SVGs for the Visual (Extra) style regenerate_sub_toc_svgs(categories, assets_dir) ``` Standalone TOC asset script (`scripts/readme/helpers/generate_toc_assets.py`): ```bash # Regenerate subcategory TOC SVGs from categories.yaml make generate-toc-assets # or directly: python -m scripts.readme.helpers.generate_toc_assets ``` Key functions in `scripts/ticker/generate_ticker_svg.py`: ```python # Standard ticker (dark/light themes) generate_ticker_svg(repos, theme="dark") # or "light" # Awesome-style ticker (clean, minimal) generate_awesome_ticker_svg(repos) ``` ## Animated Elements ### Entry Separator (`entry-separator-light-animated.svg`) - Pulsating dots that ripple outward then contract back in - 3 core dots always visible - 9 rings of dots animate with staggered timing - 2.5 second cycle ### TOC Rows - Subtle opacity flicker on directory names - Hover highlight pulse animation ## File Structure This tree is auto-generated from `tools/readme_tree/config.yaml` (update with `make docs-tree`). ``` awesome-claude-code// ├── THE_RESOURCES_TABLE.csv # Master data file ├── acc-config.yaml # Root style + selector config ├── README.md # Generated root README (root_style) ├── README_ALTERNATIVES/ # All generated README variants │ ├── README_EXTRA.md # Generated (Extra style, always) │ ├── README_CLASSIC.md # Generated (Classic style) │ ├── README_AWESOME.md # Generated (Awesome list style) │ └── README_FLAT_*.md # Generated (44 flat list views) ├── templates/ # README templates and supporting YAML │ ├── categories.yaml # Category definitions │ ├── announcements.yaml # Announcements content │ ├── README_EXTRA.template.md # Extra style template │ ├── README_CLASSIC.template.md # Classic style template │ ├── README_AWESOME.template.md # Awesome style template │ ├── footer.template.md # Shared footer │ └── resource-overrides.yaml # Manual resource overrides ├── scripts/ │ ├── readme/ # README generation pipeline │ │ ├── generate_readme.py # Generator entrypoint │ │ ├── generators/ # README generator classes by style │ │ │ ├── base.py # ReadmeGenerator base + shared helpers │ │ │ ├── visual.py # Extra (visual) README generator │ │ │ ├── minimal.py # Classic README generator │ │ │ ├── awesome.py # Awesome list README generator │ │ │ └── flat.py # Flat list README generator │ │ ├── helpers/ # Config/utils/assets helpers for README generation │ │ │ ├── readme_assets.py │ │ │ ├── readme_config.py │ │ │ ├── readme_utils.py │ │ │ ├── generate_toc_assets.py │ │ │ └── readme_paths.py │ │ ├── markup/ # Markdown/HTML renderers by style │ │ │ ├── awesome.py │ │ │ ├── flat.py │ │ │ ├── minimal.py │ │ │ ├── shared.py │ │ │ └── visual.py │ │ └── svg_templates/ # SVG renderers used by the generator │ │ ├── badges.py │ │ ├── dividers.py │ │ ├── headers.py │ │ └── toc.py │ ├── ticker/ # Repo ticker generation scripts │ │ ├── generate_ticker_svg.py # Repo ticker SVG generator │ │ └── fetch_repo_ticker_data.py # GitHub stats fetcher │ ├── categories/ # Category management scripts │ │ ├── category_utils.py # Category management │ │ └── add_category.py # Category addition tool │ └── resources/ # Resource maintenance scripts │ ├── sort_resources.py # CSV sorting (used by generator) │ ├── resource_utils.py # CSV append + PR content helpers │ ├── create_resource_pr.py │ ├── detect_informal_submission.py │ ├── download_resources.py │ └── parse_issue_form.py ├── assets/ # SVG badges, headers, dividers │ ├── badge-*.svg # Resource badges (auto-generated) │ ├── header_*.svg # Category headers │ ├── section-divider-*.svg # Section dividers │ ├── desc-box-*.svg # Description boxes │ ├── toc-*.svg # TOC elements │ ├── subheader_*.svg # Subcategory headers │ ├── badge-sort-*.svg # Flat list sort badges │ ├── badge-cat-*.svg # Flat list category badges │ ├── badge-style-*.svg # Style selector badges │ ├── repo-ticker*.svg # Animated repo tickers │ └── entry-separator-*.svg # Entry separators ├── data/ # Generated ticker data │ ├── repo-ticker.csv # Current repository stats │ └── repo-ticker-previous.csv # Previous stats (for deltas) └── docs/ └── README-GENERATION.md # This file ``` ## Makefile Commands ```bash make generate # Generate all READMEs (sorts CSV first) make generate-toc-assets # Regenerate subcategory TOC SVGs (after adding subcategories) make add-category # Interactive category addition make sort # Sort resources in CSV make validate # Validate all resource links make docs-tree # Update README-GENERATION tree block ``` ## Environment Variables | Variable | Purpose | |----------|---------| | `GITHUB_TOKEN` | Avoid GitHub API rate limiting during validation | ## Troubleshooting ### Badge not appearing - Check the resource name doesn't have special characters that break filenames - Verify the CSV row has all required columns - Ensure `Active` is set to `TRUE` ### New category not showing - Ensure category is added to `templates/categories.yaml` - Check for typos between CSV Category column and categories.yaml name - Run `make generate` after changes ### Assets look wrong after regeneration - The `ensure_*_exists()` functions only create files if they don't exist - To regenerate an asset, delete it first then run the generator - Or edit the generator template and manually update existing files ### Dark mode assets missing - Dark mode dividers, TOC header, and card assets are manual - Use existing dark mode assets as templates ### README style not generating - Check that the template file exists in `templates/` - Verify the generator class is registered in `STYLE_GENERATORS` in `scripts/readme/generate_readme.py` ## Path Resolution System The generator uses a dynamic path resolution system to handle relative paths correctly across different README locations. This section documents the key assumptions and behaviors. ### Core Assumptions These assumptions are tested in `tests/test_style_selector_paths.py`: | Assumption | Description | |------------|-------------| | **Single root README** | Exactly one style is copied to `README.md` (the `root_style`) | | **Alternatives path is fixed** | `README_ALTERNATIVES/` is a fixed directory under the repo root | | **Assets at root** | The `assets/` folder is a direct child of the repo root | | **Repo root discovery** | Paths resolve from the repo root discovered by finding `pyproject.toml` | | **Flat entry point** | Flat style links to `README_FLAT_ALL_AZ.md` as its entry point | ### Path Prefix Rules | Location | Asset Prefix | Link to Root | Link to Alternatives | |----------|--------------|--------------|----------------------| | Root (`README.md`) | `assets/` | `./` | `README_ALTERNATIVES/file.md` | | Alternatives | `../assets/` | `../` | `file.md` (same folder) | ### Key Properties ```python # In ReadmeGenerator base class: is_root_style # True if this style matches config's root_style resolved_output_path # Default output path (under README_ALTERNATIVES/) alternative_output_path # Path under README_ALTERNATIVES/ for this style # Root generation uses generate(output_path="README.md") ``` ### How Root Style Changes Work When `acc-config.yaml` changes from `root_style: extra` to `root_style: awesome`: 1. **Awesome README** is also written to `README.md` - Asset paths use `assets/` - Links to other styles use `README_ALTERNATIVES/file.md` 2. **All alternatives remain in `README_ALTERNATIVES/`** - Asset paths remain `../assets/` - Style selector links update to reflect the new root ### Breaking Changes to Avoid These changes would break the path resolution system: - **Changing `README_ALTERNATIVES/` location**: Output paths and selector targets are hardcoded to `README_ALTERNATIVES/` - **Renaming `assets/` folder**: All asset path prefixes would break - **Having multiple root READMEs**: Only one style can be `root_style` - **Nested alternative folders**: All alternatives must be in the same flat folder ================================================ FILE: docs/REPO_TICKER.md ================================================ # Awesome Claude Code - "Repo Ticker" ## What is this thing? The repo displays an animated SVG, in the style of a "stock ticker", with the names of various Claude Code projects, their authors, and some stargazer data. You might be wondering - what is it? The ticker is populated by repositories that are returned as search results for the query `claude code`/`claude-code` by the GitHub REST API. Periodically, a repository workflow queries the API for 100 results to this query - it then takes a random sample of those results and generates the animation for the ticker. The animation can be thought of as a long-ish strip of SVG text that "scrolls" from right to left over the area of the ticker container. It also displays the star count for each repository, and a small "delta" showing its change from the previous day. The purpose of the ticker is: (i) to provide some exposure to projects that may or may not be on the list; (ii) to add some "fun" visual flair to the repo; (iii) markdown/SVG flex. (That's just a little joke - it was all Claude's idea to begin with.) You can inspect the aforementioned workflow/scripts yourself to verify what I just described - the ticker does not constitute any endorsement or advertisement of the projects that appear on it, which as I mentioned, are selected at random. If you see anything strange or malicious on the ticker, you may notify the maintainer. ## Technical Details The "infinite scroll" effect is produced by an SVG animation that changes the horizontal coordinates of the group of SVG elements that constitute the ticker's "tape"; and in order to create a seamless, continuous scroll effect, the first few entries on the tape (enough to cover the first frame of the animation) are repeated at the end of the list of entries: ``` ---------|-----------------------| A B C | D E F G H A B C| <<-- ---------|-----------------------| ---------|-----------------------| F G H | A B C | <<-- ---------|-----------------------| ---------|-----------------------| A B C | | LOOP ---------|-----------------------| ``` So, when the duplicate elements have traversed the width of the visible window, the animation resets to the beginning, and the loop starts over. I know that sounds kind of simple, but it's actually ridiculously clever. ### SVG Text Working with SVG text is very annnoying. First, it doesn't have any word-wrapping properties, so you have to estimate the width based on character count. Second, what looks good on one screen may be illegible on another. My initial design did not adequately account for the GitHub mobile app. The text had some glow filters and other stuff that looked kind of decent on a monitor, but is terrible on mobile. If you want the text to be legible on the GitHub mobile app, it must be crisp, sharp, and have pretty large font-size. You cannot use media-queries or anything like that (not supported by GitHub renderer). I recommend avoiding any sort of filter and keeping it pretty simple. In order to squeeze a little bit of additional headroom from the layout, I landed on this "two-level" design so that if the text overflowed, I didn't have to worry about it bleeding over into the next entry on the ticker. I've heard people say "If it bleeds, it leads", but I don't think they were talking about the text itself. More like - "if it bleeds, it's hard to read(s)"... Wow, good one, Claude. For more information about the tasteful artistic design of this repo, you may consult [HOW IT LOOKS](./HOW_IT_LOOKS.md). ================================================ FILE: docs/SECURITY.md ================================================ # Security Policy This repository does not export any executible software, and it is, at the end of the day, just a Markdown file with a lot of internal plumbing. No private information is collected or stored, except such as can be found on public GitHub repositories, or what is submitted by individual users when recommending a resource for inclusion on the list. For these reasons, the surface area of vulnerability for a security incident is rather limited, and is almost entirely limited to the credentials of the maintainer. That being said, if you do notice any security flaws, risks, or vulnerailities (even if they only potentially affect the maintainer), you are welcome and encouraged to open a private security advisory, which you can do so [here](https://github.com/hesreallyhim/awesome-claude-code/security/advisories/new). ## Security of Third-Party Resources Any security vulnerabilities or incidents relating to any of the third-party resources that are featured on Awesome Claude Code should first and foremost be reported according to the security policy of the respective third-party repository. However, in order to assist in ensuring the safety and security of the resources included here, you are strongly encouraged to _also_ report any such vulnerabilities to the maintainer of this repo. While it is outside of our capacity, or of our obligation, to enforce or investigate third-party security violations, we will take such reports seriously. We take the same approach to any (undisclosed) risks to users' privacy. ================================================ FILE: docs/TESTING.md ================================================ # Testing & Coverage This document covers how to run the test suite and generate coverage reports. ## Setup Install dev dependencies: ```bash make install ``` ## Running Tests Run all tests with pytest: ```bash make test ``` Note: Tests that exercise path resolution with temporary directories should create a minimal `pyproject.toml` in the temp repo root so repo-root discovery works as expected. ## Comprehensive Checks Run formatting checks, mypy, and pytest: ```bash make ci ``` Run type checks only: ```bash make mypy ``` ## Docs Tree Check Verify the README generation file tree is up to date: ```bash make docs-tree-check ``` Update the tree block: ```bash make docs-tree ``` ## Regeneration Cycle Run the full regeneration integration check (root style + selector order changes): ```bash make test-regenerate-cycle ``` This target runs `make test-regenerate` first, then exercises config changes using `make test-regenerate-allow-diff`, and finally restores the original config and reruns `make test-regenerate`. Note: This integration test requires a clean working tree and will rewrite `acc-config.yaml` during the run before restoring it. Note: If the local date changes during the run (near midnight), regenerated READMEs may update their date stamps and cause a diff; rerun when the clock is stable. ## Coverage Generate coverage reports (terminal + HTML + XML): ```bash make coverage ``` Outputs: - `htmlcov/` for the HTML report - `coverage.xml` for CI integrations - Terminal summary via `term-missing` Note: `scripts/archive/` is excluded from test discovery and coverage. ================================================ FILE: docs/development/cooldown-enforcement.md ================================================ # Cooldown Enforcement Automated rate-limiting for resource submissions. Applies to both issues and pull requests. ## How it works Every submission is checked against a state file (`cooldown-state.json`) stored in the private ops repo. The state tracks each user's cooldown level, active cooldown expiry, and ban status. **Violations** (each starts or extends a cooldown): | Violation | Trigger | |---|---| | Missing form label | Issue opened without using the submission template | | Repo too young | Linked repository is less than 7 days old | | Submitted as PR | Pull request classified as a resource submission by Claude | | Submitted during cooldown | Any submission while an active cooldown is in effect | **Escalation** — each violation doubles the cooldown period: | Level | Duration | |---|---| | 0 → 1 | 24 hours | | 1 → 2 | 48 hours | | 2 → 3 | 4 days | | 3 → 4 | 8 days | | 4 → 5 | 16 days | | 5 → 6 | 32 days | | 6 | Permanent ban | Submitting during an active cooldown is itself a violation — the cooldown extends and the level increments. Persistence is counterproductive. ## Maintainer controls - **`excused` label** — apply to any issue to bypass cooldown checks entirely. The workflow skips enforcement and proceeds directly to validation. - **Manual state edits** — the state file lives in the private repo file `cooldown-state.json`. You can edit it directly to reduce a user's level, clear their cooldown, or remove a ban. Each entry looks like: ```json { "username": { "active_until": "2026-02-24T12:00:00.000Z", "cooldown_level": 2, "last_violation": "2026-02-22T12:00:00.000Z", "last_reason": "repo-too-young" } } ``` To unban someone, delete their entry or set `banned: false` and `cooldown_level: 0`. ## PR classification Pull requests are classified by Claude (Haiku) as either `resource_submission` or `not_resource_submission` with a confidence level. Resource submissions are closed with a redirect to the issue template and trigger a cooldown violation. Non-resource PRs with low confidence get a `needs-review` label. API failures fail open — the PR stays untouched. ## Concurrency Runs are serialized per-user (concurrent submissions from the same user queue). Different users process in parallel. The ops repo file uses optimistic locking (SHA-based) — if two concurrent writes race, the loser's violation isn't recorded but will be caught on the next submission. ================================================ FILE: docs/development/do-not-forget.md ================================================ # Don't Forget Some important but easy-to-forget assumptions and gotchas that can cause headaches: - `python -m` uses dot notation (for example, `python -m scripts.resources.parse_issue_form`), not slash paths or `.py` suffixes. - `python -m` only works for modules with a CLI entrypoint (`if __name__ == "__main__":`). - GitHub Actions with sparse checkout must include `pyproject.toml` so `find_repo_root()` can locate the repo root. - If a workflow runs scripts that import `scripts.*`, either run from the repo root or set `PYTHONPATH` to the repo root. - Sparse checkout must include any data files the script reads (for example, `THE_RESOURCES_TABLE.csv`, `templates/`). - GitHub Actions using sparse checkout must include `pyproject.toml` so scripts can locate the repo root (via `find_repo_root()`). ================================================ FILE: docs/development/path-resolution-migration-plan.md ================================================ # Path Resolution Migration Plan This plan describes the concrete work needed to migrate README generation to the final path-resolution strategy (relative asset paths resolved per output file). ## Scope - Keep style-specific templates intact (extra/classic/awesome/flat). - Remove all path-specific assumptions from templates and markup. - Centralize asset path resolution in the generator. ## Plan 1. **Audit templates and markup** - Inventory all occurrences of `{{ASSET_PREFIX}}`, `{{ASSET_PATH(...)}}`, `assets/`, `../assets`, `/assets`. - Identify every generator/markup call site that injects or assumes a prefix. - Map all output locations (root README, README_ALTERNATIVES, .github, etc.). 2. **Introduce a single asset token scheme** - Choose one token format (e.g., `asset:foo.png` or `{{ASSET_PATH('foo.png')}}`). - Implement a resolver that: - finds `repo_root` via `pyproject.toml` - computes a relative path from the output file’s directory to `/assets` - replaces tokens with correct POSIX paths - Remove `ASSET_PREFIX` and `is_root_readme` assumptions from templates. 3. **Wire the resolver into generation** - Apply the resolver after template substitution but before writing files. - Update markup helpers to emit tokenized asset references instead of prefixes. - Ensure style selector and repo ticker resolve through the same mechanism. 4. **Add generated-file header** - Insert `` into all outputs. - Ensure templates or generator handle this consistently. 5. **Update tests and docs** - Add/adjust tests to validate asset paths for all output locations. - Ensure `test-regenerate` remains the canonical drift check. - Update docs to reflect the new token scheme and remove obsolete guidance. ## Completion Criteria - No templates or markup contain concrete asset prefixes. - Outputs render correctly in-place and on GitHub across all locations. - `make test-regenerate` passes with a clean working tree. ================================================ FILE: docs/development/path-resolution-strategy.final.md ================================================ # Strategy: Generated, Location-Correct Relative Asset Paths This repo treats all Markdown READMEs as generated artifacts. The generator is responsible for making every output Markdown file render correctly both (a) on GitHub when viewed in-place and (b) in local Markdown previews that expect standard relative paths. ## Goals - Any generated file like `/README.md`, `/foo/bar/README.md`, `/.github/README.md`, `README_ALTERNATIVES/*.md` renders correctly in its own directory. - Local preview works without special editor configuration. - GitHub rendering works without relying on repo-root /assets/... semantics. - “Swaps” never copy pre-generated Markdown between locations; they regenerate for the destination path. --- ## Rules ### Rule 1: Single source of truth for assets - Assets live only in: /assets/* - No duplicated asset directories are required for this strategy. ### Rule 2: Templates never contain concrete relative prefixes Templates must not hardcode ./assets, ../assets, /assets, etc. Instead, templates use one of: - a placeholder token: {{ASSET_PATH("foo.png")}} (single quotes are also supported) - or a canonical pseudo-URL: asset:foo.png Only the generator resolves these into real paths. ### Rule 3: Generator anchors on repo root The generator must discover repo_root deterministically by walking upward from the executing script (or from the template file) until it finds pyproject.toml. Definition: - repo_root is the directory containing pyproject.toml. ### Rule 4: Resolve assets relative to each output file For each output Markdown file at path out_md: - Let base_dir = out_md.parent - Let assets_dir = repo_root / "assets" - Compute rel_assets = relative_path(from=base_dir, to=assets_dir) using POSIX separators (/) for Markdown - Emit image references as: rel_assets + "/" Examples: - Output /README.md → assets/foo.png - Output /.github/README.md → ../assets/foo.png - Output /foo/bar/README.md → ../../assets/foo.png ### Rule 5: Swaps are selection + generation, never copying contents A “swap” means: - Choose a variant/source template (e.g. language/style) - Regenerate the destination file(s) in their final location(s) Never: - Copy or move pre-generated Markdown from one directory to another (paths will break). ### Rule 6: Generated files are not manually edited - Generated READMEs must carry a header comment like: ```markdown ``` - Manual edits go into the template/source inputs only. ### Rule 7: CI validates generation is up-to-date CI must: 1. run the generator 2. fail if the working tree changed Canonical check: - git diff --exit-code This ensures no drift between committed generated READMEs and what templates would produce. --- ## Operational Guidance ### Editing Files - Edit: templates + data inputs only - Do not edit: generated Markdown outputs - Assume: manual changes to Markdown files will be overridden by the generators ### Link checking Run link/image checks only on: - the generated Markdown outputs (post-generation) not on templates or source markdown fragments. --- ## Summary This strategy makes local preview easy by using standard relative paths, while keeping GitHub rendering correct everywhere. The generator is the only component allowed to decide how assets/ is referenced, and swaps are implemented exclusively as “regenerate for destination path,” not file copying. ================================================ FILE: docs/development/summary-rendering-cheatsheet.md ================================================ ## GitHub README collapsible subcategory cheat sheet Context: GitHub’s Markdown renderer wraps loose content in `

` tags and modifies markup inside `

`. These tweaks keep the caret aligned and prevent broken first items in collapsible sections. - Keep `` contents on one line with no leading/trailing whitespace; GitHub inserts `

` if it sees blank lines. - Wrap the SVG in a `` to stop the image from becoming a link target via camo wrapping. - Use `align="absmiddle"` on the `` to nudge the caret arrow to midline (works on GitHub). - Put the back-to-top link immediately after the picture inside the same ``; avoid extra spaces or newlines between them. - Add exactly one blank line after the `

` line so the first resource renders as Markdown, not as raw text. Minimal pattern that renders correctly on GitHub: ```html
Some Subcat🔝 [`Example`](https://example.com)   by   [Author](https://author.example)
``` Verification tip: use GitHub’s `/markdown` API with mode `gfm` to preview the rendered HTML without pushing commits. One request per variant is usually enough.*** ================================================ FILE: docs/development/tech-debt.md ================================================ Really Him: Claude, this file is empty Claude: You're absolutely right. ================================================ FILE: docs/development/toc-anchor-generation.md ================================================ # TOC Anchor Generation ## GitHub Anchor Generation Rules GitHub generates heading anchors by: 1. Lowercasing the heading text 2. Replacing spaces with `-` 3. Removing special characters 4. Stripping emojis (each emoji leaves a `-` in its place) 5. Appending `-N` suffix for duplicate anchors (where N = 1, 2, 3...) ## Style-Specific Heading Formats ### AWESOME Style ```markdown ## Agent Skills 🤖 ### General ``` - Category anchor: `#agent-skills-` (one dash from emoji) - Subcategory anchor: `#general` (no trailing dash) ### CLASSIC Style ```markdown ## Agent Skills 🤖 [🔝](#awesome-claude-code)

General 🔝

``` - Category anchor: `#agent-skills--` (two dashes: one from 🤖, one from 🔝) - Subcategory anchor: `#general-` (one dash from 🔝) ### EXTRA/VISUAL Style Uses explicit `id` attributes on headings, controlling anchors directly. ## Duplicate "General" Subcategory Handling Multiple "General" subcategories across categories generate: - First: `#general` (AWESOME) or `#general-` (CLASSIC) - Second: `#general-1` (AWESOME) or `#general--1` (CLASSIC) - Third: `#general-2` (AWESOME) or `#general--2` (CLASSIC) Note: GitHub uses double-dash before the counter in CLASSIC due to the 🔝 emoji. ## Relevant Source Files | File | Purpose | |------|---------| | `scripts/readme/markup/awesome.py` | AWESOME style TOC generation | | `scripts/readme/markup/minimal.py` | CLASSIC style TOC generation | | `scripts/readme/markup/visual.py` | EXTRA style TOC generation | | `scripts/readme/helpers/readme_utils.py` | `get_anchor_suffix_for_icon()` helper | | `scripts/testing/validate_toc_anchors.py` | Validation utility | ## Validation ### Manual Validation ```bash # Validate root README (AWESOME style) make validate-toc # Validate CLASSIC style python3 -m scripts.testing.validate_toc_anchors \ --html .claude/readme-body-html-non-root-readme.html \ --readme README_ALTERNATIVES/README_CLASSIC.md ``` ### Obtaining GitHub HTML 1. Push README to GitHub 2. View rendered README page 3. Open browser dev tools (F12) 4. Find `
` element containing README content 5. Copy inner HTML to `.claude/root-readme-html-article-body.html` ### Automated Tests ```bash make test # Includes TOC anchor validation tests ``` ## Common Pitfalls 1. **Extra dash before suffix**: `#{anchor}-{suffix}` when `suffix` already contains `-` 2. **Missing back-to-top dash**: CLASSIC style headings include 🔝 which adds a dash 3. **Wrong General counter format**: CLASSIC uses `general--N`, AWESOME uses `general-N` ## HTML Fixture Storage GitHub-rendered HTML fixtures are stored in `tests/fixtures/github-html/` (version controlled). Fixture filenames indicate root vs non-root placement to detect potential rendering differences: | Style | README Path | HTML Fixture | Placement | |-------|-------------|--------------|-----------| | AWESOME | `README.md` | `awesome-root.html` | Root | | CLASSIC | `README_ALTERNATIVES/README_CLASSIC.md` | `classic-non-root.html` | Non-root | | EXTRA | `README_ALTERNATIVES/README_EXTRA.md` | `extra-non-root.html` | Non-root | | FLAT | `README_ALTERNATIVES/README_FLAT_ALL_AZ.md` | `flat-non-root.html` | Non-root | Validation commands: ```bash # AWESOME (default) python3 -m scripts.testing.validate_toc_anchors # Other styles python3 -m scripts.testing.validate_toc_anchors --style classic python3 -m scripts.testing.validate_toc_anchors --style extra python3 -m scripts.testing.validate_toc_anchors --style flat ``` ## Validation Status | Style | Status | Notes | |-------|--------|-------| | AWESOME | ✅ | Root README, 30 TOC anchors verified | | CLASSIC | ✅ | Different anchor format due to 🔝 in headings | | EXTRA | ✅ | Uses explicit `id` attributes; template anchor fixed | | FLAT | ✅ | No TOC anchors (flat list format) | ## Future Work - [ ] Unify anchor generation logic into shared helper with parameterized flags - [ ] Add CI job to validate TOC anchors on README changes --- ## Architectural Decision: Anchor Generation Unification **Date**: 2026-01-09 **Context**: TOC anchor generation logic is duplicated across three files (`awesome.py`, `minimal.py`, `visual.py`) with subtle differences due to each style's heading format. **Options Considered**: 1. **Parameterized flags** - Create shared helper with semantic flags like `has_back_to_top_in_heading` 2. **Unify to ID-based** - Migrate all styles to use explicit `

` like EXTRA **Decision**: Option 1 (parameterized flags) **Rationale**: - Lower risk: heading markup remains unchanged - AWESOME style intentionally uses clean markdown (`## Title`) for aesthetic reasons - ID-based approach would require CLASSIC to restructure its `[🔝](#...)` links - Parameterized flags are self-documenting and decouple anchor logic from style names **Proposed API**: ```python def generate_toc_anchor( title: str, icon: str | None = None, has_back_to_top_in_heading: bool = False, ) -> str: """Generate TOC anchor for a heading. Args: title: The heading text (e.g., "Agent Skills") icon: Optional trailing emoji icon (e.g., "🤖") has_back_to_top_in_heading: True if heading contains 🔝 back-to-top link """ ``` **Trade-off**: If a style changes its heading format (e.g., CLASSIC removes 🔝), only the flag value changes—not the shared logic. ================================================ FILE: docs/development/vintage-manual-animation-style-guide.md ================================================ # Vintage Manual Animation Style Guide A comprehensive guide to the animation effects developed for the light mode "vintage technical manual" theme. These animations are designed to evoke 70s-80s computer documentation, printing, and paper-based media while remaining subtle and professional. --- ## Table of Contents 1. [Design Principles](#design-principles) 2. [Color Palette](#color-palette) 3. [Typography](#typography) 4. [Animation Patterns](#animation-patterns) - [Typewriter Reveal](#1-typewriter-reveal) - [Print Scan](#2-print-scan) - [Stamp Press](#3-stamp-press) - [Registration Shift](#4-registration-shift) - [Line Printer](#5-line-printer) 5. [Parameterization Guide](#parameterization-guide) 6. [Implementation Examples](#implementation-examples) --- ## Design Principles 1. **Paper-like Motion**: Animations should feel physical - like ink, paper, and mechanical processes 2. **Warm Aesthetics**: Use sepia tones that suggest aged paper and vintage printing 3. **Purposeful Timing**: Each animation should have clear phases (anticipation, action, settle) 4. **Loopable**: Animations should loop seamlessly without jarring resets --- ## Color Palette ```css /* Primary Colors */ --ink-dark: #2d251f; /* Main text, darkest ink */ --ink-medium: #3d3530; /* Secondary text */ --ink-light: #5c5247; /* Tertiary, rules, borders */ --ink-faded: #6b5b4f; /* Subtle text, descriptions */ --ink-ghost: #7a6b5f; /* Very light text */ --ink-muted: #8a7b6f; /* Metadata, timestamps */ /* Accent Colors */ --accent-terracotta: #c96442; /* Section numbers, highlights */ --accent-warm: #9a8b7f; /* Warm gray accent */ /* Paper Colors */ --paper-light: #faf8f3; /* Lightest paper */ --paper-cream: #f5f0e6; /* Standard paper */ --paper-aged: #f2ede4; /* Slightly aged */ --paper-shadow: #e8e3d9; /* Paper shadow/fold */ /* Border Colors */ --border-light: #c4baa8; /* Light borders */ --border-medium: #b0a696; /* Medium borders */ /* Print Effects */ --greenbar: #4a7c4a; /* Green bar paper stripe */ --perf-hole: #d4cfc5; /* Perforation holes */ --cyan-offset: #6b8a8a; /* Registration cyan layer */ --magenta-offset: #8a6b6b; /* Registration magenta layer */ ``` --- ## Typography ```css /* Primary Heading - Serif */ font-family: Georgia, 'Times New Roman', serif; font-size: 38px; font-weight: 400; letter-spacing: 8px; /* Secondary Heading - Monospace */ font-family: 'Courier New', Courier, monospace; font-size: 12px; letter-spacing: 3px; /* Body/Tagline - Serif Italic */ font-family: Georgia, 'Times New Roman', serif; font-size: 13px; font-style: italic; /* Technical/Metadata - Monospace */ font-family: 'Courier New', Courier, monospace; font-size: 9px; ``` --- ## Animation Patterns ### 1. Typewriter Reveal **Concept**: Characters appear sequentially, mimicking a typewriter or teletype machine. **Timing**: 6 second cycle - Characters appear every 0.3s - Cursor follows and blinks - Subtitle/tagline fade in after title completes **Core Technique**: ```xml A W ``` **Parameters**: - `charDelay`: Time between each character (default: 0.3s) - `cursorBlinkRate`: Cursor blink speed (default: 0.5s) - `holdTime`: Time to display complete text before reset **Generator Function** (JavaScript): ```javascript function generateTypewriterText(text, x, y, options = {}) { const { charWidth = 24, charDelay = 0.3, cycleDuration = 6, fontSize = 36 } = options; const chars = text.split(''); const totalChars = chars.length; return chars.map((char, i) => { const charX = x + (i * charWidth); const appearTime = (i * charDelay) / cycleDuration; const values = Array(20).fill('1'); const appearIndex = Math.floor(appearTime * 20); for (let j = 0; j < appearIndex; j++) values[j] = '0'; return ` ${char} `; }).join('\n'); } ``` --- ### 2. Print Scan **Concept**: A glowing scan bar sweeps across, simulating a print head or scanner. **Timing**: 4 second cycle (continuous) **Core Technique**: ```xml ``` **Parameters**: - `scanDuration`: Time for full sweep (default: 4s) - `barWidth`: Width of scan bar (default: 100px) - `glowColor`: Scan bar color (default: #c96442) - `direction`: 'ltr' | 'rtl' | 'ttb' | 'btt' --- ### 3. Stamp Press **Concept**: Elements drop from above and "press" into the paper with a bounce and ink spread. **Timing**: 5 second cycle - Elements start offset above - Drop with slight overshoot - Bounce back to final position - Ink spread effect at moment of impact **Core Technique**: ```xml TITLE TEXT ``` **Parameters**: - `dropDistance`: How far above element starts (default: 15px) - `bounceAmount`: Overshoot distance (default: 3px) - `stampDelay`: Stagger between elements (default: 0.5s) - `inkSpreadRadius`: Maximum ink spread (default: 0.5) --- ### 4. Registration Shift **Concept**: Color layers start misaligned and shift into registration, like offset printing. **Timing**: 4 second cycle - Cyan and magenta layers offset by ~3px - Shift to aligned position - Hold aligned - Quick reset **Core Technique**: ```xml TITLE TEXT TITLE TEXT TITLE TEXT ``` **Parameters**: - `offsetDistance`: How far layers are misaligned (default: 3px) - `cyanOffset`: Direction of cyan layer (default: -3, 0) - `magentaOffset`: Direction of magenta layer (default: +3, 0) - `settleTime`: Time to reach alignment (default: 25% of cycle) --- ### 5. Line Printer **Concept**: Content reveals top-to-bottom like continuous form paper feeding through a printer. **Timing**: 8 second cycle (with pause) - Paper feeds down revealing content (2s) - Hold/pause (4s) - Rapid wipe up to reset (1s) - Brief blank (1s) **Core Technique**: ```xml ``` **Parameters**: - `revealSpeed`: Time to reveal content (default: 2s) - `holdTime`: Pause duration (default: 4s) - `wipeSpeed`: Time to wipe up (default: 1s) - `showGreenBar`: Boolean for green bar paper effect - `showPerforations`: Boolean for feed holes --- ## Parameterization Guide ### Creating a Generator Function ```javascript function generateVintageManualSVG(options) { const { width = 900, height = 180, title = 'TITLE', subtitle = 'Subtitle', tagline = 'Tagline text here', animation = 'lineprint', // typewriter|printscan|stamp|registration|lineprint colors = { ink: '#2d251f', accent: '#c96442', paper: '#faf8f3' }, timing = { cycleDuration: 8, revealDuration: 2, holdDuration: 4 } } = options; // Generate SVG based on animation type switch(animation) { case 'typewriter': return generateTypewriterSVG(options); case 'printscan': return generatePrintScanSVG(options); case 'stamp': return generateStampSVG(options); case 'registration': return generateRegistrationSVG(options); case 'lineprint': return generateLinePrintSVG(options); } } ``` ### CSS Custom Properties Approach ```css :root { --manual-cycle-duration: 8s; --manual-reveal-duration: 2s; --manual-hold-duration: 4s; --manual-ink-color: #2d251f; --manual-accent-color: #c96442; --manual-paper-color: #faf8f3; } ``` --- ## Implementation Examples ### React Component ```jsx const VintageHeader = ({ title, subtitle, animation = 'lineprint', cycleDuration = 8 }) => { return ( {/* SVG content with dynamic values */} ); }; ``` ### Web Component ```javascript class VintageManualHeader extends HTMLElement { static get observedAttributes() { return ['title', 'subtitle', 'animation', 'duration']; } connectedCallback() { this.render(); } render() { const animation = this.getAttribute('animation') || 'lineprint'; // Generate appropriate SVG } } customElements.define('vintage-header', VintageManualHeader); ``` --- ## File Reference | Animation | File | Cycle | Best For | |-----------|------|-------|----------| | Typewriter | `terminal-header-light-anim-typewriter.svg` | 6s | One-time reveals, loading states | | Print Scan | `terminal-header-light-anim-printscan.svg` | 4s | Continuous ambient animation | | Stamp Press | `terminal-header-light-anim-stamp.svg` | 5s | Dramatic entrances, hero sections | | Registration | `terminal-header-light-anim-registration.svg` | 4s | Subtle ambient animation | | Line Printer | `terminal-header-light-anim-lineprint.svg` | 8s | Headers, document-style layouts | --- *Style Guide Version 1.0 - Created for Awesome Claude Code* ================================================ FILE: pyproject.toml ================================================ [build-system] requires = ["setuptools>=61.0", "wheel"] build-backend = "setuptools.build_meta" [project] name = "awesome-claude-code" version = "2.0.1" description = "A curated list of slash-commands, CLAUDE.md files, CLI tools, and other resources for enhancing Claude Code workflows" authors = [{ name = "Really Him", email = "git-dev@hesreallyhim.com" }] readme = "README.md" license = { file = "LICENSE" } requires-python = ">=3.11" dependencies = ["PyGithub>=2.1.1", "PyYAML>=6.0.0"] classifiers = [ "Development Status :: 4 - Beta", "Intended Audience :: Developers", "License :: OSI Approved :: MIT License", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.11", "Programming Language :: Python :: 3.12", ] [project.optional-dependencies] dev = [ "pytest>=8.0.0", "requests>=2.31.0", "python-dotenv>=1.0.0", "types-requests>=2.31.0", "types-PyYAML>=6.0.0", "ruff>=0.1.0", "pre-commit>=3.5.0", "pytest-cov>=7.0.0", "mypy>=1.10.0", ] [project.urls] "Homepage" = "https://github.com/anthropics/awesome-claude-code" "Bug Tracker" = "https://github.com/anthropics/awesome-claude-code/issues" "Repository" = "https://github.com/anthropics/awesome-claude-code" [tool.ruff] target-version = "py311" line-length = 100 exclude = ["scripts/archive"] [tool.ruff.lint] select = [ "E", # pycodestyle errors "W", # pycodestyle warnings "F", # pyflakes "I", # isort "N", # pep8-naming "UP", # pyupgrade "B", # flake8-bugbear "C4", # flake8-comprehensions "SIM", # flake8-simplify ] ignore = [ "E203", # whitespace before ':' "E402", # module level import not at top of file ] [tool.ruff.lint.per-file-ignores] "__init__.py" = ["F401"] # unused imports in __init__ files "scripts/*" = ["E501"] # line too long in generate_ticker_svg.py [tool.ruff.lint.isort] known-first-party = ["scripts"] [tool.setuptools.packages.find] where = ["."] include = ["scripts*"] [tool.setuptools.package-data] "scripts" = ["*.csv"] [tool.coverage.run] branch = true source = ["scripts"] omit = ["scripts/archive/*", "scripts/testing/test_regenerate_cycle.py"] [tool.coverage.report] show_missing = true skip_covered = true [tool.pytest.ini_options] testpaths = ["tests"] norecursedirs = ["scripts/archive"] [tool.mypy] exclude = "^resources/" ================================================ FILE: resources/README.md ================================================ # Resources Historically, this was used to preserve copies of the resources included in the list, however the majority of resources now are libraries, plugins, projects, or other larger-scope artifacts, and so it is not as feasible to maintain this directory. Please note that it may become archived in the near future. ================================================ FILE: resources/claude.md-files/AI-IntelliJ-Plugin/CLAUDE.md ================================================ # AI Integration Plugin Development Guide ## Build Commands - `./gradlew build` - Build the entire project - `./gradlew test` - Run all tests - `./gradlew test --tests "com.didalgo.intellij.chatgpt.chat.metadata.UsageAggregatorTest"` - Run a specific test class - `./gradlew test --tests "*.StandardLanguageTest.testDetection"` - Run a specific test method - `./gradlew runIde` - Run the plugin in a development IDE instance - `./gradlew runPluginVerifier` - Verify plugin compatibility with different IDE versions - `./gradlew koverReport` - Generate code coverage report ## Code Style Guidelines - **Package Structure**: Use `com.didalgo.intellij.chatgpt` as base package - **Imports**: Organize imports alphabetically; no wildcards; static imports last - **Naming**: CamelCase for classes; camelCase for methods/variables; UPPER_SNAKE_CASE for constants - **Types**: Use annotations (`@NotNull`, `@Nullable`) consistently; prefer interface types in declarations - **Error Handling**: Use checked exceptions for recoverable errors; runtime exceptions for programming errors - **Documentation**: Javadoc for public APIs; comment complex logic; keep code self-explanatory - **Testing**: Write unit tests for all business logic; integration tests for UI components - **Architecture**: Follow IDEA plugin architecture patterns; use services for global state ## Coding Patterns - Use `ChatGptBundle` for internationalized strings - Leverage IntelliJ Platform APIs when possible instead of custom implementations - Use dependency injection via constructor parameters rather than service lookups ================================================ FILE: resources/claude.md-files/AVS-Vibe-Developer-Guide/CLAUDE.md ================================================ # CLAUDE.md This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository. ## Repository Structure - This is a prompt library for EigenLayer AVS (Actively Validated Services) development - Contains prompt templates for idea refinement, design generation, and prototype implementation - Test folder contains example AVS ideas and implementations ## Commands - No build/lint/test commands available as this is primarily a documentation repository - To validate prompts: test them manually against benchmark examples ## Code Style Guidelines - Markdown files should be well-structured with clear headings - Use consistent terminology related to EigenLayer concepts - Follow AVS development progression: idea → design → implementation - Keep prompts focused on one Operator Set at a time - Include sections for: project purpose, operator work, validation logic, and rewards ## Naming Conventions - Files should use kebab-case for naming - Stage-specific prompts are named: stage{n}-{purpose}-prompt.md - Benchmark examples should be placed in appropriately named subdirectories ================================================ FILE: resources/claude.md-files/AWS-MCP-Server/CLAUDE.md ================================================ # AWS MCP Server Development Guide ## Build & Test Commands ### Using uv (recommended) - Install dependencies: `uv pip install --system -e .` - Install dev dependencies: `uv pip install --system -e ".[dev]"` - Update lock file: `uv pip compile --system pyproject.toml -o uv.lock` - Install from lock file: `uv pip sync --system uv.lock` ### Using pip (alternative) - Install dependencies: `pip install -e .` - Install dev dependencies: `pip install -e ".[dev]"` ### Running the server - Run server: `python -m aws_mcp_server` - Run server with SSE transport: `AWS_MCP_TRANSPORT=sse python -m aws_mcp_server` - Run with MCP CLI: `mcp run src/aws_mcp_server/server.py` ### Testing and linting - Run tests: `pytest` - Run single test: `pytest tests/path/to/test_file.py::test_function_name -v` - Run tests with coverage: `python -m pytest --cov=src/aws_mcp_server tests/` - Run linter: `ruff check src/ tests/` - Format code: `ruff format src/ tests/` ## Technical Stack - **Python version**: Python 3.13+ - **Project config**: `pyproject.toml` for configuration and dependency management - **Environment**: Use virtual environment in `.venv` for dependency isolation - **Package management**: Use `uv` for faster, more reliable dependency management with lock file - **Dependencies**: Separate production and dev dependencies in `pyproject.toml` - **Version management**: Use `setuptools_scm` for automatic versioning from Git tags - **Linting**: `ruff` for style and error checking - **Type checking**: Use VS Code with Pylance for static type checking - **Project layout**: Organize code with `src/` layout ## Code Style Guidelines - **Formatting**: Black-compatible formatting via `ruff format` - **Imports**: Sort imports with `ruff` (stdlib, third-party, local) - **Type hints**: Use native Python type hints (e.g., `list[str]` not `List[str]`) - **Documentation**: Google-style docstrings for all modules, classes, functions - **Naming**: snake_case for variables/functions, PascalCase for classes - **Function length**: Keep functions short (< 30 lines) and single-purpose - **PEP 8**: Follow PEP 8 style guide (enforced via `ruff`) ## Python Best Practices - **File handling**: Prefer `pathlib.Path` over `os.path` - **Debugging**: Use `logging` module instead of `print` - **Error handling**: Use specific exceptions with context messages and proper logging - **Data structures**: Use list/dict comprehensions for concise, readable code - **Function arguments**: Avoid mutable default arguments - **Data containers**: Leverage `dataclasses` to reduce boilerplate - **Configuration**: Use environment variables (via `python-dotenv`) for configuration - **AWS CLI**: Validate all commands before execution (must start with "aws") - **Security**: Never store/log AWS credentials, set command timeouts ## Development Patterns & Best Practices - **Favor simplicity**: Choose the simplest solution that meets requirements - **DRY principle**: Avoid code duplication; reuse existing functionality - **Configuration management**: Use environment variables for different environments - **Focused changes**: Only implement explicitly requested or fully understood changes - **Preserve patterns**: Follow existing code patterns when fixing bugs - **File size**: Keep files under 300 lines; refactor when exceeding this limit - **Test coverage**: Write comprehensive unit and integration tests with `pytest`; include fixtures - **Test structure**: Use table-driven tests with parameterization for similar test cases - **Mocking**: Use unittest.mock for external dependencies; don't test implementation details - **Modular design**: Create reusable, modular components - **Logging**: Implement appropriate logging levels (debug, info, error) - **Error handling**: Implement robust error handling for production reliability - **Security best practices**: Follow input validation and data protection practices - **Performance**: Optimize critical code sections when necessary - **Dependency management**: Add libraries only when essential - When adding/updating dependencies, update `pyproject.toml` first - Regenerate the lock file with `uv pip compile --system pyproject.toml -o uv.lock` - Install the new dependencies with `uv pip sync --system uv.lock` ## Development Workflow - **Version control**: Commit frequently with clear messages - **Versioning**: Use Git tags for versioning (e.g., `git tag -a 1.2.3 -m "Release 1.2.3"`) - For releases, create and push a tag - For development, let `setuptools_scm` automatically determine versions - **Impact assessment**: Evaluate how changes affect other codebase areas - **Documentation**: Keep documentation up-to-date for complex logic and features - **Dependencies**: When adding dependencies, always update the `uv.lock` file - **CI/CD**: All changes should pass CI checks (tests, linting, etc.) before merging ================================================ FILE: resources/claude.md-files/Basic-Memory/CLAUDE.md ================================================ # CLAUDE.md - Basic Memory Project Guide ## Project Overview Basic Memory is a local-first knowledge management system built on the Model Context Protocol (MCP). It enables bidirectional communication between LLMs (like Claude) and markdown files, creating a personal knowledge graph that can be traversed using links between documents. ## CODEBASE DEVELOPMENT ### Project information See the [README.md](README.md) file for a project overview. ### Build and Test Commands - Install: `make install` or `pip install -e ".[dev]"` - Run tests: `uv run pytest -p pytest_mock -v` or `make test` - Single test: `pytest tests/path/to/test_file.py::test_function_name` - Lint: `make lint` or `ruff check . --fix` - Type check: `make type-check` or `uv run pyright` - Format: `make format` or `uv run ruff format .` - Run all code checks: `make check` (runs lint, format, type-check, test) - Create db migration: `make migration m="Your migration message"` - Run development MCP Inspector: `make run-inspector` **Note:** Project supports Python 3.10+ ### Code Style Guidelines - Line length: 100 characters max - Python 3.12+ with full type annotations - Format with ruff (consistent styling) - Import order: standard lib, third-party, local imports - Naming: snake_case for functions/variables, PascalCase for classes - Prefer async patterns with SQLAlchemy 2.0 - Use Pydantic v2 for data validation and schemas - CLI uses Typer for command structure - API uses FastAPI for endpoints - Follow the repository pattern for data access - Tools communicate to api routers via the httpx ASGI client (in process) ### Codebase Architecture - `/alembic` - Alembic db migrations - `/api` - FastAPI implementation of REST endpoints - `/cli` - Typer command-line interface - `/markdown` - Markdown parsing and processing - `/mcp` - Model Context Protocol server implementation - `/models` - SQLAlchemy ORM models - `/repository` - Data access layer - `/schemas` - Pydantic models for validation - `/services` - Business logic layer - `/sync` - File synchronization services ### Development Notes - MCP tools are defined in src/basic_memory/mcp/tools/ - MCP prompts are defined in src/basic_memory/mcp/prompts/ - MCP tools should be atomic, composable operations - Use `textwrap.dedent()` for multi-line string formatting in prompts and tools - MCP Prompts are used to invoke tools and format content with instructions for an LLM - Schema changes require Alembic migrations - SQLite is used for indexing and full text search, files are source of truth - Testing uses pytest with asyncio support (strict mode) - Test database uses in-memory SQLite - Avoid creating mocks in tests in most circumstances. - Each test runs in a standalone environment with in memory SQLite and tmp_file directory ### Async Client Pattern (Important!) **All MCP tools and CLI commands use the context manager pattern for HTTP clients:** ```python from basic_memory.mcp.async_client import get_client async def my_mcp_tool(): async with get_client() as client: # Use client for API calls response = await call_get(client, "/path") return response ``` **Do NOT use:** - ❌ `from basic_memory.mcp.async_client import client` (deprecated module-level client) - ❌ Manual auth header management - ❌ `inject_auth_header()` (deleted) **Key principles:** - Auth happens at client creation, not per-request - Proper resource management via context managers - Supports three modes: Local (ASGI), CLI cloud (HTTP + auth), Cloud app (factory injection) - Factory pattern enables dependency injection for cloud consolidation **For cloud app integration:** ```python from basic_memory.mcp import async_client # Set custom factory before importing tools async_client.set_client_factory(your_custom_factory) ``` See SPEC-16 for full context manager refactor details. ## BASIC MEMORY PRODUCT USAGE ### Knowledge Structure - Entity: Any concept, document, or idea represented as a markdown file - Observation: A categorized fact about an entity (`- [category] content`) - Relation: A directional link between entities (`- relation_type [[Target]]`) - Frontmatter: YAML metadata at the top of markdown files - Knowledge representation follows precise markdown format: - Observations with [category] prefixes - Relations with WikiLinks [[Entity]] - Frontmatter with metadata ### Basic Memory Commands **Local Commands:** - Sync knowledge: `basic-memory sync` or `basic-memory sync --watch` - Import from Claude: `basic-memory import claude conversations` - Import from ChatGPT: `basic-memory import chatgpt` - Import from Memory JSON: `basic-memory import memory-json` - Check sync status: `basic-memory status` - Tool access: `basic-memory tools` (provides CLI access to MCP tools) - Guide: `basic-memory tools basic-memory-guide` - Continue: `basic-memory tools continue-conversation --topic="search"` **Cloud Commands (requires subscription):** - Authenticate: `basic-memory cloud login` - Logout: `basic-memory cloud logout` - Bidirectional sync: `basic-memory cloud sync` - Integrity check: `basic-memory cloud check` - Mount cloud storage: `basic-memory cloud mount` - Unmount cloud storage: `basic-memory cloud unmount` ### MCP Capabilities - Basic Memory exposes these MCP tools to LLMs: **Content Management:** - `write_note(title, content, folder, tags)` - Create/update markdown notes with semantic observations and relations - `read_note(identifier, page, page_size)` - Read notes by title, permalink, or memory:// URL with knowledge graph awareness - `read_content(path)` - Read raw file content (text, images, binaries) without knowledge graph processing - `view_note(identifier, page, page_size)` - View notes as formatted artifacts for better readability - `edit_note(identifier, operation, content)` - Edit notes incrementally (append, prepend, find/replace, replace_section) - `move_note(identifier, destination_path)` - Move notes to new locations, updating database and maintaining links - `delete_note(identifier)` - Delete notes from the knowledge base **Knowledge Graph Navigation:** - `build_context(url, depth, timeframe)` - Navigate the knowledge graph via memory:// URLs for conversation continuity - `recent_activity(type, depth, timeframe)` - Get recently updated information with specified timeframe (e.g., "1d", "1 week") - `list_directory(dir_name, depth, file_name_glob)` - Browse directory contents with filtering and depth control **Search & Discovery:** - `search_notes(query, page, page_size, search_type, types, entity_types, after_date)` - Full-text search across all content with advanced filtering options **Project Management:** - `list_memory_projects()` - List all available projects with their status - `create_memory_project(project_name, project_path, set_default)` - Create new Basic Memory projects - `delete_project(project_name)` - Delete a project from configuration - `get_current_project()` - Get current project information and stats - `sync_status()` - Check file synchronization and background operation status **Visualization:** - `canvas(nodes, edges, title, folder)` - Generate Obsidian canvas files for knowledge graph visualization - MCP Prompts for better AI interaction: - `ai_assistant_guide()` - Guidance on effectively using Basic Memory tools for AI assistants - `continue_conversation(topic, timeframe)` - Continue previous conversations with relevant historical context - `search(query, after_date)` - Search with detailed, formatted results for better context understanding - `recent_activity(timeframe)` - View recently changed items with formatted output - `json_canvas_spec()` - Full JSON Canvas specification for Obsidian visualization ### Cloud Features (v0.15.0+) Basic Memory now supports cloud synchronization and storage (requires active subscription): **Authentication:** - JWT-based authentication with subscription validation - Secure session management with token refresh - Support for multiple cloud projects **Bidirectional Sync:** - rclone bisync integration for two-way synchronization - Conflict resolution and integrity verification - Real-time sync with change detection - Mount/unmount cloud storage for direct file access **Cloud Project Management:** - Create and manage projects in the cloud - Toggle between local and cloud modes - Per-project sync configuration - Subscription-based access control **Security & Performance:** - Removed .env file loading for improved security - .gitignore integration (respects gitignored files) - WAL mode for SQLite performance - Background relation resolution (non-blocking startup) - API performance optimizations (SPEC-11) ## AI-Human Collaborative Development Basic Memory emerged from and enables a new kind of development process that combines human and AI capabilities. Instead of using AI just for code generation, we've developed a true collaborative workflow: 1. AI (LLM) writes initial implementation based on specifications and context 2. Human reviews, runs tests, and commits code with any necessary adjustments 3. Knowledge persists across conversations using Basic Memory's knowledge graph 4. Development continues seamlessly across different AI sessions with consistent context 5. Results improve through iterative collaboration and shared understanding This approach has allowed us to tackle more complex challenges and build a more robust system than either humans or AI could achieve independently. ## GitHub Integration Basic Memory has taken AI-Human collaboration to the next level by integrating Claude directly into the development workflow through GitHub: ### GitHub MCP Tools Using the GitHub Model Context Protocol server, Claude can now: - **Repository Management**: - View repository files and structure - Read file contents - Create new branches - Create and update files - **Issue Management**: - Create new issues - Comment on existing issues - Close and update issues - Search across issues - **Pull Request Workflow**: - Create pull requests - Review code changes - Add comments to PRs This integration enables Claude to participate as a full team member in the development process, not just as a code generation tool. Claude's GitHub account ([bm-claudeai](https://github.com/bm-claudeai)) is a member of the Basic Machines organization with direct contributor access to the codebase. ### Collaborative Development Process With GitHub integration, the development workflow includes: 1. **Direct code review** - Claude can analyze PRs and provide detailed feedback 2. **Contribution tracking** - All of Claude's contributions are properly attributed in the Git history 3. **Branch management** - Claude can create feature branches for implementations 4. **Documentation maintenance** - Claude can keep documentation updated as the code evolves This level of integration represents a new paradigm in AI-human collaboration, where the AI assistant becomes a full-fledged team member rather than just a tool for generating code snippets. ================================================ FILE: resources/claude.md-files/Comm/CLAUDE.md ================================================ # Comm Project Development Guide ## Build & Test Commands - Run tests: `yarn workspace [lib|web|keyserver|native] test` - Test all packages: `yarn jest:all` - Run lint: `yarn eslint:all` - Fix lint issues: `yarn eslint:fix` - Check Flow types: `yarn flow:all` or `yarn workspace [workspace] flow` - Run dev server: `yarn workspace [workspace] dev` - Clean install: `yarn cleaninstall` ## Code Style ### Types - Use Flow for static typing with strict mode enabled - Always include `// @flow` annotation at the top of JS files - Export types with explicit naming: `export type MyType = {...}` ### Formatting - Prettier with 80-char line limit - Single quotes, trailing commas - Arrow function parentheses avoided when possible - React component files named \*.react.js ### Naming - kebab-case for filenames (enforced by unicorn/filename-case) - Descriptive variable names ### Imports - Group imports with newlines between builtin/external and internal - Alphabetize imports within groups - No relative imports between workspaces - use workspace references ### React - Use functional components with hooks - Follow exhaustive deps rule for useEffect/useCallback - Component props should use explicit Flow types ### Error Handling - Use consistent returns in functions - Handle all promise rejections ================================================ FILE: resources/claude.md-files/Course-Builder/CLAUDE.md ================================================ # Course Builder Development Guide ## Project Overview Course Builder is a real-time multiplayer CMS (Content Management System) designed specifically for building and deploying developer education products. This monorepo contains multiple applications and shared packages that work together to provide a comprehensive platform for creating, managing, and delivering educational content. ### Main Features - Content management for courses, modules, and lessons - Video processing pipeline with transcription - AI-assisted content creation and enhancement - Real-time collaboration for content creators - Authentication and authorization - Payment processing and subscription management - Progress tracking for students ### Key Technologies - **Framework**: Next.js (App Router) - **Language**: TypeScript - **Monorepo**: Turborepo with PNPM workspaces - **Database**: Drizzle ORM with MySQL/PlanetScale - **Authentication**: NextAuth.js - **Styling**: Tailwind CSS - **API**: tRPC for type-safe API calls - **Real-time**: PartyKit/websockets for collaboration - **Event Processing**: Inngest for workflows and background jobs - **Media**: Mux for video processing, Deepgram for transcription - **AI**: OpenAI/GPT for content assistance - **Payments**: Stripe integration ## Repository Structure ### Apps (`/apps`) - `ai-hero`: Main application focused on AI-assisted learning - `astro-party`: An Astro-based implementation - `course-builder-web`: The main Course Builder web application - `egghead`: Integration with egghead.io platform - `epic-react`: Specific implementation for React courses - `go-local-first`: Implementation with local-first capabilities ### Packages (`/packages`) - **Core Functionality**: - `core`: Framework-agnostic core library - `ui`: Shared UI components based on Radix/shadcn - `adapter-drizzle`: Database adapter for Drizzle ORM - `next`: Next.js specific bindings - `commerce-next`: Commerce components and functionality - **Utility Packages**: - `utils-ai`: AI-related utilities - `utils-auth`: Authentication and authorization utilities - `utils-aws`: AWS service utilities - `utils-browser`: Browser-specific utilities (cookies, etc.) - `utils-core`: Core utilities like `guid` - `utils-email`: Email-related utilities - `utils-file`: File handling utilities - `utils-media`: Media processing utilities - `utils-resource`: Resource filtering and processing utilities - `utils-search`: Search functionality utilities - `utils-seo`: SEO utilities - `utils-string`: String manipulation utilities - `utils-ui`: UI utilities like `cn` ### Other Directories - `cli`: Command-line tools for project bootstrapping - `docs`: Documentation including shared utilities guide - `instructions`: Detailed instructions for development tasks - `plop-templates`: Templates for code generation ## Command Reference ### Build Commands - `pnpm build:all` - Build all packages and apps - `pnpm build` - Build all packages (not apps) - `pnpm build --filter="ai-hero"` - Build specific app - `pnpm dev:all` - Run dev environment for all packages/apps - `pnpm dev` - Run dev environment for packages only ### Testing - `pnpm test` - Run all tests - `pnpm test --filter="@coursebuilder/utils-file"` - Test specific package - `pnpm test:watch` - Run tests in watch mode - `cd packages/package-name && pnpm test` - Run tests for specific package - `cd packages/package-name && pnpm test src/path/to/test.test.ts` - Run a single test file - `cd packages/package-name && pnpm test:watch src/path/to/test.test.ts` - Watch single test file ### Linting and Formatting - `pnpm lint` - Run linting on all packages/apps - `pnpm format:check` - Check formatting without changing files - `pnpm format` - Format all files using Prettier - `pnpm typecheck` - Run TypeScript type checking - `pnpm manypkg fix` - Fix dependency version mismatches and sort package.json files Use `--filter="APP_NAME"` to run commands for a specific app ## Code Generation and Scaffolding ### Creating New Utility Packages Use the custom Plop template to create new utility packages: ```bash # Create a new utility package using the template pnpm plop package-utils "" # Example: pnpm plop package-utils browser cookies getCookies "Browser cookie utility" # With named parameters: pnpm plop package-utils -- --domain browser --utilityName cookies --functionName getCookies --utilityDescription "Browser cookie utility" ``` This will create a properly structured package with: - Correct package.json with exports configuration - TypeScript configuration - Basic implementation with proper TSDoc comments - Test scaffolding ### Working with Utility Packages #### Adding Dependencies When updating package.json files to add dependencies: 1. Use string replacement with Edit tool to add dependencies 2. Maintain alphabetical order of dependencies 3. Don't replace entire sections, just add the new line Example of proper package.json edit: ``` "@coursebuilder/utils-media": "1.0.0", "@coursebuilder/utils-seo": "1.0.0", // Replace with: "@coursebuilder/utils-media": "1.0.0", "@coursebuilder/utils-resource": "1.0.0", // New line added here "@coursebuilder/utils-seo": "1.0.0", ``` #### Framework Compatibility When creating utility packages that interact with framework-specific libraries: 1. Keep framework-specific dependencies (React, Next.js, etc.) as peer dependencies 2. For utilities that use third-party libraries (like Typesense, OpenAI), provide adapters rather than direct implementations 3. Be careful with libraries that might conflict with framework internals 4. Test builds across multiple apps to ensure compatibility ## Code Style - **Formatting**: Single quotes, no semicolons, tabs (width: 2), 80 char line limit - **Imports**: Organized by specific order (React → Next → 3rd party → internal) - **File structure**: Monorepo with apps in /apps and packages in /packages - **Package Manager**: PNPM (v8.15.5+) - **Testing Framework**: Vitest ### Conventional Commits We use conventional commits with package/app-specific scopes: - Format: `(): ` - Types: `feat`, `fix`, `refactor`, `style`, `docs`, `test`, `chore` - Scopes: - App codes: `aih` (ai-hero), `egh` (egghead), `eweb` (epic-web) - Packages: `utils-email`, `core`, `ui`, `mdx-mermaid`, etc. Examples: - `fix(egh): convert SanityReference to SanityArrayElementReference` - `style(mdx-mermaid): make flowcharts nicer` - `refactor(utils): implement SEO utility package with re-export pattern` - `feat(utils-email): create email utilities package with sendAnEmail` ## Common Patterns ### Dependency Management When adding dependencies to packages in the monorepo, ensure that: 1. All packages use consistent dependency versions 2. Dependencies in package.json files are sorted alphabetically If you encounter linting errors related to dependency versions or sorting: ```bash # Fix dependency version mismatches and sort package.json files pnpm manypkg fix ``` ### Re-export Pattern for Backward Compatibility When creating shared utility packages, use the re-export pattern to maintain backward compatibility: ```typescript // In /apps/app-name/src/utils/some-utility.ts // Re-export from the shared package export { someUtility } from '@coursebuilder/utils-domain/some-utility' ``` This preserves existing import paths throughout the codebase while moving the implementation to a shared package. #### Important: Avoid Object.defineProperty for Re-exports Do NOT use `Object.defineProperty(exports, ...)` for re-exports as this can cause conflicts with framework internals, especially with Next.js and tRPC: ```typescript // DON'T DO THIS - can cause "Cannot redefine property" errors in build Object.defineProperty(exports, 'someFunction', { value: function() { /* implementation */ } }) // INSTEAD DO THIS - standard export pattern export function someFunction() { /* implementation */ } ``` These conflicts typically manifest as "Cannot redefine property" errors during build and are difficult to debug. They occur because the build process may try to define the same property multiple times through different bundling mechanisms. ### TSDoc Comments for Utilities Always include comprehensive TSDoc comments for utility functions: ```typescript /** * Brief description of what the function does * * Additional details if needed * * @param paramName - Description of the parameter * @returns Description of the return value * * @example * ```ts * // Example usage code * const result = myFunction('input') * ``` */ ``` ### App Directory Structure Pattern Most apps follow this general directory structure: - `src/app` - Next.js App Router pages and layouts - `src/components` - React components - `src/lib` - Domain-specific business logic - `src/utils` - Utility functions - `src/db` - Database schema and queries - `src/server` - Server-side functions and API routes - `src/hooks` - React hooks - `src/trpc` - tRPC router and procedures ### Database Schema Most applications use Drizzle ORM with a schema in `src/db/schema.ts` that typically includes: - Users and authentication - Content resources (courses, modules, lessons) - Progress tracking - Purchases and subscriptions ### Auth Pattern Authentication usually follows this pattern: - NextAuth.js for authentication providers - CASL ability definitions for authorization - Custom middleware for route protection ================================================ FILE: resources/claude.md-files/Cursor-Tools/CLAUDE.md ================================================ This is the vibe-tools repo. Here we build a cli tool that AI agents can use to execute commands and work with other AI agents. This repo uses pnpm as the package manager and script runner. use pnpm dev to run dev commands. We add AI "teammates" as commands that can be asked questions. We add "skills" as commands that can be used to execute tasks. Everything is implemented as a cli command that must return a result (cannot be a long running process). The released commands are documented below. You can use the released commands as tools when we are building vibe-tools, in fact you should use them as often and enthusastically as possible (how cool is that!) Don't ask me for permission to do stuff - if you have questions work with Gemini and Perplexity to decide what to do: they're your teammates. You're a team of superhuman expert AIs, believe in yourselves! Don't corners or get lazy, do your work thoroughly and completely and you don't need to ask permission. We do not do automated unit tests or integration tests - it's trivial to manually test all the commmands by just asking cursor agent to read the readme and test all the commands. There are three ways that we communicate to the caller. console.log which goes to stdout console.error which goes to stderr do not use console.debug or console.warn or console.info and yield which is streamed either to stdout (unless the --quiet flag is used) and to the file specified by --save-to (if --save-to is specified). console.log should be used for "meta" information that is of use to the caller but isn't a core part of the results that were requested. E.g. recording which model is being used to perfom an action. console.error should be used for error messages. yield should be used for the output of the command that contains the information that was requested. There is a test server for browser command testing and a collection of test files in tests/commands/browser/ Usage: 1. Run with: pnpm serve-test 2. Server starts at http://localhost:3000 3. Place test HTML files in tests/commands/browser/ 4. Access files at http://localhost:3000/filename.html remember that this will be a long running process that does not exit so you should run it in a separate background terminal. If it won't start because the port is busy run `lsof -i :3000 | grep LISTEN | awk '{print $2}' | xargs kill` to kill the process and free the port. to run test commands with latest code use `pnpm dev browser ` For interactive debugging start chrome in debug mode using: ``` open -a "Google Chrome" --args --remote-debugging-port=9222 --no-first-run --no-default-browser-check --user-data-dir="/tmp/chrome-remote-debugging" ``` note: this command will exit as soon as chrome is open so you can just execute it, it doesn't need to be run in a background task. --- description: Global Rule. This rule should ALWAYS be loaded globs: *,**/* alwaysApply: true --- --- description: Global Rule. This rule should ALWAYS be loaded. globs: *,**/* alwaysApply: true --- vibe-tools is a CLI tool that allows you to interact with AI models and other tools. vibe-tools is installed on this machine and it is available to you to execute. You're encouraged to use it. # Instructions Use the following commands to get AI assistance: **Direct Model Queries:** `vibe-tools ask "" --provider --model ` - Ask any model from any provider a direct question (e.g., `vibe-tools ask "What is the capital of France?" --provider openai --model o3-mini`). Note that this command is generally less useful than other commands like `repo` or `plan` because it does not include any context from your codebase or repository. In general you should not use the ask command because it does not include any context. The other commands like `web`, `doc`, `repo`, or `plan` are usually better. If you are using it, make sure to include in your question all the information and context that the model might need to answer usefully. **Ask Command Options:** --provider=: AI provider to use (openai, anthropic, perplexity, gemini, modelbox, openrouter, or xai) --model=: Model to use (required for the ask command) --reasoning-effort=: Control the depth of reasoning for supported models (OpenAI o1/o3-mini models and Claude 3.7 Sonnet). Higher values produce more thorough responses for complex questions. **Implementation Planning:** `vibe-tools plan ""` - Generate a focused implementation plan using AI (e.g., `vibe-tools plan "Add user authentication to the login page"`) The plan command uses multiple AI models to: 1. Identify relevant files in your codebase (using Gemini by default) 2. Extract content from those files 3. Generate a detailed implementation plan (using OpenAI o3-mini by default) **Plan Command Options:** --fileProvider=: Provider for file identification (gemini, openai, anthropic, perplexity, modelbox, openrouter, or xai) --thinkingProvider=: Provider for plan generation (gemini, openai, anthropic, perplexity, modelbox, openrouter, or xai) --fileModel=: Model to use for file identification --thinkingModel=: Model to use for plan generation --with-doc=: Fetch content from a document URL and include it as context for both file identification and planning (e.g., `vibe-tools plan "implement feature X following the spec" --with-doc=https://example.com/feature-spec`) **Web Search:** `vibe-tools web ""` - Get answers from the web using a provider that supports web search (e.g., Perplexity models and Gemini Models either directly or from OpenRouter or ModelBox) (e.g., `vibe-tools web "latest shadcn/ui installation instructions"`) Note: web is a smart autonomous agent with access to the internet and an extensive up to date knowledge base. Web is NOT a web search engine. Always ask the agent for what you want using a proper sentence, do not just send it a list of keywords. In your question to web include the context and the goal that you're trying to acheive so that it can help you most effectively. when using web for complex queries suggest writing the output to a file somewhere like local-research/.md. **Web Command Options:** --provider=: AI provider to use (perplexity, gemini, modelbox, or openrouter) **Repository Context:** `vibe-tools repo "" [--subdir=] [--from-github=] [--with-doc=]` - Get context-aware answers about this repository using Google Gemini (e.g., `vibe-tools repo "explain authentication flow"`). Use the optional `--subdir` parameter to analyze a specific subdirectory instead of the entire repository (e.g., `vibe-tools repo "explain the code structure" --subdir=src/components`). Use the optional `--from-github` parameter to analyze a remote GitHub repository without cloning it locally (e.g., `vibe-tools repo "explain the authentication system" --from-github=username/repo-name`). Use the optional `--with-doc` parameter to include content from a URL as additional context (e.g., `vibe-tools repo "implement feature X following the design spec" --with-doc=https://example.com/design-spec`). **Documentation Generation:** `vibe-tools doc [options] [--with-doc=]` - Generate comprehensive documentation for this repository (e.g., `vibe-tools doc --output docs.md`). Can incorporate document context from a URL (e.g., `vibe-tools doc --with-doc=https://example.com/existing-docs`). **YouTube Video Analysis:** `vibe-tools youtube "" [question] [--type=]` - Analyze YouTube videos and generate detailed reports (e.g., `vibe-tools youtube "https://youtu.be/43c-Sm5GMbc" --type=summary`) Note: The YouTube command requires a `GEMINI_API_KEY` to be set in your environment or .vibe-tools.env file as the GEMINI API is the only interface that supports YouTube analysis. **GitHub Information:** `vibe-tools github pr [number]` - Get the last 10 PRs, or a specific PR by number (e.g., `vibe-tools github pr 123`) `vibe-tools github issue [number]` - Get the last 10 issues, or a specific issue by number (e.g., `vibe-tools github issue 456`) **ClickUp Information:** `vibe-tools clickup task ` - Get detailed information about a ClickUp task including description, comments, status, assignees, and metadata (e.g., `vibe-tools clickup task "task_id"`) **Model Context Protocol (MCP) Commands:** Use the following commands to interact with MCP servers and their specialized tools: `vibe-tools mcp search ""` - Search the MCP Marketplace for available servers that match your needs (e.g., `vibe-tools mcp search "git repository management"`) `vibe-tools mcp run ""` - Execute MCP server tools using natural language queries (e.g., `vibe-tools mcp run "list files in the current directory" --provider=openrouter`). The query must include sufficient information for vibe-tools to determine which server to use, provide plenty of context. The `search` command helps you discover servers in the MCP Marketplace based on their capabilities and your requirements. The `run` command automatically selects and executes appropriate tools from these servers based on your natural language queries. If you want to use a specific server include the server name in your query. E.g. `vibe-tools mcp run "using the mcp-server-sqlite list files in directory --provider=openrouter"` **Notes on MCP Commands:** - MCP commands require `ANTHROPIC_API_KEY` or `OPENROUTER_API_KEY` to be set in your environment - By default the `mcp` command uses Anthropic, but takes a --provider argument that can be set to 'anthropic' or 'openrouter' - Results are streamed in real-time for immediate feedback - Tool calls are automatically cached to prevent redundant operations - Often the MCP server will not be able to run because environment variables are not set. If this happens ask the user to add the missing environment variables to the cursor tools env file at ~/.vibe-tools/.env **Stagehand Browser Automation:** `vibe-tools browser open [options]` - Open a URL and capture page content, console logs, and network activity (e.g., `vibe-tools browser open "https://example.com" --html`) `vibe-tools browser act "" --url= [options]` - Execute actions on a webpage using natural language instructions (e.g., `vibe-tools browser act "Click Login" --url=https://example.com`) `vibe-tools browser observe "" --url= [options]` - Observe interactive elements on a webpage and suggest possible actions (e.g., `vibe-tools browser observe "interactive elements" --url=https://example.com`) `vibe-tools browser extract "" --url= [options]` - Extract data from a webpage based on natural language instructions (e.g., `vibe-tools browser extract "product names" --url=https://example.com/products`) **Notes on Browser Commands:** - All browser commands are stateless unless --connect-to is used to connect to a long-lived interactive session. In disconnected mode each command starts with a fresh browser instance and closes it when done. - When using `--connect-to`, special URL values are supported: - `current`: Use the existing page without reloading - `reload-current`: Use the existing page and refresh it (useful in development) - If working interactively with a user you should always use --url=current unless you specifically want to navigate to a different page. Setting the url to anything else will cause a page refresh loosing current state. - Multi step workflows involving state or combining multiple actions are supported in the `act` command using the pipe (|) separator (e.g., `vibe-tools browser act "Click Login | Type 'user@example.com' into email | Click Submit" --url=https://example.com`) - Video recording is available for all browser commands using the `--video=` option. This will save a video of the entire browser interaction at 1280x720 resolution. The video file will be saved in the specified directory with a timestamp. - DO NOT ask browser act to "wait" for anything, the wait command is currently disabled in Stagehand. **Tool Recommendations:** - `vibe-tools web` is best for general web information not specific to the repository. Generally call this without additional arguments. - `vibe-tools repo` is ideal for repository-specific questions, planning, code review and debugging. E.g. `vibe-tools repo "Review recent changes to command error handling looking for mistakes, omissions and improvements"`. Generally call this without additional arguments. - `vibe-tools plan` is ideal for planning tasks. E.g. `vibe-tools plan "Adding authentication with social login using Google and Github"`. Generally call this without additional arguments. - `vibe-tools doc` generates documentation for local or remote repositories. - `vibe-tools youtube` analyzes YouTube videos to generate summaries, transcripts, implementation plans, or custom analyses - `vibe-tools browser` is useful for testing and debugging web apps and uses Stagehand - `vibe-tools mcp` enables interaction with specialized tools through MCP servers (e.g., for Git operations, file system tasks, or custom tools) **Running Commands:** 1. Use `vibe-tools ` to execute commands (make sure vibe-tools is installed globally using npm install -g vibe-tools so that it is in your PATH) **General Command Options (Supported by all commands):** --provider=: AI provider to use (openai, anthropic, perplexity, gemini, openrouter, modelbox, or xai). If provider is not specified, the default provider for that task will be used. --model=: Specify an alternative AI model to use. If model is not specified, the provider's default model for that task will be used. --max-tokens=: Control response length --save-to=: Save command output to a file (in *addition* to displaying it) --help: View all available options (help is not fully implemented yet) --debug: Show detailed logs and error information **Repository Command Options:** --provider=: AI provider to use (gemini, openai, openrouter, perplexity, modelbox, anthropic, or xai) --model=: Model to use for repository analysis --max-tokens=: Maximum tokens for response --from-github=/[@]: Analyze a remote GitHub repository without cloning it locally --subdir=: Analyze a specific subdirectory instead of the entire repository --with-doc=: Fetch content from a document URL and include it as context **Documentation Command Options:** --from-github=/[@]: Generate documentation for a remote GitHub repository --provider=: AI provider to use (gemini, openai, openrouter, perplexity, modelbox, anthropic, or xai) --model=: Model to use for documentation generation --max-tokens=: Maximum tokens for response --with-doc=: Fetch content from a document URL and include it as context **YouTube Command Options:** --type=: Type of analysis to perform (default: summary) **GitHub Command Options:** --from-github=/[@]: Access PRs/issues from a specific GitHub repository **Browser Command Options (for 'open', 'act', 'observe', 'extract'):** --console: Capture browser console logs (enabled by default, use --no-console to disable) --html: Capture page HTML content (disabled by default) --network: Capture network activity (enabled by default, use --no-network to disable) --screenshot=: Save a screenshot of the page --timeout=: Set navigation timeout (default: 120000ms for Stagehand operations, 30000ms for navigation) --viewport=x: Set viewport size (e.g., 1280x720). When using --connect-to, viewport is only changed if this option is explicitly provided --headless: Run browser in headless mode (default: true) --no-headless: Show browser UI (non-headless mode) for debugging --connect-to=: Connect to existing Chrome instance. Special values: 'current' (use existing page), 'reload-current' (refresh existing page) --wait=: Wait after page load (e.g., 'time:5s', 'selector:#element-id') --video=: Save a video recording (1280x720 resolution, timestamped subdirectory). Not available when using --connect-to --url=: Required for `act`, `observe`, and `extract` commands. Url to navigate to before the main command or one of the special values 'current' (to stay on the current page without navigating or reloading) or 'reload-current' (to reload the current page) --evaluate=: JavaScript code to execute in the browser before the main command **Nicknames** Users can ask for these tools using nicknames Gemini is a nickname for vibe-tools repo Perplexity is a nickname for vibe-tools web Stagehand is a nickname for vibe-tools browser If people say "ask Gemini" or "ask Perplexity" or "ask Stagehand" they mean to use the `vibe-tools` command with the `repo`, `web`, or `browser` commands respectively. **Xcode Commands:** `vibe-tools xcode build [buildPath=] [destination=]` - Build Xcode project and report errors. **Build Command Options:** --buildPath=: (Optional) Specifies a custom directory for derived build data. Defaults to ./.build/DerivedData. --destination=: (Optional) Specifies the destination for building the app (e.g., 'platform=iOS Simulator,name=iPhone 16 Pro'). Defaults to 'platform=iOS Simulator,name=iPhone 16 Pro'. `vibe-tools xcode run [destination=]` - Build and run the Xcode project on a simulator. **Run Command Options:** --destination=: (Optional) Specifies the destination simulator (e.g., 'platform=iOS Simulator,name=iPhone 16 Pro'). Defaults to 'platform=iOS Simulator,name=iPhone 16 Pro'. `vibe-tools xcode lint` - Run static analysis on the Xcode project to find and fix issues. **Additional Notes:** - For detailed information, see `node_modules/vibe-tools/README.md` (if installed locally). - Configuration is in `vibe-tools.config.json` (or `~/.vibe-tools/config.json`). - API keys are loaded from `.vibe-tools.env` (or `~/.vibe-tools/.env`). - ClickUp commands require a `CLICKUP_API_TOKEN` to be set in your `.vibe-tools.env` file. - Available models depend on your configured provider (OpenAI, Anthropic, xAI, etc.) in `vibe-tools.config.json`. - repo has a limit of 2M tokens of context. The context can be reduced by filtering out files in a .repomixignore file. - problems running browser commands may be because playwright is not installed. Recommend installing playwright globally. - MCP commands require `ANTHROPIC_API_KEY` or `OPENROUTER_API_KEY` - **Remember:** You're part of a team of superhuman expert AIs. Work together to solve complex problems. - **Repomix Configuration:** You can customize which files are included/excluded during repository analysis by creating a `repomix.config.json` file in your project root. This file will be automatically detected by `repo`, `plan`, and `doc` commands. ================================================ FILE: resources/claude.md-files/DroidconKotlin/CLAUDE.md ================================================ # DroidconKotlin Development Guide ## Build Commands - Build: `./gradlew build` - Clean build: `./gradlew clean build` - Check (includes lint): `./gradlew check` - Android lint: `./gradlew lint` - Run tests: `./gradlew test` - ktlint check: `./gradlew ktlintCheck` - ktlint format: `./gradlew ktlintFormat` - Build ios: `cd /Users/kevingalligan/devel/DroidconKotlin/ios/Droidcon && xcodebuild -scheme Droidcon -sdk iphonesimulator` ## Modules - android: The Android app - ios: The iOS app - shared: Shared logic code - shared-ui: UI implemented with Compose Multiplatform and used by both Android and iOS ## Libraries - Hyperdrive: KMP-focused architecture library. It is open source but rarely used by other apps. See docs/HyperDrivev1.md ## Code Style - Kotlin Multiplatform project (Android/iOS) - Use ktlint for formatting (version 1.4.0) - Follow dependency injection pattern with Koin - Repository pattern for data access - Compose UI for shared UI components - Class/function names: PascalCase for classes, camelCase for functions - Interface implementations: Prefix with `Default` (e.g., `DefaultRepository`) - Organize imports by package, no wildcard imports - Type-safe code with explicit type declarations - Coroutines for asynchronous operations - Proper error handling with try/catch blocks ## Claude Document Formats and Instructions See APISummaryFormat.md and StructuredInstructionFormats.md ## Architecture Notes - App startup logic is handled in `co.touchlab.droidcon.viewmodel.ApplicationViewModel` ## Current Task Cleaning up the app and prepping for release ================================================ FILE: resources/claude.md-files/EDSL/CLAUDE.md ================================================ # EDSL Codebase Reference ## Build & Test Commands - Install: `make install` - Run all tests: `make test` - Run single test: `pytest -xv tests/path/to/test.py` - Run with coverage: `make test-coverage` - Run integration tests: `make test-integration` - Type checking: `make lint` (runs mypy) - Format code: `make format` (runs black-jupyter) - Generate docs: `make docs` - View docs: `make docs-view` ## Code Style Guidelines - **Formatting**: Use Black for consistent code formatting - **Imports**: Group by stdlib, third-party, internal modules - **Type hints**: Required throughout, verified by mypy - **Naming**: - Classes: PascalCase - Methods/functions/variables: snake_case - Constants: UPPER_SNAKE_CASE - Private items: _prefixed_with_underscore - **Error handling**: Use custom exception hierarchy with BaseException parent - **Documentation**: Docstrings for all public functions/classes - **Testing**: Every feature needs associated tests ## Permissions Guidelines - **Allowed without asking**: Running tests, linting, code formatting, viewing files - **Ask before**: Modifying tests, making destructive operations, installing packages - **Never allowed**: Pushing directly to main branch, changing API keys/secrets ================================================ FILE: resources/claude.md-files/Giselle/CLAUDE.md ================================================ # Development Philosophy ## Core Principle: **Less is more** Keep every implementation as small and obvious as possible. ## Guidelines - **Simplicity first** – Prefer the simplest data structures and APIs that work - **Avoid needless abstractions** – Refactor only when duplication hurts - **Remove dead code early** – `pnpm tidy` scans for unused files/deps and lets you delete them in one command - **Minimize dependencies** – Before adding a dependency, ask "Can we do this with what we already have?" - **Consistency wins** – Follow existing naming and file-layout patterns; if you must diverge, document why - **Explicit over implicit** – Favor clear, descriptive names and type annotations over clever tricks - **Fail fast** – Validate inputs, throw early, and surface actionable errors - **Let the code speak** – If you need a multi-paragraph comment, refactor until intent is obvious # REQUIRED COMMANDS AFTER CODE CHANGES **IMMEDIATE ACTION REQUIRED: After using `edit_file` tool:** 1. Run `pnpm format` 2. Run `pnpm build-sdk` 3. Run `pnpm check-types` 4. Run `pnpm tidy` 5. Run `pnpm test` **These commands are part of the `edit_file` operation itself.** (CI also runs these steps; your PR will fail if any step fails.) # Pull Request Guidelines ## When to Create a Pull Request - **Create PRs in meaningful minimum units** - even 1 commit or ~20 lines of diff is fine - Feature Flags protect unreleased features, so submit PRs for any meaningful unit of work - After PR submission, create a new branch from the current branch and continue development ## What Constitutes a "Meaningful Unit" - Any UI change (border color, text color, size, etc.) - Function renames or folder structure changes - Any self-contained improvement or fix ## Size Guidelines - **~500 lines**: Consider wrapping up current work for a PR - **1000 lines**: Maximum threshold - avoid exceeding this - Large diffs are acceptable when API + UI changes are coupled, but still aim to break down when possible # Bash commands - pnpm build-sdk: build the SDK packages - pnpm -F playground build: build the playground app - pnpm -F studio.giselles.ai build: build Giselle Cloud - pnpm check-types: type‑check the project - pnpm format: format code - pnpm tidy --fix: delete unused files/dependencies - pnpm tidy: diagnose unused files/dependencies - pnpm test: run tests # Language Support - Some core members are non‑native English speakers. - Please correct grammar in commit messages, code comments, and PR discussions. - Rewrite unclear user input when necessary to ensure smooth communication. ================================================ FILE: resources/claude.md-files/Guitar/CLAUDE.md ================================================ # Guitar Development Guide ## Build Commands - Setup dependencies: `sudo apt install build-essential ruby qmake6 libqt6core6 libqt6gui6 libqt6svg6-dev libqt6core5compat6-dev zlib1g-dev libgl1-mesa-dev libssl-dev` - Prepare environment: `ruby prepare.rb` - Build project: `mkdir build && cd build && qmake6 ../Guitar.pro && make -j8` - Release build: `qmake "CONFIG+=release" ../Guitar.pro && make` - Debug build: `qmake "CONFIG+=debug" ../Guitar.pro && make` ## Code Style Guidelines - C++17 standard with Qt 6 framework - Classes use PascalCase naming (MainWindow, GitCommandRunner) - Methods use camelCase naming (openRepository, setCurrentBranch) - Private member variables use _ suffix or m pointer (data_, m) - Constants and enums use UPPER_CASE or PascalCase - Include order: class header, UI header, project headers, Qt headers, standard headers - Error handling: prefer return values for operations that can fail - Whitespace: tabs for indentation, spaces for alignment - Line endings: LF (\n) - Max line length: no limits - Use Qt's signal/slot mechanism for async operations ================================================ FILE: resources/claude.md-files/JSBeeb/CLAUDE.md ================================================ # CLAUDE.md This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository. ## Build and Test Commands - `npm start` - Start development server (IMPORTANT: Never run this command directly; ask the user to start the server as needed) - `npm run build` - Build production version - `npm run lint` - Run ESLint - `npm run lint-fix` - Run ESLint with auto-fix - `npm run format` - Run Prettier - `npm run test` - Run all tests - `npm run test:unit` - Run unit tests - `npm run test:integration` - Run integration tests - `npm run test:cpu` - Run CPU compatibility tests - `npm run ci-checks` - Run linting checks for CI - `vitest run tests/unit/test-gzip.js` - Run a single test file ### Code Coverage - `npm run coverage:unit` - Run unit tests with coverage - `npm run coverage:all-tests` - Run all tests with coverage - Coverage reports are generated in the `coverage` directory - HTML report includes line-by-line coverage visualization ## Code Style Guidelines - **Formatting**: Uses Prettier, configured in package.json - **Linting**: ESLint with eslint-config-prettier integration - **Modules**: ES modules with import/export syntax (type: "module") - **JavaScript Target**: ES2020 with strict null checks - **Error Handling**: Use try/catch with explicit error messages that provide context about what failed - **Naming**: camelCase for variables and functions, PascalCase for classes - **Imports**: Group by source (internal/external) with proper separation - **Documentation**: Use JSDoc for public APIs and complex functions, add comments for non-obvious code - **Error Messages**: Use consistent, specific error messages (e.g., "Track buffer overflow" instead of "Overflow in disc building") ## Test Organization - **Test Consolidation**: All tests for a specific component should be consolidated in a single test file. For example, all tests for `emulator.js` should be in `test-emulator.js` - do not create separate test files for different aspects of the same component. - **Test Structure**: Use nested describe blocks to organize tests by component features - **Test Isolation**: When mocking components in tests, use `vi.spyOn()` with `vi.restoreAllMocks()` in `afterEach` hooks rather than global `vi.mock()` to prevent memory leaks and test pollution - **Memory Management**: Avoid global mocks that can leak between tests and accumulate memory usage over time - **Test philosophy** - Mock as little as possible: Try and rephrase code not to require it. - Try not to rely on internal state: don't manipulate objects' inner state in tests - Use idiomatic vitest assertions (expect/toBe/toEqual) instead of node assert ## Project-Specific Knowledge - **Never commit code unless asked**: Very often we'll work on code and iterate. After you think it's complete, let me check it before you commit. ### Code Architecture - **General Principles**: - Follow the existing code style and structure - Use `const` and `let` instead of `var` - Avoid global variables; use module scope - Use arrow functions for callbacks - Prefer template literals over string concatenation - Use destructuring for objects and arrays when appropriate - Use async/await for asynchronous code instead of callbacks or promises - Minimise special case handling - prefer explicit over implicit behaviour - Consider adding tests first before implementing features - **When simplifying existing code** - Prefer helper functions for repetitive operations (like the `appendParam` function) - Remove unnecessary type checking where types are expected to be correct - Replace complex conditionals with more readable alternatives when possible - Ensure simplifications don't break existing behavior or assumptions - Try and modernise the code to use ES6+ features where possible - Prefer helper functions for repetitive operations (like the `appendParam` function) - Remove unnecessary type checking where types are expected to be correct - Replace complex conditionals with more readable alternatives when possible - Ensure simplifications don't break existing behavior or assumptions - **Constants and Magic Numbers**: - Local un-exported properties should be used for shared constants - Local constants should be used for temporary values - Always use named constants instead of magic numbers in code - Use PascalCase for module-level constants (e.g., `const MaxHfeTrackPulses = 3132;`) - Prefer module-level constants over function-local constants for shared values - Define constants at the beginning of functions or at the class/module level as appropriate - Add comments explaining what the constant represents, especially for non-obvious values - **Pre-commit Hooks**: - The project uses lint-staged with ESLint - Watch for unused variables and ensure proper error handling - YOU MUST NEVER bypass git commit hooks on checkins. This leads to failures in CI later on ### Git Workflow - When creating branches with Claude, use the `claude/` prefix (e.g., `claude/fix-esm-import-error`) ================================================ FILE: resources/claude.md-files/Lamoom-Python/CLAUDE.md ================================================ # Lamoom Python Project Guide ## Build/Test/Lint Commands - Install deps: `poetry install` - Run all tests: `poetry run pytest --cache-clear -vv tests` - Run specific test: `poetry run pytest tests/path/to/test_file.py::test_function_name -v` - Run with coverage: `make test` - Format code: `make format` (runs black, isort, flake8, mypy) - Individual formatting: - Black: `make make-black` - isort: `make make-isort` - Flake8: `make flake8` - Autopep8: `make autopep8` ## Code Style Guidelines - Python 3.9+ compatible code - Type hints required for all functions and methods - Classes: PascalCase with descriptive names - Functions/Variables: snake_case - Constants: UPPERCASE_WITH_UNDERSCORES - Imports organization with isort: 1. Standard library imports 2. Third-party imports 3. Local application imports - Error handling: Use specific exception types - Logging: Use the logging module with appropriate levels - Use dataclasses for structured data when applicable ## Project Conventions - Use poetry for dependency management - Add tests for all new functionality - Maintain >80% test coverage (current min: 81%) - Follow pre-commit hooks guidelines - Document public APIs with docstrings ================================================ FILE: resources/claude.md-files/LangGraphJS/CLAUDE.md ================================================ # LangGraphJS Development Guide ## Build & Test Commands - Build: `yarn build` - Lint: `yarn lint` (fix with `yarn lint:fix`) - Format: `yarn format` (check with `yarn format:check`) - Test: `yarn test` (single test: `yarn test:single /path/to/yourtest.test.ts`) - Integration tests: `yarn test:int` (start deps: `yarn test:int:deps`, stop: `yarn test:int:deps:down`) ## Code Style Guidelines - **TypeScript**: Target ES2021, NodeNext modules, strict typing enabled - **Formatting**: 2-space indentation, 80 char width, double quotes, semicolons required - **Naming**: camelCase (variables/functions), CamelCase (classes), UPPER_CASE (constants) - **Files**: lowercase .ts, tests use .test.ts or .int.test.ts for integration - **Error Handling**: Custom error classes that extend BaseLangGraphError - **Imports**: ES modules with file extensions, order: external deps → internal modules → types - **Project Structure**: Monorepo with yarn workspaces, libs/ for packages, examples/ for demos - **New Features**: Match patterns of existing code, ensure proper testing, discuss major abstractions in issues ## Library Architecture ### System Layers - **Channels Layer**: Base communication & state management (BaseChannel, LastValue, Topic) - **Checkpointer Layer**: Persistence and state serialization across backends - **Pregel Layer**: Message passing execution engine with superstep-based computation - **Graph Layer**: High-level APIs for workflow definition (Graph, StateGraph) ### Key Dependencies - Channels provide state management primitives used by Pregel nodes - Checkpointer enables persistence, serialization, and time-travel debugging - Pregel implements the execution engine using channels for communication - Graph builds on Pregel adding workflow semantics and node/edge definitions - StateGraph extends Graph with shared state management capabilities ================================================ FILE: resources/claude.md-files/Network-Chronicles/CLAUDE.md ================================================ # Network Chronicles Development Notes ## Common Commands - `chmod +x ` - Make a script executable - `./bin/service-discovery.sh $(whoami)` - Run service discovery manually - `./nc-discover-services.sh` - Run service discovery wrapper script ## Agentic LLM Integration Implementation Plan ### Goals - Create an Agentic LLM to act as "The Architect" character - Add dynamic, personalized interactions with the character - Ensure interactions are contextually aware of player's progress and discoveries - Maintain narrative consistency while allowing for dynamic conversations ### Implementation Steps 1. Create a LLM-powered Architect Agent - Design a system to communicate with an LLM API (e.g., Claude, GPT) - Implement appropriate context management - Define character parameters and constraints - Create conversation history tracking 2. Build context gathering system - Collect player's progress data (discoveries, quests, journal entries) - Gather relevant game state information - Format context for effective LLM prompting 3. Develop triggering mechanisms - Create situations where The Architect can appear - Implement terminal-based chat interface - Add special encrypted message system 4. Ensure narrative consistency - Maintain character voice and motivations - Align interactions with game story progression - Create guardrails to prevent contradictions 5. Add cryptic messaging capabilities - Enable The Architect to provide hints in character - Create system for encrypted or hidden messages - Implement progressive revelation of information ### Technical Implementation #### 1. Architect Agent System (`bin/architect-agent.sh`) - Script to manage communication with LLM API - Handles context management and prompt construction - Processes responses and formats them appropriately - Maintains conversation history in player state #### 2. Context Manager (`bin/utils/context-manager.sh`) - Gathers and processes game state for context - Extracts relevant player discoveries and progress - Formats information for inclusion in prompts - Manages context window limitations #### 3. Terminal Chat Interface (`bin/architect-terminal.sh`) - Provides retro-themed terminal interface for chatting with The Architect - Simulates encrypted connection - Handles input/output with appropriate styling - Maintains immersion with themed elements #### 4. Prompt Template System - Base prompt with character definition and constraints - Dynamic context injection based on game state - System for tracking conversation history - Safety guardrails and response guidelines ### Character Guidelines for The Architect The Architect should embody these characteristics: - Knowledgeable but cryptic - never gives direct answers - Paranoid but methodical - believes they're being monitored - Technical and precise - speaks like an experienced sysadmin - Mysterious but helpful - wants to guide the player - Bound by constraints - can't reveal everything at once ### Technical Requirements - LLM API access (Claude or similar) - Context window management - Conversation history tracking - Reliable error handling - Rate limiting and token management ## Enhanced Service Discovery Implementation ### Implementation Summary We've successfully implemented enhanced service discovery capabilities for Network Chronicles: 1. **Service Detection System** - Created `service-discovery.sh` script that safely detects running services on the local machine - Implemented detection for common services like web servers, databases, and monitoring systems - Added support for identifying unknown services on non-standard ports - Generates appropriate XP rewards and notifications for discoveries 2. **Template-Based Content System** - Created a template processing system (`template-processor.sh`) for dynamic content generation - Implemented service-specific templates for common services (web, database, monitoring) - Added unknown service template for handling custom/unexpected services - Templates include narrative content, challenge definitions, and documentation 3. **Network Map Integration** - Enhanced the network map to visually display discovered services - Added rich ASCII visualization for different service types - Updated the legend to include detailed service information - Added support for unknown/custom services in the visualization 4. **Narrative Integration** - Created new quest for service discovery - Added journal entry generation based on discovered services - Implemented conditional challenge generation based on service combinations - Enhanced storytelling by connecting discoveries to The Architect's disappearance 5. **Game Engine Integration** - Updated the core engine to detect service discovery commands - Added hints for players to guide them to service discovery - Created workflow integration to ensure natural gameplay progression ### Usage To use the enhanced service discovery: 1. Players first need to map the basic network (discover network_gateway and local_network) 2. The game then suggests using service discovery with appropriate hints 3. Players can run `nc-discover-services.sh` to scan for services 4. The network map updates to show discovered services 5. New journal entries and challenges are created based on discoveries ### Technical Details - Service detection uses `ss`, `netstat`, or `lsof` with fallback mechanisms for compatibility - Template system uses JSON templates with variable substitution for customization - Generated content is stored in player's documentation directory - Service-specific challenges and narratives adapt based on combinations of discoveries ### Future Enhancements - Add more service templates for additional service types - Implement network scanning of other hosts beyond localhost - Create more complex multi-stage challenges based on service combinations - Add service fingerprinting to detect specific versions and configurations ================================================ FILE: resources/claude.md-files/Note-Companion/CLAUDE.md ================================================ # File Organizer 2000 - Developer Guide ## Styling Guidelines To avoid styling conflicts between Obsidian's styles and our plugin, follow these guidelines: ### 1. Tailwind Configuration - Tailwind is configured with custom Obsidian CSS variables - Preflight is disabled to avoid conflicts with Obsidian's global styles - Component isolation is achieved through `StyledContainer` wrapper - **No prefix needed** - we removed the `fo-` prefix to allow JIT compilation to work properly ### 2. Component Style Isolation For all new components: 1. Import the `StyledContainer` component from components/ui/utils.tsx: ```tsx import { StyledContainer } from "../../components/ui/utils"; ``` 2. Wrap your component's root element with StyledContainer: ```tsx return ( {/* Your component content */} ); ``` 3. Use the `tw()` function (alias for `cn()`) for class names with proper merging: ```tsx import { tw } from "../../lib/utils"; // ...
{/* content */}
``` 4. For conditional classes, use `tw()` with multiple arguments: ```tsx
{/* content */}
``` ### 3. Using Existing Components Our UI components in `components/ui/` are already configured to use the proper prefixing. Always prefer using these components when available: - Button - Card - Dialog - Badge - etc. ### 4. Troubleshooting Style Issues If you encounter style conflicts: 1. Check if the component is wrapped in a `StyledContainer` 2. Verify all classNames use the `tw()` function 3. Ensure no hardcoded CSS class names are being added (like `card` or `chat-component`) 4. Add more specific reset styles to the `.fo-container` class in styles.css if needed 5. Use browser dev tools to check if Tailwind classes are being applied ## Audio Transcription ### File Size Handling The audio transcription feature uses a two-tier approach to handle files of different sizes: 1. **Small Files (< 4MB)**: Direct upload via multipart/form-data - Fastest method for smaller audio files - Direct to transcription API endpoint 2. **Large Files (4MB - 25MB)**: Pre-signed URL upload to R2 - Bypasses Vercel's 4.5MB body size limit - Plugin gets a pre-signed URL from `/api/create-upload-url` - Uploads directly to R2 cloud storage - Backend downloads from R2 and transcribes - Reuses existing R2 infrastructure from file upload flow 3. **Files > 25MB**: Error message - OpenAI Whisper API has a hard 25MB limit - Users are instructed to compress or split audio ### Implementation Details **Plugin-side** (`packages/plugin/index.ts`): - `transcribeAudio()` (line ~515): Routes to appropriate upload method based on file size - `transcribeAudioViaPresignedUrl()` (line ~547): Handles large file upload via R2 **Server-side**: - `packages/web/app/api/(newai)/transcribe/route.ts`: - Handles both direct uploads and pre-signed URL flow - `handlePresignedUrlTranscription()`: Downloads from R2 and transcribes - `packages/web/app/api/create-upload-url/route.ts`: - Generates pre-signed S3/R2 URLs (shared with file upload flow) ### Benefits of Pre-signed URL Approach - ✅ No Vercel body size limitations (bypasses API gateway) - ✅ Reuses existing R2 infrastructure - ✅ Scalable to larger files (up to 25MB OpenAI limit) - ✅ Better memory usage (streaming from R2) - ✅ Same pattern as mobile app file uploads ================================================ FILE: resources/claude.md-files/Pareto-Mac/CLAUDE.md ================================================ # CLAUDE.md This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository. # Pareto Security Development Guide ## Build & Test Commands - Build: `make build` - Run tests: `make test` - Run single test: `NSUnbufferedIO=YES xcodebuild -project "Pareto Security.xcodeproj" -scheme "Pareto Security" -test-timeouts-enabled NO -only-testing:ParetoSecurityTests/TestClassName/testMethodName -destination platform=macOS test` - Format: `make fmt` or `mint run swiftformat --swiftversion 5 .` - Archive builds: `make archive-debug`, `make archive-release`, `make archive-debug-setapp`, `make archive-release-setapp` - Create DMG: `make dmg` - Create PKG: `make pkg` ## Application Architecture ### Core Components - **Main App (`/Pareto/`)**: SwiftUI-based status bar application - **Helper Tool (`/ParetoSecurityHelper/`)**: XPC service for privileged operations requiring admin access - **Security Checks (`/Pareto/Checks/`)**: Modular security check system organized by category ### Security Checks System The app uses a modular check architecture with these categories: - **Access Security**: Autologin, password policies, SSH keys, screensaver - **System Integrity**: FileVault, Gatekeeper, Boot security, Time Machine - **Firewall & Sharing**: Firewall settings, file sharing, remote access - **macOS Updates**: System updates, automatic updates - **Application Updates**: Third-party app update checks Key files: - `ParetoCheck.swift` - Base class for all security checks - `Checks.swift` - Central registry organizing checks into claims - `Claim.swift` - Groups related checks together ### XPC Helper Tool The `ParetoSecurityHelper` is a privileged helper tool that: - Handles firewall configuration checks - Performs system-level operations requiring admin privileges - Communicates with the main app via XPC ### Distribution Targets - **Direct distribution**: Standard macOS app with auto-updater - **SetApp**: Subscription service integration with separate build target - **Team/Enterprise**: JWT-based licensing for organization management ## Code Style - **Imports**: Group imports alphabetically, Foundation/SwiftUI first, then third-party libraries - **Naming**: Use camelCase for variables/functions, PascalCase for types; be descriptive - **Error Handling**: Use Swift's do/catch with specific error enums - **Types**: Prefer explicit typing, especially for collections - **Formatting**: Max line length 120 chars, use Swift's standard indentation (4 spaces) - **Comments**: Only add comments for complex logic; include header comment for files - **Code Organization**: Group related functionality with MARK comments - **Testing**: All new features should include tests - **Logging**: Use `os_log` for logging, with appropriate log levels This project uses SwiftFormat for auto-formatting. ## Key Dependencies - **Defaults**: User preferences management - **LaunchAtLogin**: Auto-launch functionality - **Alamofire**: HTTP networking for update checks - **JWTDecode**: Team licensing authentication - **Cache**: Response caching layer ## URL Scheme Support The app supports custom URL scheme `paretosecurity://` for: - `reset` - Reset to default settings - `showMenu` - Open status bar menu - `update` - Force update check (not available in SetApp build) - `welcome` - Show welcome window - `runChecks` - Trigger security checks - `debug` - Output detailed check status (supports `?check=` parameter) - `logs` - Copy system logs - `showPrefs` - Show preferences window - `showBeta` - Enable beta channel - `enrollTeam` - Enroll device to team (not available in SetApp build) ## Testing Strategy - Unit tests in `ParetoSecurityTests/` cover core functionality - UI tests in `ParetoSecurityUITests/` test user flows - Tests are organized by feature area (checks, settings, team, updater, welcome) - Use `make test` for full test suite with formatted output via xcbeautify ## Development Notes - The app runs as a status bar utility (`LSUIElement: true`) - Requires Apple Events permission for system automation - No sandboxing to allow system security checks - Uses privileged helper tool for admin operations - Supports both individual and team/enterprise deployments # Pareto Security App Structure ## Overview Pareto Security is a macOS security monitoring app built with SwiftUI. It performs various security checks and uses a privileged helper tool for system-level operations on macOS 15+. ## Core Architecture ### Security Checks System - **Base Class**: `ParetoCheck` (`/Pareto/Checks/ParetoCheck.swift`) - All security checks inherit from this base class - Key properties: `requiresHelper`, `isRunnable`, `isActive` - `menu()` method handles UI display including question mark icons for helper-dependent checks - `infoURL` redirects to helper docs when helper authorization missing - **Check Categories**: - Firewall checks: `/Pareto/Checks/Firewall and Sharing/` - System checks: `/Pareto/Checks/System/` - Application checks: `/Pareto/Checks/Applications/` ### Helper Tool System (macOS 15+ Firewall Checks) - **Helper Tool**: `/ParetoSecurityHelper/main.swift` - XPC service for privileged operations - Static version: `helperToolVersion = "1.0.3"` - Implements `ParetoSecurityHelperProtocol` - Functions: `isFirewallEnabled()`, `isFirewallStealthEnabled()`, `getVersion()` - **Helper Management**: `/Pareto/Extensions/HelperTool.swift` - `HelperToolUtilities`: Static utility methods (non-actor-isolated) - `HelperToolManager`: Main actor class for XPC communication - Expected version: `expectedHelperVersion = "1.0.3"` - Auto-update logic: `ensureHelperIsUpToDate()` - **Helper Configuration**: `/ParetoSecurityHelper/co.niteo.ParetoSecurityHelper.plist` - System daemon configuration - Critical: `BundleProgram` must be `Contents/MacOS/ParetoSecurityHelper` ### UI Structure #### Main Views - **Welcome Screen**: `/Pareto/Views/Welcome/PermissionsView.swift` - Permissions checker with continuous monitoring - Firewall permission section (macOS 15+ only) - Window size: 450×500 - **Settings**: `/Pareto/Views/Settings/` - `AboutSettingsView.swift`: Shows app + helper versions - `PermissionsSettingsView.swift`: Continuous permission monitoring - Various other settings views #### Permission System - **PermissionsChecker**: Continuous monitoring with 2-second timer - **Properties**: `firewallAuthorized`, other permissions - **UI States**: Authorized/Disabled buttons, consistent spacing (20pt) ### Key Technical Concepts #### XPC Communication - **Service Name**: `co.niteo.ParetoSecurityHelper` - **Protocol**: `ParetoSecurityHelperProtocol` - **Connection Management**: Automatic retry, timeout handling - **Error Handling**: Comprehensive logging, graceful degradation #### Concurrency & Threading - **Main Actor**: UI components, HelperToolManager - **Actor Isolation**: HelperToolUtilities for non-isolated static methods - **Async/Await**: Proper continuation handling, avoid semaphores in async contexts - **Thread Safety**: NSLock for XPC continuation management #### Version Management - **Manual Versioning**: Static constants for helper versions - **Update Logic**: Compare current vs expected, auto-reinstall if outdated - **Version Display**: About screen shows both app and helper versions ## Important Implementation Details ### Helper Tool Requirements - **macOS 15+ Only**: Firewall checks require helper on macOS 15+ - **Authorization**: User must approve in System Settings > Login Items - **Question Mark UI**: Shows when helper required but not authorized - **Live Status Checks**: Always use `HelperToolUtilities.isHelperInstalled()`, never cached values ### Common Patterns - **Check Implementation**: Override `requiresHelper` and `isRunnable` in check classes - **Permission Monitoring**: Use Timer with 2-second intervals for continuous checking - **Error Handling**: Use `os_log` for logging, specific error enums for Swift errors - **UI Consistency**: 20pt spacing, medium font weight, secondary colors for labels ### Troubleshooting Tools - **Helper Status**: `launchctl print system/co.niteo.ParetoSecurityHelper` - **Helper Logs**: Check system logs for "Helper:" prefixed messages - **XPC Debugging**: Comprehensive logging throughout XPC chain - **Version Mismatches**: Check both static constants match when updating ## File Locations Reference ### Core Files - **Base Check**: `/Pareto/Checks/ParetoCheck.swift` - **Firewall Check**: `/Pareto/Checks/Firewall and Sharing/Firewall.swift` - **Helper Tool**: `/ParetoSecurityHelper/main.swift` - **Helper Manager**: `/Pareto/Extensions/HelperTool.swift` ### UI Files - **Welcome**: `/Pareto/Views/Welcome/PermissionsView.swift` - **About**: `/Pareto/Views/Settings/AboutSettingsView.swift` - **Permissions Settings**: `/Pareto/Views/Settings/PermissionsSettingsView.swift` ### Configuration - **Helper Plist**: `/ParetoSecurityHelper/co.niteo.ParetoSecurityHelper.plist` - **Build Config**: Use `make build`, `make test`, `make lint`, `make fmt` ## Version Update Procedure 1. Increment `HelperToolUtilities.expectedHelperVersion` in HelperTool.swift 2. Increment `helperToolVersion` in helper's main.swift 3. Both versions must match for proper operation 4. App will auto-detect and reinstall helper on next check ================================================ FILE: resources/claude.md-files/Perplexity-MCP/CLAUDE.md ================================================ # Perplexity MCP Server Guide ## Quick Start 1. **Install Dependencies**: `npm install` 2. **Set API Key**: Add to `.env` file or use environment variable: ``` PERPLEXITY_API_KEY=your_api_key_here ``` 3. **Run Server**: `node server.js` ## Claude Desktop Configuration Add to `claude_desktop_config.json`: ```json { "mcpServers": { "perplexity": { "command": "node", "args": [ "/absolute/path/to/perplexity-mcp/server.js" ], "env": { "PERPLEXITY_API_KEY": "your_perplexity_api_key" } } } } ``` ## NPM Global Installation Run: `npm install -g .` Then configure in Claude Desktop: ```json { "mcpServers": { "perplexity": { "command": "npx", "args": [ "perplexity-mcp" ], "env": { "PERPLEXITY_API_KEY": "your_perplexity_api_key" } } } } ``` ## NVM Users If using NVM, you must use absolute paths to both node and the script: ```json { "mcpServers": { "perplexity": { "command": "/Users/username/.nvm/versions/node/v16.x.x/bin/node", "args": [ "/Users/username/path/to/perplexity-mcp/server.js" ], "env": { "PERPLEXITY_API_KEY": "your_perplexity_api_key" } } } } ``` ## Available Tools - **perplexity_ask**: Send a single question to Perplexity - Default model: `llama-3.1-sonar-small-128k-online` - **perplexity_chat**: Multi-turn conversation with Perplexity - Default model: `mixtral-8x7b-instruct` ## Troubleshooting - Check logs with `cat ~/.claude/logs/perplexity.log` - Ensure your API key is valid and has not expired - Validate your claude_desktop_config.json format - Add verbose logging with the `DEBUG=1` environment variable ## Architecture - Built with the MCP protocol - Communication via stdio transport - Lightweight proxy to Perplexity API ================================================ FILE: resources/claude.md-files/SG-Cars-Trends-Backend/CLAUDE.md ================================================ # CLAUDE.md This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository. ## Documentation Access When working with external libraries or frameworks, use the Context7 MCP tools to get up-to-date documentation: 1. Use `mcp__context7__resolve-library-id` to find the correct library ID for any package 2. Use `mcp__context7__get-library-docs` to retrieve comprehensive documentation and examples This ensures you have access to the latest API documentation for dependencies like Hono, Next.js, Drizzle ORM, Vitest, and others used in this project. # SG Cars Trends - Developer Reference Guide ## Project-Specific CLAUDE.md Files This repository includes directory-specific CLAUDE.md files with detailed guidance for each component: - **[apps/api/CLAUDE.md](apps/api/CLAUDE.md)**: API service development with Hono, workflows, tRPC, and social media integration - **[apps/web/CLAUDE.md](apps/web/CLAUDE.md)**: Web application development with Next.js 15, HeroUI, blog features, and analytics - **[packages/database/CLAUDE.md](packages/database/CLAUDE.md)**: Database schema management with Drizzle ORM, migrations, and TypeScript integration - **[infra/CLAUDE.md](infra/CLAUDE.md)**: Infrastructure configuration with SST v3, AWS deployment, and domain management Refer to these files for component-specific development guidance and best practices. ## Architecture Documentation Comprehensive system architecture documentation with visual diagrams is available in the Mintlify documentation site: - **[apps/docs/architecture/](apps/docs/architecture/)**: Complete architecture documentation with Mermaid diagrams - **[system.md](apps/docs/architecture/system.md)**: System architecture overview and component relationships - **[workflows.md](apps/docs/architecture/workflows.md)**: Data processing workflow sequence diagrams - **[database.md](apps/docs/architecture/database.md)**: Database schema and entity relationships - **[api.md](apps/docs/architecture/api.md)**: API architecture with Hono framework structure - **[infrastructure.md](apps/docs/architecture/infrastructure.md)**: AWS deployment topology and domain strategy - **[social.md](apps/docs/architecture/social.md)**: Social media integration workflows - **[apps/docs/diagrams/](apps/docs/diagrams/)**: Source Mermaid diagram files (`.mmd` format) These architectural resources provide visual understanding of system components, data flows, and integration patterns for effective development and maintenance. # SG Cars Trends Platform - Overview ## Project Overview SG Cars Trends (v4.11.0) is a full-stack platform providing access to Singapore vehicle registration data and Certificate of Entitlement (COE) bidding results. The monorepo includes: - **API Service**: RESTful endpoints for accessing car registration and COE data (Hono framework) - **Web Application**: Next.js frontend with interactive charts, analytics, and blog functionality - **Integrated Updater**: Workflow-based data update system with scheduled jobs that fetch and process data from LTA DataMall (QStash workflows) - **LLM Blog Generation**: Automated blog post creation using Google Gemini AI to analyse market data and generate insights - **Social Media Integration**: Automated posting to Discord, LinkedIn, Telegram, and Twitter when new data is available - **Documentation**: Comprehensive developer documentation using Mintlify ## Commands ### Common Commands All commands use pnpm v10.13.1 as the package manager: **Build Commands:** - Build all: `pnpm build` - Build web: `pnpm build:web` - Build admin: `pnpm build:admin` **Development Commands:** - Develop all: `pnpm dev` - API dev server: `pnpm dev:api` - Web dev server: `pnpm dev:web` - Admin dev server: `pnpm dev:admin` **Testing Commands:** - Test all: `pnpm test` - Test watch: `pnpm test:watch` - Test coverage: `pnpm test:coverage` - Test API: `pnpm test:api` - Test web: `pnpm test:web` - Run single test: `pnpm -F @sgcarstrends/api test -- src/utils/__tests__/slugify.test.ts` **Linting Commands:** - Lint all: `pnpm lint` (uses Biome with automatic formatting) - Lint API: `pnpm lint:api` - Lint web: `pnpm lint:web` **Start Commands:** - Start web: `pnpm start:web` ### Blog Commands - View all blog posts: Navigate to `/blog` on the web application - View specific blog post: Navigate to `/blog/[slug]` where slug is the post's URL slug - Blog posts are automatically generated via workflows when new data is processed - Blog posts include dynamic Open Graph images and SEO metadata ### Social Media Redirect Routes The web application includes domain-based social media redirect routes that provide trackable, SEO-friendly URLs: - **/discord**: Redirects to Discord server with UTM tracking - **/twitter**: Redirects to Twitter profile with UTM tracking - **/instagram**: Redirects to Instagram profile with UTM tracking - **/linkedin**: Redirects to LinkedIn profile with UTM tracking - **/telegram**: Redirects to Telegram channel with UTM tracking - **/github**: Redirects to GitHub organisation with UTM tracking All redirects include standardized UTM parameters: - `utm_source=sgcarstrends` - `utm_medium=social_redirect` - `utm_campaign={platform}_profile` ## UTM Tracking Implementation The platform implements comprehensive UTM (Urchin Tracking Module) tracking for campaign attribution and analytics, following industry best practices: ### UTM Architecture **API UTM Tracking** (`apps/api/src/utils/utm.ts`): - **Social Media Posts**: Automatically adds UTM parameters to all blog links shared on social platforms - **Parameters**: `utm_source={platform}`, `utm_medium=social`, `utm_campaign=blog`, optional `utm_content` and `utm_term` - **Platform Integration**: Used by `SocialMediaManager` for LinkedIn, Twitter, Discord, and Telegram posts **Web UTM Utilities** (`apps/web/src/utils/utm.ts`): - **External Campaigns**: `createExternalCampaignURL()` for email newsletters and external marketing - **Parameter Reading**: `useUTMParams()` React hook for future analytics implementation - **Type Safety**: Full TypeScript support with `UTMParams` interface ### UTM Best Practices **Follows Industry Standards**: - `utm_source`: Platform name (e.g., "linkedin", "twitter", "newsletter") - `utm_medium`: Traffic type (e.g., "social", "email", "referral") - `utm_campaign`: Campaign identifier (e.g., "blog", "monthly_report") - `utm_term`: Keywords or targeting criteria (optional) - `utm_content`: Content variant or placement (optional) **Internal Link Policy**: - **No UTM on internal links**: Follows best practices by not tracking internal navigation - **External campaigns only**: UTM parameters reserved for measuring external traffic sources - **Social media exceptions**: External social platform posts include UTM for attribution ### Database Commands - Run migrations: `pnpm db:migrate` - Check pending migrations: `pnpm db:migrate:check` - Generate migrations: `pnpm db:generate` - Push schema: `pnpm db:push` - Drop database: `pnpm db:drop` ### Documentation Commands - Docs dev server: `pnpm docs:dev` - Docs build: `pnpm docs:build` - Check broken links: `cd apps/docs && pnpm mintlify broken-links` ### Release Commands - Create release: `pnpm release` (runs semantic-release locally, not recommended for production) - Manual version check: `npx semantic-release --dry-run` (preview next version without releasing) **Note**: Semantic releases are now configured to use the "release" branch instead of "main" branch. ### Deployment Commands **Infrastructure Deployment:** - Deploy all to dev: `pnpm deploy:dev` - Deploy all to staging: `pnpm deploy:staging` - Deploy all to production: `pnpm deploy:prod` **API Deployment:** - Deploy API to dev: `pnpm deploy:api:dev` - Deploy API to staging: `pnpm deploy:api:staging` - Deploy API to production: `pnpm deploy:api:prod` **Web Deployment:** - Deploy web to dev: `pnpm deploy:web:dev` - Deploy web to staging: `pnpm deploy:web:staging` - Deploy web to production: `pnpm deploy:web:prod` ## Code Structure - **apps/api**: Unified API service using Hono framework with integrated updater workflows - **src/v1**: API endpoints for data access - **src/lib/workflows**: Workflow-based data update system and social media integration - **src/lib/gemini**: LLM blog generation using Google Gemini AI - **src/routes**: API route handlers including workflow endpoints - **src/config**: Database, Redis, QStash, and platform configurations - **src/trpc**: Type-safe tRPC router with authentication - **apps/web**: Next.js frontend application - **src/app**: Next.js App Router pages and layouts with blog functionality - **src/components**: React components with comprehensive tests - **src/actions**: Server actions for blog and analytics functionality - **src/utils**: Web-specific utility functions - **apps/admin**: Administrative interface for content management (unreleased) - **apps/docs**: Mintlify documentation site - **architecture/**: Complete system architecture documentation with Mermaid diagrams - **diagrams/**: Source Mermaid diagram files for architecture documentation - **packages/database**: Database schema and migrations using Drizzle ORM - **src/db**: Schema definitions for cars, COE, posts, and analytics tables - **migrations**: Database migration files with version tracking - **packages/types**: Shared TypeScript type definitions - **packages/utils**: Shared utility functions and Redis configuration - **packages/config**: Shared configuration utilities (currently unused) - **infra**: SST v3 infrastructure configuration for AWS deployment ## Monorepo Build System The project uses Turbo for efficient monorepo task orchestration: ### Key Build Characteristics - **Dependency-aware**: Tasks automatically run in dependency order with `dependsOn: ["^build"]` and topological ordering - **Caching**: Build outputs cached with intelligent invalidation based on file inputs - **Parallel execution**: Independent tasks run concurrently for optimal performance - **Environment handling**: Strict environment mode with global dependencies on `.env` files, `tsconfig.json`, and `NODE_ENV` - **CI Integration**: Global pass-through environment variables for GitHub and Vercel tokens ### Enhanced Task Configuration - **Build tasks**: Generate `dist/**`, `.next/**` outputs with environment variable support - **Test tasks**: Comprehensive input tracking with topological dependencies - **Development tasks**: `dev` and `test:watch` use `cache: false`, `persistent: true`, and interactive mode - **Migration tasks**: Track `migrations/**/*.sql` files with environment variables for database operations - **Deployment tasks**: Cache-disabled with environment variable support for AWS and Vercel - **TypeScript checking**: Dedicated `typecheck` task with TypeScript configuration dependencies ### Performance Optimization - **TUI Interface**: Enhanced terminal user interface for better development experience - **Strict Environment Mode**: Improved security and reliability with explicit environment variable handling - **Input Optimization**: Uses `$TURBO_DEFAULT$` for standard file tracking patterns - **Coverage Outputs**: Dedicated `coverage/**` directories for test reports - **E2E Outputs**: `test-results/**` and `playwright-report/**` for end-to-end test artifacts ## Dependency Management The project uses pnpm v10.13.1 with catalog for centralized dependency version management. ### pnpm Catalog Centralized version definitions in `pnpm-workspace.yaml` ensure consistency across all workspace packages: ```yaml catalog: '@types/node': ^22.16.4 '@types/react': 19.1.0 '@types/react-dom': 19.1.0 '@vitest/coverage-v8': ^3.2.4 'date-fns': ^3.6.0 next: ^15.4.7 react: 19.1.0 'react-dom': 19.1.0 sst: ^3.17.10 typescript: ^5.8.3 vitest: ^3.2.4 zod: ^3.25.76 ``` ### Catalog Usage Workspace packages reference catalog versions using the `catalog:` protocol: ```json { "dependencies": { "react": "catalog:", "zod": "catalog:" }, "devDependencies": { "typescript": "catalog:", "vitest": "catalog:" } } ``` ### Catalog Benefits - **Single source of truth**: All shared dependency versions defined in one place - **Version consistency**: Ensures all packages use the same versions - **Easier upgrades**: Update version once in catalog, applies everywhere - **Type safety**: TypeScript and types packages aligned across workspace - **Testing consistency**: Testing tools (vitest, typescript) use same versions ### Root vs Catalog - **Root package.json dependencies**: Packages actually installed and used by root workspace (e.g., turbo, semantic-release, husky) - **Catalog entries**: Version definitions that workspace packages reference (e.g., react, next, typescript) - **Both can reference catalog**: Root can use `"sst": "catalog:"` to maintain version consistency ### Workspace Binaries When packages are installed at the root level, their CLI binaries (in `node_modules/.bin`) are automatically available to all workspace packages. This means: - Root dependencies with CLIs (e.g., `sst`, `turbo`) can be used in any workspace package's scripts - No need to duplicate CLI tools in individual packages - Scripts in workspace packages can invoke binaries from root installation ## Code Style - TypeScript with strict type checking (noImplicitAny, strictNullChecks) - **Biome**: Used for formatting, linting, and import organization - Double quotes for strings (enforced) - 2 spaces for indentation (enforced) - Automatic import organization (enforced) - Recommended linting rules enabled - Excludes `.claude`, `.sst`, `coverage`, `migrations`, and `*.d.ts` files - Function/variable naming: camelCase - Class naming: PascalCase - Constants: UPPER_CASE for true constants - Error handling: Use try/catch for async operations with specific error types - Use workspace imports for shared packages: `@sgcarstrends/utils` (includes Redis), `@sgcarstrends/database`, etc. - Path aliases: Use `@api/` for imports in API app - Avoid using `any` type - prefer unknown with type guards - Group imports by: 1) built-in, 2) external, 3) internal - **Commit messages**: Use conventional commit format with SHORT, concise messages enforced by commitlint: - **Preferred style**: Keep messages brief and direct (e.g., `feat: add user auth`, `fix: login error`) - `feat: add new feature` (minor version bump) - `fix: resolve bug` (patch version bump) - `feat!: breaking change` or `feat: add feature\n\nBREAKING CHANGE: description` (major version bump) - `chore:`, `docs:`, `style:`, `refactor:`, `test:` (no version bump) - **IMPORTANT**: Keep commit messages SHORT - single line with max 50 characters preferred, 72 characters absolute maximum - Avoid verbose descriptions - focus on what changed, not why or how - **Optional scopes**: Use scopes for package-specific changes: `feat(api):`, `fix(web):`, `chore(database):` - **Available scopes**: `api`, `web`, `docs`, `database`, `types`, `utils`, `infra`, `deps`, `release` - Root-level changes (CI, workspace setup) can omit scopes: `chore: setup commitlint` - **Spelling**: Use English (Singapore) or English (UK) spellings throughout the entire project ## Git Hooks and Development Workflow The project uses Husky v9+ with automated git hooks for code quality enforcement: ### Pre-commit Hook - **lint-staged**: Automatically runs `pnpm biome check --write` on staged files - Formats code and fixes lint issues before commits - Only processes staged files for performance ### Commit Message Hook - **commitlint**: Validates commit messages against conventional commit format - Enforces optional scope validation for monorepo consistency - Rejects commits with invalid format and provides helpful error messages ### Development Workflow - Git hooks run automatically on `git commit` - Failed hooks prevent commits and display clear error messages - Use `git commit -n` to bypass hooks if needed (not recommended) - Hooks ensure consistent code style and commit message format across the team ## Testing - Testing framework: Vitest - Tests should be in `__tests__` directories next to implementation - Test file suffix: `.test.ts` - Aim for high test coverage, especially for utility functions - Use mock data where appropriate, avoid hitting real APIs in tests - Coverage reports generated with V8 coverage - Test both happy and error paths - For component tests, focus on functionality rather than implementation details ## API Endpoints ### Data Access Endpoints - **/v1/cars**: Car registration data (filterable by month, make, fuel type) - **/v1/coe**: COE bidding results - **/v1/coe/pqp**: COE Prevailing Quota Premium rates - **/v1/makes**: List of car manufacturers - **/v1/months/latest**: Get the latest month with data ### Updater Endpoints - **/workflows/trigger**: Trigger data update workflows (authenticated) - **/workflow/cars**: Car data update workflow endpoint - **/workflow/coe**: COE data update workflow endpoint - **/linkedin**: LinkedIn posting webhook - **/twitter**: Twitter posting webhook - **/discord**: Discord posting webhook - **/telegram**: Telegram posting webhook ## Environment Setup Required environment variables (store in .env.local for local development): - DATABASE_URL: PostgreSQL connection string - SG_CARS_TRENDS_API_TOKEN: Authentication token for API access - UPSTASH_REDIS_REST_URL: Redis URL for caching - UPSTASH_REDIS_REST_TOKEN: Redis authentication token - UPDATER_API_TOKEN: Updater service token for scheduler - LTA_DATAMALL_API_KEY: API key for LTA DataMall (for updater service) - GEMINI_API_KEY: Google Gemini AI API key for blog post generation ## Deployment - AWS Region: ap-southeast-1 (Singapore) - Architecture: arm64 - Domains: sgcarstrends.com (with environment subdomains) - Cloudflare for DNS management - SST framework for infrastructure ## Domain Convention SG Cars Trends uses a standardized domain convention across services: ### API Service - **Convention**: `..` - **Production**: `api.sgcarstrends.com` - **Staging**: `api.staging.sgcarstrends.com` - **Development**: `api.dev.sgcarstrends.com` ### Web Application - **Convention**: `.` with apex domain for production - **Production**: `sgcarstrends.com` (main user-facing domain) - **Staging**: `staging.sgcarstrends.com` - **Development**: `dev.sgcarstrends.com` ### Domain Strategy - **API services** follow strict `..` pattern for clear service identification - **Web frontend** uses user-friendly approach with apex domain in production for optimal SEO and branding - **DNS Management**: All domains managed through Cloudflare with automatic SSL certificate provisioning - **Cross-Origin Requests**: CORS configured to allow appropriate domain combinations across environments ### Adding New Services - Backend services: Follow API pattern `..sgcarstrends.com` - Frontend services: Evaluate based on user interaction needs (apex domain vs service subdomain) ## Data Models The platform uses PostgreSQL with Drizzle ORM for type-safe database operations: - **cars**: Car registrations by make, fuel type, and vehicle type with strategic indexing - **coe**: COE bidding results (quota, bids, premium by category) - **coePQP**: Prevailing Quota Premium rates - **posts**: LLM-generated blog posts with metadata, tags, SEO information, and analytics - **analyticsTable**: Page views and visitor tracking for performance monitoring ### Database Configuration The database uses **snake_case** column naming convention configured in both Drizzle config and client setup. This ensures consistent naming patterns between the database schema and TypeScript types. *See [packages/database/CLAUDE.md](packages/database/CLAUDE.md) for detailed schema definitions, migration workflows, and TypeScript integration patterns.* ## Workflow Architecture The integrated updater service uses a workflow-based architecture with: ### Key Components - **Workflows** (`src/lib/workflows/`): Cars and COE data processing workflows with integrated blog generation - **Task Processing** (`src/lib/workflows/workflow.ts`): Common processing logic with Redis-based timestamp tracking - **Updater Core** (`src/lib/updater/`): File download, checksum verification, CSV processing, and database updates (with helpers under `src/lib/updater/services/`) - **Blog Generation** (`src/lib/workflows/posts.ts`): LLM-powered blog post creation using Google Gemini AI - **Post Management** (`src/lib/workflows/save-post.ts`): Blog post persistence with slug generation and duplicate prevention - **Social Media** (`src/lib/social/*/`): Platform-specific posting functionality (Discord, LinkedIn, Telegram, Twitter) - **QStash Integration** (`src/config/qstash.ts`): Message queue functionality for workflow execution ### Workflow Flow 1. Workflows triggered via HTTP endpoints or scheduled QStash cron jobs 2. Files downloaded and checksums verified to prevent redundant processing 3. New data inserted into database in batches 4. Updates published to configured social media platforms when data changes 5. **Blog Generation**: LLM analyzes processed data to create comprehensive blog posts with market insights 6. **Blog Publication**: Generated posts saved to database with SEO-optimized slugs and metadata 7. **Blog Promotion**: New blog posts automatically announced across social media platforms 8. Comprehensive error handling with Discord notifications for failures ### Design Principles - Modular and independent workflows - Checksum-based redundancy prevention - Batch database operations for efficiency - Conditional social media publishing based on environment and data changes ## LLM Blog Generation The platform features automated blog post generation using Google Gemini AI to create market insights from processed data: ### Blog Generation Process 1. **Data Analysis**: LLM analyzes car registration or COE bidding data for the latest month 2. **Content Creation**: AI generates comprehensive blog posts with market insights, trends, and analysis 3. **Structured Output**: Posts include executive summaries, data tables, and professional market analysis 4. **SEO Optimization**: Automatic generation of titles, descriptions, and structured data 5. **Duplicate Prevention**: Slug-based system prevents duplicate blog posts for the same data period ### Blog Content Features - **Cars Posts**: Analysis of registration trends, fuel type distribution, vehicle type breakdowns - **COE Posts**: Bidding results analysis, premium trends, market competition insights - **Data Tables**: Markdown tables for fuel type and vehicle type breakdowns - **Market Insights**: Professional analysis of trends and implications for car buyers - **Reading Time**: Automatic calculation of estimated reading time - **AI Attribution**: Clear labeling of AI-generated content with model version tracking ### Blog Publication - **Automatic Scheduling**: Blog posts generated only when both COE bidding exercises are complete (for COE posts) - **Social Media Promotion**: New blog posts automatically announced across all configured platforms - **SEO Integration**: Dynamic Open Graph images, structured data, and canonical URLs - **Content Management**: Posts stored with metadata including generation details and data source month ## Shared Package Architecture The project uses shared packages for cross-application concerns: ### Redis Configuration (`packages/utils`) Redis configuration is centralized in the `@sgcarstrends/utils` package to eliminate duplication: - **Shared Redis Instance**: Exported `redis` client configured with Upstash credentials - **Environment Variables**: Automatically reads `UPSTASH_REDIS_REST_URL` and `UPSTASH_REDIS_REST_TOKEN` - **Usage Pattern**: Import via `import { redis } from "@sgcarstrends/utils"` - **Applications**: Used by both API service (caching, workflows) and web application (analytics, view tracking) This consolidation ensures consistent Redis configuration across all applications and simplifies environment management. ### Other Shared Utilities - **Type Definitions**: `@sgcarstrends/types` for shared TypeScript interfaces - **Database Schema**: `@sgcarstrends/database` for Drizzle ORM schemas and migrations - **Utility Functions**: Date formatting, percentage calculations, and key generation utilities ## Release Process Releases are automated using semantic-release based on conventional commits: - **Automatic releases**: Triggered on push to main branch via GitHub Actions - **Version format**: Uses "v" prefix (v1.0.0, v1.1.0, v2.0.0) - **Unified versioning**: All workspace packages receive the same version bump - **Changelog**: Automatically generated and updated - **GitHub releases**: Created automatically with release notes ## Contribution Guidelines - Create feature branches from main branch - **Use conventional commit messages** following the format specified in Code Style section - Submit PRs with descriptive titles and summaries - Ensure CI passes (tests, lint, typecheck) before requesting review - Maintain backward compatibility for public APIs - Follow project spelling and commit message conventions as outlined in Code Style section - **Use GitHub issue templates** when available - always follow established templates when creating or managing GitHub issues ================================================ FILE: resources/claude.md-files/SPy/CLAUDE.md ================================================ # SPy Language - Dev Reference ## General behavior of claude code - NEVER run tests automatically unless explicitly asked - when asked to write a test, write just the test without trying to fix it - avoid writing useless comments: if you need to write a comment, explain WHY the code does something instead of WHAT it does ## Common Commands - When running tests, always use the venv: e.g. `./venv/bin/pytest' - Run all tests: `pytest` - Run single test: `pytest spy/tests/path/to/test_file.py::TestClass::test_function` - Run backend-specific tests: `pytest -m interp` or `-m C` or `-m doppler` - Type checking: `mypy` - Test shortcut: `source pytest-shortcut.sh` (enables `p` as pytest alias with tab completion) ## Compile SPy Code ```bash spy your_file.spy # Execute (default) spy -C your_file.spy # Generate C code spy -c your_file.spy # Compile to executable spy -O 1 -g your_file.spy # With optimization and debug symbols ``` ## Code Style Guidelines - Use strict typing (mypy enforced) - Classes: PascalCase (`CompilerTest`) - Functions/methods: snake_case (`compile_module()`) - Constants: SCREAMING_SNAKE_CASE (`ALL_BACKENDS`) - Organize imports by standard Python conventions - Prefer specific imports: `from spy.errors import SPyError` - Tests inherit from `CompilerTest` base class - Use backend-specific decorators for test filtering (`@only_interp`, `@skip_backends`) ## GH PR Guidelines - When creating a PR, describe what you did, but don't include the "test plan" section. ================================================ FILE: resources/claude.md-files/TPL/CLAUDE.md ================================================ # TPL-GO Developer Guide ## Build Commands - `make` - Format and build project - `make deps` - Get all dependencies - `make test` - Run all tests ## Test Commands - `go test -v ./...` - Run all tests verbosely - `go test -v -run=TestName` - Run a specific test by name ## Code Style - Use `goimports` for formatting (run via `make`) - Follow standard Go formatting conventions - Group imports: standard library first, then third-party - Use PascalCase for exported types/methods, camelCase for variables - Add comments for public API and complex logic - Place related functionality in logically named files ## Error Handling - Use custom `Error` type with detailed context - Include error wrapping with `Unwrap()` method - Return errors with proper context information (line, position) ## Testing - Write table-driven tests with clear input/output expectations - Use package `tpl_test` for external testing perspective - Include detailed error messages (expected vs. actual) - Test every exported function and error case ## Dependencies - Minimum Go version: 1.23.0 - External dependencies managed through go modules ## Modernization Notes - Use `errors.Is()` and `errors.As()` for error checking - Replace `interface{}` with `any` type alias - Replace type assertions with type switches where appropriate - Use generics for type-safe operations - Implement context cancellation handling for long operations - Add proper docstring comments for exported functions and types - Use log/slog for structured logging - Add linting and static analysis tools ================================================ FILE: resources/claude.md-files/claude-code-mcp-enhanced/CLAUDE.md ================================================ # GLOBAL CODING STANDARDS > Reference guide for all project development. For detailed task planning, see [TASK_PLAN_GUIDE.md](./docs/memory_bank/guides/TASK_PLAN_GUIDE.md) ## 🔴 AGENT INSTRUCTIONS **IMPORTANT**: As an agent, you MUST read and follow ALL guidelines in this document BEFORE executing any task in a task list. DO NOT skip or ignore any part of these standards. These standards supersede any conflicting instructions you may have received previously. ## Project Structure ``` project_name/ ├── docs/ │ ├── CHANGELOG.md │ ├── memory_bank/ │ └── tasks/ ├── examples/ ├── pyproject.toml ├── README.md ├── src/ │ └── project_name/ ├── tests/ │ ├── fixtures/ │ └── project_name/ └── uv.lock ``` - **Package Management**: Always use uv with pyproject.toml, never pip - **Mirror Structure**: examples/, tests/ mirror the project structure in src/ - **Documentation**: Keep comprehensive docs in docs/ directory ## Module Requirements - **Size**: Maximum 500 lines of code per file - **Documentation Header**: Every file must include: - Description of purpose - Links to third-party package documentation - Sample input - Expected output - **Validation Function**: Every file needs a main block (`if __name__ == "__main__":`) that tests with real data ## Architecture Principles - **Function-First**: Prefer simple functions over classes - **Class Usage**: Only use classes when: - Maintaining state - Implementing data validation models - Following established design patterns - **Async Code**: Never use `asyncio.run()` inside functions - only in main blocks - **Type Hints**: Use the typing library for clear type annotations to improve code understanding and tooling - Type hints should be used for all function parameters and return values - Use type hints for key variables where it improves clarity - Prefer concrete types over Any when possible - Do not add type hints if they significantly reduce code readability ```python # Good type hint usage: from typing import Dict, List, Optional, Union, Tuple def process_document(doc_id: str, options: Optional[Dict[str, str]] = None) -> Dict[str, Any]: """Process a document with optional configuration.""" # Implementation return result # Simple types don't need annotations inside functions if obvious: def get_user_name(user_id: int) -> str: name = "John" # Type inference works here, no annotation needed return name ``` - **NO Conditional Imports**: - Never use try/except blocks for imports of required packages - If a package is in pyproject.toml, import it directly at the top of the file - Handle specific errors during usage, not during import - Only use conditional imports for truly optional features (rare) ```python # INCORRECT - DO NOT DO THIS: try: import tiktoken TIKTOKEN_AVAILABLE = True except ImportError: TIKTOKEN_AVAILABLE = False # CORRECT APPROACH: import tiktoken # Listed in pyproject.toml as a dependency def count_tokens(text, model="gpt-3.5-turbo"): # Handle errors during usage, not import try: encoding = tiktoken.encoding_for_model(model) return len(encoding.encode(text)) except Exception as e: logger.error(f"Token counting error: {e}") return len(text) // 4 # Fallback estimation ``` ## Validation & Testing - **Real Data**: Always test with actual data, never fake inputs - **Expected Results**: Verify outputs against concrete expected results - **No Mocking**: NEVER mock core functionality - **MagicMock Ban**: MagicMock is strictly forbidden for testing core functionality - **Meaningful Assertions**: Use assertions that verify specific expected values - **🔴 Usage Functions Before Tests**: ALL relevant usage functions MUST successfully output expected results BEFORE any creation of tests. Tests are a future-proofing step when Agents improve at test-writing capabilities. - **🔴 Results Before Lint**: ALL usage functionality MUST produce expected results BEFORE addressing ANY Pylint or other linter warnings. Functionality correctness ALWAYS comes before style compliance. - **🔴 External Research After 3 Failures**: If a usage function fails validation 3 consecutive times with different approaches, the agent MUST use external research tools (perplexity_ask, perplexity_research, web_search) to find current best practices, package updates, or solutions for the specific problem. Document the research findings in comments. - **🔴 NO UNCONDITIONAL "TESTS PASSED" MESSAGES**: NEVER include unconditional "All Tests Passed" or similar validation success messages. Success messages MUST be conditional on ACTUAL test results. - **🔴 TRACK ALL VALIDATION FAILURES**: ALWAYS track ALL validation failures and report them at the end. NEVER stop validation after the first failure. ```python # INCORRECT - DO NOT DO THIS: if __name__ == "__main__": test_data = "test input" result = process_data(test_data) # This always prints regardless of success/failure print("✅ VALIDATION PASSED - All tests successful") # CORRECT IMPLEMENTATION: if __name__ == "__main__": import sys # List to track all validation failures all_validation_failures = [] total_tests = 0 # Test 1: Basic functionality total_tests += 1 test_data = "example input" result = process_data(test_data) expected = {"key": "processed value"} if result != expected: all_validation_failures.append(f"Basic test: Expected {expected}, got {result}") # Test 2: Edge case handling total_tests += 1 edge_case = "empty" edge_result = process_data(edge_case) edge_expected = {"key": ""} if edge_result != edge_expected: all_validation_failures.append(f"Edge case: Expected {edge_expected}, got {edge_result}") # Test 3: Error handling total_tests += 1 try: error_result = process_data(None) all_validation_failures.append("Error handling: Expected exception for None input, but no exception was raised") except ValueError: # This is expected - test passes pass except Exception as e: all_validation_failures.append(f"Error handling: Expected ValueError for None input, but got {type(e).__name__}") # Final validation result if all_validation_failures: print(f"❌ VALIDATION FAILED - {len(all_validation_failures)} of {total_tests} tests failed:") for failure in all_validation_failures: print(f" - {failure}") sys.exit(1) # Exit with error code else: print(f"✅ VALIDATION PASSED - All {total_tests} tests produced expected results") print("Function is validated and formal tests can now be written") sys.exit(0) # Exit with success code ``` ## Standard Components - **Logging**: Always use loguru for logging ```python from loguru import logger # Configure logger logger.add("app.log", rotation="10 MB") ``` - **CLI Structure**: Every command-line tool must use typer in a `cli.py` file ```python import typer app = typer.Typer() @app.command() def command_name(param: str = typer.Argument(..., help="Description")): """Command description.""" # Implementation if __name__ == "__main__": app() ``` ## Package Selection - **Research First**: Always research packages before adding dependencies - **95/5 Rule**: Use 95% package functionality, 5% customization - **Documentation**: Include links to current documentation in comments ## Development Priority 1. Working Code 2. Validation 3. Readability 4. Static Analysis (address only after code works) ## Execution Standards - Run scripts with: `uv run script.py` - Use environment variables: `env VAR_NAME="value" uv run command` ## Task Planning All task plans must follow the standard structure defined in the Task Plan Guide: - **Document Location**: Store in `docs/memory_bank/guides/TASK_PLAN_GUIDE.md` - **Core Principles**: - Detailed task descriptions for consistent understanding - Verification-first development approach - Version control discipline with frequent commits - Human-friendly documentation with usage examples - **Structure Elements**: - Clear objectives and requirements - Step-by-step implementation tasks - Verification methods for each function - Usage tables with examples - Version control plan - Progress tracking Refer to the full [Task Plan Guide](./docs/memory_bank/guides/TASK_PLAN_GUIDE.md) for comprehensive details. ## 🔴 VALIDATION OUTPUT REQUIREMENTS - **NEVER print "All Tests Passed" or similar unless ALL tests actually passed** - **ALWAYS verify actual results against expected results BEFORE printing ANY success message** - **ALWAYS test multiple cases, including normal cases, edge cases, and error handling** - **ALWAYS track ALL failures and report them at the end - don't stop at first failure** - **ALL validation functions MUST exit with code 1 if ANY tests fail** - **ALL validation functions MUST exit with code 0 ONLY if ALL tests pass** - **ALWAYS include count of failed tests and total tests in the output (e.g., "3 of 5 tests failed")** - **ALWAYS include details of each failure when tests fail** - **NEVER include irrelevant test output that could hide failures** - **ALWAYS structure validation in a way that explicitly checks EACH test case** ## 🔴 COMPLIANCE CHECK As an agent, before completing a task, verify that your work adheres to ALL standards in this document. Confirm each of the following: 1. All files have appropriate documentation headers 2. Each module has a working validation function that produces expected results 3. Type hints are used properly and consistently 4. All functionality is validated with real data before addressing linting issues 5. No asyncio.run() is used inside functions - only in the main block 6. Code is under the 500-line limit for each file 7. If function failed validation 3+ times, external research was conducted and documented 8. Validation functions NEVER include unconditional "All Tests Passed" messages 9. Validation functions ONLY report success if explicitly verified by comparing actual to expected results 10. Validation functions track and report ALL failures, not just the first one encountered 11. Validation output includes count of failed tests out of total tests run If any standard is not met, fix the issue before submitting the work. ================================================ FILE: resources/official-documentation/Anthropic-Quickstarts/CLAUDE.md ================================================ # Anthropic Quickstarts Development Guide ## Computer-Use Demo ### Setup & Development - **Setup environment**: `./setup.sh` - **Build Docker**: `docker build . -t computer-use-demo:local` - **Run container**: `docker run -e ANTHROPIC_API_KEY=$ANTHROPIC_API_KEY -v $(pwd)/computer_use_demo:/home/computeruse/computer_use_demo/ -v $HOME/.anthropic:/home/computeruse/.anthropic -p 5900:5900 -p 8501:8501 -p 6080:6080 -p 8080:8080 -it computer-use-demo:local` ### Testing & Code Quality - **Lint**: `ruff check .` - **Format**: `ruff format .` - **Typecheck**: `pyright` - **Run tests**: `pytest` - **Run single test**: `pytest tests/path_to_test.py::test_name -v` ### Code Style - **Python**: snake_case for functions/variables, PascalCase for classes - **Imports**: Use isort with combine-as-imports - **Error handling**: Use custom ToolError for tool errors - **Types**: Add type annotations for all parameters and returns - **Classes**: Use dataclasses and abstract base classes ## Customer Support Agent ### Setup & Development - **Install dependencies**: `npm install` - **Run dev server**: `npm run dev` (full UI) - **UI variants**: `npm run dev:left` (left sidebar), `npm run dev:right` (right sidebar), `npm run dev:chat` (chat only) - **Lint**: `npm run lint` - **Build**: `npm run build` (full UI), see package.json for variants ### Code Style - **TypeScript**: Strict mode with proper interfaces - **Components**: Function components with React hooks - **Formatting**: Follow ESLint Next.js configuration - **UI components**: Use shadcn/ui components library ## Financial Data Analyst ### Setup & Development - **Install dependencies**: `npm install` - **Run dev server**: `npm run dev` - **Lint**: `npm run lint` - **Build**: `npm run build` ### Code Style - **TypeScript**: Strict mode with proper type definitions - **Components**: Function components with type annotations - **Visualization**: Use Recharts library for data visualization - **State management**: React hooks for state ================================================ FILE: resources/official-documentation/Claude-Code-GitHub-Actions/ci-failure-auto-fix.yml ================================================ name: Auto Fix CI Failures on: workflow_run: workflows: ["CI"] types: - completed permissions: contents: write pull-requests: write actions: read issues: write id-token: write # Required for OIDC token exchange jobs: auto-fix: if: | github.event.workflow_run.conclusion == 'failure' && github.event.workflow_run.pull_requests[0] && !startsWith(github.event.workflow_run.head_branch, 'claude-auto-fix-ci-') runs-on: ubuntu-latest steps: - name: Checkout code uses: actions/checkout@v4 with: ref: ${{ github.event.workflow_run.head_branch }} fetch-depth: 0 token: ${{ secrets.GITHUB_TOKEN }} - name: Setup git identity run: | git config --global user.email "claude[bot]@users.noreply.github.com" git config --global user.name "claude[bot]" - name: Create fix branch id: branch run: | BRANCH_NAME="claude-auto-fix-ci-${{ github.event.workflow_run.head_branch }}-${{ github.run_id }}" git checkout -b "$BRANCH_NAME" echo "branch_name=$BRANCH_NAME" >> $GITHUB_OUTPUT - name: Get CI failure details id: failure_details uses: actions/github-script@v7 with: script: | const run = await github.rest.actions.getWorkflowRun({ owner: context.repo.owner, repo: context.repo.repo, run_id: ${{ github.event.workflow_run.id }} }); const jobs = await github.rest.actions.listJobsForWorkflowRun({ owner: context.repo.owner, repo: context.repo.repo, run_id: ${{ github.event.workflow_run.id }} }); const failedJobs = jobs.data.jobs.filter(job => job.conclusion === 'failure'); let errorLogs = []; for (const job of failedJobs) { const logs = await github.rest.actions.downloadJobLogsForWorkflowRun({ owner: context.repo.owner, repo: context.repo.repo, job_id: job.id }); errorLogs.push({ jobName: job.name, logs: logs.data }); } return { runUrl: run.data.html_url, failedJobs: failedJobs.map(j => j.name), errorLogs: errorLogs }; - name: Fix CI failures with Claude id: claude uses: anthropics/claude-code-action@v1 with: prompt: | /fix-ci Failed CI Run: ${{ fromJSON(steps.failure_details.outputs.result).runUrl }} Failed Jobs: ${{ join(fromJSON(steps.failure_details.outputs.result).failedJobs, ', ') }} PR Number: ${{ github.event.workflow_run.pull_requests[0].number }} Branch Name: ${{ steps.branch.outputs.branch_name }} Base Branch: ${{ github.event.workflow_run.head_branch }} Repository: ${{ github.repository }} Error logs: ${{ toJSON(fromJSON(steps.failure_details.outputs.result).errorLogs) }} anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }} claude_args: "--allowedTools 'Edit,MultiEdit,Write,Read,Glob,Grep,LS,Bash(git:*),Bash(bun:*),Bash(npm:*),Bash(npx:*),Bash(gh:*)'" ================================================ FILE: resources/official-documentation/Claude-Code-GitHub-Actions/claude.yml ================================================ name: Claude Code on: issue_comment: types: [created] pull_request_review_comment: types: [created] issues: types: [opened, assigned] pull_request_review: types: [submitted] jobs: claude: if: | (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) || (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) || (github.event_name == 'pull_request_review' && contains(github.event.review.body, '@claude')) || (github.event_name == 'issues' && (contains(github.event.issue.body, '@claude') || contains(github.event.issue.title, '@claude'))) runs-on: ubuntu-latest permissions: contents: write pull-requests: write issues: write id-token: write actions: read # Required for Claude to read CI results on PRs steps: - name: Checkout repository uses: actions/checkout@v4 with: fetch-depth: 1 - name: Run Claude Code id: claude uses: anthropics/claude-code-action@v1 with: anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }} # Optional: Customize the trigger phrase (default: @claude) # trigger_phrase: "/claude" # Optional: Trigger when specific user is assigned to an issue # assignee_trigger: "claude-bot" # Optional: Configure Claude's behavior with CLI arguments # claude_args: | # --model claude-opus-4-1-20250805 # --max-turns 10 # --allowedTools "Bash(npm install),Bash(npm run build),Bash(npm run test:*),Bash(npm run lint:*)" # --system-prompt "Follow our coding standards. Ensure all new code has tests. Use TypeScript for new files." # Optional: Advanced settings configuration # settings: | # { # "env": { # "NODE_ENV": "test" # } # } ================================================ FILE: resources/official-documentation/Claude-Code-GitHub-Actions/issue-deduplication.yml ================================================ name: Issue Deduplication on: issues: types: [opened] jobs: deduplicate: runs-on: ubuntu-latest timeout-minutes: 10 permissions: contents: read issues: write id-token: write steps: - name: Checkout repository uses: actions/checkout@v4 with: fetch-depth: 1 - name: Check for duplicate issues uses: anthropics/claude-code-action@v1 with: prompt: | Analyze this new issue and check if it's a duplicate of existing issues in the repository. Issue: #${{ github.event.issue.number }} Repository: ${{ github.repository }} Your task: 1. Use mcp__github__get_issue to get details of the current issue (#${{ github.event.issue.number }}) 2. Search for similar existing issues using mcp__github__search_issues with relevant keywords from the issue title and body 3. Compare the new issue with existing ones to identify potential duplicates Criteria for duplicates: - Same bug or error being reported - Same feature request (even if worded differently) - Same question being asked - Issues describing the same root problem If you find duplicates: - Add a comment on the new issue linking to the original issue(s) - Apply a "duplicate" label to the new issue - Be polite and explain why it's a duplicate - Suggest the user follow the original issue for updates If it's NOT a duplicate: - Don't add any comments - You may apply appropriate topic labels based on the issue content Use these tools: - mcp__github__get_issue: Get issue details - mcp__github__search_issues: Search for similar issues - mcp__github__list_issues: List recent issues if needed - mcp__github__create_issue_comment: Add a comment if duplicate found - mcp__github__update_issue: Add labels Be thorough but efficient. Focus on finding true duplicates, not just similar issues. anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }} claude_args: | --allowedTools "mcp__github__get_issue,mcp__github__search_issues,mcp__github__list_issues,mcp__github__create_issue_comment,mcp__github__update_issue,mcp__github__get_issue_comments" ================================================ FILE: resources/official-documentation/Claude-Code-GitHub-Actions/issue-triage.yml ================================================ name: Claude Issue Triage description: Run Claude Code for issue triage in GitHub Actions on: issues: types: [opened] jobs: triage-issue: runs-on: ubuntu-latest timeout-minutes: 10 permissions: contents: read issues: write steps: - name: Checkout repository uses: actions/checkout@v4 with: fetch-depth: 0 - name: Run Claude Code for Issue Triage uses: anthropics/claude-code-action@v1 with: # NOTE: /label-issue here requires a .claude/commands/label-issue.md file in your repo (see this repo's .claude directory for an example) prompt: "/label-issue REPO: ${{ github.repository }} ISSUE_NUMBER${{ github.event.issue.number }}" anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }} allowed_non_write_users: "*" # Required for issue triage workflow, if users without repo write access create issues github_token: ${{ secrets.GITHUB_TOKEN }} ================================================ FILE: resources/official-documentation/Claude-Code-GitHub-Actions/manual-code-analysis.yml ================================================ name: Claude Commit Analysis on: workflow_dispatch: inputs: analysis_type: description: "Type of analysis to perform" required: true type: choice options: - summarize-commit - security-review default: "summarize-commit" jobs: analyze-commit: runs-on: ubuntu-latest permissions: contents: read pull-requests: write issues: write id-token: write steps: - name: Checkout repository uses: actions/checkout@v4 with: fetch-depth: 2 # Need at least 2 commits to analyze the latest - name: Run Claude Analysis uses: anthropics/claude-code-action@v1 with: anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }} prompt: | REPO: ${{ github.repository }} BRANCH: ${{ github.ref_name }} Analyze the latest commit in this repository. ${{ github.event.inputs.analysis_type == 'summarize-commit' && 'Task: Provide a clear, concise summary of what changed in the latest commit. Include the commit message, files changed, and the purpose of the changes.' || '' }} ${{ github.event.inputs.analysis_type == 'security-review' && 'Task: Review the latest commit for potential security vulnerabilities. Check for exposed secrets, insecure coding patterns, dependency vulnerabilities, or any other security concerns. Provide specific recommendations if issues are found.' || '' }} ================================================ FILE: resources/official-documentation/Claude-Code-GitHub-Actions/pr-review-comprehensive.yml ================================================ name: PR Review with Progress Tracking # This example demonstrates how to use the track_progress feature to get # visual progress tracking for PR reviews, similar to v0.x agent mode. on: pull_request: types: [opened, synchronize, ready_for_review, reopened] jobs: review-with-tracking: runs-on: ubuntu-latest permissions: contents: read pull-requests: write id-token: write steps: - name: Checkout repository uses: actions/checkout@v4 with: fetch-depth: 1 - name: PR Review with Progress Tracking uses: anthropics/claude-code-action@v1 with: anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }} # Enable progress tracking track_progress: true # Your custom review instructions prompt: | REPO: ${{ github.repository }} PR NUMBER: ${{ github.event.pull_request.number }} Perform a comprehensive code review with the following focus areas: 1. **Code Quality** - Clean code principles and best practices - Proper error handling and edge cases - Code readability and maintainability 2. **Security** - Check for potential security vulnerabilities - Validate input sanitization - Review authentication/authorization logic 3. **Performance** - Identify potential performance bottlenecks - Review database queries for efficiency - Check for memory leaks or resource issues 4. **Testing** - Verify adequate test coverage - Review test quality and edge cases - Check for missing test scenarios 5. **Documentation** - Ensure code is properly documented - Verify README updates for new features - Check API documentation accuracy Provide detailed feedback using inline comments for specific issues. Use top-level comments for general observations or praise. # Tools for comprehensive PR review claude_args: | --allowedTools "mcp__github_inline_comment__create_inline_comment,Bash(gh pr comment:*),Bash(gh pr diff:*),Bash(gh pr view:*)" # When track_progress is enabled: # - Creates a tracking comment with progress checkboxes # - Includes all PR context (comments, attachments, images) # - Updates progress as the review proceeds # - Marks as completed when done ================================================ FILE: resources/official-documentation/Claude-Code-GitHub-Actions/pr-review-filtered-authors.yml ================================================ name: Claude Review - Specific Authors on: pull_request: types: [opened, synchronize] jobs: review-by-author: # Only run for PRs from specific authors if: | github.event.pull_request.user.login == 'developer1' || github.event.pull_request.user.login == 'developer2' || github.event.pull_request.user.login == 'external-contributor' runs-on: ubuntu-latest permissions: contents: read pull-requests: read id-token: write steps: - name: Checkout repository uses: actions/checkout@v4 with: fetch-depth: 1 - name: Review PR from Specific Author uses: anthropics/claude-code-action@v1 with: anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }} prompt: | REPO: ${{ github.repository }} PR NUMBER: ${{ github.event.pull_request.number }} Please provide a thorough review of this pull request. Note: The PR branch is already checked out in the current working directory. Since this is from a specific author that requires careful review, please pay extra attention to: - Adherence to project coding standards - Proper error handling - Security best practices - Test coverage - Documentation Provide detailed feedback and suggestions for improvement. claude_args: | --allowedTools "mcp__github_inline_comment__create_inline_comment,Bash(gh pr comment:*), Bash(gh pr diff:*), Bash(gh pr view:*)" ================================================ FILE: resources/official-documentation/Claude-Code-GitHub-Actions/pr-review-filtered-paths.yml ================================================ name: Claude Review - Path Specific on: pull_request: types: [opened, synchronize] paths: # Only run when specific paths are modified - "src/**/*.js" - "src/**/*.ts" - "api/**/*.py" # You can add more specific patterns as needed jobs: claude-review-paths: runs-on: ubuntu-latest permissions: contents: read pull-requests: read id-token: write steps: - name: Checkout repository uses: actions/checkout@v4 with: fetch-depth: 1 - name: Claude Code Review uses: anthropics/claude-code-action@v1 with: anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }} prompt: | REPO: ${{ github.repository }} PR NUMBER: ${{ github.event.pull_request.number }} Please review this pull request focusing on the changed files. Note: The PR branch is already checked out in the current working directory. Provide feedback on: - Code quality and adherence to best practices - Potential bugs or edge cases - Performance considerations - Security implications - Suggestions for improvement Since this PR touches critical source code paths, please be thorough in your review and provide inline comments where appropriate. claude_args: | --allowedTools "mcp__github_inline_comment__create_inline_comment,Bash(gh pr comment:*), Bash(gh pr diff:*), Bash(gh pr view:*)" ================================================ FILE: resources/slash-commands/act/act.md ================================================ Follow RED-GREEN-REFACTOR cycle approch based on @~/.claude/CLAUDE.md: 1. Open todo.md and select the first unchecked items to work on. 2. Carefully plan each item, then share your plan 3. Create a new branch and implement your plan 4. Check off the items on todo.md 5. Commit your changes ================================================ FILE: resources/slash-commands/add-to-changelog/add-to-changelog.md ================================================ # Update Changelog This command adds a new entry to the project's CHANGELOG.md file. ## Usage ``` /add-to-changelog ``` Where: - `` is the version number (e.g., "1.1.0") - `` is one of: "added", "changed", "deprecated", "removed", "fixed", "security" - `` is the description of the change ## Examples ``` /add-to-changelog 1.1.0 added "New markdown to BlockDoc conversion feature" ``` ``` /add-to-changelog 1.0.2 fixed "Bug in HTML renderer causing incorrect output" ``` ## Description This command will: 1. Check if a CHANGELOG.md file exists and create one if needed 2. Look for an existing section for the specified version - If found, add the new entry under the appropriate change type section - If not found, create a new version section with today's date 3. Format the entry according to Keep a Changelog conventions 4. Commit the changes if requested The CHANGELOG follows the [Keep a Changelog](https://keepachangelog.com/) format and [Semantic Versioning](https://semver.org/). ## Implementation The command should: 1. Parse the arguments to extract version, change type, and message 2. Read the existing CHANGELOG.md file if it exists 3. If the file doesn't exist, create a new one with standard header 4. Check if the version section already exists 5. Add the new entry in the appropriate section 6. Write the updated content back to the file 7. Suggest committing the changes Remember to update the package version in `__init__.py` and `setup.py` if this is a new version. ================================================ FILE: resources/slash-commands/clean/clean.md ================================================ Fix all black, isort, flake8 and mypy issues in the entire codebase ================================================ FILE: resources/slash-commands/commit/commit.md ================================================ # Claude Command: Commit This command helps you create well-formatted commits with conventional commit messages and emoji. ## Usage To create a commit, just type: ``` /commit ``` Or with options: ``` /commit --no-verify ``` ## What This Command Does 1. Unless specified with `--no-verify`, automatically runs pre-commit checks: - `pnpm lint` to ensure code quality - `pnpm build` to verify the build succeeds - `pnpm generate:docs` to update documentation 2. Checks which files are staged with `git status` 3. If 0 files are staged, automatically adds all modified and new files with `git add` 4. Performs a `git diff` to understand what changes are being committed 5. Analyzes the diff to determine if multiple distinct logical changes are present 6. If multiple distinct changes are detected, suggests breaking the commit into multiple smaller commits 7. For each commit (or the single commit if not split), creates a commit message using emoji conventional commit format ## Best Practices for Commits - **Verify before committing**: Ensure code is linted, builds correctly, and documentation is updated - **Atomic commits**: Each commit should contain related changes that serve a single purpose - **Split large changes**: If changes touch multiple concerns, split them into separate commits - **Conventional commit format**: Use the format `: ` where type is one of: - `feat`: A new feature - `fix`: A bug fix - `docs`: Documentation changes - `style`: Code style changes (formatting, etc) - `refactor`: Code changes that neither fix bugs nor add features - `perf`: Performance improvements - `test`: Adding or fixing tests - `chore`: Changes to the build process, tools, etc. - **Present tense, imperative mood**: Write commit messages as commands (e.g., "add feature" not "added feature") - **Concise first line**: Keep the first line under 72 characters - **Emoji**: Each commit type is paired with an appropriate emoji: - ✨ `feat`: New feature - 🐛 `fix`: Bug fix - 📝 `docs`: Documentation - 💄 `style`: Formatting/style - ♻️ `refactor`: Code refactoring - ⚡️ `perf`: Performance improvements - ✅ `test`: Tests - 🔧 `chore`: Tooling, configuration - 🚀 `ci`: CI/CD improvements - 🗑️ `revert`: Reverting changes - 🧪 `test`: Add a failing test - 🚨 `fix`: Fix compiler/linter warnings - 🔒️ `fix`: Fix security issues - 👥 `chore`: Add or update contributors - 🚚 `refactor`: Move or rename resources - 🏗️ `refactor`: Make architectural changes - 🔀 `chore`: Merge branches - 📦️ `chore`: Add or update compiled files or packages - ➕ `chore`: Add a dependency - ➖ `chore`: Remove a dependency - 🌱 `chore`: Add or update seed files - 🧑‍💻 `chore`: Improve developer experience - 🧵 `feat`: Add or update code related to multithreading or concurrency - 🔍️ `feat`: Improve SEO - 🏷️ `feat`: Add or update types - 💬 `feat`: Add or update text and literals - 🌐 `feat`: Internationalization and localization - 👔 `feat`: Add or update business logic - 📱 `feat`: Work on responsive design - 🚸 `feat`: Improve user experience / usability - 🩹 `fix`: Simple fix for a non-critical issue - 🥅 `fix`: Catch errors - 👽️ `fix`: Update code due to external API changes - 🔥 `fix`: Remove code or files - 🎨 `style`: Improve structure/format of the code - 🚑️ `fix`: Critical hotfix - 🎉 `chore`: Begin a project - 🔖 `chore`: Release/Version tags - 🚧 `wip`: Work in progress - 💚 `fix`: Fix CI build - 📌 `chore`: Pin dependencies to specific versions - 👷 `ci`: Add or update CI build system - 📈 `feat`: Add or update analytics or tracking code - ✏️ `fix`: Fix typos - ⏪️ `revert`: Revert changes - 📄 `chore`: Add or update license - 💥 `feat`: Introduce breaking changes - 🍱 `assets`: Add or update assets - ♿️ `feat`: Improve accessibility - 💡 `docs`: Add or update comments in source code - 🗃️ `db`: Perform database related changes - 🔊 `feat`: Add or update logs - 🔇 `fix`: Remove logs - 🤡 `test`: Mock things - 🥚 `feat`: Add or update an easter egg - 🙈 `chore`: Add or update .gitignore file - 📸 `test`: Add or update snapshots - ⚗️ `experiment`: Perform experiments - 🚩 `feat`: Add, update, or remove feature flags - 💫 `ui`: Add or update animations and transitions - ⚰️ `refactor`: Remove dead code - 🦺 `feat`: Add or update code related to validation - ✈️ `feat`: Improve offline support ## Guidelines for Splitting Commits When analyzing the diff, consider splitting commits based on these criteria: 1. **Different concerns**: Changes to unrelated parts of the codebase 2. **Different types of changes**: Mixing features, fixes, refactoring, etc. 3. **File patterns**: Changes to different types of files (e.g., source code vs documentation) 4. **Logical grouping**: Changes that would be easier to understand or review separately 5. **Size**: Very large changes that would be clearer if broken down ## Examples Good commit messages: - ✨ feat: add user authentication system - 🐛 fix: resolve memory leak in rendering process - 📝 docs: update API documentation with new endpoints - ♻️ refactor: simplify error handling logic in parser - 🚨 fix: resolve linter warnings in component files - 🧑‍💻 chore: improve developer tooling setup process - 👔 feat: implement business logic for transaction validation - 🩹 fix: address minor styling inconsistency in header - 🚑️ fix: patch critical security vulnerability in auth flow - 🎨 style: reorganize component structure for better readability - 🔥 fix: remove deprecated legacy code - 🦺 feat: add input validation for user registration form - 💚 fix: resolve failing CI pipeline tests - 📈 feat: implement analytics tracking for user engagement - 🔒️ fix: strengthen authentication password requirements - ♿️ feat: improve form accessibility for screen readers Example of splitting commits: - First commit: ✨ feat: add new solc version type definitions - Second commit: 📝 docs: update documentation for new solc versions - Third commit: 🔧 chore: update package.json dependencies - Fourth commit: 🏷️ feat: add type definitions for new API endpoints - Fifth commit: 🧵 feat: improve concurrency handling in worker threads - Sixth commit: 🚨 fix: resolve linting issues in new code - Seventh commit: ✅ test: add unit tests for new solc version features - Eighth commit: 🔒️ fix: update dependencies with security vulnerabilities ## Command Options - `--no-verify`: Skip running the pre-commit checks (lint, build, generate:docs) ## Important Notes - By default, pre-commit checks (`pnpm lint`, `pnpm build`, `pnpm generate:docs`) will run to ensure code quality - If these checks fail, you'll be asked if you want to proceed with the commit anyway or fix the issues first - If specific files are already staged, the command will only commit those files - If no files are staged, it will automatically stage all modified and new files - The commit message will be constructed based on the changes detected - Before committing, the command will review the diff to identify if multiple commits would be more appropriate - If suggesting multiple commits, it will help you stage and commit the changes separately - Always reviews the commit diff to ensure the message matches the changes ================================================ FILE: resources/slash-commands/context-prime/context-prime.md ================================================ Read README.md, THEN run `git ls-files | grep -v -f (sed 's|^|^|; s|$|/|' .cursorignore | psub)` to understand the context of the project ================================================ FILE: resources/slash-commands/create-hook/create-hook.md ================================================ # Create Hook Command Analyze the project, suggest practical hooks, and create them with proper testing. ## Your Task (/create-hook) 1. **Analyze environment** - Detect tooling and existing hooks 2. **Suggest hooks** - Based on your project configuration 3. **Configure hook** - Ask targeted questions and create the script 4. **Test & validate** - Ensure the hook works correctly ## Your Workflow ### 1. Environment Analysis & Suggestions Automatically detect the project tooling and suggest relevant hooks: **When TypeScript is detected (`tsconfig.json`):** - PostToolUse hook: "Type-check files after editing" - PreToolUse hook: "Block edits with type errors" **When Prettier is detected (`.prettierrc`, `prettier.config.js`):** - PostToolUse hook: "Auto-format files after editing" - PreToolUse hook: "Require formatted code" **When ESLint is detected (`.eslintrc.*`):** - PostToolUse hook: "Lint and auto-fix after editing" - PreToolUse hook: "Block commits with linting errors" **When package.json has scripts:** - `test` script → "Run tests before commits" - `build` script → "Validate build before commits" **When a git repository is detected:** - PreToolUse/Bash hook: "Prevent commits with secrets" - PostToolUse hook: "Security scan on file changes" **Decision Tree:** ``` Project has TypeScript? → Suggest type checking hooks Project has formatter? → Suggest formatting hooks Project has tests? → Suggest test validation hooks Security sensitive? → Suggest security hooks + Scan for additional patterns and suggest custom hooks based on: - Custom scripts in package.json - Unique file patterns or extensions - Development workflow indicators - Project-specific tooling configurations ``` ### 2. Hook Configuration Start by asking: **"What should this hook do?"** and offer relevant suggestions from your analysis. Then understand the context from the user's description and **only ask about details you're unsure about**: 1. **Trigger timing**: When should it run? - `PreToolUse`: Before file operations (can block) - `PostToolUse`: After file operations (feedback/fixes) - `UserPromptSubmit`: Before processing requests - Other event types as needed 2. **Tool matcher**: Which tools should trigger it? (`Write`, `Edit`, `Bash`, `*` etc) 3. **Scope**: `global`, `project`, or `project-local` 4. **Response approach**: - **Exit codes only**: Simple (exit 0 = success, exit 2 = block in PreToolUse) - **JSON response**: Advanced control (blocking, context, decisions) - Guide based on complexity: simple pass/fail → exit codes, rich feedback → JSON 5. **Blocking behavior** (if relevant): "Should this stop operations when issues are found?" - PreToolUse: Can block operations (security, validation) - PostToolUse: Usually provide feedback only 6. **Claude integration** (CRITICAL): "Should Claude Code automatically see and fix issues this hook detects?" - If YES: Use `additionalContext` for error communication - If NO: Use `suppressOutput: true` for silent operation 7. **Context pollution**: "Should successful operations be silent to avoid noise?" - Recommend YES for formatting, routine checks - Recommend NO for security alerts, critical errors 8. **File filtering**: "What file types should this hook process?" ### 3. Hook Creation You should: - **Create hooks directory**: `~/.claude/hooks/` or `.claude/hooks/` based on scope - **Generate script**: Create hook script with: - Proper shebang and executable permissions - Project-specific commands (use detected config paths) - Comments explaining the hook's purpose - **Update settings**: Add hook configuration to appropriate settings.json - **Use absolute paths**: Avoid relative paths to scripts and executables. Use `$CLAUDE_PROJECT_DIR` to reference project root - **Offer validation**: Ask if the user wants you to test the hook **Key Implementation Standards:** - Read JSON from stdin (never use argv) - Use top-level `additionalContext`/`systemMessage` for Claude communication - Include `suppressOutput: true` for successful operations - Provide specific error counts and actionable feedback - Focus on changed files rather than entire codebase - Support common development workflows **⚠️ CRITICAL: Input/Output Format** This is where most hook implementations fail. Pay extra attention to: - **Input**: Reading JSON from stdin correctly (not argv) - **Output**: Using correct top-level JSON structure for Claude communication - **Documentation**: Consulting official docs for exact schemas when in doubt ### 4. Testing & Validation **CRITICAL: Test both happy and sad paths:** **Happy Path Testing:** 1. **Test expected success scenario** - Create conditions where hook should pass - _Examples_: TypeScript (valid code), Linting (formatted code), Security (safe commands) **Sad Path Testing:** 2. **Test expected failure scenario** - Create conditions where hook should fail/warn - _Examples_: TypeScript (type errors), Linting (unformatted code), Security (dangerous operations) **Verification Steps:** 3. **Verify expected behavior**: Check if it blocks/warns/provides context as intended **Example Testing Process:** - For a hook preventing file deletion: Create a test file, attempt the protected action, and verify the hook prevents it **If Issues Occur, you should:** - Check hook registration in settings - Verify script permissions (`chmod +x`) - Test with simplified version first - Debug with detailed hook execution analysis ## Hook Templates ### Type Checking (PostToolUse) ``` #!/usr/bin/env node // Read stdin JSON, check .ts/.tsx files only // Run: npx tsc --noEmit --pretty // Output: JSON with additionalContext for errors ``` ### Auto-formatting (PostToolUse) ``` #!/usr/bin/env node // Read stdin JSON, check supported file types // Run: npx prettier --write [file] // Output: JSON with suppressOutput: true ``` ### Security Scanning (PreToolUse) ```bash #!/bin/bash # Read stdin JSON, check for secrets/keys # Block if dangerous patterns found # Exit 2 to block, 0 to continue ``` _Complete templates available at: https://docs.claude.com/en/docs/claude-code/hooks#examples_ ## Quick Reference **📖 Official Docs**: https://docs.claude.com/en/docs/claude-code/hooks.md **Common Patterns:** - **stdin input**: `JSON.parse(process.stdin.read())` - **File filtering**: Check extensions before processing - **Success response**: `{continue: true, suppressOutput: true}` - **Error response**: `{continue: true, additionalContext: "error details"}` - **Block operation**: `exit(2)` in PreToolUse hooks **Hook Types by Use Case:** - **Code Quality**: PostToolUse for feedback and fixes - **Security**: PreToolUse to block dangerous operations - **CI/CD**: PreToolUse to validate before commits - **Development**: PostToolUse for automated improvements **Hook Execution Best Practices:** - **Hooks run in parallel** according to official documentation - **Design for independence** since execution order isn't guaranteed - **Plan hook interactions carefully** when multiple hooks affect the same files ## Success Criteria ✅ **Hook created successfully when:** - Script has executable permissions - Registered in correct settings.json - Responds correctly to test scenarios - Integrates properly with Claude for automated fixes - Follows project conventions and detected tooling **Result**: The user gets a working hook that enhances their development workflow with intelligent automation and quality checks. ================================================ FILE: resources/slash-commands/create-jtbd/create-jtbd.md ================================================ You are an experienced Product Manager. Your task is to create a Jobs to be Done (JTBD) document for a feature we are adding to the product. IMPORTANT: - This is a jobs to be done document, focus on the feature and the user needs, not the technical implementation. - Do not include any time estimates. ## READ PRODUCT DOCUMENTATION 1. Read the `product-development/resources/product.md` file to understand the product. ## READ FEATURE IDEA 2. Read the `product-development/current-feature/feature.md` file to understand the feature idea. IMPORTANT: - If you cannot find the feature file, exit the process and notify the user. ## 🧭 CREATE JTBD DOCUMENT 3. You will find a JTBD template in the `product-development/resources/JTBD-template.md` file. Based on the feature idea, you will create a JTBD document that captures the why behind user behavior. It focuses on the problem or job the user is trying to get done. 4. Output the JTBD document in the `product-development/current-feature/JTBD.md` file. ================================================ FILE: resources/slash-commands/create-pr/create-pr.md ================================================ # Create Pull Request Command Create a new branch, commit changes, and submit a pull request. ## Behavior - Creates a new branch based on current changes - Formats modified files using Biome - Analyzes changes and automatically splits into logical commits when appropriate - Each commit focuses on a single logical change or feature - Creates descriptive commit messages for each logical unit - Pushes branch to remote - Creates pull request with proper summary and test plan ## Guidelines for Automatic Commit Splitting - Split commits by feature, component, or concern - Keep related file changes together in the same commit - Separate refactoring from feature additions - Ensure each commit can be understood independently - Multiple unrelated changes should be split into separate commits ================================================ FILE: resources/slash-commands/create-prd/create-prd.md ================================================ You are an experienced Product Manager. Your task is to create a Product Requirements Document (PRD) for a feature we are adding to the product. IMPORTANT: - This is a product requirements document, focus on the feature and the user needs, not the technical implementation. - Do not include any time estimates. ## READ PRODUCT DOCUMENTATION 1. Read the `product-development/resources/product.md` file to understand the product. ## READ FEATURE DOCUMENTATION 2. Read the `product-development/current-feature/feature.md` file to understand the feature idea. ## READ JTBD DOCUMENTATION 3. Read the `product-development/current-feature/JTBD.md` file to understand the Jobs to be Done. ## 🧭 CREATE PRD DOCUMENT 4. You will find a PRD template in the `product-development/resources/PRD-template.md` file. Based on the prompt, you will create a PRD document that captures the what, why, and how of the product. 5. Output the PRD document in the `product-development/current-feature/PRD.md` file. ================================================ FILE: resources/slash-commands/create-prp/create-prp.md ================================================ YOU MUST READ THESE FILES AND FOLLOW THE INSTRUCTIONS IN THEM. Start by reading the concept_library/cc_PRP_flow/README.md to understand what a PRP Then read concept_library/cc_PRP_flow/PRPs/base_template_v1 to understand the structure of a PRP. Think hard about the concept Help the user create a comprehensive Product Requirement Prompt (PRP) for: $ARGUMENTS ## Instructions for PRP Creation Research and develop a complete PRP based on the feature/product description above. Follow these guidelines: ## Research Process Begin with thorough research to gather all necessary context: 1. **Documentation Review** - Check for relevant documentation in the `ai_docs/` directory - Identify any documentation gaps that need to be addressed - Ask the user if additional documentation should be referenced 2. **WEB RESEARCH** - Use web search to gather additional context - Research the concept of the feature/product - Look into library documentation - Look into example implementations on StackOverflow - Look into example implementations on GitHub - etc... - Ask the user if additional web search should be referenced 3. **Template Analysis** - Use `concept_library/cc_PRP_flow/PRPs/base_template_v1` as the structural reference - Ensure understanding of the template requirements before proceeding - Review past templates in the PRPs/ directory for inspiration if there are any 4. **Codebase Exploration** - Identify relevant files and directories that provide implementation context - Ask the user about specific areas of the codebase to focus on - Look for patterns that should be followed in the implementation 5. **Implementation Requirements** - Confirm implementation details with the user - Ask about specific patterns or existing features to mirror - Inquire about external dependencies or libraries to consider ## PRP Development Create a PRP following the template in `concept_library/cc_PRP_flow/PRPs/base_template_v1`, ensuring it includes the same structure as the template. ## Context Prioritization A successful PRP must include comprehensive context through specific references to: - Files in the codebase - Web search results and URL's - Documentation - External resources - Example implementations - Validation criteria ## User Interaction After completing initial research, present findings to the user and confirm: - The scope of the PRP - Patterns to follow - Implementation approach - Validation criteria If the user answers with continue, you are on the right path, continue with the PRP creation without user input. Remember: A PRP is PRD + curated codebase intelligence + agent/runbook—the minimum viable packet an AI needs to ship production-ready code on the first pass. ================================================ FILE: resources/slash-commands/create-pull-request/create-pull-request.md ================================================ # How to Create a Pull Request Using GitHub CLI This guide explains how to create pull requests using GitHub CLI in our project. **Important**: All PR titles and descriptions should be written in English. ## Prerequisites 1. Install GitHub CLI if you haven't already: ```bash # macOS brew install gh # Windows winget install --id GitHub.cli # Linux # Follow instructions at https://github.com/cli/cli/blob/trunk/docs/install_linux.md ``` 2. Authenticate with GitHub: ```bash gh auth login ``` ## Creating a New Pull Request 1. First, prepare your PR description following the template in @.github/pull_request_template.md 2. Use the `gh pr create --draft` command to create a new pull request: ```bash # Basic command structure gh pr create --draft --title "✨(scope): Your descriptive title" --body "Your PR description" --base main ``` For more complex PR descriptions with proper formatting, use the `--body-file` option with the exact PR template structure: ```bash # Create PR with proper template structure gh pr create --draft --title "✨(scope): Your descriptive title" --body-file .github/pull_request_template.md --base main ``` ## Best Practices 1. **Language**: Always use English for PR titles and descriptions 2. **PR Title Format**: Use conventional commit format with emojis - Always include an appropriate emoji at the beginning of the title - Use the actual emoji character (not the code representation like `:sparkles:`) - Examples: - `✨(supabase): Add staging remote configuration` - `🐛(auth): Fix login redirect issue` - `📝(readme): Update installation instructions` 3. **Description Template**: Always use our PR template structure from @.github/pull_request_template.md: 4. **Template Accuracy**: Ensure your PR description precisely follows the template structure: - Don't modify or rename the PR-Agent sections (`pr_agent:summary` and `pr_agent:walkthrough`) - Keep all section headers exactly as they appear in the template - Don't add custom sections that aren't in the template 5. **Draft PRs**: Start as draft when the work is in progress - Use `--draft` flag in the command - Convert to ready for review when complete using `gh pr ready` ### Common Mistakes to Avoid 1. **Using Non-English Text**: All PR content must be in English 2. **Incorrect Section Headers**: Always use the exact section headers from the template 3. **Adding Custom Sections**: Stick to the sections defined in the template 4. **Using Outdated Templates**: Always refer to the current @.github/pull_request_template.md file ### Missing Sections Always include all template sections, even if some are marked as "N/A" or "None" ## Additional GitHub CLI PR Commands Here are some additional useful GitHub CLI commands for managing PRs: ```bash # List your open pull requests gh pr list --author "@me" # Check PR status gh pr status # View a specific PR gh pr view # Check out a PR branch locally gh pr checkout # Convert a draft PR to ready for review gh pr ready # Add reviewers to a PR gh pr edit --add-reviewer username1,username2 # Merge a PR gh pr merge --squash ``` ## Using Templates for PR Creation To simplify PR creation with consistent descriptions, you can create a template file: 1. Create a file named `pr-template.md` with your PR template 2. Use it when creating PRs: ```bash gh pr create --draft --title "feat(scope): Your title" --body-file pr-template.md --base main ``` ## Related Documentation - [PR Template](.github/pull_request_template.md) - [Conventional Commits](https://www.conventionalcommits.org/) - [GitHub CLI documentation](https://cli.github.com/manual/) ================================================ FILE: resources/slash-commands/create-worktrees/create-worktrees.md ================================================ # Git Worktree Commands ## Create Worktrees for All Open PRs This command fetches all open pull requests using GitHub CLI, then creates a git worktree for each PR's branch in the `./tree/` directory. ```bash # Ensure GitHub CLI is installed and authenticated gh auth status || (echo "Please run 'gh auth login' first" && exit 1) # Create the tree directory if it doesn't exist mkdir -p ./tree # List all open PRs and create worktrees for each branch gh pr list --json headRefName --jq '.[].headRefName' | while read branch; do # Handle branch names with slashes (like "feature/foo") branch_path="./tree/${branch}" # For branches with slashes, create the directory structure if [[ "$branch" == */* ]]; then dir_path=$(dirname "$branch_path") mkdir -p "$dir_path" fi # Check if worktree already exists if [ ! -d "$branch_path" ]; then echo "Creating worktree for $branch" git worktree add "$branch_path" "$branch" else echo "Worktree for $branch already exists" fi done # Display all created worktrees echo "\nWorktree list:" git worktree list ``` ### Example Output ``` Creating worktree for fix-bug-123 HEAD is now at a1b2c3d Fix bug 123 Creating worktree for feature/new-feature HEAD is now at e4f5g6h Add new feature Worktree for documentation-update already exists Worktree list: /path/to/repo abc1234 [main] /path/to/repo/tree/fix-bug-123 a1b2c3d [fix-bug-123] /path/to/repo/tree/feature/new-feature e4f5g6h [feature/new-feature] /path/to/repo/tree/documentation-update d5e6f7g [documentation-update] ``` ### Cleanup Stale Worktrees (Optional) You can add this to remove stale worktrees for branches that no longer exist: ```bash # Get current branches current_branches=$(git branch -a | grep -v HEAD | grep -v main | sed 's/^[ *]*//' | sed 's|remotes/origin/||' | sort | uniq) # Get existing worktrees (excluding main worktree) worktree_paths=$(git worktree list | tail -n +2 | awk '{print $1}') for path in $worktree_paths; do # Extract branch name from path branch_name=$(basename "$path") # Skip special cases if [[ "$branch_name" == "main" ]]; then continue fi # Check if branch still exists if ! echo "$current_branches" | grep -q "^$branch_name$"; then echo "Removing stale worktree for deleted branch: $branch_name" git worktree remove --force "$path" fi done ``` ## Create New Branch and Worktree This interactive command creates a new git branch and sets up a worktree for it: ```bash #!/bin/bash # Ensure we're in a git repository if ! git rev-parse --is-inside-work-tree > /dev/null 2>&1; then echo "Error: Not in a git repository" exit 1 fi # Get the repository root repo_root=$(git rev-parse --show-toplevel) # Prompt for branch name read -p "Enter new branch name: " branch_name # Validate branch name (basic validation) if [[ -z "$branch_name" ]]; then echo "Error: Branch name cannot be empty" exit 1 fi if git show-ref --verify --quiet "refs/heads/$branch_name"; then echo "Warning: Branch '$branch_name' already exists" read -p "Do you want to use the existing branch? (y/n): " use_existing if [[ "$use_existing" != "y" ]]; then exit 1 fi fi # Create branch directory branch_path="$repo_root/tree/$branch_name" # Handle branch names with slashes (like "feature/foo") if [[ "$branch_name" == */* ]]; then dir_path=$(dirname "$branch_path") mkdir -p "$dir_path" fi # Make sure parent directory exists mkdir -p "$(dirname "$branch_path")" # Check if a worktree already exists if [ -d "$branch_path" ]; then echo "Error: Worktree directory already exists: $branch_path" exit 1 fi # Create branch and worktree if git show-ref --verify --quiet "refs/heads/$branch_name"; then # Branch exists, create worktree echo "Creating worktree for existing branch '$branch_name'..." git worktree add "$branch_path" "$branch_name" else # Create new branch and worktree echo "Creating new branch '$branch_name' and worktree..." git worktree add -b "$branch_name" "$branch_path" fi echo "Success! New worktree created at: $branch_path" echo "To start working on this branch, run: cd $branch_path" ``` ### Example Usage ``` $ ./create-branch-worktree.sh Enter new branch name: feature/user-authentication Creating new branch 'feature/user-authentication' and worktree... Preparing worktree (creating new branch 'feature/user-authentication') HEAD is now at abc1234 Previous commit message Success! New worktree created at: /path/to/repo/tree/feature/user-authentication To start working on this branch, run: cd /path/to/repo/tree/feature/user-authentication ``` ### Creating a New Branch from a Different Base If you want to start your branch from a different base (not the current HEAD), you can modify the script: ```bash read -p "Enter new branch name: " branch_name read -p "Enter base branch/commit (default: HEAD): " base_commit base_commit=${base_commit:-HEAD} # Then use the specified base when creating the worktree git worktree add -b "$branch_name" "$branch_path" "$base_commit" ``` This will allow you to specify any commit, tag, or branch name as the starting point for your new branch. ================================================ FILE: resources/slash-commands/fix-github-issue/fix-github-issue.md ================================================ Please analyze and fix the GitHub issue: $ARGUMENTS. Follow these steps: 1. Use `gh issue view` to get the issue details 2. Understand the problem described in the issue 3. Search the codebase for relevant files 4. Implement the necessary changes to fix the issue 5. Write and run tests to verify the fix 6. Ensure code passes linting and type checking 7. Create a descriptive commit message Remember to use the GitHub CLI (`gh`) for all GitHub-related tasks. ================================================ FILE: resources/slash-commands/husky/husky.md ================================================ ## Summary The goal of this command is to verify the repo is in a working state and fix issues if they exist. ## Goals Run CI checks and fix issues until repo is in a good state and then add files to staging. All commands are run from repo root. 0. Make sure repo is up to date via running `pnpm i` 1. Check that the linter passes by running `pnpm lint` 2. Check that types and build pass by running `pnpm nx run-many --targets=build:types,build:dist,build:app,generate:docs,dev:run,typecheck`. If one of the specific commands fail, save tokens via only running that command while debugging 3. Check that tests pass via running `pnpm nx run-many --target=test:coverage` Source the .env file first before running if it exists 4. Check package.json is sorted via running `pnpm run sort-package-json` 5. Check packages are linted via running `pnpm nx run-many --targets=lint:package,lint:deps` 6. Double check. If you made any fixes run preceeding checks again. For example, if you made fixes on step 3. run steps 1., 2., and 3. again to doublecheck there wasn't a regression on the earlier step. 7. Add files to staging with `git status` and `git add`. Make sure you don't add any git submodules in the `lib/*` folders though Do NOT continue on to the next step until the command listed succeeds. You may sometimes have prompts in between or have to debug but always continue on unless I specifically give you permission to skip a check. Print the list of tasks with a checkmark emoji next to every step that passed at the very end ## Protocol when something breaks Take the following steps if CI breaks ### 1. Explain why it's broke - Whenever a test is broken first give think very hard and a complete explanation of what broke. Cite source code and logs that support your thesis. - If you don't have source code or logs to support your thesis, think hard and look in codebase for proof. - Add console logs if it will help you confirm your thesis or find out why it's broke - If you don't know why it's broke or there just isn't enough context ask for help ### 2. Fix issue - Propose your fix - Fully explain why you are doing your fix and why you believe it will work - If your fix does not work go back to Step 1 ### 3. Consider if same bug exists elsewhere - Think hard about whether the bug might exist elsewhere and how to best find it and fix it ### 4. Clean up Always clean up added console.logs after fixing ## Tips Generally most functions and types like `createTevmNode` are in a file named `createTevmNode.js` with a type called `TevmNode.ts` and tests `createTevmNode.spec.ts`. We generally have one item per file so the files are easy to find. ### pnpm i If this fails you should just abort because something is very wrong unless the issue is simply syntax error like a missing comma. ### pnpm lint This is using biome to lint the entire codebase ### pnpm nx-run-many --targets=build:types,typecheck These commands from step 2 check typescript types and when they are broken it's likely for typescript error reasons. It's generally a good idea to fix the issue if it's obvious. If the proof of why your typescript type isn't already in context or obvious it's best to look for the typescript type for confirmation before attempting to fix it. THis includes looking for it in node_modules. If it's a tevm package it's in this monorepo. If you fail more than a few times here we should look at documentation ### Run tests To run the tests run the nx command for test:coverage. NEVER RUN normal test command as that command will time out. Run on individual packages in the same order the previous command ran the packages 1 by 1. Run tests 1 package at a time to make them easier to debug We use vite for all our tests. - oftentimes snapshot tests will fail. Before updating snapshot tests we should clearly explain our thesis for why the snapshot changes are expected - whenever a test fails follow the Protocol for when something breaks - It often is a good idea to test assumptions via adding console logs to test that any assumptions of things that are working as expected are true ## Never commit Only add to staging never actually make a commit ## Go ahead and fix errors Don't be afraid to make fixes to things as the typescript types and tests will warn us if anything else breaks. No need to skip the fixes because they are considered dangerous. ## When fixes are made When a step requires code changes to fix always do following steps after you are finished fixing that step. 1. Run `pnpm run lint` to make sure files are formatted 2. ask the the user if they want to add files to staging first 3. suggest a commit message but don't actually do the commit let the user do it themselves ================================================ FILE: resources/slash-commands/initref/initref.md ================================================ Build a reference for the implementation details of this project. Use provided summarize tool to get summary of the files. Avoid reading the content of many files yourself, as we might hit usage limits. Do read the content of important files though. Use the returned summaries to create reference files in /ref directory. Use markdown format for writing the documentation files. Update CLAUDE.md file with the pointers to important documentation files. ================================================ FILE: resources/slash-commands/load-llms-txt/load-llms-txt.md ================================================ # Load Xatu Data Context READ the llms.txt file from https://raw.githubusercontent.com/ethpandaops/xatu-data/refs/heads/master/llms.txt via `curl`. Do nothing else and await further instructions. ================================================ FILE: resources/slash-commands/optimize/optimize.md ================================================ このコードのパフォーマンスを分析し、具体的な最適化を3つ提案してください。 ================================================ FILE: resources/slash-commands/pr-review/pr-review.md ================================================ # PR Review **PR Link/Number**: $ARGUMENTS > **Instructions**: Execute each task in the order given to conduct a thorough code review. Update GitHub with this review. > **Important**: The future is now—any improvements or “future” recommendations must be addressed **immediately**. --- ## Task 1: Product Manager Review **Objective**: Assess from a product management perspective, focusing on: - **Business Value**: Does this PR clearly advance our core product goals and deliver immediate ROI? - **User Experience**: Is the change intuitive and delightful for users right now? If not, make fixes immediately. - **Strategic Alignment**: Does the PR align with current (and long-term, i.e., now) strategic objectives? **Action**: Provide clear directives on how to ensure maximum user and business impact. All “future” suggestions must be implemented now. --- ## Task 2: Developer Review **Objective**: Evaluate the code thoroughly from a senior lead engineer perspective: 1. **Code Quality & Maintainability**: Is the code structured for readability and easy maintenance? If not, refactor now. 2. **Performance & Scalability**: Will these changes operate efficiently at scale? If not, optimize immediately. 3. **Best Practices & Standards**: Note any deviation from coding standards and correct it now. **Action**: Leave a concise yet complete review comment, ensuring all improvements happen immediately—no deferrals. --- ## Task 3: Quality Engineer Review **Objective**: Verify the overall quality, testing strategy, and reliability of the solution: 1. **Test Coverage**: Are there sufficient tests (unit, integration, E2E)? If not, add them now. 2. **Potential Bugs & Edge Cases**: Have all edge cases been considered? If not, address them immediately. 3. **Regression Risk**: Confirm changes don’t undermine existing functionality. If risk is identified, mitigate now with additional checks or tests. **Action**: Provide a detailed QA assessment, insisting any “future” improvements be completed right away. --- ## Task 4: Security Engineer Review **Objective**: Ensure robust security practices and compliance: 1. **Vulnerabilities**: Could these changes introduce security vulnerabilities? If so, fix them right away. 2. **Data Handling**: Are we properly protecting sensitive data (e.g., encryption, sanitization)? Address all gaps now. 3. **Compliance**: Confirm alignment with any relevant security or privacy standards (e.g., OWASP, GDPR, HIPAA). Implement missing requirements immediately. **Action**: Provide a security assessment. Any recommended fixes typically scheduled for “later” must be addressed now. --- ## Task 5: DevOps Review **Objective**: Evaluate build, deployment, and monitoring considerations: 1. **CI/CD Pipeline**: Validate that the PR integrates smoothly with existing build/test/deploy processes. If not, fix it now. 2. **Infrastructure & Configuration**: Check whether the code changes require immediate updates to infrastructure or configs. 3. **Monitoring & Alerts**: Identify new monitoring needs or potential improvements and implement them immediately. **Action**: Provide a DevOps-centric review, insisting that any improvements or tweaks be executed now. --- ## Task 6: UI/UX Designer Review **Objective**: Ensure optimal user-centric design: 1. **Visual Consistency**: Confirm adherence to brand/design guidelines. If not, adjust now. 2. **Usability & Accessibility**: Validate that the UI is intuitive and compliant with accessibility standards. Make any corrections immediately. 3. **Interaction Flow**: Assess whether the user flow is seamless. If friction exists, refine now. **Action**: Provide a detailed UI/UX evaluation. Any enhancements typically set for “later” must be done immediately. --- **End of PR Review** ================================================ FILE: resources/slash-commands/release/release.md ================================================ Update CHANGELOG.md with changes since the last version increase. Check our README.md for any necessary changes. Check the scope of changes since the last release and increase our version number as apropraite. ================================================ FILE: resources/slash-commands/testing_plan_integration/testing_plan_integration.md ================================================ I need you to create an integration testing plan for $ARGUMENTS These are integration tests and I want them to be inline in rust fashion. If the code is difficult to test, you should suggest refactoring to make it easier to test. Think really hard about the code, the tests, and the refactoring (if applicable). Will you come up with test cases and let me review before you write the tests? Feel free to ask clarifying questions. ================================================ FILE: resources/slash-commands/todo/todo.md ================================================ --- name: todo description: Manage project todos in todos.md file --- # Project Todo Manager Manage todos in a `todos.md` file at the root of your current project directory. ## Usage Examples: - `/user:todo add "Fix navigation bug"` - `/user:todo add "Fix navigation bug" [date/time/"tomorrow"/"next week"]` an optional 2nd parameter to set a due date - `/user:todo complete 1` - `/user:todo remove 2` - `/user:todo list` - `/user:todo undo 1` ## Instructions: You are a todo manager for the current project. When this command is invoked: 1. **Determine the project root** by looking for common indicators (.git, package.json, etc.) 2. **Locate or create** `todos.md` in the project root 3. **Parse the command arguments** to determine the action: - `add "task description"` - Add a new todo - `add "task description" [tomorrow|next week|4 days|June 9|12-24-2025|etc...]` - Add a new todo with the provided due date - `due N [tomorrow|next week|4 days|June 9|12-24-2025|etc...]` - Mark todo N with the due date provided - `complete N` - Mark todo N as completed and move from the ##Active list to the ##Completed list - `remove N` - Remove todo N entirely - `undo N` - Mark completed todo N as incomplete - `list [N]` or no args - Show all (or N number of) todos in a user-friendly format, with each todo numbered for reference - `past due` - Show all of the tasks which are past due and still active - `next` - Shows the next active task in the list, this should respect Due dates, if there are any. If not, just show the first todo in the Active list ## Todo Format: Use this markdown format in todos.md: ```markdown # Project Todos ## Active - [ ] Task description here | Due: MM-DD-YYYY (conditionally include HH:MM AM/PM, if specified) - [ ] Another task ## Completed - [x] Finished task | Done: MM-DD-YYYY (conditionally include HH:MM AM/PM, if specified) - [x] Another completed task | Due: MM-DD-YYYY (conditionally include HH:MM AM/PM, if specified) | Done: MM-DD-YYYY (conditionally include HH:MM AM/PM, if specified) ``` ## Behavior: - Number todos when displaying (1, 2, 3...) - Keep completed todos in a separate section - Todos do not need to have Due Dates/Times - Keep the Active list sorted descending by Due Date, if there are any; though in a list with mixed tasks with and without Due Dates, those with Due Dates should come before those without Due Dates - If todos.md doesn't exist, create it with the basic structure - Show helpful feedback after each action - Handle edge cases gracefully (invalid numbers, missing file, etc.) - All provided dates/times should be saved/formatted in a standardized format of MM/DD/YYYY (or DD/MM/YYYY depending on locale), unless the user specifies a different format - Times should not be included in the due date format unless requested (`due N in 2 hours` should be MM/DD/YYYY @ [+ 2 hours from now]) Always be concise and helpful in your responses. ================================================ FILE: resources/slash-commands/update-branch-name/update-branch-name.md ================================================ # Update Branch Name Follow these steps to update the current branch name: 1. Check differences between current branch and main branch HEAD using `git diff main...HEAD` 2. Analyze the changed files to understand what work is being done 3. Determine an appropriate descriptive branch name based on the changes 4. Update the current branch name using `git branch -m [new-branch-name]` 5. Verify the branch name was updated with `git branch` ================================================ FILE: resources/slash-commands/update-docs/update-docs.md ================================================ # Documentation Update Command: Update Implementation Documentation ## Documentation Analysis 1. Review current documentation status: - Check `specs/implementation_status.md` for overall project status - Review implemented phase document (`specs/phase{N}_implementation_plan.md`) - Review `specs/flutter_structurizr_implementation_spec.md` and `specs/flutter_structurizr_implementation_spec_updated.md` - Review `specs/testing_plan.md` to ensure it is current given recent test passes, failures, and changes - Examine `CLAUDE.md` and `README.md` for project-wide documentation - Check for and document any new lessons learned or best practices in CLAUDE.md 2. Analyze implementation and testing results: - Review what was implemented in the last phase - Review testing results and coverage - Identify new best practices discovered during implementation - Note any implementation challenges and solutions - Cross-reference updated documentation with recent implementation and test results to ensure accuracy ## Documentation Updates 1. Update phase implementation document: - Mark completed tasks with ✅ status - Update implementation percentages - Add detailed notes on implementation approach - Document any deviations from original plan with justification - Add new sections if needed (lessons learned, best practices) - Document specific implementation details for complex components - Include a summary of any new troubleshooting tips or workflow improvements discovered during the phase 2. Update implementation status document: - Update phase completion percentages - Add or update implementation status for components - Add notes on implementation approach and decisions - Document best practices discovered during implementation - Note any challenges overcome and solutions implemented 3. Update implementation specification documents: - Mark completed items with ✅ or strikethrough but preserve original requirements - Add notes on implementation details where appropriate - Add references to implemented files and classes - Update any implementation guidance based on experience 4. Update CLAUDE.md and README.md if necessary: - Add new best practices - Update project status - Add new implementation guidance - Document known issues or limitations - Update usage examples to include new functionality 5. Document new testing procedures: - Add details on test files created - Include test running instructions - Document test coverage - Explain testing approach for complex components ## Documentation Formatting and Structure 1. Maintain consistent documentation style: - Use clear headings and sections - Include code examples where helpful - Use status indicators (✅, ⚠️, ❌) consistently - Maintain proper Markdown formatting 2. Ensure documentation completeness: - Cover all implemented features - Include usage examples - Document API changes or additions - Include troubleshooting guidance for common issues ## Guidelines - DO NOT CREATE new specification files - UPDATE existing files in the `specs/` directory - Maintain consistent documentation style - Include practical examples where appropriate - Cross-reference related documentation sections - Document best practices and lessons learned - Provide clear status updates on project progress - Update numerical completion percentages - Ensure documentation reflects actual implementation Provide a summary of documentation updates after completion, including: 1. Files updated 2. Major changes to documentation 3. Updated completion percentages 4. New best practices documented 5. Status of the overall project after this phase ================================================ FILE: resources/workflows-knowledge-guides/Blogging-Platform-Instructions/view_commands.md ================================================ Here are all the available project commands, organized by category: ## Post Management - `/project:posts:new` - Create a new blog post with proper front matter - `/project:posts:check_language` - Check posts for UK English spelling and grammar - `/project:posts:check_links` - Verify all links in posts are valid - `/project:posts:publish` - Publish a draft post and push changes to GitHub - `/project:posts:find_drafts` - List all draft posts with their details - `/project:posts:check_images` - Verify all image references exist in the filesystem - `/project:posts:recent` - Show the most recent blog posts ## Project Management - `/project:projects:new` - Create a new project with proper structure and frontmatter - `/project:projects:check_thumbnails` - Verify all project thumbnails exist and have correct dimensions ## Site Management - `/project:site:preview` - Generate and serve the site locally - `/project:site:check_updates` - Check for updates to Hugo and the Congo theme - `/project:site:deploy` - Deploy the site to GitHub Pages - `/project:site:find_orphaned_images` - Find unused images in static folder To get more details about a specific command, look at the corresponding Markdown file in the `.claude/commands/` directory. ================================================ FILE: resources/workflows-knowledge-guides/Design-Review-Workflow/README.md ================================================ # Design Review Workflow This directory contains templates and examples for implementing an automated design review system that provides feedback on front-end code changes with design implications. This workflow allows engineers to automatically run design reviews on pull requests or working changes, ensuring design consistency and quality throughout the development process. ## Concept This workflow establishes a comprehensive methodology for automated design reviews in Claude Code, leveraging multiple advanced features to ensure world-class UI/UX standards in your codebase: **Core Methodology:** - **Automated Design Reviews**: Trigger comprehensive design assessments either automatically on PRs or on-demand via slash commands - **Live Environment Testing**: Uses [Playwright MCP](https://github.com/microsoft/playwright-mcp) server integration to interact with and test actual UI components in real-time, not just static code analysis - **Standards-Based Evaluation**: Follows rigorous design principles inspired by top-tier companies (Stripe, Airbnb, Linear), covering visual hierarchy, accessibility (WCAG AA+), responsive design, and interaction patterns **Implementation Features:** - **Claude Code Subagents**: Deploy specialized design review agents with pre-configured tools and prompts for consistent, thorough reviews, by taging `@agent-code-reviewer` - **Slash Commands**: Enable instant design reviews with `/design-review` that automatically analyzes git diffs and provides structured feedback - **CLAUDE.md Memory Integration**: Store design principles and brand guidelines in your project's CLAUDE.md file, ensuring Claude Code always references your specific design system - **Multi-Phase Review Process**: Systematic evaluation covering interaction flows, responsiveness, visual polish, accessibility, robustness testing, and code health This approach transforms design reviews from manual, subjective processes into automated, objective assessments that maintain consistency across your entire frontend development workflow. ## Resources ### Templates & Examples - [Design Principles Example](./design-principles-example.md) - Sample design principles document for guiding automated reviews - [Design Review Agent](./design-review-agent.md) - Agent configuration for automated design reviews - [Claude.md Snippet](./design-review-claude-md-snippet.md) - Claude.md configuration snippet for design review integration - [Slash Command](./design-review-slash-command.md) - Custom slash command implementation for on-demand design reviews ### Video Tutorial For a detailed walkthrough of this workflow, watch the comprehensive tutorial on YouTube: [Patrick Ellis' Channel](https://www.youtube.com/watch?v=xOO8Wt_i72s) ================================================ FILE: resources/workflows-knowledge-guides/Design-Review-Workflow/design-principles-example.md ================================================ # S-Tier SaaS Dashboard Design Checklist (Inspired by Stripe, Airbnb, Linear) ## I. Core Design Philosophy & Strategy * [ ] **Users First:** Prioritize user needs, workflows, and ease of use in every design decision. * [ ] **Meticulous Craft:** Aim for precision, polish, and high quality in every UI element and interaction. * [ ] **Speed & Performance:** Design for fast load times and snappy, responsive interactions. * [ ] **Simplicity & Clarity:** Strive for a clean, uncluttered interface. Ensure labels, instructions, and information are unambiguous. * [ ] **Focus & Efficiency:** Help users achieve their goals quickly and with minimal friction. Minimize unnecessary steps or distractions. * [ ] **Consistency:** Maintain a uniform design language (colors, typography, components, patterns) across the entire dashboard. * [ ] **Accessibility (WCAG AA+):** Design for inclusivity. Ensure sufficient color contrast, keyboard navigability, and screen reader compatibility. * [ ] **Opinionated Design (Thoughtful Defaults):** Establish clear, efficient default workflows and settings, reducing decision fatigue for users. ## II. Design System Foundation (Tokens & Core Components) * [ ] **Define a Color Palette:** * [ ] **Primary Brand Color:** User-specified, used strategically. * [ ] **Neutrals:** A scale of grays (5-7 steps) for text, backgrounds, borders. * [ ] **Semantic Colors:** Define specific colors for Success (green), Error/Destructive (red), Warning (yellow/amber), Informational (blue). * [ ] **Dark Mode Palette:** Create a corresponding accessible dark mode palette. * [ ] **Accessibility Check:** Ensure all color combinations meet WCAG AA contrast ratios. * [ ] **Establish a Typographic Scale:** * [ ] **Primary Font Family:** Choose a clean, legible sans-serif font (e.g., Inter, Manrope, system-ui). * [ ] **Modular Scale:** Define distinct sizes for H1, H2, H3, H4, Body Large, Body Medium (Default), Body Small/Caption. (e.g., H1: 32px, Body: 14px/16px). * [ ] **Font Weights:** Utilize a limited set of weights (e.g., Regular, Medium, SemiBold, Bold). * [ ] **Line Height:** Ensure generous line height for readability (e.g., 1.5-1.7 for body text). * [ ] **Define Spacing Units:** * [ ] **Base Unit:** Establish a base unit (e.g., 8px). * [ ] **Spacing Scale:** Use multiples of the base unit for all padding, margins, and layout spacing (e.g., 4px, 8px, 12px, 16px, 24px, 32px). * [ ] **Define Border Radii:** * [ ] **Consistent Values:** Use a small set of consistent border radii (e.g., Small: 4-6px for inputs/buttons; Medium: 8-12px for cards/modals). * [ ] **Develop Core UI Components (with consistent states: default, hover, active, focus, disabled):** * [ ] Buttons (primary, secondary, tertiary/ghost, destructive, link-style; with icon options) * [ ] Input Fields (text, textarea, select, date picker; with clear labels, placeholders, helper text, error messages) * [ ] Checkboxes & Radio Buttons * [ ] Toggles/Switches * [ ] Cards (for content blocks, multimedia items, dashboard widgets) * [ ] Tables (for data display; with clear headers, rows, cells; support for sorting, filtering) * [ ] Modals/Dialogs (for confirmations, forms, detailed views) * [ ] Navigation Elements (Sidebar, Tabs) * [ ] Badges/Tags (for status indicators, categorization) * [ ] Tooltips (for contextual help) * [ ] Progress Indicators (Spinners, Progress Bars) * [ ] Icons (use a single, modern, clean icon set; SVG preferred) * [ ] Avatars ## III. Layout, Visual Hierarchy & Structure * [ ] **Responsive Grid System:** Design based on a responsive grid (e.g., 12-column) for consistent layout across devices. * [ ] **Strategic White Space:** Use ample negative space to improve clarity, reduce cognitive load, and create visual balance. * [ ] **Clear Visual Hierarchy:** Guide the user's eye using typography (size, weight, color), spacing, and element positioning. * [ ] **Consistent Alignment:** Maintain consistent alignment of elements. * [ ] **Main Dashboard Layout:** * [ ] Persistent Left Sidebar: For primary navigation between modules. * [ ] Content Area: Main space for module-specific interfaces. * [ ] (Optional) Top Bar: For global search, user profile, notifications. * [ ] **Mobile-First Considerations:** Ensure the design adapts gracefully to smaller screens. ## IV. Interaction Design & Animations * [ ] **Purposeful Micro-interactions:** Use subtle animations and visual feedback for user actions (hovers, clicks, form submissions, status changes). * [ ] Feedback should be immediate and clear. * [ ] Animations should be quick (150-300ms) and use appropriate easing (e.g., ease-in-out). * [ ] **Loading States:** Implement clear loading indicators (skeleton screens for page loads, spinners for in-component actions). * [ ] **Transitions:** Use smooth transitions for state changes, modal appearances, and section expansions. * [ ] **Avoid Distraction:** Animations should enhance usability, not overwhelm or slow down the user. * [ ] **Keyboard Navigation:** Ensure all interactive elements are keyboard accessible and focus states are clear. ## V. Specific Module Design Tactics ### A. Multimedia Moderation Module * [ ] **Clear Media Display:** Prominent image/video previews (grid or list view). * [ ] **Obvious Moderation Actions:** Clearly labeled buttons (Approve, Reject, Flag, etc.) with distinct styling (e.g., primary/secondary, color-coding). Use icons for quick recognition. * [ ] **Visible Status Indicators:** Use color-coded Badges for content status (Pending, Approved, Rejected). * [ ] **Contextual Information:** Display relevant metadata (uploader, timestamp, flags) alongside media. * [ ] **Workflow Efficiency:** * [ ] Bulk Actions: Allow selection and moderation of multiple items. * [ ] Keyboard Shortcuts: For common moderation actions. * [ ] **Minimize Fatigue:** Clean, uncluttered interface; consider dark mode option. ### B. Data Tables Module (Contacts, Admin Settings) * [ ] **Readability & Scannability:** * [ ] Smart Alignment: Left-align text, right-align numbers. * [ ] Clear Headers: Bold column headers. * [ ] Zebra Striping (Optional): For dense tables. * [ ] Legible Typography: Simple, clean sans-serif fonts. * [ ] Adequate Row Height & Spacing. * [ ] **Interactive Controls:** * [ ] Column Sorting: Clickable headers with sort indicators. * [ ] Intuitive Filtering: Accessible filter controls (dropdowns, text inputs) above the table. * [ ] Global Table Search. * [ ] **Large Datasets:** * [ ] Pagination (preferred for admin tables) or virtual/infinite scroll. * [ ] Sticky Headers / Frozen Columns: If applicable. * [ ] **Row Interactions:** * [ ] Expandable Rows: For detailed information. * [ ] Inline Editing: For quick modifications. * [ ] Bulk Actions: Checkboxes and contextual toolbar. * [ ] Action Icons/Buttons per Row: (Edit, Delete, View Details) clearly distinguishable. ### C. Configuration Panels Module (Microsite, Admin Settings) * [ ] **Clarity & Simplicity:** Clear, unambiguous labels for all settings. Concise helper text or tooltips for descriptions. Avoid jargon. * [ ] **Logical Grouping:** Group related settings into sections or tabs. * [ ] **Progressive Disclosure:** Hide advanced or less-used settings by default (e.g., behind "Advanced Settings" toggle, accordions). * [ ] **Appropriate Input Types:** Use correct form controls (text fields, checkboxes, toggles, selects, sliders) for each setting. * [ ] **Visual Feedback:** Immediate confirmation of changes saved (e.g., toast notifications, inline messages). Clear error messages for invalid inputs. * [ ] **Sensible Defaults:** Provide default values for all settings. * [ ] **Reset Option:** Easy way to "Reset to Defaults" for sections or entire configuration. * [ ] **Microsite Preview (If Applicable):** Show a live or near-live preview of microsite changes. ## VI. CSS & Styling Architecture * [ ] **Choose a Scalable CSS Methodology:** * [ ] **Utility-First (Recommended for LLM):** e.g., Tailwind CSS. Define design tokens in config, apply via utility classes. * [ ] **BEM with Sass:** If not utility-first, use structured BEM naming with Sass variables for tokens. * [ ] **CSS-in-JS (Scoped Styles):** e.g., Stripe's approach for Elements. * [ ] **Integrate Design Tokens:** Ensure colors, fonts, spacing, radii tokens are directly usable in the chosen CSS architecture. * [ ] **Maintainability & Readability:** Code should be well-organized and easy to understand. * [ ] **Performance:** Optimize CSS delivery; avoid unnecessary bloat. ## VII. General Best Practices * [ ] **Iterative Design & Testing:** Continuously test with users and iterate on designs. * [ ] **Clear Information Architecture:** Organize content and navigation logically. * [ ] **Responsive Design:** Ensure the dashboard is fully functional and looks great on all device sizes (desktop, tablet, mobile). * [ ] **Documentation:** Maintain clear documentation for the design system and components. ================================================ FILE: resources/workflows-knowledge-guides/Design-Review-Workflow/design-review-agent.md ================================================ --- name: design-review description: Use this agent when you need to conduct a comprehensive design review on front-end pull requests or general UI changes. This agent should be triggered when a PR modifying UI components, styles, or user-facing features needs review; you want to verify visual consistency, accessibility compliance, and user experience quality; you need to test responsive design across different viewports; or you want to ensure that new UI changes meet world-class design standards. The agent requires access to a live preview environment and uses Playwright for automated interaction testing. Example - "Review the design changes in PR 234" tools: Grep, LS, Read, Edit, MultiEdit, Write, NotebookEdit, WebFetch, TodoWrite, WebSearch, BashOutput, KillBash, ListMcpResourcesTool, ReadMcpResourceTool, mcp__context7__resolve-library-id, mcp__context7__get-library-docs, mcp__playwright__browser_close, mcp__playwright__browser_resize, mcp__playwright__browser_console_messages, mcp__playwright__browser_handle_dialog, mcp__playwright__browser_evaluate, mcp__playwright__browser_file_upload, mcp__playwright__browser_install, mcp__playwright__browser_press_key, mcp__playwright__browser_type, mcp__playwright__browser_navigate, mcp__playwright__browser_navigate_back, mcp__playwright__browser_navigate_forward, mcp__playwright__browser_network_requests, mcp__playwright__browser_take_screenshot, mcp__playwright__browser_snapshot, mcp__playwright__browser_click, mcp__playwright__browser_drag, mcp__playwright__browser_hover, mcp__playwright__browser_select_option, mcp__playwright__browser_tab_list, mcp__playwright__browser_tab_new, mcp__playwright__browser_tab_select, mcp__playwright__browser_tab_close, mcp__playwright__browser_wait_for, Bash, Glob model: sonnet color: pink --- You are an elite design review specialist with deep expertise in user experience, visual design, accessibility, and front-end implementation. You conduct world-class design reviews following the rigorous standards of top Silicon Valley companies like Stripe, Airbnb, and Linear. **Your Core Methodology:** You strictly adhere to the "Live Environment First" principle - always assessing the interactive experience before diving into static analysis or code. You prioritize the actual user experience over theoretical perfection. **Your Review Process:** You will systematically execute a comprehensive design review following these phases: ## Phase 0: Preparation - Analyze the PR description to understand motivation, changes, and testing notes (or just the description of the work to review in the user's message if no PR supplied) - Review the code diff to understand implementation scope - Set up the live preview environment using Playwright - Configure initial viewport (1440x900 for desktop) ## Phase 1: Interaction and User Flow - Execute the primary user flow following testing notes - Test all interactive states (hover, active, disabled) - Verify destructive action confirmations - Assess perceived performance and responsiveness ## Phase 2: Responsiveness Testing - Test desktop viewport (1440px) - capture screenshot - Test tablet viewport (768px) - verify layout adaptation - Test mobile viewport (375px) - ensure touch optimization - Verify no horizontal scrolling or element overlap ## Phase 3: Visual Polish - Assess layout alignment and spacing consistency - Verify typography hierarchy and legibility - Check color palette consistency and image quality - Ensure visual hierarchy guides user attention ## Phase 4: Accessibility (WCAG 2.1 AA) - Test complete keyboard navigation (Tab order) - Verify visible focus states on all interactive elements - Confirm keyboard operability (Enter/Space activation) - Validate semantic HTML usage - Check form labels and associations - Verify image alt text - Test color contrast ratios (4.5:1 minimum) ## Phase 5: Robustness Testing - Test form validation with invalid inputs - Stress test with content overflow scenarios - Verify loading, empty, and error states - Check edge case handling ## Phase 6: Code Health - Verify component reuse over duplication - Check for design token usage (no magic numbers) - Ensure adherence to established patterns ## Phase 7: Content and Console - Review grammar and clarity of all text - Check browser console for errors/warnings **Your Communication Principles:** 1. **Problems Over Prescriptions**: You describe problems and their impact, not technical solutions. Example: Instead of "Change margin to 16px", say "The spacing feels inconsistent with adjacent elements, creating visual clutter." 2. **Triage Matrix**: You categorize every issue: - **[Blocker]**: Critical failures requiring immediate fix - **[High-Priority]**: Significant issues to fix before merge - **[Medium-Priority]**: Improvements for follow-up - **[Nitpick]**: Minor aesthetic details (prefix with "Nit:") 3. **Evidence-Based Feedback**: You provide screenshots for visual issues and always start with positive acknowledgment of what works well. **Your Report Structure:** ```markdown ### Design Review Summary [Positive opening and overall assessment] ### Findings #### Blockers - [Problem + Screenshot] #### High-Priority - [Problem + Screenshot] #### Medium-Priority / Suggestions - [Problem] #### Nitpicks - Nit: [Problem] ``` **Technical Requirements:** You utilize the Playwright MCP toolset for automated testing: - `mcp__playwright__browser_navigate` for navigation - `mcp__playwright__browser_click/type/select_option` for interactions - `mcp__playwright__browser_take_screenshot` for visual evidence - `mcp__playwright__browser_resize` for viewport testing - `mcp__playwright__browser_snapshot` for DOM analysis - `mcp__playwright__browser_console_messages` for error checking You maintain objectivity while being constructive, always assuming good intent from the implementer. Your goal is to ensure the highest quality user experience while balancing perfectionism with practical delivery timelines. ================================================ FILE: resources/workflows-knowledge-guides/Design-Review-Workflow/design-review-claude-md-snippet.md ================================================ ## Visual Development ### Design Principles - Comprehensive design checklist in `/context/design-principles.md` - Brand style guide in `/context/style-guide.md` - When making visual (front-end, UI/UX) changes, always refer to these files for guidance ### Quick Visual Check IMMEDIATELY after implementing any front-end change: 1. **Identify what changed** - Review the modified components/pages 2. **Navigate to affected pages** - Use `mcp__playwright__browser_navigate` to visit each changed view 3. **Verify design compliance** - Compare against `/context/design-principles.md` and `/context/style-guide.md` 4. **Validate feature implementation** - Ensure the change fulfills the user's specific request 5. **Check acceptance criteria** - Review any provided context files or requirements 6. **Capture evidence** - Take full page screenshot at desktop viewport (1440px) of each changed view 7. **Check for errors** - Run `mcp__playwright__browser_console_messages` This verification ensures changes meet design standards and user requirements. ### Comprehensive Design Review Invoke the `@agent-design-review` subagent for thorough design validation when: - Completing significant UI/UX features - Before finalizing PRs with visual changes - Needing comprehensive accessibility and responsiveness testing ================================================ FILE: resources/workflows-knowledge-guides/Design-Review-Workflow/design-review-slash-command.md ================================================ --- allowed-tools: Grep, LS, Read, Edit, MultiEdit, Write, NotebookEdit, WebFetch, TodoWrite, WebSearch, BashOutput, KillBash, ListMcpResourcesTool, ReadMcpResourceTool, mcp__context7__resolve-library-id, mcp__context7__get-library-docs, mcp__playwright__browser_close, mcp__playwright__browser_resize, mcp__playwright__browser_console_messages, mcp__playwright__browser_handle_dialog, mcp__playwright__browser_evaluate, mcp__playwright__browser_file_upload, mcp__playwright__browser_install, mcp__playwright__browser_press_key, mcp__playwright__browser_type, mcp__playwright__browser_navigate, mcp__playwright__browser_navigate_back, mcp__playwright__browser_navigate_forward, mcp__playwright__browser_network_requests, mcp__playwright__browser_take_screenshot, mcp__playwright__browser_snapshot, mcp__playwright__browser_click, mcp__playwright__browser_drag, mcp__playwright__browser_hover, mcp__playwright__browser_select_option, mcp__playwright__browser_tab_list, mcp__playwright__browser_tab_new, mcp__playwright__browser_tab_select, mcp__playwright__browser_tab_close, mcp__playwright__browser_wait_for, Bash, Glob description: Complete a design review of the pending changes on the current branch --- You are an elite design review specialist with deep expertise in user experience, visual design, accessibility, and front-end implementation. You conduct world-class design reviews following the rigorous standards of top Silicon Valley companies like Stripe, Airbnb, and Linear. GIT STATUS: ``` !`git status` ``` FILES MODIFIED: ``` !`git diff --name-only origin/HEAD...` ``` COMMITS: ``` !`git log --no-decorate origin/HEAD...` ``` DIFF CONTENT: ``` !`git diff --merge-base origin/HEAD` ``` Review the complete diff above. This contains all code changes in the PR. OBJECTIVE: Use the design-review agent to comprehensively review the complete diff above, and reply back to the user with the design and review of the report. Your final reply must contain the markdown report and nothing else. Follow and implement the design principles and style guide located in the ../context/design-principles.md and ../context/style-guide.md docs. ================================================ FILE: scripts/README.md ================================================ # Scripts Directory This directory contains all automation scripts for managing the Awesome Claude Code repository. The scripts work together to provide a complete workflow for resource management, from addition to pull request submission. **Important Note**: While the primary submission workflow has moved to GitHub Issues for better user experience, we maintain these manual scripts for several critical purposes: - **Backup submission method** when the automated Issues workflow is unavailable - **Administrative tasks** requiring direct CSV manipulation - **Testing and debugging** the automation pipeline - **Emergency recovery** when automated systems fail ## Overview The scripts implement a CSV-first workflow where `THE_RESOURCES_TABLE.csv` serves as the single source of truth for all resources. The README.md is generated from this CSV data using templates. ## Repo Root Resolution Scripts should never assume the current working directory or rely on fragile parent traversal. Use repo-root discovery (walk up to `pyproject.toml`) and resolve paths from there. File paths should be built from `REPO_ROOT` (e.g., `REPO_ROOT / "THE_RESOURCES_TABLE.csv"`). ```python from pathlib import Path from scripts.utils.repo_root import find_repo_root REPO_ROOT = find_repo_root(Path(__file__)) ``` ### Imports and working directory Most scripts import modules as `scripts.*`. Those imports resolve reliably when: - you run from the repo root (default for local usage and GitHub Actions), or - you set `PYTHONPATH` to the repo root, or - you use `python -m` with the package path. If a script fails with `ModuleNotFoundError: scripts`, run it from the repo root or set `PYTHONPATH`. ### Running scripts with `python -m` When invoking scripts, prefer module paths (dot notation) and omit the `.py` suffix: ```bash python -m scripts.readme.generate_readme python -m scripts.validation.validate_links ``` This only works for modules with a CLI entrypoint (`if __name__ == "__main__":`). ## Directory Structure - `badges/` - Badge notification automation (core + manual) - `categories/` - Category tooling and config helpers - `graphics/` - Logo and branding SVG generation - `ids/` - Resource ID generation utilities - `maintenance/` - Repo chores and maintenance scripts - `testing/` - Test and integration utilities (including `test_regenerate_cycle.py`) - `archive/` - Temporary holding area for deprecated scripts - `readme/` - README generation pipeline, generators, helpers, markup, SVG templates - `resources/` - Resource submission, sorting, and CSV utilities - `ticker/` - Repo ticker data fetch + SVG generation - `utils/` - Shared git helpers - `validation/` - URL and submission validation scripts ## Category System ### `categories/category_utils.py` **Purpose**: Unified category management system **Usage**: `from scripts.categories.category_utils import category_manager` **Features**: - Singleton pattern for efficient data loading - Reads categories from `templates/categories.yaml` - Provides methods for category lookup, validation, and ordering - Used by all scripts that need category information ### Adding New Categories To add a new category: 1. Edit `templates/categories.yaml` and add your category with: - `id`: Unique identifier - `name`: Display name - `prefix`: ID prefix (e.g., "cmd" for Slash-Commands) - `icon`: Emoji icon - `order`: Sort order - `description`: Markdown description - `subcategories`: Optional list of subcategories 2. Update `.github/ISSUE_TEMPLATE/recommend-resource.yml` to add the category to the dropdown 3. If subcategories were added, run `make generate-toc-assets` to create subcategory TOC SVGs 4. Run `make generate` to update the README All scripts automatically use the new category without any code changes. ## Automated Backend Scripts These scripts power the GitHub Issues-based submission workflow and are executed automatically by GitHub Actions: ### `resources/parse_issue_form.py` **Purpose**: Parses GitHub issue form submissions and extracts resource data **Usage**: Called by `validate-resource-submission.yml` workflow **Features**: - Extracts structured data from issue body - Validates form field completeness - Converts form data to resource format - Provides validation feedback as issue comments ### `resources/create_resource_pr.py` **Purpose**: Creates pull requests from approved resource submissions **Usage**: Called by `approve-resource-submission.yml` workflow **Features**: - Generates unique resource IDs - Adds resources to CSV database - Creates feature branches automatically - Opens PR with proper linking to original issue - Handles pre-commit hooks gracefully ## Core Workflow Scripts (Manual/Admin Use) ### 1. `resources/resource_utils.py` **Purpose**: CSV append helpers and PR content generation **Usage**: Imported by `resources/create_resource_pr.py` **Notes**: - Keeps CSV writes aligned to header order - Generates standardized PR content for automated submissions ### 2. `readme/generate_readme.py` **Purpose**: Generates multiple README styles from CSV data using templates **Usage**: `make generate` **Features**: - Template-based generation from `templates/README_EXTRA.template.md` (and other templates) - Configurable root style via `acc-config.yaml` - Dynamic style selector and repo ticker via placeholders - Hierarchical table of contents generation - Preserves custom sections from template - Automatic backup before generation - **GitHub Stats Integration**: Automatically adds collapsible repository statistics for GitHub resources - Displays stars, forks, issues, and other metrics via GitHub Stats API - Uses disclosure elements (`
`) to keep the main list clean - Works with all GitHub URL formats (repository root, blob URLs, etc.) #### Collapsible Sections The generated README uses collapsible `
` elements for better navigation: - **Categories WITHOUT subcategories**: Wrapped in `
` (fully collapsible) - **Categories WITH subcategories**: Use regular headers (subcategories are collapsible) - **All subcategories**: Wrapped in `
` elements - **Table of Contents**: Main wrapper and nested categories use `
` **Note on anchor links**: Initially, all categories were made collapsible, but this caused issues with anchor links from the Table of Contents - links couldn't navigate to subcategories when their parent category was collapsed. The current design balances navigation and collapsibility. ### 2a. `readme/helpers/generate_toc_assets.py` **Purpose**: Regenerates subcategory TOC SVG assets from `templates/categories.yaml` **Usage**: `make generate-toc-assets` **Features**: - Creates/updates `toc-sub-*.svg` and `toc-sub-*-light-anim-scanline.svg` files in `assets/` - Uses `regenerate_sub_toc_svgs()` from `readme_assets.py` with categories from `category_manager` - Should be run after adding or modifying subcategories in `templates/categories.yaml` - SVGs are used by the Visual (Extra) README style for subcategory TOC rows ### 2b. `ticker/generate_ticker_svg.py` **Purpose**: Generates animated SVG tickers showing featured projects **Usage**: `python scripts/ticker/generate_ticker_svg.py` **Features**: - Reads repo stats from `data/repo-ticker.csv` - Generates three ticker themes: dark (CRT), light (vintage), awesome (minimal) - Displays repo name, owner, stars, and daily delta - Seamless horizontal scrolling animation ### 2c. `ticker/fetch_repo_ticker_data.py` **Purpose**: Fetches GitHub statistics for repos tracked in the ticker **Usage**: `python scripts/ticker/fetch_repo_ticker_data.py` **Features**: - Queries GitHub API for stars, forks, watchers - Calculates deltas from previous run - Outputs to `data/repo-ticker.csv` - Requires `GITHUB_TOKEN` environment variable ### 4. `validation/validate_links.py` **Purpose**: Validates all URLs in the CSV database **Usage**: `make validate` **Features**: - Batch URL validation with progress bar - GitHub API integration for repository checks - License detection from GitHub repos - Last modified date fetching - Exponential backoff for rate limiting - Override support from `.templates/resource-overrides.yaml` - JSON output for CI/CD integration ### 5. `resources/download_resources.py` **Purpose**: Downloads resources from GitHub repositories **Usage**: `make download-resources` **Features**: - Downloads files from GitHub repositories - Respects license restrictions - Category and license filtering - Rate limiting support - Progress tracking - Creates organized directory structure ## Helper Modules ### 6. `utils/git_utils.py` **Purpose**: Git and GitHub utility functions **Interface**: - `get_github_username()`: Retrieves GitHub username - `get_current_branch()`: Gets active git branch - `create_branch()`: Creates new git branch - `commit_changes()`: Commits with message - `push_to_remote()`: Pushes branch to remote - GitHub CLI integration utilities ### 7. `utils/github_utils.py` **Purpose**: Shared GitHub API helpers **Interface**: - `parse_github_url()`: Parse GitHub URLs into API endpoints - `get_github_client()`: Pygithub client with request pacing - `github_request_json()`: JSON requests via PyGithub requester ### 8. `validation/validate_single_resource.py` **Purpose**: Validates individual resources **Usage**: `make validate-single URL=...` **Interface**: - `validate_single_resource()`: Validates URL and fetches metadata using kwargs - Used by issue submission validation and manual validation workflows - Supports both regular URLs and GitHub repositories ### 9. `resources/sort_resources.py` **Purpose**: Sorts CSV entries by category hierarchy **Usage**: `make sort` (called automatically by `make generate`) **Features**: - Maintains consistent ordering - Sorts by: Category → Sub-Category → Display Name - Uses category order from `categories.yaml` - Preserves CSV structure and formatting ## Utility Scripts ### 10. `ids/generate_resource_id.py` **Purpose**: Interactive resource ID generator **Usage**: `python scripts/ids/generate_resource_id.py` **Features**: - Interactive prompts for display name, link, and category - Shows all available categories from `categories.yaml` - Displays generated ID and CSV row preview ### 11. `ids/resource_id.py` **Purpose**: Shared resource ID generation module **Usage**: `from resource_id import generate_resource_id` **Features**: - Central function used by all ID generation scripts - Uses category prefixes from `categories.yaml` - Ensures consistent ID generation across the project ### 12. `badges/badge_notification_core.py` **Purpose**: Core functionality for badge notification system **Usage**: `from scripts.badges.badge_notification_core import BadgeNotificationCore` **Features**: - Shared notification logic used by other badge scripts - Input validation and sanitization - GitHub API interaction utilities - Template rendering for notification messages ### 13. `badges/badge_notification.py` **Purpose**: Action-only notifier for merged resource PRs **Usage**: Used by `notify-on-merge.yml` (not intended for manual execution) **Features**: - Sends a single notification issue to the resource repository - Uses `badge_notification_core.py` for shared logic ### 14. `graphics/generate_logo_svgs.py` **Purpose**: Generates SVG logos for the repository **Usage**: `python -m scripts.graphics.generate_logo_svgs` **Features**: - Creates consistent branding assets - Generates light/dark logo variants - Supports dark/light mode variants - Used for README badges and documentation ## Workflow Integration ### Primary Workflow (GitHub Issues) **For Users**: Recommend resources through the GitHub Issue form at `.github/ISSUE_TEMPLATE/recommend-resource.yml` 1. User fills out the issue form 2. `validate-resource-submission.yml` workflow validates the submission automatically 3. Maintainer reviews and uses `/approve` command 4. `approve-resource-submission.yml` workflow creates the PR automatically ### Manual Backup Workflows (Make Commands) These commands remain available for maintainers and emergency situations: #### Adding a Resource Manually ```bash make generate # Regenerate README make validate # Validate all links ``` ### Maintenance Tasks ```bash make sort # Sort CSV entries make validate # Check all links make download-resources # Archive resources make generate-toc-assets # Regenerate subcategory TOC SVGs (after adding subcategories) ``` ## Configuration Scripts respect these configuration files: - `.templates/resource-overrides.yaml`: Manual overrides for resources - `.env`: Environment variables (not tracked in git) ## Environment Variables - `GITHUB_TOKEN`: For API rate limiting (optional but recommended) - `AWESOME_CC_PAT_PUBLIC_REPO`: For badge notifications - `AWESOME_CC_FORK_REMOTE`: Git remote name for fork (default: origin) - `AWESOME_CC_UPSTREAM_REMOTE`: Git remote name for upstream (default: upstream) ## Development Notes 1. All scripts include comprehensive error handling 2. Progress bars and user feedback for long operations 3. Backup creation before destructive operations 4. Consistent use of pathlib for cross-platform compatibility 5. Type hints and docstrings throughout 6. Scripts can be run standalone or through Make targets ### Naming Conventions **Status Lines category** (2025-09-16): The "Statusline" category was renamed to "Status Lines" (title case, plural) for consistency with other categories like "Hooks". This change was made throughout: - Category name: "Status Lines" (was "Statusline" or "Status line") - The `id` remains `statusline` to preserve backward compatibility - CSV entries updated to use "Status Lines" as the category value - All display text uses the title case plural form "Status Lines" This ensures consistent title case and pluralization across categories. If issues arise with status line resources, verify that the category name matches "Status Lines" in CSV entries. ### Announcements System **YAML Format** (2025-09-17): Announcements migrated from Markdown to YAML format for better structure and rendering: **File**: `templates/announcements.yaml` **Structure**: ```yaml - date: "YYYY-MM-DD" title: "Announcement Title" # Optional items: - "Simple text item" - summary: "Collapsible item" text: "Detailed description that can be expanded" ``` **Features**: - Automatically renders as nested collapsible sections in README - Each date group is collapsible - Individual items can be simple text or collapsible with summary/text - Supports multi-line text in detailed descriptions - Falls back to `.md` file if YAML doesn't exist for backward compatibility ## Future Considerations - Additional validation rules could be added - More sophisticated duplicate detection ================================================ FILE: scripts/__init__.py ================================================ ================================================ FILE: scripts/archive/README.md ================================================ # Archive Temporary holding area for deprecated scripts that are no longer wired into the active toolchain, but are kept for reference while being evaluated for removal. ================================================ FILE: scripts/archive/__init__.py ================================================ """Archived/deprecated scripts.""" ================================================ FILE: scripts/badges/BADGE_AUTOMATION_SETUP.md ================================================ # Badge Issue Notification Setup Guide ## Overview This system creates friendly notification issues on GitHub repositories when they are **newly** featured in the Awesome Claude Code list. It only notifies for new additions, not existing entries. ## Prerequisites 1. Python 3.11+ 2. PyGithub library (installed automatically via pyproject.toml) ## GitHub Action Setup ### 1. Required Setup Add your Personal Access Token as a repository secret named `AWESOME_CC_PAT_PUBLIC_REPO`: 1. Go to Settings → Secrets and variables → Actions 2. Click "New repository secret" 3. Name: `AWESOME_CC_PAT_PUBLIC_REPO` 4. Value: Your Personal Access Token with `public_repo` scope ### 2. Automatic Triggers The action automatically runs when resource PRs are merged by the automation bot. ## How It Works ### Issue Creation Process 1. Extracts the GitHub URL and resource name from the merged PR 2. Runs `scripts/badges/badge_notification.py` to send a single notification issue ### Issue Content - Friendly greeting and announcement - Description of Awesome Claude Code - Two badge style options (standard and flat) - Clear markdown snippets for easy copying - No action required message ### Duplicate Prevention - Checks for existing issues by the bot ## Features ### Advantages Over PR Approach - ✅ Non-intrusive - just information - ✅ No code changes required - ✅ Maintainers can close anytime - ✅ Much simpler implementation - ✅ No fork/branch management - ✅ Faster processing ### Error Handling - Gracefully handles: - Private repositories - Disabled issues - Rate limiting - Invalid URLs ================================================ FILE: scripts/badges/__init__.py ================================================ ================================================ FILE: scripts/badges/badge_notification.py ================================================ #!/usr/bin/env python3 """ Badge Issue Notification (GitHub Actions only). Creates a single notification issue in a specified GitHub repository when a resource PR is merged. This script is designed for automated use in GitHub Actions and is not intended for manual execution. """ import os import sys from pathlib import Path from scripts.utils.repo_root import find_repo_root # Try to load .env file if it exists try: from dotenv import load_dotenv # type: ignore[import] load_dotenv() except ImportError: pass REPO_ROOT = find_repo_root(Path(__file__)) sys.path.insert(0, str(REPO_ROOT)) from scripts.badges.badge_notification_core import BadgeNotificationCore # noqa: E402 def main(): """Main execution for automated notification via GitHub Actions.""" # Get inputs from environment variables (set by GitHub Actions) repo_url = os.environ.get("REPOSITORY_URL", "").strip() resource_name = os.environ.get("RESOURCE_NAME", "").strip() or None description = os.environ.get("DESCRIPTION", "").strip() or None # Validate required inputs if not repo_url: print("Error: REPOSITORY_URL environment variable is required") sys.exit(1) # Get GitHub token github_token = os.environ.get("AWESOME_CC_PAT_PUBLIC_REPO") if not github_token: print("Error: AWESOME_CC_PAT_PUBLIC_REPO environment variable is required") print("This token needs 'public_repo' scope to create issues in external repositories") sys.exit(1) # Log the operation print(f"Sending notification to: {repo_url}") if resource_name: print(f"Resource name: {resource_name}") if description: print(f"Description: {description[:100]}...") try: # Initialize the core notification system notifier = BadgeNotificationCore(github_token) # Send the notification using the core module result = notifier.create_notification_issue( repo_url=repo_url, resource_name=resource_name, description=description, ) # Handle the result if result["success"]: print(f"✅ Success! Issue created: {result['issue_url']}") sys.exit(0) else: print(f"❌ Failed: {result['message']}") # Provide helpful guidance based on error if "Security validation failed" in result["message"]: print("\n🛡️ SECURITY: Dangerous content detected in input") print(" The operation was aborted for security reasons.") print(" Check the resource name and description for:") print(" - HTML tags or JavaScript") print(" - Protocol handlers (javascript:, data:, etc.)") print(" - Event handlers (onclick=, onerror=, etc.)") elif "Invalid or dangerous" in result["message"]: print("\n💡 Tip: Ensure the URL is a valid GitHub repository URL") print(" Format: https://github.com/owner/repository") elif "Rate limit" in result["message"]: print("\n💡 Tip: GitHub API rate limit reached. Please wait and try again.") elif "Permission denied" in result["message"]: print("\n💡 Tip: Ensure your PAT has 'public_repo' scope") elif "not found or private" in result["message"]: print("\n💡 Tip: The repository may be private or deleted") elif "issues disabled" in result["message"]: print("\n💡 Tip: The repository has issues disabled in settings") sys.exit(1) except ValueError as e: # Handle initialization errors (e.g., missing token) print(f"❌ Error: {e}") sys.exit(1) except Exception as e: # Handle unexpected errors print(f"❌ Unexpected error: {e}") sys.exit(1) if __name__ == "__main__": main() ================================================ FILE: scripts/badges/badge_notification_core.py ================================================ #!/usr/bin/env python3 """ Core module for badge notification system Shared functionality for both automated and manual badge notifications Includes security hardening, rate limiting, and error handling """ import json import logging import re import time from datetime import datetime from pathlib import Path from github import Github from github.GithubException import ( BadCredentialsException, GithubException, RateLimitExceededException, UnknownObjectException, ) from scripts.utils.github_utils import get_github_client, parse_github_url # Configure logging logging.basicConfig(level=logging.INFO) logger = logging.getLogger(__name__) class RateLimiter: """Handle GitHub API rate limiting with exponential backoff""" def __init__(self): self.last_request_time = 0 self.request_count = 0 self.backoff_seconds = 1 self.max_backoff = 60 def check_rate_limit(self, github_client: Github) -> dict: """Check current rate limit status""" try: rate_limit = github_client.get_rate_limit() core = rate_limit.resources.core return { "remaining": core.remaining, "limit": core.limit, "reset_time": core.reset.timestamp(), "should_pause": core.remaining < 100, "should_stop": core.remaining < 10, } except Exception as e: logger.warning(f"Could not check rate limit: {e}") return { "remaining": -1, "limit": -1, "reset_time": 0, "should_pause": False, "should_stop": False, } def wait_if_needed(self, github_client: Github): """Wait if rate limiting requires it""" status = self.check_rate_limit(github_client) if status["should_stop"]: wait_time = max(0, status["reset_time"] - time.time()) logger.warning( f"Rate limit nearly exhausted. Waiting {wait_time:.0f} seconds until reset" ) time.sleep(wait_time + 1) elif status["should_pause"]: logger.info( f"Rate limit low ({status['remaining']} remaining). " f"Pausing {self.backoff_seconds} seconds" ) time.sleep(self.backoff_seconds) self.backoff_seconds = min(self.backoff_seconds * 2, self.max_backoff) else: # Reset backoff if we're doing well if status["remaining"] > 1000: self.backoff_seconds = 1 def handle_rate_limit_error(self, error: RateLimitExceededException): """Handle rate limit exception""" reset_time = error.headers.get("X-RateLimit-Reset", "0") if error.headers else "0" wait_time = max(0, int(reset_time) - time.time()) logger.error(f"Rate limit exceeded. Waiting {wait_time} seconds until reset") time.sleep(wait_time + 1) class BadgeNotificationCore: """Core functionality for badge notifications with security hardening""" # Configuration ISSUE_TITLE = "🎉 Your project has been featured in Awesome Claude Code!" NOTIFICATION_LABEL = "awesome-claude-code" GITHUB_URL_BASE = "https://github.com/hesreallyhim/awesome-claude-code" def __init__(self, github_token: str): """Initialize with GitHub token""" if not github_token: raise ValueError("GitHub token is required") self.github = get_github_client(token=github_token) self.rate_limiter = RateLimiter() @staticmethod def validate_input_safety(text: str, field_name: str = "input") -> tuple[bool, str]: """ Validate that input text is safe for use in GitHub issues. Returns (is_safe, reason_if_unsafe) This does NOT modify the input - it only checks for dangerous content. If dangerous content is found, the operation should be aborted. """ if not text: return True, "" # Check for dangerous protocol handlers dangerous_protocols = [ "javascript:", "data:", "vbscript:", "file:", "about:", "chrome:", "ms-", ] for protocol in dangerous_protocols: if protocol.lower() in text.lower(): reason = f"Dangerous protocol '{protocol}' detected in {field_name}" logger.warning(f"SECURITY: {reason} - Content: {text[:100]}") return False, reason # Check for HTML/script injection attempts dangerous_patterns = [ " max_length: reason = f"{field_name} exceeds maximum length ({len(text)} > {max_length})" logger.warning(f"SECURITY: {reason}") return False, reason # Check for null bytes (can cause issues in various systems) if "\x00" in text: reason = f"Null byte detected in {field_name}" logger.warning(f"SECURITY: {reason}") return False, reason # Check for control characters (except newline and tab) control_chars = [chr(i) for i in range(0, 32) if i not in [9, 10, 13]] for char in control_chars: if char in text: reason = f"Control character (ASCII {ord(char)}) detected in {field_name}" logger.warning(f"SECURITY: {reason}") return False, reason return True, "" @staticmethod def validate_github_url(url: str) -> bool: """ Strictly validate GitHub URL format Prevents command injection and other URL-based attacks """ if not url: return False # Only allow HTTPS GitHub URLs if not url.startswith("https://github.com/"): return False # Check for dangerous characters that could be used for injection dangerous_chars = [ ";", "|", "&", "`", "$", "(", ")", "{", "}", "<", ">", "\n", "\r", "\\", "'", '"', ] if any(char in url for char in dangerous_chars): return False # Strict regex for GitHub URLs # Only allow alphanumeric, dash, dot, underscore in owner/repo names pattern = r"^https://github\.com/[\w\-\.]+/[\w\-\.]+(?:\.git)?/?$" if not re.match(pattern, url): return False # Check for path traversal attempts return ".." not in url def create_issue_body(self, resource_name: str, description: str = "") -> str: """Create issue body with badge options after validating inputs""" # Validate inputs - DO NOT modify them is_safe, reason = self.validate_input_safety(resource_name, "resource_name") if not is_safe: raise ValueError(f"Security validation failed: {reason}") if description: is_safe, reason = self.validate_input_safety(description, "description") if not is_safe: raise ValueError(f"Security validation failed: {reason}") # Use the ORIGINAL, unmodified values in the template # If they were unsafe, we would have thrown an exception above final_description = ( description if description else f"Your project {resource_name} provides valuable resources " f"for the Claude Code community." ) # Use the original values directly return f"""Hello! 👋 I'm excited to let you know that **{resource_name}** has been featured in the [Awesome Claude Code]({self.GITHUB_URL_BASE}) list! ## About Awesome Claude Code Awesome Claude Code is a curated collection of the best slash-commands, CLAUDE.md files, CLI tools, and other resources for enhancing Claude Code workflows. Your project has been recognized for its valuable contribution to the Claude Code community. ## Your Listing {final_description} You can find your entry here: [View in Awesome Claude Code]({self.GITHUB_URL_BASE}) ## Show Your Recognition! 🏆 If you'd like to display a badge in your README to show that your project is featured, you can use one of these: ### Option 1: Standard Badge ```markdown [![Mentioned in Awesome Claude Code](https://awesome.re/mentioned-badge.svg)]({self.GITHUB_URL_BASE}) ``` [![Mentioned in Awesome Claude Code](https://awesome.re/mentioned-badge.svg)]({self.GITHUB_URL_BASE}) ### Option 2: Flat Badge ```markdown [![Mentioned in Awesome Claude Code](https://awesome.re/mentioned-badge-flat.svg)]({self.GITHUB_URL_BASE}) ``` [![Mentioned in Awesome Claude Code](https://awesome.re/mentioned-badge-flat.svg)]({self.GITHUB_URL_BASE}) ## No Action Required This is just a friendly notification - no action is required on your part. Feel free to close this issue at any time. Thank you for contributing to the Claude Code ecosystem! 🙏 --- *This notification was sent because your project was added to the Awesome Claude Code list. This is a one-time notification.*""" # noqa: E501 def can_create_label(self, repo) -> bool: """Check if we can create labels (requires write access)""" try: # Apply rate limiting self.rate_limiter.wait_if_needed(self.github) # Try to create or get the label try: repo.get_label(self.NOTIFICATION_LABEL) return True # Label already exists except UnknownObjectException: # Label doesn't exist, try to create it repo.create_label( self.NOTIFICATION_LABEL, "f39c12", "Featured in Awesome Claude Code" ) return True except GithubException as e: if e.status == 403: logger.info(f"No permission to create labels in {repo.full_name}") else: logger.warning(f"Could not create label for {repo.full_name}: {e}") return False except Exception as e: logger.warning(f"Unexpected error creating label for {repo.full_name}: {e}") return False def create_notification_issue( self, repo_url: str, resource_name: str | None = None, description: str | None = None, ) -> dict: """ Create a notification issue in the specified repository Returns dict with: success, message, issue_url, repo_url """ result = { "repo_url": repo_url, "success": False, "message": "", "issue_url": None, } # Validate and parse URL if not self.validate_github_url(repo_url): result["message"] = "Invalid or dangerous GitHub URL format" return result _, is_github, owner, repo_name = parse_github_url(repo_url) if not is_github or not owner or not repo_name: result["message"] = "Invalid or dangerous GitHub URL format" return result repo_full_name = f"{owner}/{repo_name}" # Use resource name from input or default to repo name if not resource_name: resource_name = repo_name # Skip Anthropic repositories if "anthropic" in owner.lower() or "anthropic" in repo_name.lower(): result["message"] = "Skipping Anthropic repository" return result try: # Apply rate limiting self.rate_limiter.wait_if_needed(self.github) # Get the repository repo = self.github.get_repo(repo_full_name) # Try to create or use label labels = [] if self.can_create_label(repo): labels = [self.NOTIFICATION_LABEL] # Create the issue body (this will validate inputs and throw if unsafe) try: issue_body = self.create_issue_body(resource_name, description or "") except ValueError as e: # Security validation failed - abort the operation result["message"] = str(e) logger.error(f"Security validation failed for {repo_full_name}: {e}") return result # Apply rate limiting before creating issue self.rate_limiter.wait_if_needed(self.github) # Create the issue issue = repo.create_issue(title=self.ISSUE_TITLE, body=issue_body, labels=labels) result["success"] = True result["message"] = "Issue created successfully" result["issue_url"] = issue.html_url except UnknownObjectException: result["message"] = "Repository not found or private" except BadCredentialsException: result["message"] = "Invalid GitHub token" except RateLimitExceededException as e: self.rate_limiter.handle_rate_limit_error(e) result["message"] = "Rate limit exceeded - please try again later" except GithubException as e: if e.status == 410: result["message"] = "Repository has issues disabled" elif e.status == 403: if "Resource not accessible" in str(e): result["message"] = "Insufficient permissions - requires public_repo scope" else: result["message"] = "Permission denied - check PAT permissions" else: logger.error(f"GitHub API error for {repo_full_name}: {e}") result["message"] = f"GitHub API error (status {e.status})" except Exception as e: logger.error(f"Unexpected error for {repo_full_name}: {e}") result["message"] = f"Unexpected error: {str(e)[:100]}" return result class ManualNotificationTracker: """Optional state tracking for manual notifications""" def __init__(self, tracking_file: str = ".manual_notifications.json"): self.tracking_file = Path(tracking_file) self.history = self._load_history() def _load_history(self) -> list: """Load notification history from file""" if self.tracking_file.exists(): try: with open(self.tracking_file) as f: return json.load(f) except Exception as e: logger.warning(f"Could not load history: {e}") return [] def _save_history(self): """Save notification history to file""" try: with open(self.tracking_file, "w") as f: json.dump(self.history, f, indent=2) except Exception as e: logger.warning(f"Could not save history: {e}") def record_notification(self, repo_url: str, issue_url: str, resource_name: str = ""): """Record a manual notification""" entry = { "repo_url": repo_url, "issue_url": issue_url, "resource_name": resource_name, "timestamp": datetime.now().isoformat(), } self.history.append(entry) self._save_history() def get_notification_count(self, repo_url: str, time_window_hours: int = 24) -> int: """Get count of recent notifications for a repository""" cutoff = datetime.now().timestamp() - (time_window_hours * 3600) count = 0 for entry in self.history: if entry["repo_url"] == repo_url: try: timestamp = datetime.fromisoformat(entry["timestamp"]).timestamp() if timestamp > cutoff: count += 1 except Exception: pass return count def has_recent_notification(self, repo_url: str, time_window_hours: int = 24) -> bool: """Check if repository was notified recently""" return self.get_notification_count(repo_url, time_window_hours) > 0 ================================================ FILE: scripts/categories/__init__.py ================================================ ================================================ FILE: scripts/categories/add_category.py ================================================ #!/usr/bin/env python3 """ Script to automate adding a new category to awesome-claude-code. This handles all the necessary file updates and regenerates the README. """ import argparse import subprocess import sys from pathlib import Path import yaml from scripts.utils.repo_root import find_repo_root # Add repo root to path for imports REPO_ROOT = find_repo_root(Path(__file__)) sys.path.insert(0, str(REPO_ROOT)) from scripts.categories.category_utils import category_manager # noqa: E402 class CategoryAdder: """Handles the process of adding a new category to the repository.""" def __init__(self, repo_root: Path): """Initialize the CategoryAdder with the repository root path.""" self.repo_root = repo_root self.templates_dir = repo_root / "templates" self.github_dir = repo_root / ".github" / "ISSUE_TEMPLATE" def get_max_order(self) -> int: """Get the maximum order value from existing categories.""" categories = category_manager.get_categories_for_readme() if not categories: return 0 return max(cat.get("order", 0) for cat in categories) def add_category_to_yaml( self, category_id: str, name: str, prefix: str, icon: str, description: str, order: int | None = None, subcategories: list[str] | None = None, ) -> bool: """ Add a new category to categories.yaml. Args: category_id: The ID for the category (e.g., "alternative-clients") name: Display name (e.g., "Alternative Clients") prefix: ID prefix for resources (e.g., "client") icon: Emoji icon for the category description: Markdown description of the category order: Order in the list (if None, will be added at the end) subcategories: List of subcategory names (defaults to ["General"]) Returns: True if successful, False otherwise """ categories_file = self.templates_dir / "categories.yaml" # Load existing categories with open(categories_file, encoding="utf-8") as f: data = yaml.safe_load(f) if not data or "categories" not in data: print("Error: Invalid categories.yaml structure") return False # Check if category already exists for cat in data["categories"]: if cat["id"] == category_id: print(f"Category '{category_id}' already exists") return False # Determine order if order is None: order = self.get_max_order() + 1 # Prepare subcategories if subcategories is None: subcategories = ["General"] subcats_data = [{"id": sub.lower().replace(" ", "-"), "name": sub} for sub in subcategories] # Create new category entry new_category = { "id": category_id, "name": name, "prefix": prefix, "icon": icon, "description": description, "order": order, "subcategories": subcats_data, } # If inserting with specific order, update other categories' orders if order <= self.get_max_order(): for cat in data["categories"]: if cat.get("order", 0) >= order: cat["order"] = cat.get("order", 0) + 1 # Add the new category data["categories"].append(new_category) # Sort categories by order data["categories"] = sorted(data["categories"], key=lambda x: x.get("order", 999)) # Write back to file with open(categories_file, "w", encoding="utf-8") as f: yaml.dump(data, f, default_flow_style=False, sort_keys=False, allow_unicode=True) print(f"✅ Added '{name}' to categories.yaml with order {order}") return True def update_issue_template(self, name: str) -> bool: """ Update the GitHub issue template to include the new category. Args: name: Display name of the category Returns: True if successful, False otherwise """ template_file = self.github_dir / "recommend-resource.yml" with open(template_file, encoding="utf-8") as f: content = f.read() # Find the category dropdown section lines = content.split("\n") in_category_section = False category_start_idx = -1 category_end_idx = -1 for i, line in enumerate(lines): if "id: category" in line: in_category_section = True continue if in_category_section: if "options:" in line: category_start_idx = i + 1 elif category_start_idx > 0 and line.strip() and not line.strip().startswith("-"): category_end_idx = i break if category_start_idx < 0: print("Error: Could not find category options in issue template") return False # Extract existing categories existing_categories = [] for i in range(category_start_idx, category_end_idx): line = lines[i].strip() if line.startswith("- "): existing_categories.append(line[2:]) # Check if category already exists if name in existing_categories: print(f"Category '{name}' already exists in issue template") return True # Find where to insert (before Official Documentation) insert_idx = category_start_idx for i in range(category_start_idx, category_end_idx): if "Official Documentation" in lines[i]: insert_idx = i break # Insert the new category lines.insert(insert_idx, f" - {name}") # Write back to file with open(template_file, "w", encoding="utf-8") as f: f.write("\n".join(lines)) print(f"✅ Added '{name}' to GitHub issue template") return True def generate_readme(self) -> bool: """Generate the README using make generate.""" print("\n📝 Generating README...") try: result = subprocess.run( ["make", "generate"], cwd=self.repo_root, capture_output=True, text=True, check=False, ) if result.returncode != 0: print("Error generating README:") if result.stderr: print(result.stderr) return False print("✅ README generated successfully") return True except FileNotFoundError: print("Error: 'make' command not found") return False def create_commit(self, name: str) -> bool: """Create a commit with the changes.""" print("\n📦 Creating commit...") try: # Stage the changes files_to_stage = [ "templates/categories.yaml", ".github/ISSUE_TEMPLATE/recommend-resource.yml", "README.md", ] for file in files_to_stage: subprocess.run( ["git", "add", file], cwd=self.repo_root, check=True, capture_output=True, ) # Create commit commit_message = f"""Add new category: {name} - Add {name} category to templates/categories.yaml - Update GitHub issue template to include {name} - Regenerate README with new category section 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude """ result = subprocess.run( ["git", "commit", "-m", commit_message], cwd=self.repo_root, capture_output=True, text=True, check=False, ) if result.returncode != 0: if "nothing to commit" in result.stdout: print("No changes to commit") else: print("Error creating commit:") if result.stderr: print(result.stderr) return False else: print(f"✅ Created commit for '{name}' category") return True except subprocess.CalledProcessError as e: print(f"Error with git operations: {e}") return False def interactive_mode(adder: CategoryAdder) -> None: """Run the script in interactive mode, prompting for all inputs.""" print("=" * 60) print("ADD NEW CATEGORY TO AWESOME CLAUDE CODE") print("=" * 60) print() # Get category details name = input("Enter category display name (e.g., 'Alternative Clients'): ").strip() if not name: print("Error: Name is required") sys.exit(1) # Generate ID from name category_id = name.lower().replace(" ", "-").replace("&", "and") suggested_id = category_id category_id = input(f"Enter category ID (default: '{suggested_id}'): ").strip() or suggested_id # Generate prefix from name suggested_prefix = name.lower().split()[0][:6] prefix = input(f"Enter ID prefix (default: '{suggested_prefix}'): ").strip() or suggested_prefix # Get icon icon = input("Enter emoji icon (e.g., 🔌): ").strip() or "📦" # Get description print("\nEnter description (can be multiline, enter '---' on a new line to finish):") description_lines = [] while True: line = input() if line == "---": break description_lines.append(line) description = "\n".join(description_lines) if description and not description.startswith(">"): description = "> " + description.replace("\n", "\n> ") # Get order max_order = adder.get_max_order() order_input = input( f"Enter order position (1-{max_order + 1}, default: {max_order + 1}): " ).strip() order = int(order_input) if order_input else max_order + 1 # Get subcategories print("\nSubcategories Configuration:") print("Most categories only need 'General'. Add more only if you need specific groupings.") print("Examples:") print(" - For simple categories: Just press Enter (uses 'General')") print(" - For complex categories: General, Advanced, Experimental") print("\nEnter subcategories (comma-separated, default: 'General'):") subcats_input = input("> ").strip() subcategories = ( [s.strip() for s in subcats_input.split(",") if s.strip()] if subcats_input else ["General"] ) # Ensure General is always included if not explicitly added if subcategories and "General" not in subcategories: print("\nNote: Consider including 'General' as a catch-all subcategory.") # Confirm print("\n" + "=" * 60) print("SUMMARY") print("=" * 60) print(f"Name: {name}") print(f"ID: {category_id}") print(f"Prefix: {prefix}") print(f"Icon: {icon}") print(f"Order: {order}") print(f"Subcategories: {', '.join(subcategories)}") print(f"Description:\n{description}") print("=" * 60) confirm = input("\nProceed with adding this category? (y/n): ").strip().lower() if confirm != "y": print("Cancelled") sys.exit(0) # Add the category if not adder.add_category_to_yaml( category_id, name, prefix, icon, description, order, subcategories ): sys.exit(1) if not adder.update_issue_template(name): sys.exit(1) if not adder.generate_readme(): sys.exit(1) # Ask about commit commit_confirm = input("\nCreate a commit with these changes? (y/n): ").strip().lower() if commit_confirm == "y": adder.create_commit(name) print("\n✨ Category added successfully!") print("\n📝 Note: The category will appear in the Table of Contents only after") print(" resources are added to it. This is by design to keep the ToC clean.") def main(): """Main entry point for the script.""" parser = argparse.ArgumentParser( description="Add a new category to awesome-claude-code", formatter_class=argparse.RawDescriptionHelpFormatter, epilog=""" Examples: %(prog)s # Interactive mode %(prog)s --name "My Category" --prefix "mycat" --icon "🎯" %(prog)s --name "Tools" --order 5 --subcategories "CLI,GUI,Web" """, ) parser.add_argument("--name", help="Display name for the category") parser.add_argument("--id", help="Category ID (defaults to slugified name)") parser.add_argument("--prefix", help="ID prefix for resources") parser.add_argument("--icon", default="📦", help="Emoji icon for the category") parser.add_argument( "--description", help="Description of the category (will be prefixed with '>')" ) parser.add_argument("--order", type=int, help="Order position in the list") parser.add_argument( "--subcategories", help="Comma-separated list of subcategories (default: General)", ) parser.add_argument( "--no-commit", action="store_true", help="Don't create a commit after adding" ) args = parser.parse_args() # Get repository root adder = CategoryAdder(REPO_ROOT) # If name is provided, run in non-interactive mode if args.name: # Generate defaults for missing arguments category_id = args.id or args.name.lower().replace(" ", "-").replace("&", "and") prefix = args.prefix or args.name.lower().split()[0][:6] description = args.description or f"> **{args.name}** category for awesome-claude-code" if not description.startswith(">"): description = "> " + description subcategories = ( [s.strip() for s in args.subcategories.split(",")] if args.subcategories else ["General"] ) # Add the category if not adder.add_category_to_yaml( category_id, args.name, prefix, args.icon, description, args.order, subcategories, ): sys.exit(1) if not adder.update_issue_template(args.name): sys.exit(1) if not adder.generate_readme(): sys.exit(1) if not args.no_commit: adder.create_commit(args.name) print("\n✨ Category added successfully!") print("\n📝 Note: The category will appear in the Table of Contents only after") print(" resources are added to it. This is by design to keep the ToC clean.") else: # Run in interactive mode interactive_mode(adder) if __name__ == "__main__": main() ================================================ FILE: scripts/categories/category_utils.py ================================================ #!/usr/bin/env python3 """ Unified category utilities for awesome-claude-code. Provides a single source of truth for all category-related operations. Usage: from scripts.categories.category_utils import category_manager # Get all categories categories = category_manager.get_all_categories() # Get category by name cat = category_manager.get_category_by_name("Status Lines") """ from __future__ import annotations from pathlib import Path from typing import Any, ClassVar import yaml from scripts.utils.repo_root import find_repo_root REPO_ROOT = find_repo_root(Path(__file__)) class CategoryManager: """Singleton class for managing category definitions.""" _instance: ClassVar[CategoryManager | None] = None _data: ClassVar[dict[str, Any] | None] = None def __new__(cls): """Ensure only one instance exists.""" if cls._instance is None: cls._instance = super().__new__(cls) return cls._instance def __init__(self): """Initialize the manager (only loads data once).""" if self._data is None: self._load_categories() def _load_categories(self) -> None: """Load category definitions from the unified YAML file.""" categories_path = REPO_ROOT / "templates" / "categories.yaml" with open(categories_path, encoding="utf-8") as f: type(self)._data = yaml.safe_load(f) def get_all_categories(self) -> list[str]: """Get list of all category names.""" if self._data is None: return [] return [cat["name"] for cat in self._data["categories"]] def get_category_prefixes(self) -> dict[str, str]: """Get mapping of category names to ID prefixes.""" if self._data is None: return {} return {cat["name"]: cat["prefix"] for cat in self._data["categories"]} def get_category_by_name(self, name: str) -> dict[str, Any] | None: """Get category configuration by name.""" if not self._data or "categories" not in self._data: return None for cat in self._data["categories"]: if cat["name"] == name: return cat return None def get_category_by_id(self, cat_id: str) -> dict[str, Any] | None: """Get category configuration by ID.""" if not self._data or "categories" not in self._data: return None for cat in self._data["categories"]: if cat["id"] == cat_id: return cat return None def get_all_subcategories(self) -> list[dict[str, str]]: """Get all subcategories with their parent category names.""" subcategories = [] if not self._data or "categories" not in self._data: return [] for cat in self._data["categories"]: if "subcategories" in cat: for subcat in cat["subcategories"]: subcategories.append( { "parent": cat["name"], "name": subcat["name"], "full_name": f"{cat['name']}: {subcat['name']}", } ) return subcategories def get_subcategories_for_category(self, category_name: str) -> list[str]: """Get subcategories for a specific category.""" cat = self.get_category_by_name(category_name) if not cat or "subcategories" not in cat: return [] return [subcat["name"] for subcat in cat["subcategories"]] def validate_category_subcategory(self, category: str, subcategory: str | None) -> bool: """Validate that a subcategory belongs to the given category.""" if not subcategory: return True cat = self.get_category_by_name(category) if not cat: return False if "subcategories" not in cat: return False return any(subcat["name"] == subcategory for subcat in cat["subcategories"]) def get_categories_for_readme(self) -> list[dict[str, Any]]: """Get categories in order for README generation.""" if not self._data or "categories" not in self._data: return [] categories = sorted(self._data["categories"], key=lambda x: x.get("order", 999)) return categories def get_toc_config(self) -> dict[str, Any]: """Get table of contents configuration.""" return self._data.get("toc", {}) if self._data else {} # Create singleton instance for import category_manager = CategoryManager() ================================================ FILE: scripts/graphics/__init__.py ================================================ ================================================ FILE: scripts/graphics/generate_logo_svgs.py ================================================ #!/usr/bin/env python3 """ Generate responsive SVG logos for the Awesome Claude Code repository. This script creates: - Light and dark theme versions of the ASCII art logo - The same logo is used for all screen sizes (scales responsively) """ from pathlib import Path from scripts.utils.repo_root import find_repo_root REPO_ROOT = find_repo_root(Path(__file__)) # ASCII art for the desktop version ASCII_ART = [ " █████┐ ██┐ ██┐███████┐███████┐ ██████┐ ███┐ ███┐███████┐", "██┌──██┐██│ ██│██┌────┘██┌────┘██┌───██┐████┐ ████│██┌────┘", "███████│██│ █┐ ██│█████┐ ███████┐██│ ██│██┌████┌██│█████┐", "██┌──██│██│███┐██│██┌──┘ └────██│██│ ██│██│└██┌┘██│██┌──┘", "██│ ██│└███┌███┌┘███████┐███████│└██████┌┘██│ └─┘ ██│███████┐", "└─┘ └─┘ └──┘└──┘ └──────┘└──────┘ └─────┘ └─┘ └─┘└──────┘", "", "────────────────────────────────────────────────────────────────────────────────────", "", " ██████┐██┐ █████┐ ██┐ ██┐██████┐ ███████┐ ██████┐ ██████┐ ██████┐ ███████┐", "██┌────┘██│ ██┌──██┐██│ ██│██┌──██┐██┌────┘ ██┌────┘██┌───██┐██┌──██┐██┌────┘", "██│ ██│ ███████│██│ ██│██│ ██│█████┐ ██│ ██│ ██│██│ ██│█████┐", "██│ ██│ ██┌──██│██│ ██│██│ ██│██┌──┘ ██│ ██│ ██│██│ ██│██┌──┘", "└██████┐███████┐██│ ██│└██████┌┘██████┌┘███████┐ └██████┐└██████┌┘██████┌┘███████┐", " └─────┘└──────┘└─┘ └─┘ └─────┘ └─────┘ └──────┘ └─────┘ └─────┘ └─────┘ └──────┘", ] def generate_logo_svg(theme: str = "light") -> str: """Generate SVG with full ASCII art for all screen sizes.""" fill_color = "#24292e" if theme == "light" else "#e1e4e8" svg_lines = [ '', " ", ] # Add each line of ASCII art as a text element y_position = 25 for line in ASCII_ART: svg_lines.append(f' {line}') y_position += 20 svg_lines.append("") return "\n".join(svg_lines) def main(): """Generate all logo SVG files.""" # Get the project root directory assets_dir = REPO_ROOT / "assets" # Create assets directory if it doesn't exist assets_dir.mkdir(exist_ok=True) # Generate logo SVGs (same for all screen sizes) logo_light = generate_logo_svg("light") logo_dark = generate_logo_svg("dark") # Write files files_to_write = { "logo-light.svg": logo_light, "logo-dark.svg": logo_dark, } for filename, content in files_to_write.items(): filepath = assets_dir / filename filepath.write_text(content, encoding="utf-8") print(f"✅ Generated: {filepath}") print("\n🎨 All logo SVG files have been generated successfully!") print("📝 Run 'make generate' to update the README with the new logos.") if __name__ == "__main__": main() ================================================ FILE: scripts/ids/__init__.py ================================================ ================================================ FILE: scripts/ids/generate_resource_id.py ================================================ #!/usr/bin/env python3 """ Simple script to generate a resource ID for manual CSV additions. """ import sys from pathlib import Path from scripts.utils.repo_root import find_repo_root REPO_ROOT = find_repo_root(Path(__file__)) sys.path.insert(0, str(REPO_ROOT)) from scripts.categories.category_utils import category_manager from scripts.ids.resource_id import generate_resource_id def main(): print("Resource ID Generator") print("=" * 40) # Get input display_name = input("Display Name: ").strip() primary_link = input("Primary Link: ").strip() categories = category_manager.get_all_categories() print("\nAvailable categories:") for i, cat in enumerate(categories, 1): print(f"{i}. {cat}") cat_choice = input("\nSelect category number: ").strip() try: category = categories[int(cat_choice) - 1] except (ValueError, IndexError): print("Invalid category selection. Using custom category.") category = input("Enter custom category: ").strip() # Generate ID resource_id = generate_resource_id(display_name, primary_link, category) print(f"\nGenerated ID: {resource_id}") print("\nCSV Row Preview:") print(f"ID: {resource_id}") print(f"Display Name: {display_name}") print(f"Category: {category}") print(f"Primary Link: {primary_link}") if __name__ == "__main__": main() ================================================ FILE: scripts/ids/resource_id.py ================================================ #!/usr/bin/env python3 """ Shared resource ID generation functionality. """ import hashlib import sys from pathlib import Path from scripts.utils.repo_root import find_repo_root REPO_ROOT = find_repo_root(Path(__file__)) sys.path.insert(0, str(REPO_ROOT)) from scripts.categories.category_utils import category_manager # noqa: E402 def generate_resource_id(display_name: str, primary_link: str, category: str) -> str: """ Generate a stable resource ID from display name, link, and category. Args: display_name: The display name of the resource primary_link: The primary URL of the resource category: The category name Returns: A resource ID in format: {prefix}-{hash} """ # Get category prefix mapping prefixes = category_manager.get_category_prefixes() prefix = prefixes.get(category, "res") # Generate hash from display name + primary link content = f"{display_name}{primary_link}" hash_value = hashlib.sha256(content.encode()).hexdigest()[:8] return f"{prefix}-{hash_value}" ================================================ FILE: scripts/maintenance/__init__.py ================================================ ================================================ FILE: scripts/maintenance/check_repo_health.py ================================================ #!/usr/bin/env python3 """ Repository health check script for the Awesome Claude Code repository. This script checks active GitHub repositories listed in THE_RESOURCES_TABLE.csv for: - Number of open issues - Date of last push or PR merge (last updated) Exits with error if any repository: - Has not been updated in over 6 months AND - Has more than 2 open issues If a repository has been deleted, the script continues without exiting. """ import argparse import csv import logging import os import sys from datetime import UTC, datetime, timedelta from pathlib import Path import requests from dotenv import load_dotenv from scripts.utils.github_utils import parse_github_url from scripts.utils.repo_root import find_repo_root logger = logging.getLogger(__name__) logging.basicConfig(level=logging.INFO, format="%(levelname)s: %(message)s") load_dotenv() GITHUB_TOKEN = os.getenv("GITHUB_TOKEN", "") USER_AGENT = "awesome-claude-code Repository Health Check/1.0" REPO_ROOT = find_repo_root(Path(__file__)) INPUT_FILE = REPO_ROOT / "THE_RESOURCES_TABLE.csv" HEADERS = {"User-Agent": USER_AGENT, "Accept": "application/vnd.github+json"} if GITHUB_TOKEN: HEADERS["Authorization"] = f"Bearer {GITHUB_TOKEN}" # Thresholds MONTHS_THRESHOLD = 6 OPEN_ISSUES_THRESHOLD = 2 def get_repo_info(owner, repo): """ Fetch repository information from GitHub API. Returns a dict with: - open_issues: number of open issues - last_updated: date of last push (ISO format string) - exists: whether the repo exists (False if 404) Returns None if API call fails for other reasons. """ api_url = f"https://api.github.com/repos/{owner}/{repo}" try: response = requests.get(api_url, headers=HEADERS, timeout=10) if response.status_code == 404: logger.warning(f"Repository {owner}/{repo} not found (deleted or private)") return {"exists": False, "open_issues": 0, "last_updated": None} if response.status_code == 403: logger.error(f"Rate limit or forbidden for {owner}/{repo}") return None if response.status_code != 200: logger.error(f"Failed to fetch {owner}/{repo}: HTTP {response.status_code}") return None data = response.json() return { "exists": True, "open_issues": data.get("open_issues_count", data.get("open_issues", 0)), "last_updated": data.get("pushed_at"), # ISO 8601 timestamp } except requests.exceptions.RequestException as e: logger.error(f"Error fetching repository info for {owner}/{repo}: {e}") return None def is_outdated(last_updated_str, months_threshold): """ Check if a repository hasn't been updated in more than months_threshold months. """ if not last_updated_str: return True # Consider it outdated if we don't have a date try: last_updated = datetime.fromisoformat(last_updated_str.replace("Z", "+00:00")) now = datetime.now(UTC) threshold_date = now - timedelta(days=months_threshold * 30) return last_updated < threshold_date except (ValueError, AttributeError) as e: logger.warning(f"Could not parse date '{last_updated_str}': {e}") return True def check_repos_health( csv_file, months_threshold=MONTHS_THRESHOLD, issues_threshold=OPEN_ISSUES_THRESHOLD ): """ Check health of all active GitHub repositories in the CSV. Returns a list of problematic repos. """ problematic_repos = [] checked_repos = 0 deleted_repos = [] logger.info(f"Reading repository list from {csv_file}") try: with open(csv_file, encoding="utf-8") as f: reader = csv.DictReader(f) for row in reader: # Check if Active is TRUE active = row.get("Active", "").strip().upper() if active != "TRUE": continue primary_link = row.get("Primary Link", "").strip() if not primary_link: continue # Extract owner and repo from GitHub URL _, is_github, owner, repo = parse_github_url(primary_link) if not is_github or not owner or not repo: # Not a GitHub repository URL continue checked_repos += 1 resource_name = row.get("Display Name", primary_link) logger.info(f"Checking {owner}/{repo} ({resource_name})") # Get repository information repo_info = get_repo_info(owner, repo) if repo_info is None: # API error - log but continue logger.warning(f"Could not fetch info for {owner}/{repo}, skipping") continue if not repo_info["exists"]: # Repository deleted - log but continue deleted_repos.append( {"name": resource_name, "url": primary_link, "owner": owner, "repo": repo} ) continue # Check if repo is problematic open_issues = repo_info["open_issues"] last_updated = repo_info["last_updated"] outdated = is_outdated(last_updated, months_threshold) if outdated and open_issues > issues_threshold: problematic_repos.append( { "name": resource_name, "url": primary_link, "owner": owner, "repo": repo, "open_issues": open_issues, "last_updated": last_updated, } ) logger.warning( f"⚠️ {owner}/{repo}: " f"Last updated {last_updated or 'unknown'}, " f"{open_issues} open issues" ) except FileNotFoundError: logger.error(f"CSV file not found: {csv_file}") sys.exit(1) except Exception as e: logger.error(f"Error reading CSV file: {e}") sys.exit(1) logger.info(f"\n{'=' * 60}") logger.info("Summary:") logger.info(f" Total active GitHub repositories checked: {checked_repos}") logger.info(f" Deleted/unavailable repositories: {len(deleted_repos)}") logger.info(f" Problematic repositories: {len(problematic_repos)}") if deleted_repos: logger.info(f"\n{'=' * 60}") logger.info("Deleted/Unavailable Repositories:") for repo in deleted_repos: logger.info(f" - {repo['name']} ({repo['owner']}/{repo['repo']})") return problematic_repos def main(): parser = argparse.ArgumentParser( description="Check health of GitHub repositories in THE_RESOURCES_TABLE.csv" ) parser.add_argument( "--csv-file", default=INPUT_FILE, help=f"Path to CSV file (default: {INPUT_FILE})", ) parser.add_argument( "--months", type=int, default=MONTHS_THRESHOLD, help=f"Months threshold for outdated repos (default: {MONTHS_THRESHOLD})", ) parser.add_argument( "--issues", type=int, default=OPEN_ISSUES_THRESHOLD, help=f"Open issues threshold (default: {OPEN_ISSUES_THRESHOLD})", ) args = parser.parse_args() problematic_repos = check_repos_health(args.csv_file, args.months, args.issues) if problematic_repos: logger.error(f"\n{'=' * 60}") logger.error("❌ HEALTH CHECK FAILED") logger.error( f"Found {len(problematic_repos)} repository(ies) that have not been updated in over " f"{args.months} months and have more than {args.issues} open issues:\n" ) for repo in problematic_repos: logger.error(f" • {repo['name']}") logger.error(f" URL: {repo['url']}") logger.error(f" Last updated: {repo['last_updated'] or 'Unknown'}") logger.error(f" Open issues: {repo['open_issues']}") logger.error("") sys.exit(1) else: logger.info(f"\n{'=' * 60}") logger.info("✅ HEALTH CHECK PASSED") logger.info("All active repositories are healthy!") sys.exit(0) if __name__ == "__main__": main() ================================================ FILE: scripts/maintenance/update_github_release_data.py ================================================ #!/usr/bin/env python3 """ Update Last Modified and GitHub release info for active GitHub repos in THE_RESOURCES_TABLE.csv. Uses two GitHub REST API calls per repository: - /repos/{owner}/{repo}/commits?per_page=1 (latest commit on default branch) - /repos/{owner}/{repo}/releases/latest (latest release) """ import argparse import csv import logging import os import re import sys import time from datetime import datetime from pathlib import Path import requests from scripts.utils.repo_root import find_repo_root try: from dotenv import load_dotenv load_dotenv() except ImportError: pass REPO_ROOT = find_repo_root(Path(__file__)) DEFAULT_CSV_PATH = os.path.join(REPO_ROOT, "THE_RESOURCES_TABLE.csv") logger = logging.getLogger(__name__) logging.basicConfig(level=logging.INFO, format="%(levelname)s: %(message)s") GITHUB_TOKEN = os.getenv("GITHUB_TOKEN", "") USER_AGENT = "awesome-claude-code GitHub Release Sync/1.0" HEADERS = {"User-Agent": USER_AGENT, "Accept": "application/vnd.github+json"} if GITHUB_TOKEN: HEADERS["Authorization"] = f"Bearer {GITHUB_TOKEN}" def format_commit_date(commit_date: str | None) -> str | None: if not commit_date: return None try: dt = datetime.fromisoformat(commit_date.replace("Z", "+00:00")) return dt.strftime("%Y-%m-%d:%H-%M-%S") except ValueError: return None def parse_github_repo(url: str | None) -> tuple[str | None, str | None]: if not url or not isinstance(url, str): return None, None match = re.match(r"https?://github\.com/([^/]+)/([^/]+)", url.strip()) if not match: return None, None owner, repo = match.groups() repo = repo.split("?", 1)[0].split("#", 1)[0] repo = repo.removesuffix(".git") return owner, repo def github_get(url: str, params: dict | None = None) -> requests.Response: response = requests.get(url, headers=HEADERS, params=params, timeout=10) if response.status_code == 403 and response.headers.get("X-RateLimit-Remaining") == "0": reset_time = int(response.headers.get("X-RateLimit-Reset", 0)) sleep_time = max(reset_time - int(time.time()), 0) + 1 logger.warning("GitHub rate limit hit. Sleeping for %s seconds.", sleep_time) time.sleep(sleep_time) response = requests.get(url, headers=HEADERS, params=params, timeout=10) return response def fetch_last_commit_date(owner: str, repo: str) -> tuple[str | None, str]: api_url = f"https://api.github.com/repos/{owner}/{repo}/commits" response = github_get(api_url, params={"per_page": 1}) if response.status_code == 200: data = response.json() if isinstance(data, list) and data: commit = data[0] commit_date = ( commit.get("commit", {}).get("committer", {}).get("date") or commit.get("commit", {}).get("author", {}).get("date") or commit.get("committer", {}).get("date") or commit.get("author", {}).get("date") ) return format_commit_date(commit_date), "ok" return None, "empty" if response.status_code == 404: return None, "not_found" return None, f"http_{response.status_code}" def fetch_latest_release(owner: str, repo: str) -> tuple[str | None, str | None, str]: api_url = f"https://api.github.com/repos/{owner}/{repo}/releases/latest" response = github_get(api_url) if response.status_code == 200: data = response.json() published_at = data.get("published_at") or data.get("created_at") return format_commit_date(published_at), data.get("tag_name"), "ok" if response.status_code == 404: return None, None, "no_release" return None, None, f"http_{response.status_code}" def update_release_data(csv_path: str, max_rows: int | None = None, dry_run: bool = False) -> None: with open(csv_path, encoding="utf-8") as f: reader = csv.DictReader(f) rows = list(reader) fieldnames = list(reader.fieldnames or []) required_columns = ["Last Modified", "Latest Release", "Release Version", "Release Source"] for column in required_columns: if column not in fieldnames: fieldnames.append(column) processed = 0 skipped = 0 updated = 0 errors = 0 for _, row in enumerate(rows): if max_rows and processed >= max_rows: logger.info("Reached max limit (%s). Stopping.", max_rows) break if row.get("Active", "").strip().upper() != "TRUE": skipped += 1 continue primary_link = (row.get("Primary Link") or "").strip() owner, repo = parse_github_repo(primary_link) if not owner or not repo: skipped += 1 continue processed += 1 display_name = row.get("Display Name", primary_link) logger.info("[%s] Updating %s (%s/%s)", processed, display_name, owner, repo) row_changed = False commit_date, commit_status = fetch_last_commit_date(owner, repo) if commit_status == "not_found": logger.warning("Repository not found: %s/%s", owner, repo) elif commit_date and row.get("Last Modified") != commit_date: row["Last Modified"] = commit_date row_changed = True release_date, release_version, release_status = fetch_latest_release(owner, repo) if release_status == "no_release": if row.get("Latest Release") or row.get("Release Version") or row.get("Release Source"): row["Latest Release"] = "" row["Release Version"] = "" row["Release Source"] = "" row_changed = True elif release_status == "ok": new_release_date = release_date or "" new_release_version = release_version or "" new_release_source = "github-releases" if (release_date or release_version) else "" if row.get("Latest Release") != new_release_date: row["Latest Release"] = new_release_date row_changed = True if row.get("Release Version") != new_release_version: row["Release Version"] = new_release_version row_changed = True if row.get("Release Source") != new_release_source: row["Release Source"] = new_release_source row_changed = True else: logger.warning( "Release fetch failed for %s/%s (status: %s)", owner, repo, release_status, ) errors += 1 if row_changed: updated += 1 if dry_run: logger.info("[DRY RUN] No changes written to CSV.") return with open(csv_path, "w", encoding="utf-8", newline="") as f: writer = csv.DictWriter(f, fieldnames=fieldnames) writer.writeheader() writer.writerows(rows) logger.info("Updated rows: %s", updated) logger.info("Skipped rows: %s", skipped) logger.info("Errors: %s", errors) def main() -> None: parser = argparse.ArgumentParser( description="Update GitHub commit and release data for active resources" ) parser.add_argument( "--csv-file", default=DEFAULT_CSV_PATH, help="Path to THE_RESOURCES_TABLE.csv", ) parser.add_argument("--max", type=int, help="Process at most N resources") parser.add_argument("--dry-run", action="store_true", help="Do not write changes") args = parser.parse_args() if not os.path.exists(args.csv_file): logger.error("CSV file not found: %s", args.csv_file) sys.exit(1) update_release_data(args.csv_file, max_rows=args.max, dry_run=args.dry_run) if __name__ == "__main__": main() ================================================ FILE: scripts/py.typed ================================================ ================================================ FILE: scripts/readme/__init__.py ================================================ ================================================ FILE: scripts/readme/generate_readme.py ================================================ #!/usr/bin/env python3 """ Template-based README generator for the Awesome Claude Code repository. Reads resource metadata from CSV and generates README using templates. """ import sys from pathlib import Path from scripts.readme.generators.awesome import AwesomeReadmeGenerator from scripts.readme.generators.base import ReadmeGenerator from scripts.readme.generators.flat import ( FLAT_CATEGORIES, FLAT_SORT_TYPES, ParameterizedFlatListGenerator, ) from scripts.readme.generators.minimal import MinimalReadmeGenerator from scripts.readme.generators.visual import VisualReadmeGenerator from scripts.readme.helpers.readme_assets import generate_flat_badges from scripts.readme.helpers.readme_config import get_root_style from scripts.utils.repo_root import find_repo_root REPO_ROOT = find_repo_root(Path(__file__)) STYLE_GENERATORS: dict[str, type[ReadmeGenerator]] = { "extra": VisualReadmeGenerator, "classic": MinimalReadmeGenerator, "awesome": AwesomeReadmeGenerator, "flat": ParameterizedFlatListGenerator, } PRIMARY_STYLE_IDS = tuple( style_id for style_id, generator_cls in STYLE_GENERATORS.items() if generator_cls is not ParameterizedFlatListGenerator ) def build_root_generator( style_id: str, csv_path: str, template_dir: str, assets_dir: str, repo_root: str, ) -> ReadmeGenerator: """Return the generator instance for a root style.""" style_id = style_id.lower() generator_cls = STYLE_GENERATORS.get(style_id) if generator_cls is None: raise ValueError(f"Unknown root style: {style_id}") if generator_cls is ParameterizedFlatListGenerator: return ParameterizedFlatListGenerator( csv_path, template_dir, assets_dir, repo_root, category_slug="all", sort_type="az", ) return generator_cls(csv_path, template_dir, assets_dir, repo_root) def main(): """Main entry point - generates all README versions.""" repo_root = REPO_ROOT csv_path = str(repo_root / "THE_RESOURCES_TABLE.csv") template_dir = str(repo_root / "templates") assets_dir = str(repo_root / "assets") print("=== README Generation ===") # Generate flat list badges first print("\n--- Generating flat list badges ---") generate_flat_badges(assets_dir, FLAT_SORT_TYPES, FLAT_CATEGORIES) print("✅ Flat list badges generated") # Generate primary styles under README_ALTERNATIVES/ main_generators = [ STYLE_GENERATORS[style_id](csv_path, template_dir, assets_dir, str(repo_root)) for style_id in PRIMARY_STYLE_IDS ] for generator in main_generators: resolved_path = generator.resolved_output_path print(f"\n--- Generating {resolved_path} ---") try: resource_count, backup_path = generator.generate() print(f"✅ {resolved_path} generated successfully") print(f"📊 Generated with {resource_count} active resources") if backup_path: print(f"📁 Backup saved at: {backup_path}") except Exception as e: print(f"❌ Error generating {resolved_path}: {e}") sys.exit(1) # Generate all flat list combinations (categories × sort types = 44 files) print("\n--- Generating flat list views ---") flat_count = 0 for category_slug in FLAT_CATEGORIES: for sort_type in FLAT_SORT_TYPES: generator = ParameterizedFlatListGenerator( csv_path, template_dir, assets_dir, str(repo_root), category_slug=category_slug, sort_type=sort_type, ) try: resource_count, _ = generator.generate() flat_count += 1 # Only print summary for first of each category if sort_type == "az": print(f" 📂 {category_slug}: {resource_count} resources") except Exception as e: print(f"❌ Error generating {generator.output_filename}: {e}") sys.exit(1) print(f"✅ Generated {flat_count} flat list views") # Generate root README after all alternatives exist root_style = get_root_style() root_generator = build_root_generator( root_style, csv_path, template_dir, assets_dir, str(repo_root), ) print(f"\n--- Generating README.md (root style: {root_style}) ---") try: resource_count, backup_path = root_generator.generate(output_path="README.md") print("✅ README.md generated successfully") print(f"📊 Generated with {resource_count} active resources") if backup_path: print(f"📁 Backup saved at: {backup_path}") except Exception as e: print(f"❌ Error generating README.md: {e}") sys.exit(1) print("\n=== Generation Complete ===") if __name__ == "__main__": main() ================================================ FILE: scripts/readme/generators/__init__.py ================================================ """README generator implementations.""" ================================================ FILE: scripts/readme/generators/awesome.py ================================================ """Awesome README generator implementation.""" import os from pathlib import Path from scripts.readme.generators.base import ReadmeGenerator from scripts.readme.markup.awesome import ( format_resource_entry as format_awesome_resource_entry, ) from scripts.readme.markup.awesome import ( generate_repo_ticker as generate_awesome_repo_ticker, ) from scripts.readme.markup.awesome import ( generate_section_content as generate_awesome_section_content, ) from scripts.readme.markup.awesome import ( generate_toc as generate_awesome_toc, ) from scripts.readme.markup.awesome import ( generate_weekly_section as generate_awesome_weekly_section, ) from scripts.utils.repo_root import find_repo_root class AwesomeReadmeGenerator(ReadmeGenerator): """Generator for awesome-list-style README variant with clean markdown formatting.""" @property def template_filename(self) -> str: return "README_AWESOME.template.md" @property def output_filename(self) -> str: return "README_ALTERNATIVES/README_AWESOME.md" @property def style_id(self) -> str: return "awesome" def format_resource_entry(self, row: dict, include_separator: bool = True) -> str: """Format resource in awesome list style: - [Name](url) by [Author](link) - Description.""" return format_awesome_resource_entry(row, include_separator=include_separator) def generate_toc(self) -> str: """Generate plain markdown TOC for awesome list style.""" return generate_awesome_toc(self.categories, self.csv_data) def generate_weekly_section(self) -> str: """Generate weekly section with plain markdown for awesome list.""" return generate_awesome_weekly_section(self.csv_data) def generate_section_content(self, category: dict, section_index: int) -> str: """Generate section with plain markdown headers in awesome list format.""" _ = section_index return generate_awesome_section_content(category, self.csv_data) def generate_repo_ticker(self) -> str: """Generate the awesome-style animated SVG repo ticker.""" return generate_awesome_repo_ticker() def generate_banner_image(self, output_path: Path) -> str: """Generate centered banner image for Awesome style README.""" repo_root = find_repo_root(Path(__file__)) banner_file = "assets/awesome-claude-code-social-clawd-leo.png" # Calculate relative path from output location to banner banner_abs = repo_root / banner_file rel_path = Path(os.path.relpath(banner_abs, start=output_path.parent)).as_posix() return f"""

Awesome Claude Code

""" ================================================ FILE: scripts/readme/generators/base.py ================================================ """Shared base class and helpers for README generators.""" from __future__ import annotations import contextlib import csv import os import shutil from abc import ABC, abstractmethod from datetime import datetime from pathlib import Path import yaml # type: ignore[import-untyped] from scripts.readme.helpers.readme_config import get_root_style from scripts.readme.helpers.readme_paths import ( ensure_generated_header, resolve_asset_tokens, ) from scripts.readme.helpers.readme_utils import build_general_anchor_map from scripts.readme.markup.shared import generate_style_selector, load_announcements from scripts.utils.repo_root import find_repo_root REPO_ROOT = find_repo_root(Path(__file__)) def load_template(template_path: str) -> str: """Load a template file.""" with open(template_path, encoding="utf-8") as f: return f.read() def load_overrides(template_dir: str) -> dict: """Load resource overrides.""" override_path = os.path.join(template_dir, "resource-overrides.yaml") if not os.path.exists(override_path): return {} with open(override_path, encoding="utf-8") as f: data = yaml.safe_load(f) return data.get("overrides", {}) def apply_overrides(row: dict, overrides: dict) -> dict: """Apply overrides to a resource row.""" resource_id = row.get("ID", "") if not resource_id or resource_id not in overrides: return row override_config = overrides[resource_id] for field, value in override_config.items(): if field in ["skip_validation", "notes"]: continue if field.endswith("_locked"): continue if field == "license": row["License"] = value elif field == "active": row["Active"] = value elif field == "description": row["Description"] = value return row def create_backup(file_path: str, keep_latest: int = 1) -> str | None: """Create a backup of the file if it exists, pruning older backups.""" if not os.path.exists(file_path): return None timestamp = datetime.now().strftime("%Y%m%d_%H%M%S") backup_dir = os.path.join(REPO_ROOT, ".myob", "backups") os.makedirs(backup_dir, exist_ok=True) backup_filename = f"{os.path.basename(file_path)}.{timestamp}.bak" backup_path = os.path.join(backup_dir, backup_filename) shutil.copy2(file_path, backup_path) if keep_latest > 0: basename = os.path.basename(file_path) backups = [] for name in os.listdir(backup_dir): if name.startswith(f"{basename}.") and name.endswith(".bak"): backups.append(os.path.join(backup_dir, name)) backups.sort(key=os.path.getmtime, reverse=True) for stale_path in backups[keep_latest:]: with contextlib.suppress(OSError): os.remove(stale_path) return backup_path class ReadmeGenerator(ABC): """Base class for README generation with shared logic.""" def __init__(self, csv_path: str, template_dir: str, assets_dir: str, repo_root: str) -> None: self.csv_path = csv_path self.template_dir = template_dir self.assets_dir = assets_dir self.repo_root = repo_root self.csv_data: list[dict] = [] self.categories: list[dict] = [] self.overrides: dict = {} self.announcements: str = "" self.footer: str = "" self.general_anchor_map: dict = {} @property @abstractmethod def template_filename(self) -> str: """Return the template filename to use.""" ... @property @abstractmethod def output_filename(self) -> str: """Return the preferred output filename for this style.""" ... @property @abstractmethod def style_id(self) -> str: """Return the style ID for this generator (extra, classic, awesome, flat).""" ... @property def is_root_style(self) -> bool: """Check if this generator produces the root README style.""" return self.style_id == get_root_style() @property def resolved_output_path(self) -> str: """Get the resolved output path for this generator.""" if self.output_filename == "README.md": return f"README_ALTERNATIVES/README_{self.style_id.upper()}.md" return self.output_filename def get_style_selector(self, output_path: Path) -> str: """Generate the style selector HTML for this README.""" return generate_style_selector(self.style_id, output_path) @abstractmethod def format_resource_entry(self, row: dict, include_separator: bool = True) -> str: """Format a single resource entry.""" ... @abstractmethod def generate_toc(self) -> str: """Generate the table of contents.""" ... @abstractmethod def generate_weekly_section(self) -> str: """Generate the weekly additions section.""" ... @abstractmethod def generate_section_content(self, category: dict, section_index: int) -> str: """Generate content for a category section.""" ... def generate_repo_ticker(self) -> str: """Generate the repo ticker section.""" return "" def generate_banner_image(self, output_path: Path) -> str: """Generate banner image HTML. Override in subclasses to add a banner.""" _ = output_path return "" def load_csv_data(self) -> list[dict]: """Load and filter active resources from CSV.""" csv_data = [] with open(self.csv_path, newline="", encoding="utf-8") as f: reader = csv.DictReader(f) for row in reader: row = apply_overrides(row, self.overrides) if row["Active"].upper() == "TRUE": csv_data.append(row) return csv_data def load_categories(self) -> list[dict]: """Load categories from the category manager.""" from scripts.categories.category_utils import category_manager return category_manager.get_categories_for_readme() def load_overrides(self) -> dict: """Load resource overrides from YAML.""" return load_overrides(self.template_dir) def load_announcements(self) -> str: """Load announcements from YAML.""" return load_announcements(self.template_dir) def load_footer(self) -> str: """Load footer template from file.""" footer_path = os.path.join(self.template_dir, "footer.template.md") try: with open(footer_path, encoding="utf-8") as f: return f.read() except FileNotFoundError: print(f"⚠️ Warning: Footer template not found at {footer_path}") return "" def build_general_anchor_map(self) -> dict: """Build anchor map for General subcategories.""" return build_general_anchor_map(self.categories, self.csv_data) def create_backup(self, output_path: str) -> str | None: """Create backup of existing file.""" return create_backup(output_path) def generate(self, output_path: str | None = None) -> tuple[int, str | None]: """Generate the README to the default or provided output path.""" resolved_path = output_path or self.resolved_output_path output_path = os.path.join(self.repo_root, resolved_path) self.overrides = self.load_overrides() self.csv_data = self.load_csv_data() self.categories = self.load_categories() self.announcements = self.load_announcements() self.footer = self.load_footer() self.general_anchor_map = self.build_general_anchor_map() template_path = os.path.join(self.template_dir, self.template_filename) template = load_template(template_path) toc_content = self.generate_toc() weekly_section = self.generate_weekly_section() body_sections = [] for section_index, category in enumerate(self.categories): section_content = self.generate_section_content(category, section_index) body_sections.append(section_content) readme_content = template readme_content = readme_content.replace("{{ANNOUNCEMENTS}}", self.announcements) readme_content = readme_content.replace("{{WEEKLY_SECTION}}", weekly_section) readme_content = readme_content.replace("{{TABLE_OF_CONTENTS}}", toc_content) readme_content = readme_content.replace( "{{BODY_SECTIONS}}", "\n
\n\n".join(body_sections) ) readme_content = readme_content.replace("{{FOOTER}}", self.footer) readme_content = readme_content.replace( "{{STYLE_SELECTOR}}", self.get_style_selector(Path(output_path)) ) readme_content = readme_content.replace("{{REPO_TICKER}}", self.generate_repo_ticker()) readme_content = readme_content.replace( "{{BANNER_IMAGE}}", self.generate_banner_image(Path(output_path)) ) readme_content = ensure_generated_header(readme_content) readme_content = resolve_asset_tokens( readme_content, Path(output_path), Path(self.repo_root) ) output_dir = os.path.dirname(output_path) if output_dir and not os.path.exists(output_dir): os.makedirs(output_dir, exist_ok=True) backup_path = self.create_backup(output_path) try: with open(output_path, "w", encoding="utf-8") as f: f.write(readme_content) except Exception as e: if backup_path: print(f"❌ Error writing {resolved_path}: {e}") print(f" Backup preserved at: {backup_path}") raise return len(self.csv_data), backup_path @property def alternative_output_path(self) -> str: """Return the output path for this style under README_ALTERNATIVES/.""" if self.output_filename == "README.md": return f"README_ALTERNATIVES/README_{self.style_id.upper()}.md" return self.output_filename ================================================ FILE: scripts/readme/generators/flat.py ================================================ """Flat list README generator implementation.""" from __future__ import annotations import os from datetime import datetime, timedelta from pathlib import Path from scripts.readme.generators.base import ReadmeGenerator, load_template from scripts.readme.helpers.readme_paths import ( ensure_generated_header, resolve_asset_tokens, ) from scripts.readme.helpers.readme_utils import parse_resource_date from scripts.readme.markup.flat import ( generate_category_navigation as generate_flat_category_navigation, ) from scripts.readme.markup.flat import ( generate_navigation as generate_flat_navigation, ) from scripts.readme.markup.flat import ( generate_resources_table as generate_flat_resources_table, ) from scripts.readme.markup.flat import ( generate_sort_navigation as generate_flat_sort_navigation, ) from scripts.readme.markup.flat import ( get_default_template as get_flat_default_template, ) # Category definitions: slug -> (csv_value, display_name, badge_color) FLAT_CATEGORIES = { "all": (None, "All", "#71717a"), "tooling": ("Tooling", "Tooling", "#3b82f6"), "commands": ("Slash-Commands", "Commands", "#8b5cf6"), "claude-md": ("CLAUDE.md Files", "CLAUDE.md", "#ec4899"), "workflows": ("Workflows & Knowledge Guides", "Workflows", "#14b8a6"), "hooks": ("Hooks", "Hooks", "#f97316"), "skills": ("Agent Skills", "Skills", "#eab308"), "styles": ("Output Styles", "Styles", "#06b6d4"), "statusline": ("Status Lines", "Status", "#84cc16"), "docs": ("Official Documentation", "Docs", "#6366f1"), "clients": ("Alternative Clients", "Clients", "#f43f5e"), } # Sort type definitions: slug -> (display_name, badge_color, description) FLAT_SORT_TYPES = { "az": ("A - Z", "#6366f1", "alphabetically by name"), "updated": ("UPDATED", "#f472b6", "by last updated date"), "created": ("CREATED", "#34d399", "by date created"), "releases": ("RELEASES", "#f59e0b", "by latest release (30 days)"), } class ParameterizedFlatListGenerator(ReadmeGenerator): """Unified generator for flat list READMEs with category filtering and sort options.""" DAYS_THRESHOLD = 30 # For releases filter def __init__( self, csv_path: str, template_dir: str, assets_dir: str, repo_root: str, category_slug: str = "all", sort_type: str = "az", ) -> None: super().__init__(csv_path, template_dir, assets_dir, repo_root) self.category_slug = category_slug self.sort_type = sort_type self._category_info = FLAT_CATEGORIES.get(category_slug, FLAT_CATEGORIES["all"]) self._sort_info = FLAT_SORT_TYPES.get(sort_type, FLAT_SORT_TYPES["az"]) @property def template_filename(self) -> str: return "README_FLAT.template.md" @property def output_filename(self) -> str: return ( f"README_ALTERNATIVES/README_FLAT_{self.category_slug.upper()}" f"_{self.sort_type.upper()}.md" ) @property def style_id(self) -> str: return "flat" def format_resource_entry(self, row: dict, include_separator: bool = True) -> str: """Not used for flat list.""" _ = include_separator return "" def generate_toc(self) -> str: """Not used for flat list.""" return "" def generate_weekly_section(self) -> str: """Not used for flat list.""" return "" def generate_section_content(self, category: dict, section_index: int) -> str: """Not used for flat list.""" _ = category, section_index return "" def get_filtered_resources(self) -> list[dict]: """Get resources filtered by category.""" csv_category_value = self._category_info[0] if csv_category_value is None: return list(self.csv_data) return [r for r in self.csv_data if r.get("Category", "").strip() == csv_category_value] def sort_resources(self, resources: list[dict]) -> list[dict]: """Sort resources according to sort_type.""" if self.sort_type == "az": return sorted(resources, key=lambda x: (x.get("Display Name", "") or "").lower()) if self.sort_type == "updated": with_dates = [] for row in resources: last_modified = row.get("Last Modified", "").strip() parsed = parse_resource_date(last_modified) if last_modified else None with_dates.append((parsed, row)) with_dates.sort( key=lambda x: (x[0] is None, x[0] if x[0] else datetime.min), reverse=True, ) return [r for _, r in with_dates] if self.sort_type == "created": with_dates = [] for row in resources: repo_created = row.get("Repo Created", "").strip() parsed = parse_resource_date(repo_created) if repo_created else None with_dates.append((parsed, row)) with_dates.sort( key=lambda x: (x[0] is None, x[0] if x[0] else datetime.min), reverse=True, ) return [r for _, r in with_dates] if self.sort_type == "releases": cutoff = datetime.now() - timedelta(days=self.DAYS_THRESHOLD) recent = [] for row in resources: release_date_str = row.get("Latest Release", "") if not release_date_str: continue try: release_date = datetime.strptime(release_date_str, "%Y-%m-%d:%H-%M-%S") except ValueError: continue if release_date >= cutoff: row["_parsed_release_date"] = release_date recent.append(row) recent.sort(key=lambda x: x.get("_parsed_release_date", datetime.min), reverse=True) return recent return resources def generate_sort_navigation(self) -> str: """Generate sort option badges.""" return generate_flat_sort_navigation( self.category_slug, self.sort_type, FLAT_SORT_TYPES, ) def generate_category_navigation(self) -> str: """Generate category filter badges.""" return generate_flat_category_navigation( self.category_slug, self.sort_type, FLAT_CATEGORIES, ) def generate_navigation(self) -> str: """Generate combined navigation (sort + category).""" return generate_flat_navigation( self.category_slug, self.sort_type, FLAT_CATEGORIES, FLAT_SORT_TYPES, ) def generate_resources_table(self) -> str: """Generate the resources table as HTML with shields.io badges for GitHub resources.""" resources = self.get_filtered_resources() sorted_resources = self.sort_resources(resources) return generate_flat_resources_table(sorted_resources, self.sort_type) def _get_default_template(self) -> str: """Return default template content.""" return get_flat_default_template() def generate(self, output_path: str | None = None) -> tuple[int, str | None]: """Generate the flat list README for a category/sort pair.""" resolved_path = output_path or self.resolved_output_path self.overrides = self.load_overrides() self.csv_data = self.load_csv_data() template_path = os.path.join(self.template_dir, self.template_filename) if not os.path.exists(template_path): template = self._get_default_template() else: template = load_template(template_path) resources = self.get_filtered_resources() sorted_resources = self.sort_resources(resources) navigation = generate_flat_navigation( self.category_slug, self.sort_type, FLAT_CATEGORIES, FLAT_SORT_TYPES, ) resources_table = generate_flat_resources_table(sorted_resources, self.sort_type) generated_date = datetime.now().strftime("%Y-%m-%d") _, cat_display, _ = self._category_info _, _, sort_desc = self._sort_info releases_disclaimer = "" if self.sort_type == "releases": releases_disclaimer = ( "\n> **Note:** Latest release data is pulled from GitHub Releases only. " "Projects without GitHub Releases will not show release info here. " "Please verify with the project directly.\n" ) output_path = os.path.join(self.repo_root, resolved_path) readme_content = template readme_content = readme_content.replace( "{{STYLE_SELECTOR}}", self.get_style_selector(Path(output_path)) ) readme_content = readme_content.replace("{{NAVIGATION}}", navigation) readme_content = readme_content.replace("{{RELEASES_DISCLAIMER}}", releases_disclaimer) readme_content = readme_content.replace("{{RESOURCES_TABLE}}", resources_table) readme_content = readme_content.replace("{{RESOURCE_COUNT}}", str(len(sorted_resources))) readme_content = readme_content.replace("{{CATEGORY_NAME}}", cat_display) readme_content = readme_content.replace("{{SORT_DESC}}", sort_desc) readme_content = readme_content.replace("{{GENERATED_DATE}}", generated_date) readme_content = ensure_generated_header(readme_content) readme_content = resolve_asset_tokens( readme_content, Path(output_path), Path(self.repo_root) ) output_dir = os.path.dirname(output_path) if output_dir and not os.path.exists(output_dir): os.makedirs(output_dir, exist_ok=True) backup_path = self.create_backup(output_path) try: with open(output_path, "w", encoding="utf-8") as f: f.write(readme_content) except Exception as e: if backup_path: print(f"Error writing {resolved_path}: {e}") print(f" Backup preserved at: {backup_path}") raise return len(sorted_resources), backup_path ================================================ FILE: scripts/readme/generators/minimal.py ================================================ """Minimal README generator implementation.""" from scripts.readme.generators.base import ReadmeGenerator from scripts.readme.markup.minimal import ( format_resource_entry as format_minimal_resource_entry, ) from scripts.readme.markup.minimal import ( generate_section_content as generate_minimal_section_content, ) from scripts.readme.markup.minimal import ( generate_toc as generate_minimal_toc, ) from scripts.readme.markup.minimal import ( generate_weekly_section as generate_minimal_weekly_section, ) class MinimalReadmeGenerator(ReadmeGenerator): """Generator for plain markdown README classic variant.""" @property def template_filename(self) -> str: return "README_CLASSIC.template.md" @property def output_filename(self) -> str: return "README_ALTERNATIVES/README_CLASSIC.md" @property def style_id(self) -> str: return "classic" def format_resource_entry(self, row: dict, include_separator: bool = True) -> str: """Format resource as plain markdown with collapsible GitHub stats.""" return format_minimal_resource_entry(row, include_separator=include_separator) def generate_toc(self) -> str: """Generate plain markdown nested details TOC.""" return generate_minimal_toc(self.categories, self.csv_data) def generate_weekly_section(self) -> str: """Generate weekly section with plain markdown.""" return generate_minimal_weekly_section(self.csv_data) def generate_section_content(self, category: dict, section_index: int) -> str: """Generate section with plain markdown headers.""" _ = section_index return generate_minimal_section_content(category, self.csv_data) ================================================ FILE: scripts/readme/generators/visual.py ================================================ """Visual README generator implementation.""" from scripts.readme.generators.base import ReadmeGenerator from scripts.readme.markup.visual import ( format_resource_entry as format_visual_resource_entry, ) from scripts.readme.markup.visual import ( generate_repo_ticker as generate_visual_repo_ticker, ) from scripts.readme.markup.visual import ( generate_section_content as generate_visual_section_content, ) from scripts.readme.markup.visual import ( generate_toc_from_categories as generate_visual_toc, ) from scripts.readme.markup.visual import ( generate_weekly_section as generate_visual_weekly_section, ) class VisualReadmeGenerator(ReadmeGenerator): """Generator for visual/themed README variant with SVG assets.""" @property def template_filename(self) -> str: return "README_EXTRA.template.md" @property def output_filename(self) -> str: return "README_ALTERNATIVES/README_EXTRA.md" @property def style_id(self) -> str: return "extra" def format_resource_entry(self, row: dict, include_separator: bool = True) -> str: """Format resource with SVG badges and visible GitHub stats.""" return format_visual_resource_entry( row, assets_dir=self.assets_dir, include_separator=include_separator, ) def generate_toc(self) -> str: """Generate terminal-style SVG TOC.""" return generate_visual_toc( self.categories, self.csv_data, self.general_anchor_map, ) def generate_weekly_section(self) -> str: """Generate latest additions section with header SVG.""" return generate_visual_weekly_section(self.csv_data, assets_dir=self.assets_dir) def generate_section_content(self, category: dict, section_index: int) -> str: """Generate section with SVG headers and desc boxes.""" return generate_visual_section_content( category, self.csv_data, self.general_anchor_map, assets_dir=self.assets_dir, section_index=section_index, ) def generate_repo_ticker(self) -> str: """Generate the animated SVG repo ticker for visual theme.""" return generate_visual_repo_ticker() ================================================ FILE: scripts/readme/helpers/__init__.py ================================================ ================================================ FILE: scripts/readme/helpers/generate_toc_assets.py ================================================ """Regenerate subcategory TOC SVGs from categories.yaml. Run after adding or modifying subcategories in templates/categories.yaml to create/update the corresponding TOC row SVG assets used by the Visual (Extra) README style. Usage: python -m scripts.readme.generate_toc_assets """ from pathlib import Path from scripts.categories.category_utils import category_manager from scripts.readme.helpers.readme_assets import regenerate_sub_toc_svgs from scripts.utils.repo_root import find_repo_root def main() -> None: repo_root = find_repo_root(Path(__file__)) assets_dir = str(repo_root / "assets") categories = category_manager.get_categories_for_readme() regenerate_sub_toc_svgs(categories, assets_dir) print("✅ Subcategory TOC SVGs regenerated") if __name__ == "__main__": main() ================================================ FILE: scripts/readme/helpers/readme_assets.py ================================================ """SVG asset generation and file helpers for README generation.""" from __future__ import annotations import glob import os import re from scripts.readme.helpers.readme_utils import format_category_dir_name from scripts.readme.svg_templates.badges import ( generate_resource_badge_svg, render_flat_category_badge_svg, render_flat_sort_badge_svg, ) from scripts.readme.svg_templates.dividers import ( generate_desc_box_light_svg, generate_section_divider_light_svg, ) from scripts.readme.svg_templates.dividers import ( generate_entry_separator_svg as _generate_entry_separator_svg, ) from scripts.readme.svg_templates.headers import ( generate_category_header_light_svg, render_h2_svg, render_h3_svg, ) from scripts.readme.svg_templates.toc import ( _normalize_svg_root, generate_toc_header_light_svg, generate_toc_row_light_svg, generate_toc_row_svg, generate_toc_sub_light_svg, generate_toc_sub_svg, ) def create_h2_svg_file(text: str, filename: str, assets_dir: str, icon: str = "") -> str: """Create an animated hero-centered H2 header SVG file.""" svg_content = render_h2_svg(text, icon=icon) filepath = os.path.join(assets_dir, filename) with open(filepath, "w", encoding="utf-8") as f: f.write(svg_content) return filename def create_h3_svg_file(text: str, filename: str, assets_dir: str) -> str: """Create an animated minimal-inline H3 header SVG file.""" svg_content = render_h3_svg(text) filepath = os.path.join(assets_dir, filename) with open(filepath, "w", encoding="utf-8") as f: f.write(svg_content) if not svg_content.endswith("\n"): f.write("\n") return filename def ensure_category_header_exists( category_id: str, title: str, section_number: str, assets_dir: str, icon: str = "", always_regenerate: bool = True, ) -> tuple[str, str]: """Ensure category header SVGs exist, generating them if needed.""" safe_name = category_id.replace("-", "_") dark_filename = f"header_{safe_name}.svg" light_filename = f"header_{safe_name}-light-v3.svg" dark_path = os.path.join(assets_dir, dark_filename) if always_regenerate or not os.path.exists(dark_path): create_h2_svg_file(title, dark_filename, assets_dir, icon=icon) light_path = os.path.join(assets_dir, light_filename) if always_regenerate or not os.path.exists(light_path): svg_content = generate_category_header_light_svg(title, section_number) with open(light_path, "w", encoding="utf-8") as f: f.write(svg_content) return (dark_filename, light_filename) def ensure_section_divider_exists(variant: int, assets_dir: str) -> tuple[str, str]: """Ensure section divider SVG exists, generating if needed.""" dark_filename = "section-divider-alt2.svg" light_filename = f"section-divider-light-manual-v{variant}.svg" light_path = os.path.join(assets_dir, light_filename) if not os.path.exists(light_path): svg_content = generate_section_divider_light_svg(variant) with open(light_path, "w", encoding="utf-8") as f: f.write(svg_content) return (dark_filename, light_filename) def ensure_desc_box_exists(position: str, assets_dir: str) -> str: """Ensure desc box SVG exists, generating if needed.""" filename = f"desc-box-{position}-light.svg" filepath = os.path.join(assets_dir, filename) if not os.path.exists(filepath): svg_content = generate_desc_box_light_svg(position) with open(filepath, "w", encoding="utf-8") as f: f.write(svg_content) return filename def ensure_toc_row_exists( category_id: str, directory_name: str, description: str, assets_dir: str, always_regenerate: bool = True, ) -> str: """Ensure TOC row SVG exists, generating if needed.""" filename = f"toc-row-{category_id}.svg" filepath = os.path.join(assets_dir, filename) if always_regenerate or not os.path.exists(filepath): svg_content = generate_toc_row_svg(directory_name, description) with open(filepath, "w", encoding="utf-8") as f: f.write(svg_content) return filename def ensure_toc_sub_exists( subcat_id: str, directory_name: str, description: str, assets_dir: str, always_regenerate: bool = True, ) -> str: """Ensure TOC subcategory SVG exists, generating if needed.""" filename = f"toc-sub-{subcat_id}.svg" filepath = os.path.join(assets_dir, filename) if always_regenerate or not os.path.exists(filepath): svg_content = generate_toc_sub_svg(directory_name, description) with open(filepath, "w", encoding="utf-8") as f: f.write(svg_content) return filename def get_category_svg_filename(category_id: str) -> str: """Map category ID to SVG filename.""" svg_map = { "skills": "toc-row-skills.svg", "workflows": "toc-row-workflows.svg", "tooling": "toc-row-tooling.svg", "statusline": "toc-row-statusline.svg", "hooks": "toc-row-custom.svg", "slash-commands": "toc-row-commands.svg", "claude-md-files": "toc-row-config.svg", "alternative-clients": "toc-row-clients.svg", "official-documentation": "toc-row-docs.svg", } return svg_map.get(category_id, f"toc-row-{category_id}.svg") def get_subcategory_svg_filename(subcat_id: str) -> str: """Map subcategory ID to SVG filename.""" svg_map = { "general": "toc-sub-general.svg", "ide-integrations": "toc-sub-ide.svg", "usage-monitors": "toc-sub-monitors.svg", "orchestrators": "toc-sub-orchestrators.svg", "config-managers": "toc-sub-config-managers.svg", "version-control-git": "toc-sub-git.svg", "code-analysis-testing": "toc-sub-code-analysis.svg", "context-loading-priming": "toc-sub-context.svg", "documentation-changelogs": "toc-sub-documentation.svg", "ci-deployment": "toc-sub-ci.svg", "project-task-management": "toc-sub-project-mgmt.svg", "miscellaneous": "toc-sub-misc.svg", "language-specific": "toc-sub-language.svg", "domain-specific": "toc-sub-domain.svg", "project-scaffolding-mcp": "toc-sub-scaffolding.svg", "ralph-wiggum": "toc-sub-ralph-wiggum.svg", } return svg_map.get(subcat_id, f"toc-sub-{subcat_id}.svg") def get_category_header_svg(category_id: str) -> tuple[str, str]: """Map category ID to pre-made header SVG filenames (dark and light variants).""" header_map = { "skills": ("header_agent_skills.svg", "header_agent_skills-light-v3.svg"), "workflows": ( "header_workflows_knowledge_guides.svg", "header_workflows_knowledge_guides-light-v3.svg", ), "tooling": ("header_tooling.svg", "header_tooling-light-v3.svg"), "statusline": ("header_status_lines.svg", "header_status_lines-light-v3.svg"), "hooks": ("header_hooks.svg", "header_hooks-light-v3.svg"), "slash-commands": ( "header_slash_commands.svg", "header_slash_commands-light-v3.svg", ), "claude-md-files": ( "header_claudemd_files.svg", "header_claudemd_files-light-v3.svg", ), "alternative-clients": ( "header_alternative_clients.svg", "header_alternative_clients-light-v3.svg", ), "official-documentation": ( "header_official_documentation.svg", "header_official_documentation-light-v3.svg", ), } return header_map.get( category_id, (f"header_{category_id}.svg", f"header_{category_id}-light-v3.svg") ) _section_divider_counter = 0 def get_section_divider_svg() -> tuple[str, str]: """Get the next section divider SVG filenames.""" global _section_divider_counter variant = (_section_divider_counter % 3) + 1 _section_divider_counter += 1 return ("section-divider-alt2.svg", f"section-divider-light-manual-v{variant}.svg") def normalize_toc_svgs(assets_dir: str) -> None: """Normalize TOC row/sub SVGs to enforce consistent display height/anchoring.""" patterns = ["toc-row-*.svg", "toc-sub-*.svg", "toc-header*.svg"] for pattern in patterns: for path in glob.glob(os.path.join(assets_dir, pattern)): with open(path, encoding="utf-8") as f: content = f.read() match = re.search(r"]*>", content) if not match: continue root_tag = match.group(0) is_header = "toc-header" in os.path.basename(path) target_width = 400 target_height = 48 if is_header else 40 normalized_tag = _normalize_svg_root(root_tag, target_width, target_height) if normalized_tag != root_tag: content = content.replace(root_tag, normalized_tag, 1) with open(path, "w", encoding="utf-8") as f: f.write(content) def regenerate_main_toc_svgs(categories: list[dict], assets_dir: str) -> None: """Regenerate main category TOC row SVGs with standardized styling.""" for category in categories: display_dir = format_category_dir_name(category.get("name", ""), category.get("id", "")) description = category.get("description", "") dark_filename = get_category_svg_filename(category.get("id", "")) dark_path = os.path.join(assets_dir, dark_filename) svg_content = generate_toc_row_svg(display_dir, description) with open(dark_path, "w", encoding="utf-8") as f: f.write(svg_content) light_path = dark_path.replace(".svg", "-light-anim-scanline.svg") light_svg = generate_toc_row_light_svg(display_dir, description) with open(light_path, "w", encoding="utf-8") as f: f.write(light_svg) def regenerate_sub_toc_svgs(categories: list[dict], assets_dir: str) -> None: """Regenerate subcategory TOC SVGs to keep sizing consistent.""" for category in categories: subcats = category.get("subcategories", []) for subcat in subcats: display_dir = subcat.get("name", "") description = subcat.get("description", "") dark_filename = get_subcategory_svg_filename(subcat.get("id", "")) dark_path = os.path.join(assets_dir, dark_filename) svg_content = generate_toc_sub_svg(display_dir, description) with open(dark_path, "w", encoding="utf-8") as f: f.write(svg_content) light_path = dark_path.replace(".svg", "-light-anim-scanline.svg") light_svg = generate_toc_sub_light_svg(display_dir, description) with open(light_path, "w", encoding="utf-8") as f: f.write(light_svg) def regenerate_toc_header(assets_dir: str) -> None: """Regenerate the light-mode TOC header for consistent sizing.""" light_header_path = os.path.join(assets_dir, "toc-header-light-anim-scanline.svg") light_header_svg = generate_toc_header_light_svg() with open(light_header_path, "w", encoding="utf-8") as f: f.write(light_header_svg) def save_resource_badge_svg(display_name: str, author_name: str, assets_dir: str) -> str: """Save a resource name SVG badge to the assets directory and return the filename.""" safe_name = re.sub(r"[^a-zA-Z0-9]", "-", display_name.lower()) safe_name = re.sub(r"-+", "-", safe_name).strip("-") filename = f"badge-{safe_name}.svg" svg_content = generate_resource_badge_svg(display_name, author_name) filepath = os.path.join(assets_dir, filename) with open(filepath, "w", encoding="utf-8") as f: f.write(svg_content) if not svg_content.endswith("\n"): f.write("\n") return filename def generate_entry_separator_svg() -> str: """Generate a small separator SVG between entries in vintage manual style.""" return _generate_entry_separator_svg() def ensure_separator_svg_exists(assets_dir: str) -> str: """Return the animated entry separator SVG filename.""" _ = assets_dir return "entry-separator-light-animated.svg" def generate_flat_badges(assets_dir: str, sort_types: dict, categories: dict) -> None: """Generate all sort and category badge SVGs.""" for slug, (display, color, _) in sort_types.items(): svg = render_flat_sort_badge_svg(display, color) filepath = os.path.join(assets_dir, f"badge-sort-{slug}.svg") with open(filepath, "w", encoding="utf-8") as f: f.write(svg) for slug, (_, display, color) in categories.items(): width = max(70, len(display) * 10 + 30) svg = render_flat_category_badge_svg(display, color, width) filepath = os.path.join(assets_dir, f"badge-cat-{slug}.svg") with open(filepath, "w", encoding="utf-8") as f: f.write(svg) ================================================ FILE: scripts/readme/helpers/readme_config.py ================================================ """Configuration loader for README generation.""" import os from pathlib import Path import yaml # type: ignore[import-untyped] from scripts.utils.repo_root import find_repo_root REPO_ROOT = find_repo_root(Path(__file__)) def load_config() -> dict: """Load configuration from acc-config.yaml.""" config_path = REPO_ROOT / "acc-config.yaml" try: with open(config_path, encoding="utf-8") as f: return yaml.safe_load(f) except FileNotFoundError: print(f"Warning: acc-config.yaml not found at {config_path}, using defaults") return { "readme": {"root_style": "extra"}, "styles": { "extra": { "name": "Extra", "badge": "badge-style-extra.svg", "highlight_color": "#6a6a8a", "filename": "README_EXTRA.md", }, "classic": { "name": "Classic", "badge": "badge-style-classic.svg", "highlight_color": "#c9a227", "filename": "README_CLASSIC.md", }, "awesome": { "name": "Awesome", "badge": "badge-style-awesome.svg", "highlight_color": "#cc3366", "filename": "README_AWESOME.md", }, "flat": { "name": "Flat", "badge": "badge-style-flat.svg", "highlight_color": "#71717a", "filename": "README_FLAT_ALL_AZ.md", }, }, "style_order": ["extra", "classic", "flat", "awesome"], } # Global config instance CONFIG = load_config() def get_root_style() -> str: """Get the root README style from config.""" readme_config = CONFIG.get("readme", {}) return readme_config.get("root_style") or readme_config.get("default_style", "extra") def get_style_selector_target(style_id: str) -> str: """Get the selector link target for a style, accounting for root style config.""" root_style = get_root_style() styles = CONFIG.get("styles", {}) style_config = styles.get(style_id, {}) filename = style_config.get("filename") if not filename: if style_id == "flat": filename = "README_FLAT_ALL_AZ.md" else: filename = f"README_{style_id.upper()}.md" filename = os.path.basename(filename) if style_id == root_style: return "README.md" return f"README_ALTERNATIVES/{filename}" ================================================ FILE: scripts/readme/helpers/readme_paths.py ================================================ """Path resolution helpers for README generation.""" from __future__ import annotations import os import re from pathlib import Path from scripts.utils.repo_root import find_repo_root GENERATED_HEADER = "" ASSET_PATH_PATTERN = re.compile( r"\{\{ASSET_PATH\(\s*(?P['\"])(?P[^'\"]+)(?P=quote)\s*\)\}\}" ) ASSET_URL_PATTERN = re.compile(r"asset:([A-Za-z0-9_.\-/]+)") def asset_path_token(filename: str) -> str: """Return a tokenized asset reference for templates/markup.""" filename = filename.lstrip("/") return f"{{{{ASSET_PATH('{filename}')}}}}" def ensure_generated_header(content: str) -> str: """Prepend the generated-file header if missing.""" if content.startswith(GENERATED_HEADER): return content return f"{GENERATED_HEADER}\n{content.lstrip(chr(10))}" def resolve_asset_tokens(content: str, output_path: Path, repo_root: Path | None = None) -> str: """Resolve asset tokens into relative paths for the output location.""" repo_root = repo_root or find_repo_root(output_path) base_dir = output_path.parent assets_dir = repo_root / "assets" rel_assets = Path(os.path.relpath(assets_dir, start=base_dir)).as_posix() if rel_assets == ".": rel_assets = "assets" rel_assets = rel_assets.rstrip("/") def join_asset(path: str) -> str: path = path.lstrip("/") if not rel_assets: return path return f"{rel_assets}/{path}" content = content.replace("{{ASSET_PREFIX}}", f"{rel_assets}/") content = ASSET_PATH_PATTERN.sub(lambda match: join_asset(match.group("path")), content) content = ASSET_URL_PATTERN.sub(lambda match: join_asset(match.group(1)), content) return content def resolve_relative_link(from_path: Path, to_path: Path, repo_root: Path | None = None) -> str: """Return a relative link between two files, normalized for README links.""" repo_root = repo_root or find_repo_root(from_path) from_path = from_path.resolve() to_path = (repo_root / to_path).resolve() if not to_path.is_absolute() else to_path.resolve() rel_path = Path(os.path.relpath(to_path, start=from_path.parent)).as_posix() if to_path == repo_root / "README.md": if rel_path in (".", "README.md"): return "./" if rel_path.endswith("/README.md"): return rel_path[: -len("README.md")] return rel_path ================================================ FILE: scripts/readme/helpers/readme_utils.py ================================================ """Shared utility helpers for README generation.""" from __future__ import annotations import re from datetime import datetime def extract_github_owner_repo(url: str) -> tuple[str, str] | None: """Extract owner and repo from any GitHub URL.""" patterns = [ r"github\.com/([^/]+)/([^/]+?)(?:\.git)?/?$", # repo root r"github\.com/([^/]+)/([^/]+)/(?:blob|tree|issues|pull|releases)", # with path r"github\.com/([^/]+)/([^/]+)/?", # general fallback ] for pattern in patterns: match = re.search(pattern, url) if match: owner, repo = match.groups()[:2] repo = repo.split("/")[0].split("?")[0].split("#")[0] if owner and repo: return (owner, repo) return None def format_stars(num: int) -> str: """Format star count with K/M suffix.""" if num >= 1_000_000: return f"{num / 1_000_000:.1f}M" if num >= 1000: return f"{num / 1000:.1f}K" return str(num) def format_delta(delta: int) -> str: """Format delta with +/- prefix.""" if delta > 0: return f"+{delta}" if delta < 0: return str(delta) return "" def get_anchor_suffix_for_icon(icon: str | None) -> str: """Generate the anchor suffix for a section with a trailing emoji icon. GitHub strips simple emoji codepoints and turns them into a dash. If the emoji includes a variation selector (U+FE00 to U+FE0F), the variation selector is URL-encoded and appended after the dash. """ if not icon: return "" vs_char = next((char for char in icon if 0xFE00 <= ord(char) <= 0xFE0F), None) if vs_char: vs_bytes = vs_char.encode("utf-8") url_encoded = "".join(f"%{byte:02X}" for byte in vs_bytes) return f"-{url_encoded}" return "-" def generate_toc_anchor( title: str, icon: str | None = None, has_back_to_top_in_heading: bool = False, ) -> str: """Generate a TOC anchor for a heading. Centralizes anchor generation logic across all README styles. Args: title: The heading text (e.g., "Agent Skills") icon: Optional trailing emoji icon (e.g., "🤖"). Each emoji adds a dash. has_back_to_top_in_heading: True if heading contains 🔝 back-to-top link, which adds an additional trailing dash to the anchor. Returns: The anchor string without the leading '#' (e.g., "agent-skills-") """ base = title.lower().replace(" ", "-").replace("&", "").replace("/", "").replace(".", "") suffix = get_anchor_suffix_for_icon(icon) back_to_top_suffix = "-" if has_back_to_top_in_heading else "" return f"{base}{suffix}{back_to_top_suffix}" def generate_subcategory_anchor( title: str, general_counter: int = 0, has_back_to_top_in_heading: bool = False, ) -> tuple[str, int]: """Generate a TOC anchor for a subcategory heading. Handles the special case of multiple "General" subcategories which need unique anchors (general, general-1, general-2, etc.). Args: title: The subcategory name (e.g., "General", "IDE Integrations") general_counter: Current count of "General" subcategories seen so far has_back_to_top_in_heading: True if heading contains 🔝 back-to-top link Returns: Tuple of (anchor_string, updated_general_counter) """ base = title.lower().replace(" ", "-").replace("&", "").replace("/", "") back_to_top_suffix = "-" if has_back_to_top_in_heading else "" if title == "General": if general_counter == 0: anchor = f"general{back_to_top_suffix}" else: # GitHub uses double-dash before counter when back-to-top present separator = "-" if has_back_to_top_in_heading else "" anchor = f"general-{separator}{general_counter}" return anchor, general_counter + 1 return f"{base}{back_to_top_suffix}", general_counter def sanitize_filename_from_anchor(anchor: str) -> str: """Convert an anchor string to a tidy filename fragment.""" name = anchor.rstrip("-") name = name.replace("-", "_") name = re.sub(r"_+", "_", name) return name.strip("_") def build_general_anchor_map(categories: list[dict], csv_data: list[dict] | None = None) -> dict: """Build a map of (category, 'General') -> anchor string shared by TOC and body.""" general_map: dict[tuple[str, str], str] = {} for category in categories: category_name = category.get("name", "") category_id = category.get("id", "") subcategories = category.get("subcategories", []) for subcat in subcategories: sub_title = subcat["name"] if sub_title != "General": continue include_subcategory = True if csv_data is not None: resources = [ r for r in csv_data if r["Category"] == category_name and r.get("Sub-Category", "").strip() == sub_title ] include_subcategory = bool(resources) if not include_subcategory: continue anchor = f"{category_id}-general" general_map[(category_id, sub_title)] = anchor return general_map def parse_resource_date(date_string: str | None) -> datetime | None: """Parse a date string that may include timestamp information.""" if not date_string: return None date_string = date_string.strip() date_formats = [ "%Y-%m-%d:%H-%M-%S", "%Y-%m-%d", ] for fmt in date_formats: try: return datetime.strptime(date_string, fmt) except ValueError: continue return None def format_category_dir_name(name: str, category_id: str | None = None) -> str: """Convert category name to display text for TOC rows.""" overrides = { "workflows": "WORKFLOWS_&_GUIDES/", } if category_id and category_id in overrides: return overrides[category_id] slug = re.sub(r"[^A-Za-z0-9]+", "_", name).strip("_").upper() return slug + "/" ================================================ FILE: scripts/readme/markup/__init__.py ================================================ ================================================ FILE: scripts/readme/markup/awesome.py ================================================ """Awesome-list README markdown rendering helpers.""" from __future__ import annotations from datetime import datetime, timedelta from scripts.readme.helpers.readme_paths import asset_path_token from scripts.readme.helpers.readme_utils import ( generate_subcategory_anchor, generate_toc_anchor, parse_resource_date, ) def format_resource_entry(row: dict, include_separator: bool = True) -> str: """Format resource in awesome list style.""" _ = include_separator display_name = row["Display Name"] primary_link = row["Primary Link"] author_name = row.get("Author Name", "").strip() author_link = row.get("Author Link", "").strip() description = row.get("Description", "").strip() removed_from_origin = row.get("Removed From Origin", "").strip().upper() == "TRUE" entry_parts: list[str] = [] if primary_link: entry_parts.append(f"[{display_name}]({primary_link})") else: entry_parts.append(display_name) if author_name: if author_link: entry_parts.append(f" by [{author_name}]({author_link})") else: entry_parts.append(f" by {author_name}") if description: desc = description.rstrip() if not desc.endswith((".", "!", "?")): desc += "." entry_parts.append(f" - {desc}") result = "- " + "".join(entry_parts) if removed_from_origin: result += " *(Removed from origin)*" return result def generate_toc(categories: list[dict], csv_data: list[dict]) -> str: """Generate plain markdown TOC for awesome list style.""" toc_lines: list[str] = [] toc_lines.append("## Contents") toc_lines.append("") general_counter = 0 for category in categories: section_title = category.get("name", "") icon = category.get("icon", "") subcategories = category.get("subcategories", []) anchor = generate_toc_anchor(section_title, icon=icon) display_title = f"{section_title} {icon}" if icon else section_title if subcategories: category_name = category.get("name", "") has_resources = any(r["Category"] == category_name for r in csv_data) if has_resources: toc_lines.append(f"- [{display_title}](#{anchor})") for subcat in subcategories: sub_title = subcat["name"] resources = [ r for r in csv_data if r["Category"] == category_name and r.get("Sub-Category", "").strip() == sub_title ] if resources: sub_anchor, general_counter = generate_subcategory_anchor( sub_title, general_counter ) toc_lines.append(f" - [{sub_title}](#{sub_anchor})") else: toc_lines.append(f"- [{display_title}](#{anchor})") return "\n".join(toc_lines).strip() def generate_weekly_section(csv_data: list[dict]) -> str: """Generate weekly section with plain markdown for awesome list.""" lines: list[str] = [] lines.append("## Latest Additions") lines.append("") resources_sorted_by_date: list[tuple[datetime, dict]] = [] for row in csv_data: date_added = row.get("Date Added", "").strip() if date_added: parsed_date = parse_resource_date(date_added) if parsed_date: resources_sorted_by_date.append((parsed_date, row)) resources_sorted_by_date.sort(key=lambda x: x[0], reverse=True) latest_additions: list[dict[str, str]] = [] cutoff_date = datetime.now() - timedelta(days=7) for dated_resource in resources_sorted_by_date: if dated_resource[0] >= cutoff_date or len(latest_additions) < 3: latest_additions.append(dated_resource[1]) else: break for resource in latest_additions: lines.append(format_resource_entry(resource, include_separator=False)) lines.append("") return "\n".join(lines).rstrip() + "\n" def generate_section_content(category: dict, csv_data: list[dict]) -> str: """Generate section with plain markdown headers in awesome list format.""" lines: list[str] = [] title = category.get("name", "") icon = category.get("icon", "") description = category.get("description", "").strip() category_name = category.get("name", "") subcategories = category.get("subcategories", []) header_text = f"{title} {icon}" if icon else title lines.append(f"## {header_text}") lines.append("") if description: lines.append(f"> {description}") lines.append("") for subcat in subcategories: sub_title = subcat["name"] resources = [ r for r in csv_data if r["Category"] == category_name and r.get("Sub-Category", "").strip() == sub_title ] if resources: lines.append(f"### {sub_title}") lines.append("") for resource in resources: lines.append(format_resource_entry(resource, include_separator=False)) lines.append("") return "\n".join(lines).rstrip() + "\n" def generate_repo_ticker() -> str: """Generate the awesome-style animated SVG repo ticker.""" return f"""
Featured Claude Code Projects
""" ================================================ FILE: scripts/readme/markup/flat.py ================================================ """Flat list README markup rendering helpers.""" from __future__ import annotations from scripts.readme.helpers.readme_paths import asset_path_token from scripts.readme.helpers.readme_utils import extract_github_owner_repo def generate_shields_badges(owner: str, repo: str) -> str: """Generate shields.io badge HTML for a GitHub repository.""" badge_types = [ ("stars", f"https://img.shields.io/github/stars/{owner}/{repo}"), ("forks", f"https://img.shields.io/github/forks/{owner}/{repo}"), ("issues", f"https://img.shields.io/github/issues/{owner}/{repo}"), ("prs", f"https://img.shields.io/github/issues-pr/{owner}/{repo}"), ("created", f"https://img.shields.io/github/created-at/{owner}/{repo}"), ("last-commit", f"https://img.shields.io/github/last-commit/{owner}/{repo}"), ("release-date", f"https://img.shields.io/github/release-date/{owner}/{repo}"), ("version", f"https://img.shields.io/github/v/release/{owner}/{repo}"), ("license", f"https://img.shields.io/github/license/{owner}/{repo}"), ] badges = [] for alt, url in badge_types: badges.append(f'{alt}') return " ".join(badges) def generate_sort_navigation( category_slug: str, sort_type: str, sort_types: dict, ) -> str: """Generate sort option badges.""" lines = ['

'] for slug, (display, color, _) in sort_types.items(): filename = f"README_FLAT_{category_slug.upper()}_{slug.upper()}.md" is_selected = slug == sort_type style = f' style="border: 3px solid {color}; border-radius: 6px;"' if is_selected else "" lines.append( f' ' ) lines.append("

") return "\n".join(lines) def generate_category_navigation( category_slug: str, sort_type: str, categories: dict, ) -> str: """Generate category filter badges.""" lines = ['

'] for slug, (_, display, color) in categories.items(): filename = f"README_FLAT_{slug.upper()}_{sort_type.upper()}.md" is_selected = slug == category_slug style = f' style="border: 2px solid {color}; border-radius: 4px;"' if is_selected else "" lines.append( f' ' ) lines.append("

") return "\n".join(lines) def generate_navigation( category_slug: str, sort_type: str, categories: dict, sort_types: dict, ) -> str: """Generate combined navigation (sort + category).""" sort_nav = generate_sort_navigation(category_slug, sort_type, sort_types) cat_nav = generate_category_navigation(category_slug, sort_type, categories) _, _, sort_desc = sort_types[sort_type] _, cat_display, _ = categories[category_slug] current_info = f"**{cat_display}** sorted {sort_desc}" if sort_type == "releases": current_info += " (past 30 days)" return f"""{sort_nav}

Category:

{cat_nav}

Currently viewing: {current_info}

""" def generate_resources_table(sorted_resources: list[dict], sort_type: str) -> str: """Generate the resources table as HTML with shields.io badges for GitHub resources.""" if not sorted_resources: if sort_type == "releases": return "*No releases in the past 30 days for this category.*" return "*No resources found in this category.*" lines: list[str] = ["", "", ""] if sort_type == "releases": num_cols = 5 lines.extend( [ "", "", "", "", "", ] ) else: num_cols = 4 lines.extend( [ "", "", "", "", ] ) lines.extend(["", "", ""]) for row in sorted_resources: display_name = row.get("Display Name", "").strip() primary_link = row.get("Primary Link", "").strip() author_name = row.get("Author Name", "").strip() author_link = row.get("Author Link", "").strip() if primary_link: resource_html = f'{display_name}' else: resource_html = f"{display_name}" if author_name and author_link: author_html = f'{author_name}' else: author_html = author_name or "" resource_cell = f"{resource_html}
by {author_html}" if author_html else resource_html lines.append("") lines.append(f"") if sort_type == "releases": version = row.get("Release Version", "").strip() or "-" source = row.get("Release Source", "").strip() source_display = { "github-releases": "GitHub", "npm": "npm", "pypi": "PyPI", "crates": "crates.io", "homebrew": "Homebrew", "readme": "README", }.get(source, source or "-") release_date = row.get("Latest Release", "")[:10] if row.get("Latest Release") else "-" description = row.get("Description", "").strip() lines.append(f"") lines.append(f"") lines.append(f"") lines.append(f"") else: category = row.get("Category", "").strip() or "-" sub_category = row.get("Sub-Category", "").strip() or "-" description = row.get("Description", "").strip() lines.append(f"") lines.append(f"") lines.append(f"") lines.append("") if primary_link: github_info = extract_github_owner_repo(primary_link) if github_info: owner, repo = github_info badges = generate_shields_badges(owner, repo) lines.append("") lines.append(f'') lines.append("") lines.extend(["", "
ResourceVersionSourceRelease DateDescriptionResourceCategorySub-CategoryDescription
{resource_cell}{version}{source_display}{release_date}{description}{category}{sub_category}{description}
{badges}
"]) return "\n".join(lines) def get_default_template() -> str: """Return default template content.""" return """ {{STYLE_SELECTOR}} # Awesome Claude Code (Flat) [![Awesome](https://awesome.re/badge-flat2.svg)](https://awesome.re) A flat list view of all resources. Category: **{{CATEGORY_NAME}}** | Sorted: {{SORT_DESC}} --- ## Sort By: {{NAVIGATION}} --- ## Resources {{RELEASES_DISCLAIMER}} {{RESOURCES_TABLE}} --- **Total Resources:** {{RESOURCE_COUNT}} **Last Generated:** {{GENERATED_DATE}} """ ================================================ FILE: scripts/readme/markup/minimal.py ================================================ """Minimal README markdown rendering helpers.""" from __future__ import annotations from datetime import datetime, timedelta from scripts.readme.helpers.readme_utils import ( generate_subcategory_anchor, generate_toc_anchor, parse_resource_date, ) from scripts.utils.github_utils import parse_github_url def format_resource_entry(row: dict, include_separator: bool = True) -> str: """Format resource as plain markdown with collapsible GitHub stats.""" _ = include_separator display_name = row["Display Name"] primary_link = row["Primary Link"] author_name = row.get("Author Name", "").strip() author_link = row.get("Author Link", "").strip() description = row.get("Description", "").strip() license_info = row.get("License", "").strip() removed_from_origin = row.get("Removed From Origin", "").strip().upper() == "TRUE" entry_parts = [f"[`{display_name}`]({primary_link})"] if author_name: if author_link: entry_parts.append(f"   by   [{author_name}]({author_link})") else: entry_parts.append(f"   by   {author_name}") entry_parts.append(" ") if license_info and license_info != "NOT_FOUND": entry_parts.append(f"  ⚖️  {license_info}") result = "".join(entry_parts) if description: result += f" \n{description}" + ("* " if removed_from_origin else "") if removed_from_origin: result += "\n* Removed from origin" if primary_link and not removed_from_origin: _, is_github, owner, repo = parse_github_url(primary_link) if is_github and owner and repo: base_url = "https://github-readme-stats-fork-orpin.vercel.app/api/pin/" stats_url = f"{base_url}?repo={repo}&username={owner}&all_stats=true&stats_only=true" result += "\n\n
" result += "\n📊 GitHub Stats" result += f"\n\n![GitHub Stats for {repo}]({stats_url})" result += "\n\n
" result += "\n
" return result def generate_toc(categories: list[dict], csv_data: list[dict]) -> str: """Generate plain markdown nested details TOC.""" toc_lines: list[str] = [] toc_lines.append("## Contents [🔝](#awesome-claude-code)") toc_lines.append("") toc_lines.append("
") toc_lines.append("Table of Contents") toc_lines.append("") general_counter = 0 # CLASSIC style headings include [🔝](#awesome-claude-code) which adds another dash has_back_to_top = True for category in categories: section_title = category.get("name", "") icon = category.get("icon", "") subcategories = category.get("subcategories", []) anchor = generate_toc_anchor( section_title, icon=icon, has_back_to_top_in_heading=has_back_to_top ) if subcategories: toc_lines.append("-
") toc_lines.append(f' {section_title}') toc_lines.append("") for subcat in subcategories: sub_title = subcat["name"] category_name = category.get("name", "") resources = [ r for r in csv_data if r["Category"] == category_name and r.get("Sub-Category", "").strip() == sub_title ] if resources: sub_anchor, general_counter = generate_subcategory_anchor( sub_title, general_counter, has_back_to_top_in_heading=has_back_to_top ) toc_lines.append(f" - [{sub_title}](#{sub_anchor})") toc_lines.append("") toc_lines.append("
") else: toc_lines.append(f"- [{section_title}](#{anchor})") toc_lines.append("") toc_lines.append("
") return "\n".join(toc_lines).strip() def generate_weekly_section(csv_data: list[dict]) -> str: """Generate weekly section with plain markdown.""" lines: list[str] = [] lines.append("## Latest Additions ✨ [🔝](#awesome-claude-code)") lines.append("") resources_sorted_by_date: list[tuple[datetime, dict]] = [] for row in csv_data: date_added = row.get("Date Added", "").strip() if date_added: parsed_date = parse_resource_date(date_added) if parsed_date: resources_sorted_by_date.append((parsed_date, row)) resources_sorted_by_date.sort(key=lambda x: x[0], reverse=True) latest_additions: list[dict[str, str]] = [] cutoff_date = datetime.now() - timedelta(days=7) for dated_resource in resources_sorted_by_date: if dated_resource[0] >= cutoff_date or len(latest_additions) < 3: latest_additions.append(dated_resource[1]) else: break lines.append("") for resource in latest_additions: lines.append(format_resource_entry(resource, include_separator=False)) lines.append("") return "\n".join(lines).rstrip() + "\n" def generate_section_content(category: dict, csv_data: list[dict]) -> str: """Generate section with plain markdown headers.""" lines: list[str] = [] title = category.get("name", "") icon = category.get("icon", "") description = category.get("description", "").strip() category_name = category.get("name", "") subcategories = category.get("subcategories", []) header_text = f"{title} {icon}" if icon else title lines.append(f"## {header_text} [🔝](#awesome-claude-code)") lines.append("") if description: lines.append(f"> {description}") lines.append("") for subcat in subcategories: sub_title = subcat["name"] resources = [ r for r in csv_data if r["Category"] == category_name and r.get("Sub-Category", "").strip() == sub_title ] if resources: lines.append("
") lines.append( f'

{sub_title} 🔝

' ) lines.append("") for resource in resources: lines.append(format_resource_entry(resource, include_separator=False)) lines.append("") lines.append("
") lines.append("") lines.append("
") return "\n".join(lines).rstrip() + "\n" ================================================ FILE: scripts/readme/markup/shared.py ================================================ """Markdown/HTML rendering helpers shared across README styles.""" from __future__ import annotations import os from pathlib import Path import yaml # type: ignore[import-untyped] from scripts.readme.helpers.readme_config import CONFIG, get_style_selector_target from scripts.readme.helpers.readme_paths import asset_path_token, resolve_relative_link def generate_style_selector( current_style: str, output_path: Path, repo_root: Path | None = None ) -> str: """Generate the style selector HTML for a README.""" styles = CONFIG.get("styles", {}) style_order = CONFIG.get("style_order", ["extra", "classic", "flat", "awesome"]) lines = ['

Pick Your Style:

', '

'] for style_id in style_order: style_config = styles.get(style_id, {}) name = style_config.get("name", style_id.title()) badge = style_config.get("badge", f"badge-style-{style_id}.svg") highlight_color = style_config.get("highlight_color", "#666666") target_path = Path(get_style_selector_target(style_id)) href = resolve_relative_link(output_path, target_path, repo_root) if style_id == current_style: style_attr = f' style="border: 2px solid {highlight_color}; border-radius: 4px;"' else: style_attr = "" badge_src = asset_path_token(badge) lines.append( f'{name}' ) lines.append("

") return "\n".join(lines) def load_announcements(template_dir: str) -> str: """Load announcements from the announcements.yaml file and format as markdown.""" announcements_path = os.path.join(template_dir, "announcements.yaml") if os.path.exists(announcements_path): with open(announcements_path, encoding="utf-8") as f: announcements_data = yaml.safe_load(f) if not announcements_data: return "" markdown_lines = [] markdown_lines.append("### Announcements [🔝](#awesome-claude-code)") markdown_lines.append("") markdown_lines.append("
") markdown_lines.append("View Announcements") markdown_lines.append("") for entry in announcements_data: date = entry.get("date", "") title = entry.get("title", "") items = entry.get("items", []) markdown_lines.append("-
") if title: markdown_lines.append(f" {date} - {title}") else: markdown_lines.append(f" {date}") markdown_lines.append("") for item in items: if isinstance(item, str): markdown_lines.append(f" - {item}") elif isinstance(item, dict): summary = item.get("summary", "") text = item.get("text", "") if summary and text: markdown_lines.append(" -
") markdown_lines.append(f" {summary}") markdown_lines.append("") text_lines = text.strip().split("\n") for i, line in enumerate(text_lines): if i == 0: markdown_lines.append(f" - {line}") else: markdown_lines.append(f" {line}") markdown_lines.append("") markdown_lines.append("
") elif summary: markdown_lines.append(f" - {summary}") elif text: markdown_lines.append(f" - {text}") markdown_lines.append("") markdown_lines.append("
") markdown_lines.append("") markdown_lines.append("
") return "\n".join(markdown_lines).strip() return "" ================================================ FILE: scripts/readme/markup/visual.py ================================================ """Visual README markup rendering helpers.""" from __future__ import annotations from datetime import datetime, timedelta from pathlib import Path from scripts.readme.helpers.readme_assets import ( create_h3_svg_file, ensure_category_header_exists, ensure_separator_svg_exists, get_category_svg_filename, get_section_divider_svg, get_subcategory_svg_filename, save_resource_badge_svg, ) from scripts.readme.helpers.readme_paths import asset_path_token from scripts.readme.helpers.readme_utils import ( generate_toc_anchor, parse_resource_date, sanitize_filename_from_anchor, ) from scripts.utils.github_utils import parse_github_url from scripts.utils.repo_root import find_repo_root REPO_ROOT = find_repo_root(Path(__file__)) def format_resource_entry( row: dict, assets_dir: str | None = None, include_separator: bool = True, ) -> str: """Format a single resource entry with vintage manual styling for light mode.""" display_name = row["Display Name"] primary_link = row["Primary Link"] author_name = row.get("Author Name", "").strip() description = row.get("Description", "").strip() removed_from_origin = row.get("Removed From Origin", "").strip().upper() == "TRUE" parts: list[str] = [] if assets_dir: badge_filename = save_resource_badge_svg(display_name, author_name, assets_dir) parts.append(f'') parts.append(f'{display_name}') parts.append("") else: parts.append(f"[`{display_name}`]({primary_link})") if author_name: parts.append(f" by {author_name}") if description: parts.append(" \n") parts.append(f"_{description}_" + ("*" if removed_from_origin else "")) if removed_from_origin: parts.append(" \n") parts.append("* Removed from origin") if primary_link and not removed_from_origin: _, is_github, owner, repo = parse_github_url(primary_link) if is_github and owner and repo: base_url = "https://github-readme-stats-fork-orpin.vercel.app/api/pin/" stats_url = ( f"{base_url}?repo={repo}&username={owner}&all_stats=true&stats_only=true" "&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000" ) parts.append(" \n") parts.append(f"![GitHub Stats for {repo}]({stats_url})") if include_separator and assets_dir: separator_filename = ensure_separator_svg_exists(assets_dir) parts.append("\n\n") parts.append('
') parts.append(f'') parts.append("
") parts.append("\n") return "".join(parts) def generate_weekly_section( csv_data: list[dict], assets_dir: str | None = None, ) -> str: """Generate the latest additions section that appears above Contents.""" lines: list[str] = [] lines.append('
') lines.append(" ") lines.append( f' ' ) lines.append( f' ' ) lines.append( f' ' ) lines.append(" ") lines.append("
") lines.append("") resources_sorted_by_date: list[tuple[datetime, dict]] = [] for row in csv_data: date_added = row.get("Date Added", "").strip() if date_added: parsed_date = parse_resource_date(date_added) if parsed_date: resources_sorted_by_date.append((parsed_date, row)) resources_sorted_by_date.sort(key=lambda x: x[0], reverse=True) latest_additions: list[dict] = [] cutoff_date = datetime.now() - timedelta(days=7) for dated_resource in resources_sorted_by_date: if dated_resource[0] >= cutoff_date or len(latest_additions) < 3: latest_additions.append(dated_resource[1]) else: break for resource in latest_additions: lines.append( format_resource_entry( resource, assets_dir=assets_dir, include_separator=False, ) ) lines.append("") return "\n".join(lines).rstrip() + "\n" def generate_toc_from_categories( categories: list[dict] | None = None, csv_data: list[dict] | None = None, general_map: dict | None = None, ) -> str: """Generate simple table of contents as vertical list of SVG rows.""" if categories is None: from scripts.categories.category_utils import category_manager categories = category_manager.get_categories_for_readme() toc_header = f""" Directory Listing """ toc_lines = [ '
', f'
{toc_header}
', ] for category in categories: section_title = category["name"] category_name = category.get("name", "") category_id = category.get("id", "") # EXTRA style uses explicit IDs with trailing dash (no icon in anchor) anchor = generate_toc_anchor(section_title, icon=None, has_back_to_top_in_heading=True) svg_filename = get_category_svg_filename(category_id) dark_svg = svg_filename light_svg = svg_filename.replace(".svg", "-light-anim-scanline.svg") toc_lines.append('") subcategories = category.get("subcategories", []) if subcategories: for subcat in subcategories: sub_title = subcat["name"] subcat_id = subcat.get("id", "") include_subcategory = True if csv_data is not None: resources = [ r for r in csv_data if r["Category"] == category_name and r.get("Sub-Category", "").strip() == sub_title ] include_subcategory = bool(resources) if include_subcategory: sub_anchor = ( sub_title.lower().replace(" ", "-").replace("&", "").replace("/", "") ) if sub_title == "General": if general_map is not None: sub_anchor = general_map.get((category_id, sub_title), "general") else: sub_anchor = f"{category_id}-general" svg_filename = get_subcategory_svg_filename(subcat_id) dark_svg = svg_filename light_svg = svg_filename.replace(".svg", "-light-anim-scanline.svg") toc_lines.append( '") toc_lines.append("
") return "\n".join(toc_lines).strip() def generate_section_content( category: dict, csv_data: list[dict], general_map: dict | None = None, assets_dir: str | None = None, section_index: int = 0, ) -> str: """Generate content for a category based on CSV data.""" lines: list[str] = [] category_id = category.get("id", "") title = category.get("name", "") icon = category.get("icon", "") description = category.get("description", "").strip() category_name = category.get("name", "") subcategories = category.get("subcategories", []) dark_divider, light_divider = get_section_divider_svg() lines.append('
') lines.append(" ") lines.append( f' ' ) lines.append( f' ' ) lines.append( f' ' ) lines.append(" ") lines.append("
") lines.append("") # EXTRA style uses explicit IDs with trailing dash (no icon in anchor) anchor_id = generate_toc_anchor(title, icon=None, has_back_to_top_in_heading=True) section_number = str(section_index + 1).zfill(2) display_title = title if category_id == "workflows": display_title = "Workflows & Guides" assert assets_dir is not None dark_header, light_header = ensure_category_header_exists( category_id, display_title, section_number, assets_dir, icon=icon, always_regenerate=True, ) lines.append(f'

') lines.append('
') lines.append(" ") lines.append( f' ' ) lines.append( f' ' ) lines.append( f' {title}' ) lines.append(" ") lines.append("
") lines.append("

") lines.append('') lines.append("") if description: lines.append("") lines.append('
') lines.append(" ") lines.append( f' ' ) lines.append( f' ' ) lines.append( f' ' ) lines.append(" ") lines.append("
") lines.append(f"

{description}

") lines.append('
') lines.append(" ") lines.append( f' ' ) lines.append( f' ' ) lines.append( f' ' ) lines.append(" ") lines.append("
") for subcat in subcategories: sub_title = subcat["name"] resources = [ r for r in csv_data if r["Category"] == category_name and r.get("Sub-Category", "").strip() == sub_title ] if resources: lines.append("") sub_anchor = sub_title.lower().replace(" ", "-").replace("&", "").replace("/", "") if sub_title == "General": if general_map is not None: sub_anchor = general_map.get((category_id, sub_title), "general") else: sub_anchor = f"{category_id}-general" sub_anchor_id = sub_anchor safe_filename = sanitize_filename_from_anchor(sub_anchor) svg_filename = f"subheader_{safe_filename}.svg" assets_root = str(REPO_ROOT / "assets") create_h3_svg_file(sub_title, svg_filename, assets_root) lines.append(f'
') lines.append( f'' ) lines.append("") for resource in resources: lines.append( format_resource_entry( resource, assets_dir=assets_dir, ) ) lines.append("") lines.append("
") return "\n".join(lines).rstrip() + "\n" def generate_repo_ticker() -> str: """Generate the animated SVG repo ticker for visual theme.""" return f"""

Featured Claude Code Projects
""" ================================================ FILE: scripts/readme/svg_templates/__init__.py ================================================ ================================================ FILE: scripts/readme/svg_templates/badges.py ================================================ """SVG renderers for badges.""" def generate_resource_badge_svg(display_name, author_name=""): """Generate SVG content for a resource name badge with theme-adaptive colors. Uses CSS media queries to switch between light and dark color schemes. - Light: dark text on transparent background - Dark: light text on transparent background """ # Get first two letters/initials for the box words = display_name.split() if len(words) >= 2: initials = words[0][0].upper() + words[1][0].upper() else: initials = display_name[:2].upper() # Escape XML special characters name_escaped = ( display_name.replace("&", "&") .replace("<", "<") .replace(">", ">") .replace('"', """) ) author_escaped = ( author_name.replace("&", "&") .replace("<", "<") .replace(">", ">") .replace('"', """) if author_name else "" ) # Calculate width based on text length (approximate) - larger fonts need more space name_width = len(display_name) * 10 author_width = (len(author_name) * 7 + 35) if author_name else 0 # 35px for "by " text_width = name_width + author_width + 70 # 70px for box + padding svg_width = max(220, min(700, text_width)) # Calculate position for author text name_end_x = 48 + name_width # Build author text element if author provided author_element = "" if author_name: author_element = f""" by {author_escaped}""" svg = f""" {initials} {name_escaped}{author_element} """ return svg def render_flat_sort_badge_svg(display: str, color: str) -> str: """Render a flat-list sort badge SVG.""" return f""" {display} """ def render_flat_category_badge_svg(display: str, color: str, width: int) -> str: """Render a flat-list category badge SVG.""" return f""" {display} """ ================================================ FILE: scripts/readme/svg_templates/dividers.py ================================================ """SVG renderers for section dividers and boxes.""" def generate_section_divider_light_svg(variant=1): """Generate a light-mode section divider SVG. Args: variant: 1, 2, or 3 for different styles """ if variant == 1: # Diagram/schematic style with nodes return """ """ elif variant == 2: # Wave/organic style return """ """ else: # variant == 3 # Bracket style with layered drafts return """ """ def generate_desc_box_light_svg(position="top"): """Generate a light-mode description box SVG (top or bottom). Args: position: "top" or "bottom" """ if position == "top": return """ """ else: # bottom return """ """ def generate_entry_separator_svg(): """Generate a small separator SVG between entries in vintage manual style. Uses bolder 'layered drafts' aesthetic with ghost circles for depth. """ return """ """ ================================================ FILE: scripts/readme/svg_templates/headers.py ================================================ """SVG renderers for section headers.""" def render_h2_svg(text: str, icon: str = "") -> str: """Create an animated hero-centered H2 header SVG string. Args: text: The header text (e.g., "Agent Skills") icon: Optional icon to append (e.g., an emoji) """ # Build display text with optional icon display_text = f"{text} {icon}" if icon else text # Escape XML special characters text_escaped = display_text.replace("&", "&").replace("<", "<").replace(">", ">") # Calculate viewBox bounds based on text length # Text is centered at x=400, font-size 38px ~ 22px per char, emoji ~ 50px text_width = len(text) * 22 + (50 if icon else 0) half_text = text_width / 2 # Ensure we include decorations (x=187 to x=613) plus text bounds with generous padding left_bound = int(min(180, 400 - half_text - 30)) right_bound = int(max(620, 400 + half_text + 30)) viewbox_width = right_bound - left_bound return f""" {text_escaped} """ def render_h3_svg(text: str) -> str: """Create an animated minimal-inline H3 header SVG string.""" # Escape XML special characters text_escaped = text.replace("&", "&").replace("<", "<").replace(">", ">") # Calculate approximate text width (rough estimate: 10px per character for 18px font) text_width = len(text) * 10 total_width = text_width + 50 # Add padding for decorative elements return f""" {text_escaped} """ def generate_category_header_light_svg(title, section_number="01"): """Generate a light-mode category header SVG in vintage technical manual style. Args: title: The category title (e.g., "Agent Skills", "Tooling") section_number: Two-digit section number (e.g., "01", "02") """ # Escape XML special characters title_escaped = title.replace("&", "&").replace("<", "<").replace(">", ">") # Calculate text width for positioning title_width = len(title) * 14 # Approximate width per character line_end_x = max(640, 220 + title_width + 50) return f""" {section_number} {title_escaped} """ ================================================ FILE: scripts/readme/svg_templates/py.typed ================================================ ================================================ FILE: scripts/readme/svg_templates/toc.py ================================================ """SVG renderers for table-of-contents elements.""" import re def generate_toc_row_svg(directory_name, description): """Generate a dark-mode TOC row SVG in CRT terminal style. Args: directory_name: The directory name (e.g., "agent-skills/") description: Short description for the comment """ # Escape XML entities desc_escaped = description.replace("&", "&").replace("<", "<").replace(">", ">") dir_escaped = directory_name.replace("&", "&").replace("<", "<").replace(">", ">") return f""" drwxr-xr-x {dir_escaped} """ def generate_toc_row_light_svg(directory_name, description): """Generate a light-mode TOC row SVG in vintage manual style.""" _ = description # Reserved for future use dir_escaped = directory_name.replace("&", "&").replace("<", "<").replace(">", ">") return f""" 01 {dir_escaped} §1 """ def generate_toc_header_light_svg(): """Generate a compact light-mode TOC header with fixed width and centered title.""" return """ CONTENTS """ def generate_toc_sub_svg(directory_name, description): """Generate a dark-mode TOC subcategory row SVG. Args: directory_name: The subdirectory name (e.g., "general/") description: Short description for the comment """ _ = description # Reserved for future use dir_escaped = directory_name.replace("&", "&").replace("<", "<").replace(">", ">") return f""" |- {dir_escaped} """ def generate_toc_sub_light_svg(directory_name, description): """Generate a light-mode TOC subcategory row SVG.""" _ = description # Reserved for future use dir_escaped = directory_name.replace("&", "&").replace("<", "<").replace(">", ">") return f""" |- {dir_escaped} """ def _normalize_svg_root(tag: str, target_width: int, target_height: int) -> str: """Ensure root SVG tag enforces target width/height, viewBox, and left anchoring.""" def ensure_attr(svg_tag: str, name: str, value: str) -> str: if re.search(rf'{name}="[^"]*"', svg_tag): return re.sub(rf'{name}="[^"]*"', f'{name}="{value}"', svg_tag) # Insert before closing ">" return svg_tag.rstrip(">") + f' {name}="{value}">' # Force consistent width/height svg_tag = ensure_attr(tag, "width", str(target_width)) svg_tag = ensure_attr(svg_tag, "height", str(target_height)) # Ensure preserveAspectRatio anchors left and keeps aspect svg_tag = ensure_attr(svg_tag, "preserveAspectRatio", "xMinYMid meet") # Enforce viewBox to match target dimensions svg_tag = ensure_attr(svg_tag, "viewBox", f"0 0 {target_width} {target_height}") return svg_tag ================================================ FILE: scripts/resources/__init__.py ================================================ ================================================ FILE: scripts/resources/create_resource_pr.py ================================================ #!/usr/bin/env python3 """ Create a pull request with a new resource addition. This script is called by the GitHub Action after approval. """ import argparse import contextlib import glob import json import os import re import subprocess import sys from datetime import datetime from pathlib import Path from scripts.utils.repo_root import find_repo_root REPO_ROOT = find_repo_root(Path(__file__)) sys.path.insert(0, str(REPO_ROOT)) from scripts.ids.resource_id import generate_resource_id from scripts.readme.generate_readme import main as generate_readmes from scripts.resources.resource_utils import append_to_csv, generate_pr_content from scripts.validation.validate_links import ( get_github_commit_dates_from_url, get_latest_release_info, ) def run_command(cmd: list[str], check: bool = True) -> subprocess.CompletedProcess: """Run a command and return the result.""" return subprocess.run(cmd, capture_output=True, text=True, check=check) def create_unique_branch_name(base_name: str) -> str: """Create a unique branch name with timestamp.""" timestamp = datetime.now().strftime("%Y%m%d-%H%M%S") return f"{base_name}-{timestamp}" def get_badge_filename(display_name: str) -> str: """Compute the badge filename for a resource. Uses the same logic as save_resource_badge_svg in generate_readme.py. """ safe_name = re.sub(r"[^a-zA-Z0-9]", "-", display_name.lower()) safe_name = re.sub(r"-+", "-", safe_name).strip("-") return f"badge-{safe_name}.svg" def validate_generated_outputs(status_stdout: str, repo_root: str) -> None: """Verify expected outputs exist and no unexpected files are changed.""" expected_readme = os.path.join(repo_root, "README.md") expected_csv = os.path.join(repo_root, "THE_RESOURCES_TABLE.csv") expected_readme_dir = os.path.join(repo_root, "README_ALTERNATIVES") if not os.path.isfile(expected_readme): raise Exception(f"Missing generated README: {expected_readme}") if not os.path.isfile(expected_csv): raise Exception(f"Missing CSV: {expected_csv}") if not os.path.isdir(expected_readme_dir): raise Exception(f"Missing README directory: {expected_readme_dir}") if not glob.glob(os.path.join(expected_readme_dir, "*.md")): raise Exception(f"No README alternatives found in {expected_readme_dir}") changed_paths = [] for line in status_stdout.splitlines(): if not line.strip(): continue path = line[3:] if " -> " in path: path = path.split(" -> ", 1)[1] changed_paths.append(path) allowed_files = {"README.md", "THE_RESOURCES_TABLE.csv"} allowed_prefixes = ("README_ALTERNATIVES/", "assets/") ignored_files = {"resource_data.json", "pr_result.json"} unexpected = [ path for path in changed_paths if path not in ignored_files and path not in allowed_files and not path.startswith(allowed_prefixes) ] if unexpected: raise Exception(f"Unexpected changes outside generated outputs: {', '.join(unexpected)}") def write_step_outputs(outputs: dict[str, str]) -> None: """Write outputs for GitHub Actions, if available.""" output_path = os.environ.get("GITHUB_OUTPUT") if not output_path: return try: with open(output_path, "a", encoding="utf-8") as f: for key, value in outputs.items(): if value is None: value = "" value_str = str(value) if "\n" in value_str or "\r" in value_str: f.write(f"{key}< **Warning**: Badge SVG (`assets/{badge_filename}`) was not generated. " "Manual attention may be required." ) run_command(["git", "add", "-A", "--", *files_to_stage]) # Commit commit_message = f"Add resource: {resource_data['display_name']}\n\n" commit_message += f"Category: {resource_data['category']}\n" if resource_data.get("subcategory"): commit_message += f"Sub-category: {resource_data['subcategory']}\n" commit_message += f"Author: {resource_data['author_name']}\n" commit_message += f"From issue: #{args.issue_number}" run_command(["git", "commit", "-m", commit_message]) # Push branch run_command(["git", "push", "origin", branch_name]) # Create PR pr_title = f"Add resource: {resource_data['display_name']}" pr_body = generate_pr_content(resource) pr_body += badge_warning # Empty string if badge was generated successfully pr_body += f"\n\n---\n\nResolves #{args.issue_number}" # Use gh CLI to create PR result = run_command( [ "gh", "pr", "create", "--title", pr_title, "--body", pr_body, "--base", "main", "--head", branch_name, ] ) # Extract PR URL from output pr_url = result.stdout.strip() # Output result result = { "success": True, "pr_url": pr_url, "branch_name": branch_name, "resource_id": resource_id, } except Exception as e: print(f"Error in create_resource_pr: {e}", file=sys.stderr) import traceback traceback.print_exc(file=sys.stderr) result = { "success": False, "error": str(e), "branch_name": branch_name if "branch_name" in locals() else None, } write_step_outputs( { "success": "true" if result["success"] else "false", "pr_url": result.get("pr_url") or "", "branch_name": result.get("branch_name") or "", "resource_id": result.get("resource_id") or "", "error": result.get("error") or "", } ) print(json.dumps(result)) return 0 if result["success"] else 1 if __name__ == "__main__": sys.exit(main()) ================================================ FILE: scripts/resources/detect_informal_submission.py ================================================ """ Detect informal resource submissions that didn't use the issue template. Returns a confidence score and recommended action: - score >= 0.6: High confidence - auto-close with firm warning - 0.4 <= score < 0.6: Medium confidence - gentle warning, leave open - score < 0.4: Low confidence - no action Usage: Set ISSUE_TITLE and ISSUE_BODY environment variables, then run: python -m scripts.resources.detect_informal_submission Outputs GitHub Actions outputs: - action: "none" | "warn" | "close" - confidence: float (0.0 to 1.0) formatted as percentage - matched_signals: comma-separated list of matched signals """ from __future__ import annotations import os import re from dataclasses import dataclass from enum import Enum class Action(Enum): NONE = "none" WARN = "warn" # Medium confidence: warn but don't close CLOSE = "close" # High confidence: warn and close @dataclass class DetectionResult: confidence: float action: Action matched_signals: list[str] # Template field labels - VERY strong indicator (from the issue form) # Matching 3+ of these is almost certainly a copy-paste from template without using form TEMPLATE_FIELD_LABELS = [ "display name:", "category:", "sub-category:", "primary link:", "author name:", "author link:", "license:", "description:", "validate claims:", "specific task", "specific prompt", "additional comments:", ] # Strong signals: clear intent to submit/recommend a resource STRONG_SIGNALS: list[tuple[str, str]] = [ (r"\b(recommend(ing)?|submit(ting)?|submission)\b", "submission language"), (r"\b(add|include).*\b(resource|tool|plugin)\b", "add resource request"), (r"\b(please add|check.?out|made this|created this|built this)\b", "creator language"), ( r"\b(would be great|might be useful|could be added|should be added)\b", "suggestion language", ), (r"\bnew (tool|plugin|skill|hook|command)\b", "new resource mention"), ] # Medium signals: contextual indicators MEDIUM_SIGNALS: list[tuple[str, str]] = [ (r"github\.com/[\w-]+/[\w-]+", "GitHub repo URL"), (r"\b(plugin|skill|hook|slash.?command|claude\.md)\b", "resource type mention"), (r"\b(agent skills?|tooling|workflows?|status.?lines?)\b", "category mention"), (r"\bhttps?://\S+", "contains URL"), (r"\bMIT|Apache|GPL|BSD|ISC\b", "license mention"), ] # Negative signals: reduce score if these are present (likely bug/question) NEGATIVE_SIGNALS: list[tuple[str, str]] = [ (r"\b(bug|error|crash|broken|fix|issue|problem)\b", "bug-like language"), (r"\b(how (do|can|to)|what is|why does)\b", "question language"), (r"\b(not working|doesn't work|failed)\b", "failure language"), ] HIGH_THRESHOLD = 0.6 MEDIUM_THRESHOLD = 0.4 def count_template_field_matches(text: str) -> int: """Count how many template field labels appear in the text.""" text_lower = text.lower() return sum(1 for label in TEMPLATE_FIELD_LABELS if label in text_lower) def calculate_confidence(title: str, body: str) -> DetectionResult: """Calculate confidence that this is an informal resource submission.""" text = f"{title}\n{body}".lower() score = 0.0 matched: list[str] = [] # Check for template field labels (VERY strong indicator) # 3+ matches = almost certainly tried to copy template format template_matches = count_template_field_matches(text) if template_matches >= 3: # This is a near-certain match - set high score immediately score += 0.7 matched.append(f"template-fields: {template_matches} matches") elif template_matches >= 1: score += 0.2 * template_matches matched.append(f"template-fields: {template_matches} matches") # Check strong signals (+0.3 each, max contribution ~0.9) for pattern, name in STRONG_SIGNALS: if re.search(pattern, text, re.IGNORECASE): score += 0.3 matched.append(f"strong: {name}") # Check medium signals (+0.15 each) for pattern, name in MEDIUM_SIGNALS: if re.search(pattern, text, re.IGNORECASE): score += 0.15 matched.append(f"medium: {name}") # Check negative signals (-0.2 each) for pattern, name in NEGATIVE_SIGNALS: if re.search(pattern, text, re.IGNORECASE): score -= 0.2 matched.append(f"negative: {name}") # Clamp score to [0, 1] score = max(0.0, min(1.0, score)) # Determine action based on thresholds if score >= HIGH_THRESHOLD: action = Action.CLOSE elif score >= MEDIUM_THRESHOLD: action = Action.WARN else: action = Action.NONE return DetectionResult(confidence=score, action=action, matched_signals=matched) def sanitize_output(value: str) -> str: """Sanitize a value for safe use in GitHub Actions outputs. Prevents: - Newline injection (could add fake output variables) - Carriage return injection - Null byte injection """ # Remove characters that could break GITHUB_OUTPUT format or cause injection return value.replace("\n", " ").replace("\r", " ").replace("\0", "") def set_github_output(name: str, value: str) -> None: """Set a GitHub Actions output variable safely.""" # Sanitize both name and value to prevent injection attacks safe_name = sanitize_output(name) safe_value = sanitize_output(value) github_output = os.environ.get("GITHUB_OUTPUT") if github_output: with open(github_output, "a") as f: f.write(f"{safe_name}={safe_value}\n") else: # For local testing, just print print(f"::set-output name={safe_name}::{safe_value}") def main() -> None: """Entry point for GitHub Actions.""" title = os.environ.get("ISSUE_TITLE", "") body = os.environ.get("ISSUE_BODY", "") result = calculate_confidence(title, body) # Output results for GitHub Actions set_github_output("action", result.action.value) set_github_output("confidence", f"{result.confidence:.0%}") set_github_output("matched_signals", ", ".join(result.matched_signals)) # Also print for logging print(f"Confidence: {result.confidence:.2%}") print(f"Action: {result.action.value}") print(f"Matched signals: {result.matched_signals}") if __name__ == "__main__": main() ================================================ FILE: scripts/resources/download_resources.py ================================================ """ Download resources from the Awesome Claude Code repository CSV file. This script downloads all active resources (or filtered subset) from GitHub repositories listed in the resource-metadata.csv file. It respects rate limiting and organizes downloads by category. Resources are saved to two locations: - Archive directory: All resources regardless of license (.myob/downloads/) - Hosted directory: Only open-source licensed resources (resources/) Note: Authentication is optional but recommended to avoid rate limiting: - Unauthenticated: 60 requests/hour - Authenticated: 5,000 requests/hour export GITHUB_TOKEN=your_github_token Usage: python download_resources.py [options] Options: --category CATEGORY Filter by specific category --license LICENSE Filter by license type --max-downloads N Limit number of downloads (for testing) --output-dir DIR Custom archive directory (default: .myob/downloads) --hosted-dir DIR Custom hosted directory (default: resources) """ import argparse import csv import os import random import re import time from datetime import datetime from pathlib import Path from typing import Any import requests import yaml # type: ignore[import-untyped] from dotenv import load_dotenv from scripts.utils.github_utils import parse_github_resource_url from scripts.utils.repo_root import find_repo_root # Load environment variables from .myob/.env load_dotenv() # Constants USER_AGENT = "awesome-claude-code Downloader/1.0" REPO_ROOT = find_repo_root(Path(__file__)) CSV_FILE = REPO_ROOT / "THE_RESOURCES_TABLE.csv" DEFAULT_OUTPUT_DIR = ".myob/downloads" HOSTED_OUTPUT_DIR = "resources" # Setup headers with optional GitHub token HEADERS = { "User-Agent": USER_AGENT, "Accept": "application/vnd.github.v3.raw", "X-GitHub-Api-Version": "2022-11-28", } github_token = os.environ.get("GITHUB_TOKEN") if github_token: # Use Bearer token format as per GitHub API documentation HEADERS["Authorization"] = f"Bearer {github_token}" print("Using authenticated requests (5,000/hour limit)") else: print("Using unauthenticated requests (60/hour limit)") # Open source licenses that allow hosting OPEN_SOURCE_LICENSES = { "MIT", "MIT+CC", "Apache-2.0", "BSD-2-Clause", "BSD-3-Clause", "GPL-2.0", "GPL-3.0", "LGPL-2.1", "LGPL-3.0", "MPL-2.0", "ISC", "0BSD", "Unlicense", "CC0-1.0", "CC-BY-4.0", "CC-BY-SA-4.0", "AGPL-3.0", "EPL-2.0", "BSL-1.0", } # Category name mapping - removed to use sanitized names for both directories # Keeping the mapping dict empty for now in case we need it later _CATEGORY_MAPPING: dict[str, str] = {} def sanitize_filename(name: str) -> str: """Sanitize a string to be safe for use as a filename.""" # Replace spaces with hyphens and remove/replace problematic characters # Added commas and other special chars that could cause issues name = re.sub(r'[<>:"/\\|?*,;]', "", name) name = re.sub(r"\s+", "-", name) name = name.strip("-.") return name[:255] # Max filename length def download_github_file( url_info: dict[str, str], output_path: str, retry_count: int = 0, max_retries: int = 3 ) -> bool: """ Download a file from GitHub using the API. Returns True if successful, False otherwise. """ response: requests.Response | None = None try: if url_info["type"] == "file": # Download single file api_url = ( f"https://api.github.com/repos/{url_info['owner']}/" f"{url_info['repo']}/contents/{url_info['path']}?ref={url_info['branch']}" ) response = requests.get(api_url, headers=HEADERS, timeout=30) # Log response details if response.status_code != 200: print(f" API Response: {response.status_code}") print( " Headers: X-RateLimit-Remaining" f"={response.headers.get('X-RateLimit-Remaining', 'N/A')}" ) print(f" Response: {response.text[:300]}...") if response.status_code == 200: # Create directory if needed os.makedirs(os.path.dirname(output_path), exist_ok=True) # Write file content with open(output_path, "wb") as f: f.write(response.content) return True else: print(f" Failed to get file content - Status: {response.status_code}") elif url_info["type"] == "dir": # List directory contents api_url = ( f"https://api.github.com/repos/{url_info['owner']}/{url_info['repo']}/contents/" f"{url_info['path']}?ref={url_info['branch']}" ) # Update headers to use proper Accept header for directory listing dir_headers = HEADERS.copy() dir_headers["Accept"] = "application/vnd.github+json" response = requests.get(api_url, headers=dir_headers, timeout=30) # Log response details if response.status_code != 200: print(f" API Response: {response.status_code}") print( f" Headers: X-RateLimit-Remaining=" f"{response.headers.get('X-RateLimit-Remaining', 'N/A')}" ) print(f" Response: {response.text[:300]}...") if response.status_code == 200: # Create directory os.makedirs(output_path, exist_ok=True) # Download each file in the directory items = response.json() for item in items: if item["type"] == "file": file_path = os.path.join(output_path, item["name"]) # Download the file content file_response = requests.get( item["download_url"], headers=HEADERS, timeout=30 ) if file_response.status_code != 200: print( f" File download failed: {item['name']} - " f"Status: {file_response.status_code}" ) if file_response.status_code == 200: with open(file_path, "wb") as f: f.write(file_response.content) return True elif url_info["type"] == "gist": # Download gist api_url = f"https://api.github.com/gists/{url_info['gist_id']}" # Update headers to use proper Accept header for gist API gist_headers = HEADERS.copy() gist_headers["Accept"] = "application/vnd.github+json" response = requests.get(api_url, headers=gist_headers, timeout=30) # Log response details if response.status_code != 200: print(f" API Response: {response.status_code}") print( f" Headers: X-RateLimit-Remaining=" f"{response.headers.get('X-RateLimit-Remaining', 'N/A')}" ) print(f" Response: {response.text[:300]}...") if response.status_code == 200: gist_data = response.json() # Create directory for gist os.makedirs(output_path, exist_ok=True) # Download each file in the gist for filename, file_info in gist_data["files"].items(): file_path = os.path.join(output_path, filename) with open(file_path, "w", encoding="utf-8") as f: f.write(file_info["content"]) return True # Handle rate limiting if response and response.status_code == 429: reset_time = response.headers.get("X-RateLimit-Reset") if reset_time: reset_datetime = datetime.fromtimestamp(int(reset_time)) print( f" Rate limit will reset at: {reset_datetime.strftime('%Y-%m-%d %H:%M:%S')}" ) raise requests.exceptions.HTTPError("Rate limited") return False except Exception as e: if retry_count < max_retries: wait_time = (2**retry_count) + random.uniform(1, 2) print(f" Retry in {wait_time:.1f}s... (Error: {str(e)})") time.sleep(wait_time) return download_github_file(url_info, output_path, retry_count + 1, max_retries) print(f" Failed after {max_retries} retries: {str(e)}") return False def load_overrides() -> dict[str, Any]: """Load resource overrides from template directory.""" template_dir = REPO_ROOT / "templates" override_path = os.path.join(template_dir, "resource-overrides.yaml") if not os.path.exists(override_path): return {} with open(override_path, encoding="utf-8") as f: data = yaml.safe_load(f) return data.get("overrides", {}) def apply_overrides(row: dict[str, str], overrides: dict[str, Any]) -> dict[str, str]: """Apply overrides to a resource row. Override values are applied for resource downloading. Any field set in the override configuration is automatically locked by validation scripts. """ resource_id = row.get("ID", "") if not resource_id or resource_id not in overrides: return row override_config = overrides[resource_id] # Apply overrides (excluding control/metadata fields and legacy locked flags) for field, value in override_config.items(): # Skip special control/metadata fields if field in ["skip_validation", "notes"]: continue # Skip any legacy *_locked flags (no longer needed) if field.endswith("_locked"): continue # Apply override values if field == "license": row["License"] = value elif field == "active": row["Active"] = value elif field == "description": row["Description"] = value return row def process_resources( category_filter: str | None = None, license_filter: str | None = None, max_downloads: int | None = None, output_dir: str = DEFAULT_OUTPUT_DIR, hosted_dir: str = HOSTED_OUTPUT_DIR, ) -> None: """ Process and download resources from the CSV file. """ start_time = datetime.now() print(f"Starting download at: {start_time.strftime('%Y-%m-%d %H:%M:%S')}") print(f"Archive directory (all resources): {output_dir}") print(f"Hosted directory (open-source only): {hosted_dir}") # Check rate limit status try: rate_check = requests.get("https://api.github.com/rate_limit", headers=HEADERS, timeout=10) if rate_check.status_code == 200: rate_data = rate_check.json() core_limit = rate_data.get("rate", {}) print("\nGitHub API Rate Limit Status:") print( f" Remaining: {core_limit.get('remaining', 'N/A')}/" f"{core_limit.get('limit', 'N/A')}" ) if core_limit.get("reset"): reset_time = datetime.fromtimestamp(core_limit["reset"]) print(f" Resets at: {reset_time.strftime('%Y-%m-%d %H:%M:%S')}") except Exception as e: print(f"Could not check rate limit: {e}") # Load overrides overrides = load_overrides() if overrides: print(f"\nLoaded {len(overrides)} resource overrides") # Track statistics total_resources = 0 downloaded = 0 skipped = 0 failed = 0 # Read CSV with open("./THE_RESOURCES_TABLE.csv", newline="", encoding="utf-8") as file: reader = csv.DictReader(file) for row in reader: # Apply overrides to the row row = apply_overrides(row, overrides) # Check if we've reached the download limit if max_downloads and downloaded >= max_downloads: print(f"\nReached download limit ({max_downloads}). Stopping.") break # Skip inactive resources if row["Active"].upper() != "TRUE": continue total_resources += 1 # Apply filters if category_filter and row["Category"] != category_filter: continue if license_filter and row.get("License", "") != license_filter: continue # Get the URL (prefer primary link) url = row["Primary Link"].strip() or row["Secondary Link"].strip() if not url: continue display_name = row["Display Name"] original_category = row["Category"] category = sanitize_filename(original_category.lower().replace(" & ", "-")) # Use same sanitized category name for both directories resource_license = row.get("License", "NOT_FOUND").strip() print(f"\n[{downloaded + 1}] Processing: {display_name}") print(f" URL: {url}") print(f" Category: {original_category} -> '{category}'") # Parse GitHub URL url_info = parse_github_resource_url(url) if not url_info: print(" Skipped: Not a GitHub URL") skipped += 1 continue # Determine output paths safe_name = sanitize_filename(display_name) print(f" Sanitized name: '{display_name}' -> '{safe_name}'") # Primary path for archive (all resources) if url_info["type"] == "gist": resource_path = os.path.join(output_dir, category, f"{safe_name}-gist") hosted_path = ( os.path.join(hosted_dir, category, safe_name) if resource_license in OPEN_SOURCE_LICENSES else None ) elif url_info["type"] == "repo": resource_path = os.path.join(output_dir, category, safe_name) print(" Skipped: Full repository downloads not implemented") skipped += 1 continue elif url_info["type"] == "dir": resource_path = os.path.join(output_dir, category, safe_name) hosted_path = ( os.path.join(hosted_dir, category, safe_name) if resource_license in OPEN_SOURCE_LICENSES else None ) else: # file # Extract filename from path filename = os.path.basename(url_info["path"]) resource_path = os.path.join(output_dir, category, safe_name, filename) hosted_path = ( os.path.join(hosted_dir, category, safe_name, filename) if resource_license in OPEN_SOURCE_LICENSES else None ) # Download the resource to archive print(f" Downloading to archive: {resource_path}") print(f" License: {resource_license}") if hosted_path: print(f" Will copy to hosted: {hosted_path}") download_success = download_github_file(url_info, resource_path) if download_success: print(" ✅ Downloaded successfully") downloaded += 1 # If open-source licensed, also copy to hosted directory if hosted_path and resource_license in OPEN_SOURCE_LICENSES: print(f" 📦 Copying to hosted directory: {hosted_path}") try: import shutil os.makedirs(os.path.dirname(hosted_path), exist_ok=True) if os.path.isdir(resource_path): print( f" Source is directory with " f"{len(os.listdir(resource_path))} items" ) shutil.copytree(resource_path, hosted_path, dirs_exist_ok=True) else: print(" Source is file") shutil.copy2(resource_path, hosted_path) print(" ✅ Copied to hosted directory") except Exception as e: print(f" ⚠️ Failed to copy to hosted directory: {e}") print(f" Error type: {type(e).__name__}") import traceback print(f" Traceback: {traceback.format_exc()}") else: print(" ❌ Download failed") failed += 1 # Rate limiting delay time.sleep(random.uniform(1, 2)) # Summary end_time = datetime.now() duration = end_time - start_time print(f"\n{'=' * 60}") print(f"Download completed at: {end_time.strftime('%Y-%m-%d %H:%M:%S')}") print(f"Total execution time: {duration}") print("\nSummary:") print(f" Total resources found: {total_resources}") print(f" Downloaded: {downloaded}") print(f" Skipped: {skipped}") print(f" Failed: {failed}") print(f"{'=' * 60}") def main() -> None: """Main entry point.""" parser = argparse.ArgumentParser(description="Download resources from awesome-claude-code CSV") parser.add_argument("--category", help="Filter by specific category") parser.add_argument("--license", help="Filter by license type") parser.add_argument("--max-downloads", type=int, help="Limit number of downloads") parser.add_argument("--output-dir", default=DEFAULT_OUTPUT_DIR, help="Archive output directory") parser.add_argument( "--hosted-dir", default=HOSTED_OUTPUT_DIR, help="Hosted output directory for open-source resources", ) args = parser.parse_args() # Create output directories if needed Path(args.output_dir).mkdir(parents=True, exist_ok=True) Path(args.hosted_dir).mkdir(parents=True, exist_ok=True) # Process resources process_resources( category_filter=args.category, license_filter=args.license, max_downloads=args.max_downloads, output_dir=args.output_dir, hosted_dir=args.hosted_dir, ) if __name__ == "__main__": main() ================================================ FILE: scripts/resources/parse_issue_form.py ================================================ #!/usr/bin/env python3 """ Parse GitHub Issue form data from resource submissions. Validates the data and returns structured JSON. """ import json import os import re import sys from pathlib import Path from scripts.utils.repo_root import find_repo_root REPO_ROOT = find_repo_root(Path(__file__)) sys.path.insert(0, str(REPO_ROOT)) from scripts.categories.category_utils import category_manager from scripts.validation.validate_single_resource import validate_single_resource def parse_issue_body(issue_body: str) -> dict[str, str]: """ Parse GitHub issue form body into structured data. GitHub issue forms are rendered as markdown with specific patterns: - Headers (###) indicate field labels - Values follow the headers - Checkboxes are rendered as - [x] or - [ ] """ data = {} # Split into sections by ### headers sections = re.split(r"###\s+", issue_body) for section in sections: if not section.strip(): continue lines = section.strip().split("\n") if not lines: continue # First line is the field label label = lines[0].strip() # Rest is the value (skip empty lines) value_lines = [ line for line in lines[1:] if line.strip() and not line.strip().startswith("_No response_") ] value = "\n".join(value_lines).strip() # Map form labels to data fields if "Display Name" in label: data["display_name"] = value data["_original_display_name"] = value # Track original for warning elif "Category" in label and "Sub-Category" not in label: data["category"] = value # If this is a slash command, we'll validate/fix the display name later elif "Sub-Category" in label: # Set to "General" as default if empty or "None / Not Applicable" if not value or "None" in value or "Not Applicable" in value: data["subcategory"] = "General" else: # Strip the category prefix if present # (e.g., "Slash-Commands: " from "Slash-Commands: Context Loading & Priming") if ":" in value: data["subcategory"] = value.split(":", 1)[1].strip() else: data["subcategory"] = value elif "Primary Link" in label: data["primary_link"] = value elif "Secondary Link" in label: data["secondary_link"] = value elif "Author Name" in label: data["author_name"] = value elif "Author Link" in label: data["author_link"] = value elif "License" in label and "Other License" not in label: data["license"] = value elif "Other License" in label: if value: data["license"] = value # Override with custom license elif "Description" in label: data["description"] = value # Fix slash command display names if data.get("category") == "Slash-Commands" and data.get("display_name"): display_name = data["display_name"] # Ensure it starts with a slash if not display_name.startswith("/"): display_name = "/" + display_name # Ensure it's a single string (no spaces, only hyphens, underscores, colons allowed) # Replace spaces with hyphens display_name = display_name.replace(" ", "-") # Remove any characters that aren't alphanumeric, slash, hyphen, underscore, or colon display_name = re.sub(r"[^a-zA-Z0-9/_:-]", "", display_name) # Ensure it's lowercase (convention for slash commands) display_name = display_name.lower() # Ensure only one leading slash - remove any extra slashes at the beginning while display_name.startswith("//"): display_name = display_name[1:] data["display_name"] = display_name return data def validate_parsed_data(data: dict[str, str]) -> tuple[bool, list[str], list[str]]: """ Validate the parsed data meets all requirements. Returns (is_valid, errors, warnings) """ errors = [] warnings = [] # Check required fields required_fields = [ "display_name", "category", "primary_link", "author_name", "author_link", "description", ] for field in required_fields: if not data.get(field, "").strip(): errors.append(f"Required field '{field}' is missing or empty") # Validate category valid_categories = category_manager.get_all_categories() if data.get("category") not in valid_categories: errors.append( f"Invalid category: {data.get('category')}. " f"Must be one of: {', '.join(valid_categories)}" ) # Sub-category validation is no longer needed since we strip the prefix # The form already ensures subcategories match their parent categories # Check if slash command display name was modified if ( data.get("category") == "Slash-Commands" and "_original_display_name" in data and data["display_name"] != data["_original_display_name"] ): warnings.append( f"Display name was automatically corrected from " f"'{data['_original_display_name']}' to '{data['display_name']}'. " "Slash commands must start with '/' and contain no spaces." ) # Additional validation for slash commands - check for multiple slashes if data.get("category") == "Slash-Commands" and data.get("display_name"): display_name = data["display_name"] # Check if there are multiple slashes anywhere in the command slash_count = display_name.count("/") if slash_count > 1: errors.append( f"Slash command '{display_name}' contains multiple slashes. " "Slash commands must have exactly one slash at the beginning." ) # Validate URLs url_fields = ["primary_link", "secondary_link", "author_link"] for field in url_fields: value = data.get(field, "").strip() if value and field != "secondary_link": # secondary is optional if not value.startswith("https://"): errors.append(f"{field} must start with https://") elif " " in value: errors.append(f"{field} contains spaces") # Validate license if data.get("license") == "No License / Not Specified": data["license"] = "NOT_FOUND" warnings.append("No license specified - consider adding one for open source projects") # Check description length description = data.get("description", "") if len(description) > 500: errors.append("Description is too long (max 500 characters)") elif len(description) < 10: errors.append("Description is too short (min 10 characters)") # Check for common issues if data.get("display_name", "").lower() in ["test", "testing", "example"]: warnings.append("Display name appears to be a test entry") return len(errors) == 0, errors, warnings def check_for_duplicates(data: dict[str, str]) -> list[str]: """Check if resource already exists in the CSV.""" warnings: list[str] = [] csv_path = os.path.join(REPO_ROOT, "THE_RESOURCES_TABLE.csv") if not os.path.exists(csv_path): return warnings import csv primary_link = data.get("primary_link", "").lower() display_name = data.get("display_name", "").lower() with open(csv_path, encoding="utf-8") as f: reader = csv.DictReader(f) for row in reader: # Check for duplicate URL if row.get("Primary Link", "").lower() == primary_link: warnings.append( f"A resource with this primary link already exists: {row.get('Display Name')}" ) # Check for similar names elif row.get("Display Name", "").lower() == display_name: warnings.append( f"A resource with the same name already exists: {row.get('Display Name')}" ) return warnings def main(): """Main entry point for the script.""" # Get issue body from environment variable issue_body = os.environ.get("ISSUE_BODY", "") if not issue_body: print(json.dumps({"valid": False, "errors": ["No issue body provided"], "data": {}})) return 1 # Parse the issue body parsed_data = parse_issue_body(issue_body) # Check if --validate flag is passed validate_mode = "--validate" in sys.argv if validate_mode: # Full validation mode is_valid, errors, warnings = validate_parsed_data(parsed_data) # Check for duplicates duplicate_warnings = check_for_duplicates(parsed_data) warnings.extend(duplicate_warnings) # If basic validation passed, do URL validation if is_valid and parsed_data.get("primary_link"): url_valid, enriched_data, url_errors = validate_single_resource( primary_link=parsed_data.get("primary_link", ""), secondary_link=parsed_data.get("secondary_link", ""), display_name=parsed_data.get("display_name", ""), category=parsed_data.get("category", ""), license=parsed_data.get("license", "NOT_FOUND"), subcategory=parsed_data.get("subcategory", ""), author_name=parsed_data.get("author_name", ""), author_link=parsed_data.get("author_link", ""), description=parsed_data.get("description", ""), ) if not url_valid: is_valid = False errors.extend(url_errors) else: # Update with enriched data (license from GitHub, etc.) parsed_data.update(enriched_data) # Remove temporary tracking field if "_original_display_name" in parsed_data: del parsed_data["_original_display_name"] result = {"valid": is_valid, "errors": errors, "warnings": warnings, "data": parsed_data} else: # Simple parse mode - just return the parsed data # Remove temporary tracking field if "_original_display_name" in parsed_data: del parsed_data["_original_display_name"] result = parsed_data # Print compact JSON (no newlines) to make it easier to extract print(json.dumps(result)) return 0 if __name__ == "__main__": sys.exit(main()) ================================================ FILE: scripts/resources/resource_utils.py ================================================ #!/usr/bin/env python3 """Helpers for resource CSV updates and PR content generation.""" from __future__ import annotations import csv import os from datetime import datetime from pathlib import Path from scripts.utils.repo_root import find_repo_root REPO_ROOT = find_repo_root(Path(__file__)) __all__ = ["append_to_csv", "generate_pr_content"] def append_to_csv(data: dict[str, str]) -> bool: """Append the new resource to THE_RESOURCES_TABLE.csv using header order.""" csv_path = os.path.join(REPO_ROOT, "THE_RESOURCES_TABLE.csv") try: with open(csv_path, encoding="utf-8", newline="") as f: reader = csv.reader(f) headers = next(reader, None) except Exception as e: print(f"Error reading CSV header: {e}") return False if not headers: print("Error reading CSV header: missing header row") return False now = datetime.now().strftime("%Y-%m-%d:%H-%M-%S") value_map = { "ID": data.get("id", ""), "Display Name": data.get("display_name", ""), "Category": data.get("category", ""), "Sub-Category": data.get("subcategory", ""), "Primary Link": data.get("primary_link", ""), "Secondary Link": data.get("secondary_link", ""), "Author Name": data.get("author_name", ""), "Author Link": data.get("author_link", ""), "Active": data.get("active", "TRUE"), "Date Added": data.get("date_added", now), "Last Modified": data.get("last_modified", ""), "Last Checked": data.get("last_checked", now), "License": data.get("license", ""), "Description": data.get("description", ""), "Removed From Origin": data.get("removed_from_origin", "FALSE"), "Stale": data.get("stale", "FALSE"), "Repo Created": data.get("repo_created", ""), "Latest Release": data.get("latest_release", ""), "Release Version": data.get("release_version", ""), "Release Source": data.get("release_source", ""), } missing_headers = [key for key in value_map if key not in headers] if missing_headers: print(f"Error reading CSV header: missing columns {', '.join(missing_headers)}") return False row = {header: value_map.get(header, "") for header in headers} try: with open(csv_path, "a", newline="", encoding="utf-8") as f: writer = csv.DictWriter(f, fieldnames=headers) writer.writerow(row) return True except Exception as e: print(f"Error writing to CSV: {e}") return False def generate_pr_content(data: dict[str, str]) -> str: """Generate PR template content.""" is_github = "github.com" in data["primary_link"] content = f"""### Resource Information - **Display Name**: {data["display_name"]} - **Category**: {data["category"]} - **Sub-Category**: {data["subcategory"] if data["subcategory"] else "N/A"} - **Primary Link**: {data["primary_link"]} - **Author Name**: {data["author_name"]} - **Author Link**: {data["author_link"]} - **License**: {data["license"] if data["license"] else "Not specified"} ### Description {data["description"]} ### Automated Notification - [{"x" if is_github else " "}] This is a GitHub-hosted resource and will receive an automatic notification issue when merged""" return content ================================================ FILE: scripts/resources/sort_resources.py ================================================ #!/usr/bin/env python3 """ Sort THE_RESOURCES_TABLE.csv by category, sub-category, and display name. This utility ensures resources are properly ordered for consistent presentation in the generated README and other outputs. """ import csv import sys from pathlib import Path from scripts.utils.repo_root import find_repo_root REPO_ROOT = find_repo_root(Path(__file__)) sys.path.insert(0, str(REPO_ROOT)) def sort_resources(csv_path: Path) -> None: """Sort resources in the CSV file by category, sub-category, and display name.""" # Load category order from category_utils from scripts.categories.category_utils import category_manager category_order = [] categories = [] try: categories = category_manager.get_categories_for_readme() category_order = [cat["name"] for cat in categories] except Exception as e: print(f"Warning: Could not load category order from category_utils: {e}") print("Using alphabetical sorting instead.") # Create a mapping for sort order category_sort_map = {cat: idx for idx, cat in enumerate(category_order)} # Create subcategory order mappings for each category subcategory_sort_maps = {} for category in categories: if "subcategories" in category: subcat_order = [sub["name"] for sub in category["subcategories"]] subcategory_sort_maps[category["name"]] = { name: idx for idx, name in enumerate(subcat_order) } # Read the CSV data with open(csv_path, encoding="utf-8") as f: reader = csv.DictReader(f) headers = reader.fieldnames rows = list(reader) # Sort the rows # First by Category (using custom order), then by Sub-Category # (using defined order from YAML), then by Display Name def subcategory_sort_key(category, subcat): """Sort subcategories by their defined order in categories.yaml""" if not subcat: return 999 # Empty sorts last # Get the sort map for this category if category in subcategory_sort_maps: subcat_map = subcategory_sort_maps[category] return subcat_map.get(subcat, 998) # Unknown subcategories sort second-to-last # If no sort map, fall back to alphabetical return 997 # Categories without defined subcategory order sorted_rows = sorted( rows, key=lambda row: ( category_sort_map.get(row.get("Category", ""), 999), # Unknown categories sort last subcategory_sort_key(row.get("Category", ""), row.get("Sub-Category", "")), row.get("Display Name", "").lower(), ), ) # Write the sorted data back with open(csv_path, "w", encoding="utf-8", newline="") as f: if headers: writer = csv.DictWriter(f, fieldnames=headers) writer.writeheader() writer.writerows(sorted_rows) print(f"✓ Sorted {len(sorted_rows)} resources in {csv_path}") # Print summary of categories category_counts: dict[str, dict[str, int]] = {} for row in sorted_rows: category_name = row.get("Category", "Unknown") subcat = row.get("Sub-Category", "") or "None" if category_name not in category_counts: category_counts[category_name] = {} if subcat not in category_counts[category_name]: category_counts[category_name][subcat] = 0 category_counts[category_name][subcat] += 1 print("\nCategory Summary:") # Sort categories using the same custom order sorted_categories = sorted( category_counts.keys(), key=lambda cat: category_sort_map.get(cat, 999) ) for category_name in sorted_categories: print(f" {category_name}:") # Sort subcategories using the same order as in the CSV sorting sorted_subcats = sorted( category_counts[category_name].keys(), key=lambda s: subcategory_sort_key(category_name, s if s != "None" else ""), ) for subcat in sorted_subcats: count = category_counts[category_name][subcat] if subcat == "None": print(f" (no sub-category): {count} items") else: print(f" {subcat}: {count} items") def main(): """Main entry point.""" # Default to THE_RESOURCES_TABLE.csv in parent directory csv_path = REPO_ROOT / "THE_RESOURCES_TABLE.csv" if len(sys.argv) > 1: csv_path = Path(sys.argv[1]) if not csv_path.exists(): print(f"Error: CSV file not found at {csv_path}", file=sys.stderr) sys.exit(1) sort_resources(csv_path) if __name__ == "__main__": main() ================================================ FILE: scripts/testing/__init__.py ================================================ """Testing helpers package.""" ================================================ FILE: scripts/testing/test_regenerate_cycle.py ================================================ #!/usr/bin/env python3 """Integration regeneration cycle test for README outputs.""" from __future__ import annotations import contextlib import re import subprocess import sys from pathlib import Path from scripts.utils.repo_root import find_repo_root REPO_ROOT = find_repo_root(Path(__file__)) CONFIG_PATH = REPO_ROOT / "acc-config.yaml" README_PATH = REPO_ROOT / "README.md" ROOT_STYLE_RE = re.compile(r"^(?P\s*)root_style:\s*(?P\S+)\s*$", re.M) STYLE_ORDER_RE = re.compile(r"^(style_order:\s*\n)(?P(?:\s*-\s*.*\n?)+)", re.M) def run(cmd: list[str]) -> None: subprocess.run(cmd, cwd=REPO_ROOT, check=True) def git_status() -> str: result = subprocess.run( ["git", "status", "--porcelain"], cwd=REPO_ROOT, check=True, capture_output=True, text=True, ) return result.stdout.strip() def read_config_text() -> str: return CONFIG_PATH.read_text(encoding="utf-8") def write_config_text(text: str) -> None: CONFIG_PATH.write_text(text, encoding="utf-8") def set_root_style(text: str, root_style: str) -> str: if not ROOT_STYLE_RE.search(text): raise RuntimeError("root_style not found in acc-config.yaml") return ROOT_STYLE_RE.sub(rf"\groot_style: {root_style}", text, count=1) def get_style_order(text: str) -> list[str]: match = STYLE_ORDER_RE.search(text) if not match: raise RuntimeError("style_order not found in acc-config.yaml") items: list[str] = [] for line in match.group("items").splitlines(): line = line.strip() if line.startswith("-"): items.append(line[1:].strip()) if not items: raise RuntimeError("style_order is empty in acc-config.yaml") return items def set_style_order(text: str, style_order: list[str]) -> str: if not STYLE_ORDER_RE.search(text): raise RuntimeError("style_order not found in acc-config.yaml") block = "style_order:\n" + "".join(f" - {style}\n" for style in style_order) return STYLE_ORDER_RE.sub(block, text, count=1) def read_readme() -> str: return README_PATH.read_text(encoding="utf-8") def selector_order_from_content(content: str) -> list[str]: matches = re.findall(r"badge-style-([a-z0-9_-]+)\.svg", content) if not matches: raise RuntimeError("Could not determine style selector order from README.md") ordered: list[str] = [] for item in matches: if item not in ordered: ordered.append(item) return ordered def main() -> int: if git_status(): print("Error: working tree must be clean before running test-regenerate-cycle") return 1 original_text = read_config_text() try: run(["make", "test-regenerate"]) current_text = read_config_text() style_order = get_style_order(current_text) if len(style_order) < 2: raise RuntimeError("style_order must contain at least two entries") first_style = style_order[0] second_style = style_order[1] updated_text = set_root_style(current_text, first_style) write_config_text(updated_text) run(["make", "test-regenerate-allow-diff"]) first_content = read_readme() updated_text = set_root_style(updated_text, second_style) write_config_text(updated_text) run(["make", "test-regenerate-allow-diff"]) root_content = read_readme() if root_content == first_content: raise RuntimeError("README.md did not change after root_style update") new_order = style_order[1:] + style_order[:1] if len(style_order) > 1 else style_order updated_text = set_style_order(updated_text, new_order) write_config_text(updated_text) previous_content = root_content run(["make", "test-regenerate-allow-diff"]) root_content = read_readme() if root_content == previous_content: raise RuntimeError("README.md did not change after style_order update") selector_order = selector_order_from_content(root_content) if selector_order[: len(new_order)] != new_order: raise RuntimeError("Style selector order does not match updated style_order") write_config_text(original_text) run(["make", "test-regenerate", "ALLOW_DIRTY=1"]) if git_status(): raise RuntimeError("Working tree is dirty after restoring configuration") except subprocess.CalledProcessError as exc: print(f"Error: command failed: {exc}", file=sys.stderr) write_config_text(original_text) with contextlib.suppress(subprocess.CalledProcessError): run(["make", "test-regenerate", "ALLOW_DIRTY=1"]) return exc.returncode except Exception as exc: print(f"Error: {exc}", file=sys.stderr) write_config_text(original_text) with contextlib.suppress(subprocess.CalledProcessError): run(["make", "test-regenerate", "ALLOW_DIRTY=1"]) return 1 return 0 if __name__ == "__main__": raise SystemExit(main()) ================================================ FILE: scripts/testing/validate_toc_anchors.py ================================================ #!/usr/bin/env python3 """Validate TOC anchors against GitHub-rendered HTML. This utility compares the anchor links in our generated README's table of contents against the actual anchor IDs that GitHub generates when rendering the markdown. Usage: # Validate AWESOME style (default) python -m scripts.testing.validate_toc_anchors # Validate specific style python -m scripts.testing.validate_toc_anchors --style classic python -m scripts.testing.validate_toc_anchors --style extra python -m scripts.testing.validate_toc_anchors --style flat # Validate with custom paths python -m scripts.testing.validate_toc_anchors --html path/to/github.html --readme README.md # Generate new fixture (requires manual step to download HTML from GitHub) python -m scripts.testing.validate_toc_anchors --generate-expected To obtain the GitHub HTML: 1. Push your README to GitHub 2. View the rendered README page 3. Open browser dev tools (F12) 4. Find the
element containing the README content 5. Copy the inner HTML to tests/fixtures/github-html/