🧠 Project Graph – Context Engine

Save 60–80% of tokens on every AI request. Project Graph runs silently in the background, indexing your codebase and building compressed, relevant context — so your AI assistant always knows your project without you pasting files manually.

Works with any AI — ChatGPT, Claude, Gemini, GitHub Copilot Chat, Cursor, and more.

✨ Features

Feature	Description
🗂️ Auto-Generated Project Manifest	Detects your stack, frameworks, and conventions automatically
🔍 Structural Indexing	Extracts function signatures, class methods, exports via TypeScript AST
📊 Token Budget Control	Never overflow context windows — stays under 4,000 tokens (configurable)
📋 One-Click Context Copy	Copy optimized project context to clipboard, paste into any AI chat
🧭 Active File Tracking	Tracks your current file, recent edits, and diagnostics in real-time
💾 Incremental Updates	Only re-indexes changed files — fast and lightweight
📈 Token Savings Dashboard	See exactly how many tokens you're saving per session

🚀 Getting Started

Step 1: Install

Search "Project Graph - Context Engine" in the VS Code Extensions panel and click Install.

Step 2: Open Any Project

Open any project folder in VS Code. The extension activates automatically and:

Creates a .contextrc.json manifest in your project root
Creates a .context/ folder with your structural index
Shows a ✅ status indicator in the bottom-left status bar

Step 3: Use with Your AI

When you need AI help, open the Command Palette and run "Project Graph: Copy Context to Clipboard":

OS	Shortcut
Windows / Linux	`Ctrl + Shift + P`
macOS	`⌘ + Shift + P`

Then paste (Ctrl+V / ⌘+V) into any AI chat window. Your AI now has full project awareness!

📖 Commands

Open the Command Palette (Ctrl+Shift+P on Windows/Linux, ⌘+Shift+P on macOS) and type any of these:

Command	What It Does
`Project Graph: Copy Context to Clipboard`	📋 Builds optimized context and copies it — paste into any AI chat
`Project Graph: Show Index Summary`	📊 Opens a dashboard showing indexed files and tokens saved this session
`Project Graph: Rebuild Full Index`	🔄 Force re-indexes the entire workspace from scratch
`Project Graph: Edit Project Manifest`	✏️ Opens `.contextrc.json` for customization
`Project Graph: Initialise Project`	🆕 Re-generates the project manifest
`Project Graph: Clear Conversation Memory`	🗑️ Wipes conversation summary

🔧 Configuration

After first launch, a .contextrc.json file appears in your project root. Customize it:

{
  "name": "my-app",
  "version": "1.0.0",
  "stack": ["TypeScript", "React", "Node.js"],
  "entryPoints": ["src/index.ts", "src/App.tsx"],
  "testFramework": "Vitest",
  "conventions": "functional components, named exports, Airbnb ESLint",
  "architecture": "feature-based folders: src/features/{feature}/index.ts",
  "ignore": ["node_modules", "dist", "build", "*.test.ts", "coverage"],
  "contextBudget": 4000,
  "maxActiveFiles": 5
}

Key Settings

You can also configure these in VS Code Settings (Ctrl+, / ⌘+,):

Setting	Default	Description
`projectgraph.enable`	`true`	Enable or disable the extension
`projectgraph.tokenBudget`	`4000`	Max tokens per context request
`projectgraph.maxActiveFiles`	`5`	Number of recent files tracked
`projectgraph.debugMode`	`false`	Log token counts to Output panel

📋 What Gets Copied to Clipboard

When you run "Copy Context to Clipboard", you get a structured block like this:

=== PROJECT CONTEXT ===
Project: my-app | Stack: TypeScript, React, Node.js
Conventions: functional components, named exports, Airbnb ESLint
Entry points: src/index.ts, src/App.tsx

=== ACTIVE CONTEXT ===
Current File: src/auth/authService.ts
Diagnostics:
  - Line 42: Property 'token' does not exist on type 'User'

Content:
[current file content]

=== RECENT FILES ===
src/db/userRepo.ts — exports: UserRepo, findById, createUser
src/config/env.ts  — exports: ENV, validateEnv

This gives any AI complete awareness of your project in under 4,000 tokens instead of dumping tens of thousands of tokens of raw files.

💡 Tips

Add .context/ to your .gitignore — it contains machine-specific index data
Customize ignore patterns in .contextrc.json to exclude test files, generated code, etc.
Lower contextBudget if you're using a smaller model with limited context
The extension works with any AI — it doesn't connect to any API. It just builds the context for you to paste anywhere

🛡️ Privacy

Project Graph runs 100% locally. Your code never leaves your machine. All indexing and context assembly happens inside the VS Code extension host — zero network calls for indexing.

📊 Token Savings

Run "Project Graph: Show Index Summary" to see your session stats:

Total workspace tokens tracked
Tokens actually sent in context
Total tokens saved (the difference!)

🐛 Issues & Feedback

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

Made with ❤️ for developers who use AI every day.

Project Graph - Context Engine

Furkan_Khan