llmcat

Fast and flexible tool for copying files to large language models from command-line, supporting fuzzy search, multi-file selection and respecting .gitignore rules.

# Copy specific file
$ llmcat path/to/file.txt

# Copy directory
$ llmcat ./src/

# Interactive mode (opens fuzzy finder)
$ llmcat

Output format:

# Directory: src/state

[file tree]

## File: src/state/config.ts
---
[file contents]

See also: Interactive Demo | Blog

Install

# Download the script
curl -o llmcat https://raw.githubusercontent.com/azer/llmcat/main/llmcat

# Make it executable
chmod +x llmcat

# Move to your PATH
sudo mv llmcat /usr/local/bin/

Required for interactive mode:

• fzf
• bat

Usage

Interactive

When no path provided, llmcat opens fzf where you can search and select files by just pressing tab key.

Keybindings:

• tab: Select file (moves up after selection)
• shift-tab: Unselect file
• ctrl-/: Toggle preview
• ctrl-d: Directory mode
• ctrl-f: File mode
• enter: Confirm
• esc: Exit

Example:

Search and select files directories in a Phoenix project:

Command-line

# Copy a single file
$ llmcat src/main.rs

# Copy directory
$ llmcat src/

# Ignore specific files
$ llmcat -i "*.log" ./src/

# Print output while copying
$ llmcat -p file.txt

# Print only the directory tree
$ llmcat -t ./src/

Manual

llmcat - Prepare files and directories for LLM consumption

Usage: llmcat [options] [path]
       llmcat (interactive mode with fzf)

Options:
    -h, --help              Show this help message
    -i, --ignore PATTERN    Additional ignore patterns (grep -E format)
    -v, --version          Show version
    -t, --tree-only        Only output directory tree
    -q, --quiet            Silent mode (only copy to clipboard)
    -p, --print            Print copied files/content (default: quiet)
    --debug                Enable debug output

Interactive Mode (fzf):
    tab          - Select/mark multiple files
    shift-tab    - Unselect/unmark file
    ctrl-/       - Toggle preview window
    ctrl-d       - Select directory mode
    ctrl-f       - Select file mode
    enter        - Confirm selection(s)
    esc          - Exit

Examples:
    # Interactive file selection
    llmcat

    # Process specific file
    llmcat path/to/file.txt

    # Process directory with custom ignore
    llmcat -i "*.log|*.tmp" ./src/

    # Print content while copying
    llmcat -p ./src/file.txt

Features:
    - Interactive fuzzy finder with file preview
    - Auto-copies output to clipboard
    - Respects .gitignore
    - Directory tree visualization
    - Multi-file selection
    - Cross-platform (Linux/OSX)