CodeTrace-AI v1.0.1 — Stop Reading Code. Start Understanding It.
Every developer has experienced this.
You clone a repository, open it, and suddenly you're staring at thousands of files.
You spend hours answering questions like:
- Where is this function called?
- Which files depend on this module?
- What happens if I modify this class?
- Is this code even used anymore?
Traditional tools like grep, IDE search, or AI chat assistants can help you find code.
They don't help you understand the architecture.
That's why I built CodeTrace-AI.
What is CodeTrace-AI?
CodeTrace-AI is an AI-powered code intelligence tool that transforms your repository into a searchable structural knowledge graph.
Instead of treating your project as plain text, it understands your codebase structurally by analyzing:
- 📂 Folder hierarchy
- 📄 Files
- 🏛 Classes
- ⚙ Functions
- 📦 Imports
- 🔗 Function calls
- 🌐 Cross-file dependencies
Think of it as having an AI Software Architect that understands your entire repository.
🚀 What's New in v1.0.1
This release focuses on speed, privacy, and understanding large repositories.
- 🕸 Interactive Code Graph
One of the biggest additions is the interactive repository graph.
Instead of reading hundreds of files manually, you can visualize relationships between:
- Folders
- Files
- Classes
- Functions
- Imports
- Function calls
Understanding a new project becomes dramatically easier.
- ⚡ SHA-256 Delta Sync Engine
One feature I'm particularly proud of is the new Incremental Indexing Engine.
Most code intelligence tools rebuild their entire index every time.
CodeTrace-AI doesn't.
It computes a SHA-256 fingerprint for every tracked file and detects:
- ✅ Modified files
- ➕ Newly added files
- ❌ Deleted files
Only those files are:
- Re-parsed
- Re-embedded
- Re-added to the knowledge graph
Everything else is skipped.
This makes repeated indexing dramatically faster, especially for large repositories where only a few files change between runs.
Under the hood
The sync engine includes:
- SHA-256 fingerprinting
- Parallel file hashing
- Manifest tracking
- Deleted file detection
- Incremental embedding updates
- Structural graph synchronization
- File snapshot tracking
Instead of rebuilding everything...
Repository
│
▼
Detect Changes
│
▼
Only Update
Changed Files
│
▼
Knowledge Graph Updated
- 🤖 Local Ollama Support
Privacy matters.
You can now connect any locally installed Ollama model in seconds.
That means:
-No API keys
- No cloud dependency
- No sending proprietary code to external services
Perfect for enterprise projects or developers who prefer local AI.
- 🧠 Structural Code Intelligence
CodeTrace-AI doesn't just perform semantic search.
It combines:
- Vector embeddings
- Structural code analysis
- Call graph generation
- Repository metadata
- Dependency mapping
This enables questions like:
- Where is this function used?
- What breaks if I modify this file?
- Explain this project's architecture.
- Show the execution flow.
- Which modules depend on this class?
Why I Built It
After working with larger repositories, I realized the biggest bottleneck wasn't writing code.
It was understanding existing code.
Modern AI coding assistants are excellent at generating code, but they often lack awareness of your project's full architecture.
CodeTrace-AI was built to bridge that gap.
Instead of generating code blindly, it helps developers understand how everything connects before making changes.
Example Workflow
Clone Repository
│
▼
Index Project
│
▼
Build Knowledge Graph
│
▼
Ask Questions
│
▼
Understand Architecture
No more endlessly clicking through files.
Who Is It For?
- Software Engineers
- AI Engineers
- Open Source Contributors
- Students
- Technical Leads
- Anyone working with unfamiliar codebases
What's Next?
This is just the beginning.
Future releases will continue expanding CodeTrace-AI with deeper architectural reasoning, smarter repository analysis, and more powerful AI-assisted developer workflows.
The goal isn't to replace developers.
The goal is to help them understand complex codebases faster than ever before.
Try CodeTrace-AI
I'd love to hear your feedback and feature requests.
🌐 Website
📦 PyPI
💻 GitHub
Viraj465
/
CodeTrace-ai
Codetrace-ai is a deeply integrated, privacy-first AI agent that understands your entire codebase.
🧠 Codetrace AI
The Autonomous System Architect for your Terminal and IDE.
Codetrace AI is a privacy-first AI agent that builds a "Hybrid Brain" of your codebase — combining semantic vector search with structural call-graph analysis — so it understands what calls what, who owns what, and what breaks if you change something.
🎥 See it in Action
🆕 What's New in v1.0.0
✨ Interactive Architecture Visualizer (codetrace visualize)
The biggest addition yet. A completely new, interactive HTML architecture map generated directly from your code graph.
- Folder-level dependency map — groups all symbols by directory and renders cross-folder function call edges
- Hover on any folder → instantly highlights all its connections and shows a detailed breakdown panel
- Hover on any edge → reveals the exact function-to-function calls driving that dependency
- Click a folder → opens a detail sidebar showing all files, symbols, and dependency counts
- …
🎥 YouTube
If you find the project useful, consider giving it a ⭐ on GitHub—it helps others discover the project and motivates continued development.


Top comments (0)