Codebase Radar — Instant Repo Intelligence

You understand any codebase immediately by running the radar script first. This is always your first move when working with an existing project.

The Golden Rule

Never start reading files one by one. Run the radar first.

The analyze script gives you tech stack, architecture map, hotspots, entry points, and dependencies in under a second. That context makes every subsequent file read 10x more meaningful.

Workflow

Step 1 — Run the analyze script

python skills/codebase-radar/scripts/analyze.py <path> [--depth 6]

# Examples
python analyze.py /path/to/project
python analyze.py . --depth 4
python analyze.py ~/projects/my-app --json

Step 2 — Parse the JSON output

Key fields to extract:

Step 3 — Targeted file reading

Now that you have the map, read only the relevant files:

• Start with entry points
• Read hotspots that are relevant to the task
• Navigate architecture dirs by their role

Step 4 — Begin the task

Armed with full context, complete the user's request efficiently.

Output Reference

{
  "project": "my-app",
  "summary": {
    "total_files": 142,
    "total_lines": 18420,
    "primary_language": "TypeScript",
    "frameworks": ["Next.js", "Tailwind", "Prisma", "PostgreSQL"]
  },
  "languages": {
    "TypeScript": { "files": 87, "lines": 12400 },
    "CSS": { "files": 12, "lines": 980 }
  },
  "architecture": {
    "app": { "files": 34, "role": "app/routes" },
    "components": { "files": 28, "role": "UI components" },
    "lib": { "files": 15, "role": "shared utilities" }
  },
  "entry_points": ["src/app/layout.tsx", "src/app/page.tsx"],
  "hotspots": [
    { "file": "src/lib/auth.ts", "lines": 480, "functions": 22 }
  ],
  "dependencies": {
    "package.json": { "prod": ["next", "react", "prisma"] }
  }
}

What the script detects

Frameworks (signals-based detection): Next.js, Astro, React, Vue, Svelte, Flutter, FastAPI, Django, Go Chi/Gin/Fiber, Axum, Tokio, Prisma, Drizzle, PostgreSQL, MongoDB, Redis, Docker, GitHub Actions, Tailwind, shadcn/ui, and more.

Languages: Python, Go, Rust, TypeScript, JavaScript, Dart, Swift, Kotlin, Java, C++, C, C#, Ruby, PHP, Zig, Elixir, SQL, GraphQL, Protobuf

Hotspots: Files over 200 lines with many function definitions — these are the complex areas that need most attention during refactoring or debugging.

Script location

skills/codebase-radar/scripts/analyze.py

Requires Python 3.10+ stdlib only. Runs in < 1 second on most codebases.