queensac mascot - friendly orange crab character
GitHub Actions Integration

Stop ignoring broken links. Start fixing them.

queensac automatically detects broken links in your GitHub repository, finds valid alternatives, and creates pull requests. No more manual checking, no more ignored CI failures.

Free for open source • Apache-2.0 License

The problem with traditional link checkers

They only tell you what's broken. They don't fix anything.

Traditional Approach

  • • Link checker finds 404 errors
  • • CI fails but gets ignored
  • • Documentation stays broken
  • • Users encounter dead links
  • • Manual fixes required

queensac Approach

  • • Detects broken links automatically
  • • Finds valid alternatives
  • • Creates pull request with fixes
  • • Review and merge when ready
  • • Documentation stays healthy

How it works

🔍

1. Extract & Validate

Scans your repository for all links and checks each one for errors like 404 Not Found or timeouts.

🔧

2. Find Alternatives

When broken links are found, queensac searches for valid alternative URLs to replace them with.

3. Create PR

Automatically creates a pull request with the corrected links ready for your review and merge.

Built for modern development

Seamlessly integrates with your existing GitHub workflow

GitHub Actions Integration

Works seamlessly with your CI/CD pipeline. Add a few lines to your workflow and you're done.

Automated Fixes

Unlike other tools that just report issues, queensac actually fixes broken links for you.

Smart Link Discovery

Intelligently finds valid alternative URLs to replace broken links when possible.

Pull Request Creation

Automatically creates well-formatted pull requests with all the fixes ready to review.

Get started in minutes

Two simple steps to improve your documentation quality

1

Install the GitHub App

Install queensac[bot] on your GitHub repository from the GitHub Marketplace.

Install queensac[bot]
2

Add to your workflow

Add queensac to your GitHub Actions workflow with a simple configuration.

- name: 👑 Run queensac
  uses: reddevilmidzy/queensac@v1
  with:
    github_app_id: ${{ secrets.QUEENSAC_APP_ID }}
    github_app_private_key: ${{ secrets.QUEENSAC_APP_PRIVATE_KEY }}
    repo: https://github.com/${{ github.repository }}

Ready to fix your documentation?

Join open source projects already using queensac to maintain high-quality documentation.

Built with v0