Gptree

To get truly helpful responses from a Large Language Model (LLM) for your coding projects, you need to provide it with the right context. gptree is a powerful utility designed for developers that automates this entire process. It intelligently combines your project files into a single, perfectly formatted text output, ready for any LLM prompt, so you can get better assistance, faster.

Key Features

🌳 Intelligent Context Curation gptree generates a clean directory tree structure and appends the full contents of your selected source files into one cohesive block of text. This provides the LLM with a complete, easy-to-understand view of your project's architecture and code, leading to far more accurate and relevant assistance for debugging, refactoring, or feature development.

🎛️ Granular and Interactive Control You have complete control over what context is included. gptree automatically respects your .gitignore file and smartly excludes common noise like .git or __pycache__. For fine-tuned selections, you can use the interactive mode (-i) to visually select files with your arrow keys or define precise include/exclude rules via CLI flags or configuration files.

🖥️ Dual Interface: Powerful CLI & Intuitive GUI Work the way you want. gptree offers both a fast, scriptable Command-Line Interface (CLI) for power users and automation, and a beautiful, lightweight Graphical User Interface (GUI) for those who prefer a visual approach. The GUI is built with Rust and Tauri, ensuring it's incredibly fast and efficient on macOS, Windows, and Linux.

⚙️ Flexible Configuration & Safeguards Set your preferences once and forget them. gptree supports both a global ~/.gptreerc file for your default settings and project-specific .gptree_config files for custom overrides. To protect you from generating excessively large prompts, a built-in "Safe Mode" prevents the tool from combining too many files or exceeding a reasonable size limit, a feature you can disable when needed.

How gptree Solves Your Problems

• Debugging a Complex Issue: You're facing a bug that involves interactions between a model, a service, and a controller. Instead of manually opening each file and pasting its contents, you run gptree -i. In seconds, you select the three relevant files, and the combined context is copied directly to your clipboard. You paste it into your LLM and get targeted debugging advice immediately.

• Onboarding to a New Feature: You need to add a new API endpoint and want the LLM's help to ensure you follow existing patterns. You run gptree --previous to use a saved configuration that includes key files like the router, existing controllers, and utility functions. This gives the LLM all the necessary background to provide high-quality, consistent code suggestions for the new feature.

Why Choose gptree?

Unmatched Workflow Efficiency gptree eliminates the tedious, error-prone task of manually gathering and formatting code for an LLM. What used to take minutes of clicking, copying, and pasting now takes a single command or a few clicks. This allows you to stay focused on solving the problem, not preparing the prompt.

A Tool for Every Developer With both a robust CLI and a polished GUI, gptree meets you where you are. Automate context generation in your scripts with the CLI, or visually explore and select files with the intuitive desktop app. This dual offering makes gptree a uniquely versatile and accessible tool for any developer's toolkit.

Conclusion

gptree is the essential bridge between your local codebase and the power of Large Language Models. By removing the friction of context gathering, it enables you to leverage AI assistance with greater speed, precision, and efficiency. Stop wasting time with manual copy-pasting and start getting better answers from your AI coding partner.

Explore gptree and accelerate your development workflow today!

FAQ

1. What's the practical difference between the CLI and the GUI? The CLI is ideal for developers who live in the terminal and for automation. You can integrate it into scripts, chain it with other commands, and use flags for precise, repeatable operations. The GUI is perfect for users who prefer a visual approach, allowing you to browse your file tree, click to select files and folders, and see a live preview of the generated output.

2. How does gptree decide which files to ignore? gptree uses a clear hierarchy. By default, it automatically respects the rules in your project's .gitignore file. It also has a built-in list of common patterns to ignore (e.g., .git, .vscode, __pycache__). You can override all of this with CLI flags (--include-file-types, --exclude-file-types, --ignore-gitignore) or by defining rules in your configuration files for ultimate control.

3. Is there a limit to how much context I can generate? Yes, by default. "Safe Mode" is enabled to prevent you from accidentally creating an output file that is too large for most LLM context windows. It limits the total file count (default: 30) and combined size (default: ~100,000 bytes). If you are confident you need a larger context, you can easily disable this protection with the --disable-safe-mode flag.