HN Showcase
Back to browse
GitHub Repository

Code visualization for non-programmers. A docent for your codebase.

9 starsPython

Codedocent – Code visualization for non-programmers

by clanker-lover·Feb 20, 2026·3 points·0 comments
Visit ProjectView on HN

AI Analysis

●●●BangerBig BrainSolve My ProblemWizardry

Visual code navigator for non-programmers—niche but solves real manager/designer onboarding pain.

Strengths
  • •Genuinely novel user persona: non-programmers understanding code structure
  • •Architecture/dependency graph at multiple zoom levels is smart design
  • •Local Ollama + cloud flexibility shows thoughtful choice architecture
Weaknesses
  • •v1.0.2 is early; unproven on large industrial codebases
  • •Adoption depends on whether non-coders actually adopt a CLI tool
Target Audience

Managers, PMs, non-technical stakeholders reviewing codebases; also onboarding developers

Similar To

GitHub Copilot explain (text-only) · Source{d} Engine · Merico

Post Description

I'm a hardware engineer who reads schematics, not source code. I kept needing to understand codebases for projects I was managing but couldn't read the syntax. So I built a tool that turns any codebase into an interactive visual map with plain English explanations.

Point it at a folder, get nested colored blocks showing the structure (directories → files → classes → functions). Click to drill down. AI generates summaries written for humans, not programmers. Architecture mode shows a dependency graph so you can see how modules connect.

Built the whole thing in ~30 hours using a multi-node AI workflow: Claude for planning/decisions, Claude Code for implementation, five other models for adversarial security review (42 fixes across 6 rounds). I made every design decision; AI wrote every line of code.

Cloud AI (OpenAI/Groq) or local AI (Ollama) — your choice. pip install codedocent and run the setup wizard.

MIT licensed. Would love feedback from people who actually write code — does this help when onboarding onto unfamiliar codebases?

Similar Projects