DEV Community

praniket01
praniket01

Posted on Originally published at youtube.com

# πŸ¦₯ My Codebase Has 847 Files. My Brain Has 2 Remaining Tabs.

Meet CodeSloth β€” because Ctrl + Click is not a software architecture strategy.

Ever opened an open-source repo to make a tiny contribution and ended up questioning your career choices? Yeah, same.

πŸ’€ Problem Statement

Unfamiliar codebases are a maze of files, dependencies, APIs, and databases. Understanding how everything connects can take longer than the actual contribution.

🩹 Current Workaround

Open 37 tabs, chase imports, search for API routes, and pray the original developer left a comment. Spoiler: they didn't.

πŸ’‘ Proposed Solution β€” CodeSloth

A local-first codebase explorer that turns GitHub repositories into:

  • 🌳 Project Tree β€” Navigate the codebase without archaeological equipment.
  • πŸ•ΈοΈ Dependency Graph β€” See which files depend on what.
  • πŸ—οΈ Architecture Flow β€” Visualize frontend β†’ APIs β†’ backend β†’ databases.
  • πŸ€– Ask CodeSloth β€” Get AI-assisted code explanations using local Ollama models.

**πŸ’» Source Code - https://github.com/praniket01/Codesloth

Demo
🎬 Live Demo: https://www.youtube.com/watch?v=cesLtzG88_s

Live Website: https://frontend-kappa-two-86.vercel.app/

βš™οΈ Working Model

Paste a public GitHub repository URL β†’ CodeSloth indexes the codebase β†’ explore its structure and connections β†’ ask questions about the code using local AI.

Stack: Next.js Β· React Flow Β· FastAPI Β· SQLite Β· Ollama

🎯 The Mission

Make open-source contributions less intimidating by reducing the time spent understanding unfamiliar code and increasing the time spent building, fixing, and contributing.

The goal? Less spelunking. Fewer tabs. Faster pull requests.

Because life's too short to reverse-engineer an entire codebase just to fix one bug.

πŸ‘‰ Explore the demo, inspect the architecture, and let the sloth do the digging.

Top comments (0)