ctxcraft

Generate structured project context for AI coding assistants in seconds.

ctxcraft is a lightweight Node.js CLI that scans your project, understands its structure, analyzes dependencies, and generates AI-ready project context. Instead of manually explaining your codebase to an LLM, simply run a command and provide the generated context.

It is designed for developers using ChatGPT, Claude, Gemini, Grok, and other coding assistants.

✨ Features

• 📁 Generate complete project context
• 🌳 Project directory tree generation
• 📄 Includes source code of relevant files
• 🔍 Dependency analysis
• 🔗 Import relationship mapping
• 🌐 API route detection
• ⚡ Live Architecture Dashboard
• 📡 Real-time Frontend & Backend API Tracker
• 📝 Generate context only for changed Git files
• 🐞 Debug a file with its direct dependencies
• 🔄 Workflow dependency analysis
• 📋 Copy generated context directly to clipboard
• 💾 Save context as Markdown
• 🚫 Respects .gitignore automatically
• ⚙️ Configured for modern JavaScript/TypeScript projects

📦 Installation

npm install -g ctxcraft

🚀 Quick Start

Generate complete project context:

ctx

Copy context directly to clipboard:

ctx --copy

Save context to a Markdown file:

ctx --output

🛠 Commands

| Command | Description | |---------|-------------| | ctx | Generate complete project context | | ctx --copy | Copy context to clipboard | | ctx --output | Save context as Markdown | | ctx --changed | Generate context for changed Git files | | ctx --debug <file> | Generate debug context for a specific file | | ctx --workflow <file> | Generate complete workflow dependency context | | ctx --architecture | Launch interactive architecture dashboard |

🏗 Architecture Dashboard

The Architecture Dashboard provides an interactive visualization of your project.

Features include:

• Dependency graph
• Import relationships
• API route mapping
• Live frontend requests
• Live backend requests
• Request timeline
• File explorer
• Open files directly in VS Code

📁 Example

ctx --architecture

Then open:

http://localhost:4577

💡 Use Cases

• Explain large codebases to AI
• Debug complex projects
• Share project context with teammates
• Analyze architecture
• Track frontend and backend requests
• Generate AI prompts automatically
• Understand project workflows

📋 Requirements

• Node.js 18+
• Git (for --changed)
• VS Code (optional, for opening files)

🤝 Contributing

Contributions, feature requests, and bug reports are welcome.

📄 License

MIT License

👨‍💻 Author

Darshan Ningappa Nandagavi

GitHub: https://github.com/Darshannandagavi

If you find this project useful, consider giving it a ⭐ on GitHub.