kopipasta 0.43.0

A CLI tool to generate prompts with project structure and file contents

kopipasta

kopipasta bridges the gap between your local file system and LLM context windows.

A CLI tool for taking full, transparent control of your prompt. No black boxes.

• An LLM told me that "kopi" means Coffee in some languages... and a Diffusion model then made this delicious soup.

The Philosophy: You Control the Context

Many AI coding assistants automatically find what they think is relevant context. This is a black box. When the LLM gives a bad answer, you can't debug it because you don't know what context it was actually given.

kopipasta is the opposite. I built it for myself on the principle of explicit context control. You are in the driver's seat. You decide exactly what files, functions, and snippets go into the prompt. This transparency is the key to getting reliable, debuggable results from an LLM.

It's a "smart copy" command for your project, not a magic wand.

How It Works

The workflow is a fast, iterative cycle:

1. Context: Run kopipasta to select files and define your task.
2. Generate: Paste the prompt into your LLM (ChatGPT, Claude, etc.).
3. Patch: Press p in kopipasta and paste the LLM's response to apply changes locally.
4. Iterate: Review with git diff, then repeat for the next step.

Installation

# Using pipx (recommended for CLI tools)
pipx install kopipasta

# Or using standard pip
pip install kopipasta

Usage

kopipasta has two main modes: creating prompts and applying patches.

Creating a Prompt

kopipasta [options] [files_or_directories_or_urls...]

Arguments:

• [files_or_directories_or_urls...]: One or more paths to files, directories, or web URLs to use as the starting point for your context.

Options:

• -t TASK, --task TASK: Provide the task description directly on the command line, skipping the editor.

Applying Patches

kopipasta automatically injects strict instructions into your prompt, teaching the LLM how to format code for this tool. kopipasta can apply changes suggested by an LLM directly to your codebase, assuming you are in a Git repository.

1. Press p in the file selector.
2. Paste the entire markdown response from your LLM.
3. The tool robustly detects code blocks, handles indentation quirks, and applies changes (full files or diffs).
4. If a patch fails, the tool provides diagnostic feedback telling you exactly why (e.g., missing headers).
5. Always review changes with git diff before committing.

Key Features

• Total Context Control: Interactively select files, directories, or snippets. You see everything that goes into the prompt.
• Smart Dependency Analysis: Press d on a Python or TypeScript/JavaScript file, and kopipasta will scan imports to find and add related local files to your context automatically.
• Robust Code Patcher: Applies LLM suggestions directly. Handles indentation, various comment styles (#, //, <!--), and multiple files per block.
• Built-in Search: Press g to grep for text patterns inside directories to find relevant files.
• Transparent & Explicit: No hidden RAG. You know exactly what's in the prompt because you built it. This makes debugging LLM failures possible.
• Web-Aware: Pulls in content directly from URLs—perfect for API documentation.
• Safety First:
  • Automatically respects your .gitignore rules.
  • Detects if you're about to include secrets from a .env file and asks what to do.
• Context-Aware: Keeps a running total of the prompt size (in characters and estimated tokens) so you don't overload the LLM's context window.
• Developer-Friendly:
  • Provides a rich, interactive prompt for writing task descriptions in terminal.
  • Copies the final prompt directly to your clipboard.
  • Provides syntax highlighting during chunk selection.

Interactive Controls

Key	Action
Space	Toggle file/directory selection
s	Toggle Snippet Mode (include only the first 50 lines)
d	Analyze Dependencies (find and add imported files)
g	Grep (search text in directory)
a	Add all files in directory
p	Apply Patch (paste LLM response)
r	Reuse selection from previous run
Enter	Expand/Collapse directory
q	Quit and finalize selection

A Real-World Example

I had a bug where my setup.py didn't include all the dependencies from requirements.txt.

1. I ran kopipasta -t "Update setup.py to read dependencies dynamically from requirements.txt" setup.py requirements.txt.
2. The tool confirmed the inclusion of both files and copied the complete prompt to my clipboard.
3. I pasted the prompt into my LLM chat window.
4. I copied the LLM's response (which included a modified setup.py in a markdown code block).
5. Inside kopipasta, I pressed p, pasted the response, and my local setup.py was updated.
6. I ran git diff to review the changes, then tested and committed.

No manual file reading, no clumsy copy-pasting, just a clean, context-rich prompt that I had full control over, and a seamless way to apply the results.