Skip to content

omar-hanafy/context_collector

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

72 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Context Collector

Context Collector Icon

License: MIT Platforms: macOS, Windows Dart SDK: >=3.0.0 <4.0.0 Flutter Last Commit GitHub Stars

Combine files & folders into a clean, AI-ready text bundle — powered by Flutter and Monaco Editor.

Context Collector is a lightweight desktop app (macOS • Windows) that lets you drag-and-drop source files, logs, configurations, or entire directories and outputs a neatly annotated document. Every chunk includes full file paths and metadata, making it ideal for working smoothly with AIs and LLMs without the hassle of manual copying and pasting.

Context Collector main window (dark theme)


🖥️ Platform Support

Platform Status Requirements
macOS ✅ Fully Supported macOS 10.13 or later
Windows ✅ Fully Supported Windows 10/11 with WebView2 Runtime

Note for Windows users: The app will prompt you to install WebView2 Runtime if it's not already installed. This is required for the Monaco editor integration.


🖥️ Typical Workflow

Editor view with combined content

  1. Drag & drop files or directories onto the drop zone.
  2. Toggle files to include/exclude from your combined context.
  3. Review & edit the assembled content inside the Monaco editor.
  4. Copy your merged content instantly.

Tip: Head to Settings → Extensions to exclude noisy logs or add specialized formats (.bert, .fish, etc.).


✨ Key Features

Capability What it means for you
Drag‑and‑drop everything Drop individual files or entire directories; nested files are discovered automatically.
250+ extensions supported Built‑in support for code, logs, configs, docs, data & more — easily add your own custom extensions.
Monaco editor inside Flutter Enjoy syntax highlighting, multi‑cursor editing, Vim/IntelliJ/VS Code keybindings, themes, and word-wrap.
Live statistics Line, character, cursor, and selection counts update in real-time—ideal for managing prompt token budgets.
Quick copy Copy merged context to clipboard with one click.
Extensible APIs Integrate the toolkit into your Flutter apps or automate assembly using Dart scripts.

Sidepanel expanded with file details


🚀 Getting Started

Option 1: Pre-built app (Recommended)

  1. Go to Releases and download the latest:
    • macOS: .dmg file
    • Windows: .exe installer
  2. Install and run—zero setup required.

Option 2: Build from source (Flutter 3.22+)

git clone https://github.com/omar-hanafy/context_collector.git
cd context_collector
flutter pub get

# Enable desktop support if not already enabled
flutter config --enable-macos-desktop --enable-windows-desktop

# Run or build
flutter run  # or flutter build macos / windows

🛠️ Configuration Highlights

  • Editor presets: Beginner, Developer, Power User, Accessibility.
  • Keybinding presets: VS Code (default), IntelliJ/WebStorm, Vim, Emacs—or load your custom JSON map.
  • Theme support: Comes bundled with VS Light/Dark, One Dark Pro, and HC Black. Easily import additional VS Code themes.
  • Customizable extension catalog: Quickly enable or disable formats or add custom file-to-category mappings.

Context Collector Settings
General application settings.


Context Collector Editor Settings
Editor specific settings and theme selection.


📌 Why Context Collector?

Problem Context Collector's solution
"ChatGPT keeps asking 'where's that widget defined?'" Bundles related Dart, Swift, HTML, etc., files into one cohesive, prompt-ready bundle.
"Sharing repro steps means pasting multiple logs." Drag your entire logs directory; text files merge automatically and binaries are skipped.
"Losing track of copied files." Path headers and file-size indicators clearly organize your context.
"Long prompts blow up my token budget." Quickly toggle files on/off or collapse content to control token usage.

⚠️ Known Limitations

Drag & Drop

Application Limitation Workaround
JetBrains IDEs Multi-file selection only drops the first file Drop files one at a time or use finder/explorer
VS Code Dropped files show only the filename The full content is still processed correctly

🔮 Roadmap

  • Add Windows support. Done!
  • 📟 Export as file. Done!
  • 📂 Add tree view. Done!
  • 🗂️ Import from GitHub repos.
  • 🌐 Add web support.
  • 🤖 AI summarization of context.

Have an idea? Open an issue or join our Discord!


🤝 Contributing

Contributions are welcome! Whether you're fixing bugs, adding features, or improving documentation, your help is appreciated.


☕ Support

If you find this project helpful or valuable, please consider supporting its development:

Buy Me A Coffee

Your support helps maintain and improve Context Collector. Thank you!


📄 License

Context Collector is open-source software licensed under the MIT License—see LICENSE. © 2025 Omar Hanafy & community contributors.


🙏 Acknowledgements

Context Collector is built with:

  • Flutter & Dart - The cross-platform framework powering this app
  • Monaco Editor - Microsoft's powerful code editor integrated via webview
  • Open Source Community - Special thanks to all contributors and the maintainers of our dependencies

📦 For a complete list of dependencies, see pubspec.yaml

A heartfelt thank you to everyone who stars the repository, contributes code, reports issues, or offers feedback. Your support is invaluable! ❤️

About

Context Collector For LLMs

Resources

License

Stars

Watchers

Forks

Sponsor this project

Packages

No packages published

Contributors 2

  •  
  •