Skip to content

Datvex/FileCLI

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

20 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

FileCLI

English | Русский

Python Platform License

An interactive terminal tool that merges your project files into a single document, ready to paste into any LLM context window.

What is FileCLI?

When working with AI coding assistants (Claude, GPT, Gemini, etc.), you often need to share your codebase as context. FileCLI solves this: point it at a folder, pick the files you want, and get a clean merged .txt in seconds.

python merge_files.py

Key capabilities:

  • Navigate your project with a keyboard driven TUI, no dependencies required
  • Select or deselect individual files; FileCLI remembers your choices per directory
  • Drag and drop folders or files directly into the terminal (Windows, Linux, macOS, Termux)
  • Skips binary files, build artifacts, and node_modules automatically
  • Supports English, Russian, and Chinese interfaces

Installation

FileCLI requires no third party packages, just Python 3.8 or later.

Clone and run:

git clone https://github.com/Datvex/FileCLI.git
cd FileCLI
python merge_files.py

Or download the script directly:

curl -O https://raw.githubusercontent.com/Datvex/FileCLI/main/merge_files.py
python merge_files.py
Platform Supported
Windows 10/11 yes
Linux yes
macOS yes
Termux yes

Usage

  1. Launch the script.
  2. Press 1 to start, then enter a folder path or drag and drop it into the terminal.
  3. Toggle files on/off by typing their numbers. Press 0 to confirm.
  4. Find the merged .txt file in your Downloads folder (or a custom path from Settings).

The output file is formatted with clear separators between files, so any LLM can parse it easily.

Settings

Press 2 from the main menu to open Settings:

  • Output path — change where merged files are saved
  • Language — switch between English, Russian, and Chinese

Settings are saved automatically across sessions.

License

GPL3.0

About

Merge selected project files into a single .txt for LLM context (ChatGPT, Claude, Gemini). Zero dependencies, Drag & Drop, remembers your file selection

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages