Apps

ReadMyRepo

Paste a GitHub link and see how the files connect, what’s risky or slow, and what to hand your AI coding assistant.

Client
Open source
Role
Design, development
Year
2026
ReadMyRepo: Paste a GitHub link and see how the files connect, what’s risky or slow, and what to hand your AI coding assistant.

The challenge

The first hour in an unfamiliar codebase goes mostly on orientation: which files matter, what depends on what, and where the problems are.

The solution

A dependency map where every file is a box, 17 automated checks explained in plain English and linked to the exact line, and a ready-made AGENTS.md for Claude Code, Cursor and Copilot.

How it was built

The technology at every layer, from the screen down to the infrastructure.

  1. Websites
    • React 19
    • Tailwind CSS 4
    • Vite
  2. Apps
    • Multi-language import analysis
    • 17 static checks
    • AGENTS.md generator
  3. Hosting & cloud
    • Cloudflare
    • GitHub API
  4. Networks & ITNot needed

Key technical decisions

  1. No backend

    The browser fetches the files straight from GitHub and analyses them locally. Nothing is uploaded or stored on a server.

  2. Honest about big projects

    Large repositories are sampled to at most 44 of the most connected files, and the report always says how much was read.

  3. Private repositories, safely

    A read-only token stays in the open tab, is sent only to api.github.com and is never stored.

What it includes

  • Dependency map showing import loops and oversized files
  • 17 security, performance and architecture checks
  • Scores out of 100, with an explanation
  • Ready-made AGENTS.md for AI assistants
  • Shareable report link and README badge

The result

Live at readmyrepo.com, free and with no sign-up. The analysis runs entirely in your browser and nothing is uploaded to a server.

Articles about this project

Have something similar in mind?

Tell me what you need and I’ll suggest the simplest way to get it done.