DeepCtx — AI Codebase Context

Stop explaining your codebase to AI. Let DeepCtx do it automatically.

Every time you open ChatGPT, Claude, or Cursor, your AI has zero memory of your project. You waste 10–15 minutes re-explaining your folder structure, your patterns, your stack — before you can even ask the real question.

DeepCtx fixes this. One scan. One context file. Paste it anywhere.

How it works

1. Scan — DeepCtx walks your entire repo and reads key files in every folder
2. Summarize — Groq AI generates a technical summary of each folder in plain English
3. Copy — One click copies the full context block to your clipboard
4. Paste — Drop it into ChatGPT, Claude, or Cursor before your question

Your AI now knows your codebase instantly.

Features

• 🔍 Auto repo scanner — walks every folder, respects node_modules/.git/dist ignores
• 🤖 AI-powered summaries — generates a technical summary of what each folder actually does
• 📋 One-click copy — full context block ready to paste into any AI tool
• 💾 Saves to .deepctx.md — lives in your repo root, re-run anytime
• ⚙️ Fully configurable — choose model, ignored folders, files per folder
• 🚀 Works with everything — ChatGPT, Claude, Cursor, Copilot, any LLM

Setup (30 seconds)

Step 1 — Install & open a project

Install DeepCtx → open any project folder in VS Code → click the ⬡ icon in the activity bar

Step 2 — Scan

Click "Scan & Build Context" → watch it analyze your repo folder by folder

Step 3 — Use it

Click "Copy Context to Clipboard" → paste into ChatGPT, Claude, or Cursor → ask your question

That's it. No API key. No account. No setup.

Example output

# DeepCtx — Codebase Context for my-app

## Project Overview
- Primary Stack: node
- Framework: Next.js
- Top-level directories: src, public, components, lib

## Codebase Map

### `/src/app`
Files: page.tsx, layout.tsx, globals.css
The root Next.js app directory. `page.tsx` is the homepage component rendering
the hero section and feature grid. `layout.tsx` wraps all pages with the
navigation bar and footer. Uses Tailwind CSS for styling throughout.

### `/src/lib`
Files: db.ts, auth.ts, utils.ts
Core utility layer. `db.ts` initializes the Prisma client for PostgreSQL access.
`auth.ts` handles NextAuth session management with Google OAuth provider.
`utils.ts` contains shared helper functions for date formatting and string manipulation.

Settings

Tips

• Re-scan after big refactors — the context file gets stale if you rename folders or add major features
• Add .deepctx.md to .gitignore if your repo has sensitive architecture details
• Use llama-3.1-8b-instant in settings for faster (but lighter) summaries on large repos

Why Groq?

Groq is free for the amounts DeepCtx uses. A full scan of a medium-sized project (50 folders) costs fractions of a cent. You bring your own key so your data stays between you and Groq — DeepCtx never sees it.

Feedback & Issues

Found a bug or have a feature request? Open an issue on GitHub.

Built for developers who are tired of re-explaining their codebase.