toprakahmetaydogmus/TZeroAlgorithm

  
> **Enterprise-Grade Codebase Context Builder, AST Signatures Analyzer, and Token Reducer.**
> Built for Cursor, VS Code Copilot, Cline, Antigravity IDE, Claude Code, and ChatGPT. Cuts LLM context ingestion overhead by **up to 95%** while preserving the structural outline of your code (signatures, hierarchy, dependencies).
> Includes a native **Model Context Protocol (MCP)** server for autonomous AI coding agents.
**Developer:** Toprak Ahmet Aydoğmuş
**LinkedIn:** Toprak Ahmet Aydoğmuş
**Bio & Hub:** https://hopp.bio/siberegitim
**GitHub Repository:** https://github.com/toprakahmetaydogmus/TZeroAlgorithm
⚡ Visual Proof: Raw Ingestion vs. T-Zero AST Pruning (Reproducible)
| Analysis Mode | Raw Context Volume | T-Zero Pruned Payload | Token Reduction Ratio | Cost Delta / Query |
|:---|:---|:---|:---:|:---:|
| **Full Repository Scan** | 166,996 tokens | 8,465 tokens | **-94.9%** | **-$0.3963 / query** |
> Run it yourself offline ($0 cost): python tzero.py --savings
🚀 1-Line Quickstart
Or configure directly into your MCP Client (**Cursor**, **Claude Desktop**, **Windsurf**, or **Antigravity IDE**):
Or run offline CLI inspection immediately ($0 cost, 100% Zero-Leak):
---
🇬🇧 English
 
Table of Contents
1. Security Architecture (100% Zero-Leak Guarantee)
2. Model Context Protocol (MCP) Server
3. System Architecture
4. Core Highlights & Capabilities
5. Installation & Setup
6. Usage Guide (GUI & CLI)
7. Keyboard Shortcuts
8. Project Structure
9. Automated Test Suite & CI/CD
10. License & Credits
---
🔒 Security Architecture (100% Zero-Leak Guarantee)
> [!IMPORTANT]
> **T-Zero Algorithm strictly contains ZERO hardcoded, personal, or public API keys or credentials anywhere in the repository.**
> Defense-in-depth and zero-trust principles are enforced by default.
1. **OS-Level Credential Encryption (Keyring Engine):**
- API keys are never written to plain-text configuration files or logs.
- Stored through the cross-platform keyring library, which uses the native OS store:
- **Windows:** Windows Credential Manager
- **macOS:** Apple Keychain
- **Linux:** Secret Service API (GNOME Keyring / KWallet via DBus)
2. **Zero Telemetry & Absolute Privacy:**
- Your source code, tokens, file structure, and API credentials are never sent to any third-party telemetry, analytics, or developer servers.
- Outbound network traffic is exclusively initiated directly from your client to the AI provider endpoint chosen by you (NVIDIA, OpenAI, Google, Anthropic, OpenRouter, or localhost Ollama).
- The optional local web dashboard (--web) binds to 127.0.0.1 only; its page loads a web font from Google Fonts in your browser.
3. **Password-Obfuscated Keyring Backup:**
- API keys can be backed up to a password-protected .dat binary file. This uses a simple repeating-key XOR (no salt, not strong cryptography), so keep the file private and treat it like a secret. It is git-ignored by default.
4. **12-Factor Environment Variable Detection:**
- Automatically detects and inherits standard system environment variables when present:
- NVIDIA_API_KEY
- OPENAI_API_KEY
- GEMINI_API_KEY
- OPENROUTER_API_KEY
- ANTHROPIC_API_KEY
5. **100% Offline Dry-Run Mode ($0 Cost):**
- Generate full-featured context trees, AST signature maps, and markdown blueprints without any internet connection, API keys, or AI provider subscriptions.
---
🤖 Model Context Protocol (MCP) Server
T-Zero V3 natively embeds a standard **Model Context Protocol (MCP)** server (tzero_mcp.py) operating over stdio. This empowers AI agents in **Cursor**, **Claude Desktop**, **Antigravity IDE**, and **Cline** to autonomously inspect, prune, and query your project's codebase before writing a single line of code.
🛠 Available MCP Tools (21 Autonomous Tools)
| Tool Name | Parameters | Purpose |
|:----------|:-----------|:--------|
| get_project_context_tree | project_root, reduction_mode, max_tokens, include_file_contents | Scans workspace and builds a multi-tier T-Zero hierarchical context tree (T-1 to T-4) with PageRank & Git recency token budgeting. Reduces tokens by up to 95%. |
| query_module_dependencies | project_root, file_path | Analyzes incoming and outgoing import dependencies across Python, TypeScript, Go, Rust, Java, C#, and C++. |
| query_architecture_boundaries | project_root, extra_guidance | Queries active T-4 architectural boundaries, operational constraints, and Zero-Leak rules for coding agents. |
| generate_architecture_blueprint | project_root | Generates a complete system architecture specification (ARCHITECTURE.md) with live Mermaid topology diagrams. |