⚡ context-gen-cli (ctx) — Python Edition

⚡ 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):

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:

ctx -d

2. Generate All Formats (Markdown, JSON, YAML)

Scans the current directory and outputs agent.md, agent.json, and agent.yaml in context/:

ctx

3. Quick Refresh / Regenerate

ctx update

4. Custom Format & Output Destination

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:

ctx -w

📖 CLI Reference

📄 License

MIT © yakkshit