Transform entire codebases into AI-ready context. Perfect for LLM prompting, code documentation, and project analysis.
npm install code-contextifyTransform your entire codebase into AI-ready context in seconds



> "Turn thousands of files into one perfect prompt for your AI assistant"
---
Fed up with copying and pasting files into ChatGPT? Struggling to give Claude the full picture of your project? code-contextify solves this by creating a single, comprehensive text file containing your entire project structure and content - perfectly formatted for AI consumption.
---
``bashInstall globally
npm install -g code-contextify
---
๐ ๏ธ Installation
$3
- Node.js >= 14.0.0$3
`bash
Global installation (recommended)
npm install -g code-contextifyOr use npx without installing
npx code-contextify /path/to/project
`---
๐ฎ Usage Guide
$3
`bash
Convert current directory
code-contextifyConvert specific directory
code-contextify /path/to/your/projectCustom output filename in current directory
code-contextify my-project-context.txt
`$3
`bash
Exclude specific folders from the current directory
code-contextify --filter "node_modules,dist,build"Exclude files with specific patterns
code-contextify --filter "test,__mocks__,*.spec.js"Complex filtering with paths
code-contextify --filter "src/tests,docs,temp,*.log"
`$3
#### 1. Prepare for AI Code Review
`bash
code-contextify review-context.txt --filter "node_modules,dist,*.min.js"
`#### 2. Share Project Context with Team
`bash
code-contextify /path/to/project team-brief.txt
`#### 3. Create Documentation Context
`bash
code-contextify docs-context.txt --filter "tests,__tests__,.test."
`#### 4. Debug with AI Assistant
`bash
code-contextify debug-context.txt --filter "node_modules,*.log,temp"
`---
๐ What's In The Output?
Your generated context file includes:
$3
`
Project Statistics:
Total Files: 42
Total Size: 1.25 MB`$3
`
Folder Structure (Tree)
=====================
Legend: โ = Excluded
โโโ src/
โ โโโ components/
โ โ โโโ Header.js
โ โ โโโ Footer.js
โ โโโ utils/
โโโ node_modules/ โ
โโโ package-lock.json (123.45 KB) โ
โโโ README.md (2.34 KB)
`$3
`
src/components/Header.js
------------------------
import React from 'react';
// ... actual file content
`---
๐ง AI Prompting Tips
$3
`
Here's the complete context of my project.
Please help me [your specific request]:[Generated context content here]
`$3
- "Explain this codebase to me"
- "Find potential bugs in this project"
- "Suggest improvements to this architecture"
- "Write documentation for this project"
- "Help me understand how these components work together"---
โ๏ธ How It Works
$3
โ
Automatically Excludes:
- Binary files (images, executables, etc.)
- Configuration files (package-lock.json, .env)
- Common directories (node_modules, .git)
- Git-ignored files and patterns
- Media files (videos, audio, etc.)โ
Intelligently Includes:
- Source code files
- Documentation
- Configuration files you actually need
- Text-based assets
$3
Automatically identifies:
- JavaScript/TypeScript
- React/Vue/Angular
- Python
- And many more!---
๐ฏ Pro Tips
$3
`bash
For models with smaller context windows
code-contextify --filter "tests,docs,examples,*.md"For models with large context windows
code-contextify # Include everything!
`$3
`bash
Timestamped context files
code-contextify project_$(date +%Y%m%d_%H%M%S).txt
`$3
`bash
Only include source code
code-contextify --filter "tests,docs,.md,.json,*.yml"Only include tests
code-contextify tests-context.txt --filter "src,docs,*.md"
`---
๐ก๏ธ Security & Privacy
- Local Processing - Your code never leaves your machine
- Respects .gitignore - Doesn't include ignored files
- No Telemetry - Zero data collection
- Open Source - Audit the code yourself
---
๐ค Contributing
Contributions welcome! Here's how to get started:
1. Fork the repository
2. Create your feature branch:
git checkout -b feature/AmazingFeature
3. Commit your changes: git commit -m 'Add some AmazingFeature'
4. Push to the branch: git push origin feature/AmazingFeature`---
This project is licensed under MIT with Commons Clause - see the LICENSE file for details.
Commercial use requires permission.
---
Nidal Siddique Oritro
- Website: iam.ioritro.com
- GitHub: @ElvinEga
Built with โค๏ธ for developers working with AI
---
Need help?
- ๐ Report an issue
- ๐ฌ Join discussions
- ๐ง Contact the author
---
If this tool saves you time:
- โญ Star this repository
- ๐ฆ Tweet about it
- ๐ค Recommend to fellow developers
- ๐ Sponsor the project
---
"Turn your codebase into conversation - one context file at a time"