context-gen-cli 1.3.3__tar.gz → 1.3.5__tar.gz

context_gen_cli-1.3.5/PKG-INFO

@@ -0,0 +1,192 @@
+Metadata-Version: 2.4
+Name: context-gen-cli
+Version: 1.3.5
+Summary: A modern CLI tool that scans any project, builds an AST-based dependency graph, and generates structured LLM context (agent.md / agent.json).
+Author: yakkshit
+License-Expression: MIT
+Keywords: llm,context,agent,cli,code-analysis,ast,graph,mcp
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: typer>=0.12.0
+Requires-Dist: rich>=13.7.0
+Requires-Dist: shellingham>=1.5.4
+Requires-Dist: pathspec>=0.12.1
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Requires-Dist: build>=1.1.0; extra == "dev"
+Requires-Dist: twine>=5.0.0; extra == "dev"
+
+# ⚡ context-gen-cli (`ctx`) — Python Edition
+
+<p align="center">
+  <a href="https://pypi.org/project/context-gen-cli/"><img src="https://img.shields.io/pypi/v/context-gen-cli.svg?color=3775a9" alt="PyPI version" /></a>
+  <a href="https://pypi.org/project/context-gen-cli/"><img src="https://img.shields.io/pypi/pyversions/context-gen-cli.svg" alt="Python Versions" /></a>
+  <a href="https://modelcontextprotocol.io"><img src="https://img.shields.io/badge/MCP-Protocol%20Ready-6366f1.svg" alt="MCP Ready" /></a>
+  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="MIT License" /></a>
+  <a href="https://resume.cedzlabs.com/labs"><img src="https://img.shields.io/badge/Cedzlabs-Labs%20%E2%86%97-cyan.svg" alt="Cedzlabs Labs" /></a>
+</p>
+
+> **Stop dumping 50,000 raw tokens into your AI coding agent.**  
+> `context-gen-cli` analyzes any codebase using native AST parsers and **Entropy-Guided Reference Distillation (EGRD)** to give Cursor, Antigravity, Claude Code, and VS Code an ultra-dense **~40-token Senior Engineer Context Plan**—or stops to ask targeted questions if your prompt is ambiguous.
+
+---
+
+### 💡 Package Name vs. Command Alias
+
+| What you install | What you run in your terminal |
+| :--- | :--- |
+| `pip install context-gen-cli` | **`ctx`** |
+
+> **Why `ctx`?** While the package is registered as `context-gen-cli` on PyPI and npm, you shouldn't have to type 15 characters every time you run a command. The binary alias **`ctx`** is automatically registered upon installation. (The full `context-gen` alias is also preserved for scripts).
+
+---
+
+## 🌟 Highlights
+
+- **⚡ Fast Short Alias (`ctx`)**: Type `ctx` anywhere in your terminal.
+- **🧠 Entropy-Guided Reference Distillation (EGRD)**: Calculates Shannon Entropy ($H$) over codebase signatures to filter 98.5% of prompt noise.
+- **🛡️ Anti-Hallucination Clarification Gate**: If your prompt is ambiguous ($H \ge 1.50\text{ bits}$), `ctx` halts guessing and asks targeted questions using real paths from your repo.
+- **🕸️ 100% Accurate AST Knowledge Graph**: Uses native AST traversal to resolve relative imports, exports, roles, and downstream **Blast Radius** (what files break if this changes).
+- **🔋 Zero GPU / CUDA Bloat**: Strictly capped at 1–2 CPU cores. No 15GB PyTorch downloads or local embedding models.
+- **📁 Clean Monorepo / Workspace Storage**: Saves context models neatly into `context/agent.md`, `context/agent.json`, and `context/agent.yaml`.
+- **🔒 Security Filter**: Strips virtual environments (`.venv*`, `venv*`), `.env*` files, pem/key certificates, and secrets automatically.
+
+---
+
+## 📦 Installation
+
+```bash
+# Standard installation
+pip install context-gen-cli
+
+# Or with pipx (recommended for isolated global CLI tools)
+pipx install context-gen-cli
+
+# Or with uv
+uv tool install context-gen-cli
+```
+
+Verify installation:
+```bash
+ctx --help
+```
+
+---
+
+## 🚀 Everyday Workflows & Examples
+
+### 1. ⚡ All-In-One Workspace Mode (`ctx -d`)
+Generates triple context formats (`agent.md`, `agent.json`, `agent.yaml`) in `context/` and runs a live auto-sync watcher in the background:
+```bash
+ctx -d
+```
+
+### 2. 🎯 Distill a Specific Prompt (`ctx distill`)
+Generate a dense Senior Engineer Blueprint for any task:
+```bash
+ctx distill "add jwt refresh token rotation to authentication"
+```
+
+**Output:**
+```text
+╔═══════════════════════════════════════════════════════════════╗
+║  🧠 SENIOR ENGINEER CONTEXT PLAN (EGRD Distilled)             ║
+╚═══════════════════════════════════════════════════════════════╝
+
+  🎯 Task: add jwt refresh token rotation to authentication
+  ⚙️  Engineering Mode: Architecture / Refactor
+
+  📂 Primary Files to Reference:
+     ✔ src/services/auth.py
+     ✔ src/routes/auth_routes.py
+     ✔ src/models/user.py
+
+  💥 Blast Radius (Downstream Callers):
+     src/middleware/guard.py, src/app.py
+
+  🛡️ Architecture Guardrail:
+     Changes affect 2 downstream callers. Verify token payload backward compatibility.
+```
+
+### 3. ⚠️ The Clarification Gate (Ambiguous Prompts)
+If you provide a vague prompt like:
+```bash
+ctx distill "update config"
+```
+Instead of hallucinating or dumping the entire repository, `ctx` pauses and shows:
+```text
+╔═══════════════════════════════════════════════════════════════╗
+║  ⚠️  CLARIFICATION NEEDED — Ambiguous Prompt Detected         ║
+╚═══════════════════════════════════════════════════════════════╝
+
+  ▸ Prompt entropy H = 1.84 bits exceeds confident threshold (1.50 bits).
+  ▸ Disambiguate by specifying target:
+    1. src/config/database.py
+    2. src/config/server.py
+    3. src/config/redis.py
+```
+
+### 4. 📊 Check Token Weight & Savings (`ctx --tokens`)
+Inspect how much context weight your AI agent saves compared to raw directory dumps:
+```bash
+ctx --tokens
+```
+
+---
+
+## 📖 CLI Reference
+
+| Command | Description |
+| :--- | :--- |
+| `ctx` | Scans workspace and generates `agent.md`, `agent.json`, `agent.yaml` in `context/` |
+| `ctx -d` / `ctx --default` | **⚡ All-in-One**: Generates context and starts live file-watching sync |
+| `ctx distill "<prompt>"` | **🧠 EGRD Distiller**: Generates high-signal Senior Engineer Blueprint |
+| `ctx -w` / `ctx --watch` | **👀 Watch Mode**: Watches codebase and auto-updates context files on save |
+| `ctx --tokens` | **📊 Token Analytics**: Displays token counts and compression ratios |
+| `ctx -o <dir>` | **📁 Custom Output**: Specify output directory (defaults to `context/`) |
+| `ctx -f <format>` | **📄 Format Filter**: Choose `md`, `json`, `yaml`, or `all` |
+| `ctx update` | **🔄 Quick Refresh**: Re-indexes the current workspace |
+| `ctx --help` | View full options and flag descriptions |
+
+---
+
+## 🛠️ MCP (Model Context Protocol) Integration
+
+`ctx` can act as an MCP server for **Cursor**, **Claude Desktop**, **Antigravity**, and **VS Code**:
+
+Add to your MCP settings (`claude_desktop_config.json` or Cursor Settings):
+```json
+{
+  "mcpServers": {
+    "context-gen": {
+      "command": "ctx",
+      "args": ["-d"]
+    }
+  }
+}
+```
+
+---
+
+## 🤝 Ecosystem & Links
+
+- **Documentation & Showcase:** [https://resume.cedzlabs.com/labs](https://resume.cedzlabs.com/labs)
+- **Node.js (npm):** `npx context-gen-cli@latest`
+- **Homebrew (macOS):** `brew install context-gen-cli`
+- **GitHub Repository:** [https://github.com/yakkshit/context-gen](https://github.com/yakkshit/context-gen)
+
+---
+
+## 📄 License
+
+MIT © [Yakkshit](https://github.com/yakkshit) & [Cedzlabs](https://resume.cedzlabs.com/labs)

context_gen_cli-1.3.5/README.md

@@ -0,0 +1,164 @@
+# ⚡ context-gen-cli (`ctx`) — Python Edition
+
+<p align="center">
+  <a href="https://pypi.org/project/context-gen-cli/"><img src="https://img.shields.io/pypi/v/context-gen-cli.svg?color=3775a9" alt="PyPI version" /></a>
+  <a href="https://pypi.org/project/context-gen-cli/"><img src="https://img.shields.io/pypi/pyversions/context-gen-cli.svg" alt="Python Versions" /></a>
+  <a href="https://modelcontextprotocol.io"><img src="https://img.shields.io/badge/MCP-Protocol%20Ready-6366f1.svg" alt="MCP Ready" /></a>
+  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="MIT License" /></a>
+  <a href="https://resume.cedzlabs.com/labs"><img src="https://img.shields.io/badge/Cedzlabs-Labs%20%E2%86%97-cyan.svg" alt="Cedzlabs Labs" /></a>
+</p>
+
+> **Stop dumping 50,000 raw tokens into your AI coding agent.**  
+> `context-gen-cli` analyzes any codebase using native AST parsers and **Entropy-Guided Reference Distillation (EGRD)** to give Cursor, Antigravity, Claude Code, and VS Code an ultra-dense **~40-token Senior Engineer Context Plan**—or stops to ask targeted questions if your prompt is ambiguous.
+
+---
+
+### 💡 Package Name vs. Command Alias
+
+| What you install | What you run in your terminal |
+| :--- | :--- |
+| `pip install context-gen-cli` | **`ctx`** |
+
+> **Why `ctx`?** While the package is registered as `context-gen-cli` on PyPI and npm, you shouldn't have to type 15 characters every time you run a command. The binary alias **`ctx`** is automatically registered upon installation. (The full `context-gen` alias is also preserved for scripts).
+
+---
+
+## 🌟 Highlights
+
+- **⚡ Fast Short Alias (`ctx`)**: Type `ctx` anywhere in your terminal.
+- **🧠 Entropy-Guided Reference Distillation (EGRD)**: Calculates Shannon Entropy ($H$) over codebase signatures to filter 98.5% of prompt noise.
+- **🛡️ Anti-Hallucination Clarification Gate**: If your prompt is ambiguous ($H \ge 1.50\text{ bits}$), `ctx` halts guessing and asks targeted questions using real paths from your repo.
+- **🕸️ 100% Accurate AST Knowledge Graph**: Uses native AST traversal to resolve relative imports, exports, roles, and downstream **Blast Radius** (what files break if this changes).
+- **🔋 Zero GPU / CUDA Bloat**: Strictly capped at 1–2 CPU cores. No 15GB PyTorch downloads or local embedding models.
+- **📁 Clean Monorepo / Workspace Storage**: Saves context models neatly into `context/agent.md`, `context/agent.json`, and `context/agent.yaml`.
+- **🔒 Security Filter**: Strips virtual environments (`.venv*`, `venv*`), `.env*` files, pem/key certificates, and secrets automatically.
+
+---
+
+## 📦 Installation
+
+```bash
+# Standard installation
+pip install context-gen-cli
+
+# Or with pipx (recommended for isolated global CLI tools)
+pipx install context-gen-cli
+
+# Or with uv
+uv tool install context-gen-cli
+```
+
+Verify installation:
+```bash
+ctx --help
+```
+
+---
+
+## 🚀 Everyday Workflows & Examples
+
+### 1. ⚡ All-In-One Workspace Mode (`ctx -d`)
+Generates triple context formats (`agent.md`, `agent.json`, `agent.yaml`) in `context/` and runs a live auto-sync watcher in the background:
+```bash
+ctx -d
+```
+
+### 2. 🎯 Distill a Specific Prompt (`ctx distill`)
+Generate a dense Senior Engineer Blueprint for any task:
+```bash
+ctx distill "add jwt refresh token rotation to authentication"
+```
+
+**Output:**
+```text
+╔═══════════════════════════════════════════════════════════════╗
+║  🧠 SENIOR ENGINEER CONTEXT PLAN (EGRD Distilled)             ║
+╚═══════════════════════════════════════════════════════════════╝
+
+  🎯 Task: add jwt refresh token rotation to authentication
+  ⚙️  Engineering Mode: Architecture / Refactor
+
+  📂 Primary Files to Reference:
+     ✔ src/services/auth.py
+     ✔ src/routes/auth_routes.py
+     ✔ src/models/user.py
+
+  💥 Blast Radius (Downstream Callers):
+     src/middleware/guard.py, src/app.py
+
+  🛡️ Architecture Guardrail:
+     Changes affect 2 downstream callers. Verify token payload backward compatibility.
+```
+
+### 3. ⚠️ The Clarification Gate (Ambiguous Prompts)
+If you provide a vague prompt like:
+```bash
+ctx distill "update config"
+```
+Instead of hallucinating or dumping the entire repository, `ctx` pauses and shows:
+```text
+╔═══════════════════════════════════════════════════════════════╗
+║  ⚠️  CLARIFICATION NEEDED — Ambiguous Prompt Detected         ║
+╚═══════════════════════════════════════════════════════════════╝
+
+  ▸ Prompt entropy H = 1.84 bits exceeds confident threshold (1.50 bits).
+  ▸ Disambiguate by specifying target:
+    1. src/config/database.py
+    2. src/config/server.py
+    3. src/config/redis.py
+```
+
+### 4. 📊 Check Token Weight & Savings (`ctx --tokens`)
+Inspect how much context weight your AI agent saves compared to raw directory dumps:
+```bash
+ctx --tokens
+```
+
+---
+
+## 📖 CLI Reference
+
+| Command | Description |
+| :--- | :--- |
+| `ctx` | Scans workspace and generates `agent.md`, `agent.json`, `agent.yaml` in `context/` |
+| `ctx -d` / `ctx --default` | **⚡ All-in-One**: Generates context and starts live file-watching sync |
+| `ctx distill "<prompt>"` | **🧠 EGRD Distiller**: Generates high-signal Senior Engineer Blueprint |
+| `ctx -w` / `ctx --watch` | **👀 Watch Mode**: Watches codebase and auto-updates context files on save |
+| `ctx --tokens` | **📊 Token Analytics**: Displays token counts and compression ratios |
+| `ctx -o <dir>` | **📁 Custom Output**: Specify output directory (defaults to `context/`) |
+| `ctx -f <format>` | **📄 Format Filter**: Choose `md`, `json`, `yaml`, or `all` |
+| `ctx update` | **🔄 Quick Refresh**: Re-indexes the current workspace |
+| `ctx --help` | View full options and flag descriptions |
+
+---
+
+## 🛠️ MCP (Model Context Protocol) Integration
+
+`ctx` can act as an MCP server for **Cursor**, **Claude Desktop**, **Antigravity**, and **VS Code**:
+
+Add to your MCP settings (`claude_desktop_config.json` or Cursor Settings):
+```json
+{
+  "mcpServers": {
+    "context-gen": {
+      "command": "ctx",
+      "args": ["-d"]
+    }
+  }
+}
+```
+
+---
+
+## 🤝 Ecosystem & Links
+
+- **Documentation & Showcase:** [https://resume.cedzlabs.com/labs](https://resume.cedzlabs.com/labs)
+- **Node.js (npm):** `npx context-gen-cli@latest`
+- **Homebrew (macOS):** `brew install context-gen-cli`
+- **GitHub Repository:** [https://github.com/yakkshit/context-gen](https://github.com/yakkshit/context-gen)
+
+---
+
+## 📄 License
+
+MIT © [Yakkshit](https://github.com/yakkshit) & [Cedzlabs](https://resume.cedzlabs.com/labs)

{context_gen_cli-1.3.3 → context_gen_cli-1.3.5}/context_gen/scanner.py

@@ -14,12 +14,30 @@ DEFAULT_IGNORES: List[str] = [
     ".git/**",
     ".venv",
     ".venv/**",
+    ".venv*",
+    ".venv*/**",
     "venv",
     "venv/**",
+    "venv*",
+    "venv*/**",
+    "*venv*",
+    "*venv*/**",
     "env",
     "env/**",
+    "site-packages",
+    "site-packages/**",
+    ".pytest_cache",
+    ".pytest_cache/**",
+    ".mypy_cache",
+    ".mypy_cache/**",
+    ".ruff_cache",
+    ".ruff_cache/**",
     "node_modules",
     "node_modules/**",
+    ".next",
+    ".next/**",
+    ".turbo",
+    ".turbo/**",
     ".DS_Store",
     "context",
     "context/**",

context_gen_cli-1.3.5/context_gen_cli.egg-info/PKG-INFO

@@ -0,0 +1,192 @@
+Metadata-Version: 2.4
+Name: context-gen-cli
+Version: 1.3.5
+Summary: A modern CLI tool that scans any project, builds an AST-based dependency graph, and generates structured LLM context (agent.md / agent.json).
+Author: yakkshit
+License-Expression: MIT
+Keywords: llm,context,agent,cli,code-analysis,ast,graph,mcp
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: typer>=0.12.0
+Requires-Dist: rich>=13.7.0
+Requires-Dist: shellingham>=1.5.4
+Requires-Dist: pathspec>=0.12.1
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Requires-Dist: build>=1.1.0; extra == "dev"
+Requires-Dist: twine>=5.0.0; extra == "dev"
+
+# ⚡ context-gen-cli (`ctx`) — Python Edition
+
+<p align="center">
+  <a href="https://pypi.org/project/context-gen-cli/"><img src="https://img.shields.io/pypi/v/context-gen-cli.svg?color=3775a9" alt="PyPI version" /></a>
+  <a href="https://pypi.org/project/context-gen-cli/"><img src="https://img.shields.io/pypi/pyversions/context-gen-cli.svg" alt="Python Versions" /></a>
+  <a href="https://modelcontextprotocol.io"><img src="https://img.shields.io/badge/MCP-Protocol%20Ready-6366f1.svg" alt="MCP Ready" /></a>
+  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="MIT License" /></a>
+  <a href="https://resume.cedzlabs.com/labs"><img src="https://img.shields.io/badge/Cedzlabs-Labs%20%E2%86%97-cyan.svg" alt="Cedzlabs Labs" /></a>
+</p>
+
+> **Stop dumping 50,000 raw tokens into your AI coding agent.**  
+> `context-gen-cli` analyzes any codebase using native AST parsers and **Entropy-Guided Reference Distillation (EGRD)** to give Cursor, Antigravity, Claude Code, and VS Code an ultra-dense **~40-token Senior Engineer Context Plan**—or stops to ask targeted questions if your prompt is ambiguous.
+
+---
+
+### 💡 Package Name vs. Command Alias
+
+| What you install | What you run in your terminal |
+| :--- | :--- |
+| `pip install context-gen-cli` | **`ctx`** |
+
+> **Why `ctx`?** While the package is registered as `context-gen-cli` on PyPI and npm, you shouldn't have to type 15 characters every time you run a command. The binary alias **`ctx`** is automatically registered upon installation. (The full `context-gen` alias is also preserved for scripts).
+
+---
+
+## 🌟 Highlights
+
+- **⚡ Fast Short Alias (`ctx`)**: Type `ctx` anywhere in your terminal.
+- **🧠 Entropy-Guided Reference Distillation (EGRD)**: Calculates Shannon Entropy ($H$) over codebase signatures to filter 98.5% of prompt noise.
+- **🛡️ Anti-Hallucination Clarification Gate**: If your prompt is ambiguous ($H \ge 1.50\text{ bits}$), `ctx` halts guessing and asks targeted questions using real paths from your repo.
+- **🕸️ 100% Accurate AST Knowledge Graph**: Uses native AST traversal to resolve relative imports, exports, roles, and downstream **Blast Radius** (what files break if this changes).
+- **🔋 Zero GPU / CUDA Bloat**: Strictly capped at 1–2 CPU cores. No 15GB PyTorch downloads or local embedding models.
+- **📁 Clean Monorepo / Workspace Storage**: Saves context models neatly into `context/agent.md`, `context/agent.json`, and `context/agent.yaml`.
+- **🔒 Security Filter**: Strips virtual environments (`.venv*`, `venv*`), `.env*` files, pem/key certificates, and secrets automatically.
+
+---
+
+## 📦 Installation
+
+```bash
+# Standard installation
+pip install context-gen-cli
+
+# Or with pipx (recommended for isolated global CLI tools)
+pipx install context-gen-cli
+
+# Or with uv
+uv tool install context-gen-cli
+```
+
+Verify installation:
+```bash
+ctx --help
+```
+
+---
+
+## 🚀 Everyday Workflows & Examples
+
+### 1. ⚡ All-In-One Workspace Mode (`ctx -d`)
+Generates triple context formats (`agent.md`, `agent.json`, `agent.yaml`) in `context/` and runs a live auto-sync watcher in the background:
+```bash
+ctx -d
+```
+
+### 2. 🎯 Distill a Specific Prompt (`ctx distill`)
+Generate a dense Senior Engineer Blueprint for any task:
+```bash
+ctx distill "add jwt refresh token rotation to authentication"
+```
+
+**Output:**
+```text
+╔═══════════════════════════════════════════════════════════════╗
+║  🧠 SENIOR ENGINEER CONTEXT PLAN (EGRD Distilled)             ║
+╚═══════════════════════════════════════════════════════════════╝
+
+  🎯 Task: add jwt refresh token rotation to authentication
+  ⚙️  Engineering Mode: Architecture / Refactor
+
+  📂 Primary Files to Reference:
+     ✔ src/services/auth.py
+     ✔ src/routes/auth_routes.py
+     ✔ src/models/user.py
+
+  💥 Blast Radius (Downstream Callers):
+     src/middleware/guard.py, src/app.py
+
+  🛡️ Architecture Guardrail:
+     Changes affect 2 downstream callers. Verify token payload backward compatibility.
+```
+
+### 3. ⚠️ The Clarification Gate (Ambiguous Prompts)
+If you provide a vague prompt like:
+```bash
+ctx distill "update config"
+```
+Instead of hallucinating or dumping the entire repository, `ctx` pauses and shows:
+```text
+╔═══════════════════════════════════════════════════════════════╗
+║  ⚠️  CLARIFICATION NEEDED — Ambiguous Prompt Detected         ║
+╚═══════════════════════════════════════════════════════════════╝
+
+  ▸ Prompt entropy H = 1.84 bits exceeds confident threshold (1.50 bits).
+  ▸ Disambiguate by specifying target:
+    1. src/config/database.py
+    2. src/config/server.py
+    3. src/config/redis.py
+```
+
+### 4. 📊 Check Token Weight & Savings (`ctx --tokens`)
+Inspect how much context weight your AI agent saves compared to raw directory dumps:
+```bash
+ctx --tokens
+```
+
+---
+
+## 📖 CLI Reference
+
+| Command | Description |
+| :--- | :--- |
+| `ctx` | Scans workspace and generates `agent.md`, `agent.json`, `agent.yaml` in `context/` |
+| `ctx -d` / `ctx --default` | **⚡ All-in-One**: Generates context and starts live file-watching sync |
+| `ctx distill "<prompt>"` | **🧠 EGRD Distiller**: Generates high-signal Senior Engineer Blueprint |
+| `ctx -w` / `ctx --watch` | **👀 Watch Mode**: Watches codebase and auto-updates context files on save |
+| `ctx --tokens` | **📊 Token Analytics**: Displays token counts and compression ratios |
+| `ctx -o <dir>` | **📁 Custom Output**: Specify output directory (defaults to `context/`) |
+| `ctx -f <format>` | **📄 Format Filter**: Choose `md`, `json`, `yaml`, or `all` |
+| `ctx update` | **🔄 Quick Refresh**: Re-indexes the current workspace |
+| `ctx --help` | View full options and flag descriptions |
+
+---
+
+## 🛠️ MCP (Model Context Protocol) Integration
+
+`ctx` can act as an MCP server for **Cursor**, **Claude Desktop**, **Antigravity**, and **VS Code**:
+
+Add to your MCP settings (`claude_desktop_config.json` or Cursor Settings):
+```json
+{
+  "mcpServers": {
+    "context-gen": {
+      "command": "ctx",
+      "args": ["-d"]
+    }
+  }
+}
+```
+
+---
+
+## 🤝 Ecosystem & Links
+
+- **Documentation & Showcase:** [https://resume.cedzlabs.com/labs](https://resume.cedzlabs.com/labs)
+- **Node.js (npm):** `npx context-gen-cli@latest`
+- **Homebrew (macOS):** `brew install context-gen-cli`
+- **GitHub Repository:** [https://github.com/yakkshit/context-gen](https://github.com/yakkshit/context-gen)
+
+---
+
+## 📄 License
+
+MIT © [Yakkshit](https://github.com/yakkshit) & [Cedzlabs](https://resume.cedzlabs.com/labs)

{context_gen_cli-1.3.3 → context_gen_cli-1.3.5}/context_gen_cli.egg-info/requires.txt

@@ -1,5 +1,6 @@
-typer[all]>=0.12.0
+typer>=0.12.0
 rich>=13.7.0
+shellingham>=1.5.4
 pathspec>=0.12.1
 
 [dev]

{context_gen_cli-1.3.3 → context_gen_cli-1.3.5}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "context-gen-cli"
-version = "1.3.3"
+version = "1.3.5"
 description = "A modern CLI tool that scans any project, builds an AST-based dependency graph, and generates structured LLM context (agent.md / agent.json)."
 readme = "README.md"
 authors = [{ name = "yakkshit" }]
@@ -25,8 +25,9 @@ classifiers = [
 ]
 
 dependencies = [
-    "typer[all]>=0.12.0",
+    "typer>=0.12.0",
     "rich>=13.7.0",
+    "shellingham>=1.5.4",
     "pathspec>=0.12.1"
 ]
 

context_gen_cli-1.3.3/PKG-INFO

@@ -1,115 +0,0 @@
-Metadata-Version: 2.4
-Name: context-gen-cli
-Version: 1.3.3
-Summary: A modern CLI tool that scans any project, builds an AST-based dependency graph, and generates structured LLM context (agent.md / agent.json).
-Author: yakkshit
-License-Expression: MIT
-Keywords: llm,context,agent,cli,code-analysis,ast,graph,mcp
-Classifier: Development Status :: 4 - Beta
-Classifier: Environment :: Console
-Classifier: Intended Audience :: Developers
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Topic :: Software Development :: Code Generators
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-Requires-Dist: typer[all]>=0.12.0
-Requires-Dist: rich>=13.7.0
-Requires-Dist: pathspec>=0.12.1
-Provides-Extra: dev
-Requires-Dist: pytest>=8.0.0; extra == "dev"
-Requires-Dist: build>=1.1.0; extra == "dev"
-Requires-Dist: twine>=5.0.0; extra == "dev"
-
-# ⚡ context-gen-cli (`ctx`) — Python Edition
-
-[![PyPI version](https://img.shields.io/pypi/v/context-gen-cli.svg?color=3775a9)](https://pypi.org/project/context-gen-cli/)
-[![Python Versions](https://img.shields.io/pypi/pyversions/context-gen-cli.svg)](https://pypi.org/project/context-gen-cli/)
-[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
-
-> ⚡ **Fast, AST-powered Python CLI tool that scans any project, extracts architecture models, and generates structured LLM context (`agent.md`, `agent.json`, `agent.yaml`).**
-
----
-
-## 🌟 Highlights
-
-- **⚡ Short Command Alias (`ctx`)**: Type `ctx` anywhere in your terminal.
-- **100% Accurate Python Dependency Graphs**: Built using Python's native `ast` (Abstract Syntax Tree) module to resolve imports, relative packages, entry points, and utilities.
-- **📁 Clean Workspace Storage**: Everything (`agent.md`, `agent.json`, `agent.yaml`, `.context-gen.json`) is saved neatly inside `context/`.
-- **⚡ All-In-One Default Mode (`-d`)**: Auto-generates triple context formats in `context/` and runs a live auto-sync watcher in the background.
-- **`.gitignore` & Multi-Ignore Respect**: Automatically parses rules from `.gitignore`, `.npmignore`, `.dockerignore`, `.contextignore`, `.ignore`, and filters `.env*` secrets.
-- **Triple Format Output**: Generates Markdown (`agent.md`), MCP-compatible structured JSON (`agent.json`), and clean YAML (`agent.yaml`).
-- **🔄 Auto-Sync Watch Mode (`-w`)**: Monitors workspace changes and updates context files automatically on save.
-- **Configuration Parity**: Seamlessly reads `context/.context-gen.json` to maintain unified project settings with the Node.js edition.
-
----
-
-## 📦 Installation
-
-Install from PyPI using `pip` (or `pipx` / `uv`):
-
-```bash
-pip install context-gen-cli
-```
-
----
-
-## 🚀 Quick Start
-
-### 1. ⚡ All-In-One Default Mode (Recommended)
-Generates all formats in `context/` and starts the live auto-sync watcher in background:
-
-```bash
-ctx -d
-```
-
-### 2. Generate All Formats (Markdown, JSON, YAML)
-Scans the current directory and outputs `agent.md`, `agent.json`, and `agent.yaml` in `context/`:
-
-```bash
-ctx
-```
-
-### 3. Quick Refresh / Regenerate
-```bash
-ctx update
-```
-
-### 4. Custom Format & Output Destination
-```bash
-ctx update -f json
-ctx -o custom_docs/
-ctx -p /path/to/project
-```
-
-### 5. Watch Mode
-Keep context files fresh automatically on every file edit:
-
-```bash
-ctx -w
-```
-
----
-
-## 📖 CLI Reference
-
-| Flag / Command | Alias | Description |
-| :--- | :--- | :--- |
-| `ctx -d` | `ctx --default` | **⚡ All-in-One**: Generates context files and starts live auto-sync watcher |
-| `ctx -w` | `ctx --watch` | **👀 Watch Mode**: Auto-regenerates context on file changes |
-| `ctx -f <type>` | `ctx --format <type>` | **Format**: `md`, `json`, `yaml`, or `all` |
-| `ctx -o <path>` | `ctx --output <path>` | **Custom Output**: Output file/folder path |
-| `ctx -p <path>` | `ctx --project <path>` | **Target Directory**: Directory to analyze |
-| `ctx update` | — | **Refresh**: Regenerate context files |
-| `ctx --help` | — | View full help options |
-
----
-
-## 📄 License
-
-MIT © [yakkshit](https://github.com/yakkshit)
-

context_gen_cli-1.3.3/README.md

@@ -1,88 +0,0 @@
-# ⚡ context-gen-cli (`ctx`) — Python Edition
-
-[![PyPI version](https://img.shields.io/pypi/v/context-gen-cli.svg?color=3775a9)](https://pypi.org/project/context-gen-cli/)
-[![Python Versions](https://img.shields.io/pypi/pyversions/context-gen-cli.svg)](https://pypi.org/project/context-gen-cli/)
-[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
-
-> ⚡ **Fast, AST-powered Python CLI tool that scans any project, extracts architecture models, and generates structured LLM context (`agent.md`, `agent.json`, `agent.yaml`).**
-
----
-
-## 🌟 Highlights
-
-- **⚡ Short Command Alias (`ctx`)**: Type `ctx` anywhere in your terminal.
-- **100% Accurate Python Dependency Graphs**: Built using Python's native `ast` (Abstract Syntax Tree) module to resolve imports, relative packages, entry points, and utilities.
-- **📁 Clean Workspace Storage**: Everything (`agent.md`, `agent.json`, `agent.yaml`, `.context-gen.json`) is saved neatly inside `context/`.
-- **⚡ All-In-One Default Mode (`-d`)**: Auto-generates triple context formats in `context/` and runs a live auto-sync watcher in the background.
-- **`.gitignore` & Multi-Ignore Respect**: Automatically parses rules from `.gitignore`, `.npmignore`, `.dockerignore`, `.contextignore`, `.ignore`, and filters `.env*` secrets.
-- **Triple Format Output**: Generates Markdown (`agent.md`), MCP-compatible structured JSON (`agent.json`), and clean YAML (`agent.yaml`).
-- **🔄 Auto-Sync Watch Mode (`-w`)**: Monitors workspace changes and updates context files automatically on save.
-- **Configuration Parity**: Seamlessly reads `context/.context-gen.json` to maintain unified project settings with the Node.js edition.
-
----
-
-## 📦 Installation
-
-Install from PyPI using `pip` (or `pipx` / `uv`):
-
-```bash
-pip install context-gen-cli
-```
-
----
-
-## 🚀 Quick Start
-
-### 1. ⚡ All-In-One Default Mode (Recommended)
-Generates all formats in `context/` and starts the live auto-sync watcher in background:
-
-```bash
-ctx -d
-```
-
-### 2. Generate All Formats (Markdown, JSON, YAML)
-Scans the current directory and outputs `agent.md`, `agent.json`, and `agent.yaml` in `context/`:
-
-```bash
-ctx
-```
-
-### 3. Quick Refresh / Regenerate
-```bash
-ctx update
-```
-
-### 4. Custom Format & Output Destination
-```bash
-ctx update -f json
-ctx -o custom_docs/
-ctx -p /path/to/project
-```
-
-### 5. Watch Mode
-Keep context files fresh automatically on every file edit:
-
-```bash
-ctx -w
-```
-
----
-
-## 📖 CLI Reference
-
-| Flag / Command | Alias | Description |
-| :--- | :--- | :--- |
-| `ctx -d` | `ctx --default` | **⚡ All-in-One**: Generates context files and starts live auto-sync watcher |
-| `ctx -w` | `ctx --watch` | **👀 Watch Mode**: Auto-regenerates context on file changes |
-| `ctx -f <type>` | `ctx --format <type>` | **Format**: `md`, `json`, `yaml`, or `all` |
-| `ctx -o <path>` | `ctx --output <path>` | **Custom Output**: Output file/folder path |
-| `ctx -p <path>` | `ctx --project <path>` | **Target Directory**: Directory to analyze |
-| `ctx update` | — | **Refresh**: Regenerate context files |
-| `ctx --help` | — | View full help options |
-
----
-
-## 📄 License
-
-MIT © [yakkshit](https://github.com/yakkshit)
-

context_gen_cli-1.3.3/context_gen_cli.egg-info/PKG-INFO

@@ -1,115 +0,0 @@
-Metadata-Version: 2.4
-Name: context-gen-cli
-Version: 1.3.3
-Summary: A modern CLI tool that scans any project, builds an AST-based dependency graph, and generates structured LLM context (agent.md / agent.json).
-Author: yakkshit
-License-Expression: MIT
-Keywords: llm,context,agent,cli,code-analysis,ast,graph,mcp
-Classifier: Development Status :: 4 - Beta
-Classifier: Environment :: Console
-Classifier: Intended Audience :: Developers
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Topic :: Software Development :: Code Generators
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-Requires-Dist: typer[all]>=0.12.0
-Requires-Dist: rich>=13.7.0
-Requires-Dist: pathspec>=0.12.1
-Provides-Extra: dev
-Requires-Dist: pytest>=8.0.0; extra == "dev"
-Requires-Dist: build>=1.1.0; extra == "dev"
-Requires-Dist: twine>=5.0.0; extra == "dev"
-
-# ⚡ context-gen-cli (`ctx`) — Python Edition
-
-[![PyPI version](https://img.shields.io/pypi/v/context-gen-cli.svg?color=3775a9)](https://pypi.org/project/context-gen-cli/)
-[![Python Versions](https://img.shields.io/pypi/pyversions/context-gen-cli.svg)](https://pypi.org/project/context-gen-cli/)
-[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
-
-> ⚡ **Fast, AST-powered Python CLI tool that scans any project, extracts architecture models, and generates structured LLM context (`agent.md`, `agent.json`, `agent.yaml`).**
-
----
-
-## 🌟 Highlights
-
-- **⚡ Short Command Alias (`ctx`)**: Type `ctx` anywhere in your terminal.
-- **100% Accurate Python Dependency Graphs**: Built using Python's native `ast` (Abstract Syntax Tree) module to resolve imports, relative packages, entry points, and utilities.
-- **📁 Clean Workspace Storage**: Everything (`agent.md`, `agent.json`, `agent.yaml`, `.context-gen.json`) is saved neatly inside `context/`.
-- **⚡ All-In-One Default Mode (`-d`)**: Auto-generates triple context formats in `context/` and runs a live auto-sync watcher in the background.
-- **`.gitignore` & Multi-Ignore Respect**: Automatically parses rules from `.gitignore`, `.npmignore`, `.dockerignore`, `.contextignore`, `.ignore`, and filters `.env*` secrets.
-- **Triple Format Output**: Generates Markdown (`agent.md`), MCP-compatible structured JSON (`agent.json`), and clean YAML (`agent.yaml`).
-- **🔄 Auto-Sync Watch Mode (`-w`)**: Monitors workspace changes and updates context files automatically on save.
-- **Configuration Parity**: Seamlessly reads `context/.context-gen.json` to maintain unified project settings with the Node.js edition.
-
----
-
-## 📦 Installation
-
-Install from PyPI using `pip` (or `pipx` / `uv`):
-
-```bash
-pip install context-gen-cli
-```
-
----
-
-## 🚀 Quick Start
-
-### 1. ⚡ All-In-One Default Mode (Recommended)
-Generates all formats in `context/` and starts the live auto-sync watcher in background:
-
-```bash
-ctx -d
-```
-
-### 2. Generate All Formats (Markdown, JSON, YAML)
-Scans the current directory and outputs `agent.md`, `agent.json`, and `agent.yaml` in `context/`:
-
-```bash
-ctx
-```
-
-### 3. Quick Refresh / Regenerate
-```bash
-ctx update
-```
-
-### 4. Custom Format & Output Destination
-```bash
-ctx update -f json
-ctx -o custom_docs/
-ctx -p /path/to/project
-```
-
-### 5. Watch Mode
-Keep context files fresh automatically on every file edit:
-
-```bash
-ctx -w
-```
-
----
-
-## 📖 CLI Reference
-
-| Flag / Command | Alias | Description |
-| :--- | :--- | :--- |
-| `ctx -d` | `ctx --default` | **⚡ All-in-One**: Generates context files and starts live auto-sync watcher |
-| `ctx -w` | `ctx --watch` | **👀 Watch Mode**: Auto-regenerates context on file changes |
-| `ctx -f <type>` | `ctx --format <type>` | **Format**: `md`, `json`, `yaml`, or `all` |
-| `ctx -o <path>` | `ctx --output <path>` | **Custom Output**: Output file/folder path |
-| `ctx -p <path>` | `ctx --project <path>` | **Target Directory**: Directory to analyze |
-| `ctx update` | — | **Refresh**: Regenerate context files |
-| `ctx --help` | — | View full help options |
-
----
-
-## 📄 License
-
-MIT © [yakkshit](https://github.com/yakkshit)
-