DEV Community

Viraaj Sawant
Viraaj Sawant

Posted on

CodeTrace-AI v1.0.1: AI-Powered Code Intelligence with SHA-256 Delta Sync & Interactive Code Graphs

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.

  1. 🕸 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.

  1. ⚡ 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
Enter fullscreen mode Exit fullscreen mode

  1. 🤖 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.

  1. 🧠 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
Enter fullscreen mode Exit fullscreen mode

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

codetrace-ai · PyPI

Autonomous AI CLI for interactive architecture visualization, call-graph mapping, and hybrid codebase intelligence.

favicon pypi.org

💻 GitHub

GitHub logo Viraj465 / CodeTrace-ai

Codetrace-ai is a deeply integrated, privacy-first AI agent that understands your entire codebase.

Codetrace-ai Banner

PyPI Version Total Downloads Monthly Downloads MIT License GitHub Stars PRs Welcome Open Issues Open Pull Requests Build Status Join Slack

🧠 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

Watch Demo


🆕 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)