AI-powered GitHub Repository Health Analyzer
Built with the GitHub Copilot SDK — the same AI agent runtime that powers Copilot CLI.

Website • Quick Start • Features • How It Works • Commands • Documentation

RepoCheckAI is your repository's AI doctor that diagnoses issues and prescribes solutions. It performs comprehensive health checks across 6 critical areas — documentation, developer experience, CI/CD, testing, governance, and security — delivering a detailed diagnosis with prioritized findings (P0/P1/P2) and actionable remediation steps.

Automatically publish analysis reports to GitHub as structured issues:

export GITHUB_TOKEN=ghp_xxx          # or REPOCHECKAI_GITHUB_TOKEN, as configured
repocheck analyze owner/repo --issue
# Creates: 🔴 [RepoCheckAI] docs: Missing README
#         🟠 [RepoCheckAI] ci: No CI/CD Pipeline
#         🟡 [RepoCheckAI] dx: Code Quality Issues

Each issue includes:

• Detailed description with evidence and impact assessment
• Actionable fix instructions with code examples
• Priority labels (P0/P1/P2) and category tags
• Full analysis context for team collaboration

# Set token securely (recommended)
export GITHUB_TOKEN=ghp_your_token_here

# Or use gh CLI auth
gh auth login

# Then start interactive mode
repocheck chat
/analyze facebook/react --issue
/deep microsoft/vscode

📖 Learn how to set up GitHub tokens

Want to see RepoCheckAI create GitHub issues automatically?

# 1. Get a GitHub token (see detailed setup below)
# 2. Set it as environment variable
export GITHUB_TOKEN=ghp_your_token_here

# 3. Analyze and create issues automatically!
repocheck analyze your-username/your-repo --issue

Result: Multiple GitHub issues created with detailed analysis, impact assessment, and fix instructions! 🎉

For the --issue feature, you'll need a GitHub Personal Access Token with specific permissions:

1. Go to github.com/settings/tokens
2. Generate a new "Tokens (classic)"
3. Select these scopes:
   • repo (full repository access) OR the following granular permissions:
     • metadata — Read repository metadata
     • contents — Read repository contents
     • issues — Create and manage issues
4. Copy the token (starts with ghp_)

--issue (CLI) and Publish to GitHub Issues (Web UI) both need GitHub API credentials with issue-write permission.

export GITHUB_TOKEN=ghp_your_pat_here
repocheck analyze owner/repo --issue

npm run dev:local-ui

In the form:

1. Enable Publish to GitHub Issues
2. Optional: paste GitHub Token (overrides server env token)
3. Run analysis

If no token is provided in the field, the backend uses GITHUB_TOKEN from the server environment.

For full step-by-step setup and 401/403 troubleshooting, see docs/issue-publishing.md.

# Clone the repository
git clone https://github.com/glaucia86/repocheckai.git
cd repocheckai

# Install dependencies and build
npm install
npm run build

# Link globally
npm link

# Interactive mode
repocheck

# Direct analysis
repocheck vercel/next.js

# Deep analysis with premium model
repocheck vercel/next.js --model claude-sonnet-4 --deep

# 🚀 Auto-create GitHub issues for each problem found
repocheck vercel/next.js --issue

The repository keeps application runtime code in src/ and the public website in site/:

site/          # Static marketing/docs site deployed to GitHub Pages
src/           # Clean architecture runtime code

Implementation source is now organized by clean architecture layers in src/:

• Presentation: src/presentation/** (CLI, API, Web UI, terminal UI)
• Application: src/application/** (analysis and reporting orchestration)
• Infrastructure: src/infrastructure/** (GitHub/providers/tools adapters)
• Domain: src/domain/** (schemas, contracts, interfaces)
• Shared utilities: src/utils/**

The project has a single Web UI implementation served from src/presentation/web/public by src/presentation/web/main.ts.

npm run dev:web-ui:api
npm run dev:web-ui

Or run both services together:

npm run dev:local-ui

Current MVP capabilities:

• Create analysis jobs from web state/client modules
• Read completed markdown/JSON reports
• Stream progress seeds and cancel running jobs
• Copy and export completed reports (md and json)

repocheck
/analyze microsoft/vscode

repocheck
/model claude-sonnet-4
/deep facebook/react

repocheck
/analyze vercel/next.js
/export nextjs-report.md

repocheck
# Then use commands interactively
/analyze myorg/myrepo
/copy

📖 Full documentation: docs/index.md

Copilot SDK AI Orchestration

Octokit GitHub API

Repomix Repo Packing

TypeScript Language

Zod Validation

The codebase follows SOLID principles for maintainability:

src/
├── cli/          # Command handlers, state, parsers
├── core/agent/   # Copilot SDK session, modular prompts
├── tools/        # Individual tool files (SRP)
├── ui/display/   # Display modules (spinner, menus, etc.)
└── types/        # Zod schemas, interfaces

Key Design Decisions:

• Agentic CLI: Uses GitHub Copilot SDK for AI-powered analysis
• Modular Prompts: System prompts composed from reusable base modules
• Tool-Based Architecture: AI agent invokes specific tools for data gathering
• Streaming Output: Real-time analysis with event-driven updates
• Security First: Content sanitization prevents prompt injection

📖 See Architecture Documentation for technical details.

If you find RepoCheckAI useful:

MIT © Glaucia Lemos

Glaucia Lemos
_{A.I Developer at Zup Innovation/Itaú}



🐦 Twitter • 💼 LinkedIn • 🐙 GitHub

Made with 💚 using the GitHub Copilot SDK

⬆️ Back to Top