Home
/
News
/
Show HN: FileKitty – Combine and label text files for LLM prompt contexts

Show HN: FileKitty – Combine and label text files for LLM prompt contexts

https://github.com/banagale/FileKitty

FileKitty

A simple file selection and concatenation tool.

Features

  • Select files from a directory
  • Concatenate selected files into a single file
  • Save the concatenated file to a directory
  • Copy file to clipboard

Good for

  • Concatenating files for use in a single file format
  • Pasting file contents into an LLM to provide context to a prompt

How to use it

  1. Open the app and click Open Files.
  2. Select the files you want to concatenate:
  3. Click Open and files will be added to the text area.
  4. Select, copy to clipboard, and paste into your prompt:

OR

  1. In MacOS Finder, find the files you want to concatenate
  2. Open the FileKitty app
  3. Drag and drop the files into the app
  4. Select, copy to clipboard, and paste into your prompt

Build

Prerequisites

  • Poetry is used to manage dependencies and build the app.
  • Refer to the Poetry documentation for installation instructions.

Build from source

poetry install
poetry run python setup.py py2app
  • App should show up in ./dist/FileKitty.app
  • Copy to Applications folder

Linting and Formatting

This project uses Ruff for linting and code formatting.

Run locally

make lint       # Check for lint issues
make format     # Format code

Or using poetry directly:

poetry run ruff check .
poetry run ruff format .

Contributing

Pre-commit hooks

This project uses pre-commit to enforce linting before each commit.

To set it up locally:

poetry install  # If not already done
pre-commit install
pre-commit run --all-files  # Optional: check everything right away

Continuous Integration

  • Linting: Enforced via GitHub Actions on every push and pull request. See .github/workflows/lint.yml.
  • Build Validation: Ensures the app builds correctly on macOS. See .github/workflows/build.yml.
{
  "by": "bredren",
  "descendants": 21,
  "id": 40226976,
  "kids": [
    40230373,
    40231132,
    40232792,
    40235036,
    40253694,
    40231422,
    40230233,
    40230855,
    40226992
  ],
  "score": 69,
  "time": 1714587003,
  "title": "Show HN: FileKitty – Combine and label text files for LLM prompt contexts",
  "type": "story",
  "url": "https://github.com/banagale/FileKitty"
}
{
  "author": "banagale",
  "date": null,
  "description": "GUI for selecting text files for concatenation and submission to LLMs - banagale/FileKitty",
  "image": "https://opengraph.githubassets.com/059582b3bf48082af7a5dfdac2ccacb64aa7cfef6971c356dd2d3d1c959a7933/banagale/FileKitty",
  "logo": "https://logo.clearbit.com/github.com",
  "publisher": "GitHub",
  "title": "GitHub - banagale/FileKitty: GUI for selecting text files for concatenation and submission to LLMs",
  "url": "https://github.com/banagale/FileKitty"
}
{
  "url": "https://github.com/banagale/FileKitty",
  "title": "GitHub - banagale/FileKitty: GUI for selecting text files for concatenation and submission to LLMs",
  "description": "FileKitty  A simple file selection and concatenation tool. Features  Select files from a directory Concatenate selected files into a single file Save the concatenated file to a directory Copy file to...",
  "links": [
    "https://github.com/banagale/FileKitty"
  ],
  "image": "https://opengraph.githubassets.com/059582b3bf48082af7a5dfdac2ccacb64aa7cfef6971c356dd2d3d1c959a7933/banagale/FileKitty",
  "content": "<div><article><p></p><h2>FileKitty</h2><a target=\"_blank\" href=\"https://github.com/banagale/FileKitty#filekitty\"></a><p></p>\n<a target=\"_blank\" href=\"https://private-user-images.githubusercontent.com/1409710/327196008-d7c68e71-5245-499b-8be9-3ca1f88adc1b.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NDM3MTE0NTYsIm5iZiI6MTc0MzcxMTE1NiwicGF0aCI6Ii8xNDA5NzEwLzMyNzE5NjAwOC1kN2M2OGU3MS01MjQ1LTQ5OWItOGJlOS0zY2ExZjg4YWRjMWIucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI1MDQwMyUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNTA0MDNUMjAxMjM2WiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9ZTY4NDVhNWQxZjE1NjAyZmNhMTljOWIwZDI0MTIwNWNjYzIxZDFkMDhkNTU5MzE3ZjlkZWNjMDBhNGYyYWE3NCZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QifQ.ttz_5PgwjXPu4cR4Ga74u1rYDJEeAl305uiKzpeoDSU\"><img src=\"https://private-user-images.githubusercontent.com/1409710/327196008-d7c68e71-5245-499b-8be9-3ca1f88adc1b.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NDM3MTE0NTYsIm5iZiI6MTc0MzcxMTE1NiwicGF0aCI6Ii8xNDA5NzEwLzMyNzE5NjAwOC1kN2M2OGU3MS01MjQ1LTQ5OWItOGJlOS0zY2ExZjg4YWRjMWIucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI1MDQwMyUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNTA0MDNUMjAxMjM2WiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9ZTY4NDVhNWQxZjE1NjAyZmNhMTljOWIwZDI0MTIwNWNjYzIxZDFkMDhkNTU5MzE3ZjlkZWNjMDBhNGYyYWE3NCZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QifQ.ttz_5PgwjXPu4cR4Ga74u1rYDJEeAl305uiKzpeoDSU\" /></a>\n<p>A simple file selection and concatenation tool.</p>\n<p></p><h2>Features</h2><a target=\"_blank\" href=\"https://github.com/banagale/FileKitty#features\"></a><p></p>\n<ul>\n<li>Select files from a directory</li>\n<li>Concatenate selected files into a single file</li>\n<li>Save the concatenated file to a directory</li>\n<li>Copy file to clipboard</li>\n</ul>\n<p></p><h2>Good for</h2><a target=\"_blank\" href=\"https://github.com/banagale/FileKitty#good-for\"></a><p></p>\n<ul>\n<li>Concatenating files for use in a single file format</li>\n<li>Pasting file contents into an LLM to provide context to a prompt</li>\n</ul>\n<p></p><h2>How to use it</h2><a target=\"_blank\" href=\"https://github.com/banagale/FileKitty#how-to-use-it\"></a><p></p>\n<ol>\n<li>Open the app and click <em><strong>Open Files</strong></em>.</li>\n<li>Select the files you want to concatenate:<br />\n<a target=\"_blank\" href=\"https://private-user-images.githubusercontent.com/1409710/354033702-5596d32e-52b3-4791-90eb-32ba0def3162.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NDM3MTE0NTYsIm5iZiI6MTc0MzcxMTE1NiwicGF0aCI6Ii8xNDA5NzEwLzM1NDAzMzcwMi01NTk2ZDMyZS01MmIzLTQ3OTEtOTBlYi0zMmJhMGRlZjMxNjIucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI1MDQwMyUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNTA0MDNUMjAxMjM2WiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9MGNkYzkyYTVjOTVhNWY3ZTkyZjljYzliMjBiN2FhZTIyMWQ0NDdlYzE3NDRlZjQ0YzdjMzA1MDI4ZjA2MTYyYSZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QifQ.yVlUCyJ6xwKBivW4UKUb1PB6hyQsbqYj1UABFpLvo_I\"><img src=\"https://private-user-images.githubusercontent.com/1409710/354033702-5596d32e-52b3-4791-90eb-32ba0def3162.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NDM3MTE0NTYsIm5iZiI6MTc0MzcxMTE1NiwicGF0aCI6Ii8xNDA5NzEwLzM1NDAzMzcwMi01NTk2ZDMyZS01MmIzLTQ3OTEtOTBlYi0zMmJhMGRlZjMxNjIucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI1MDQwMyUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNTA0MDNUMjAxMjM2WiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9MGNkYzkyYTVjOTVhNWY3ZTkyZjljYzliMjBiN2FhZTIyMWQ0NDdlYzE3NDRlZjQ0YzdjMzA1MDI4ZjA2MTYyYSZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QifQ.yVlUCyJ6xwKBivW4UKUb1PB6hyQsbqYj1UABFpLvo_I\" /></a></li>\n<li>Click <em><strong>Open</strong></em> and files will be added to the text area.</li>\n<li>Select, copy to clipboard, and paste into your prompt:<br />\n<a target=\"_blank\" href=\"https://private-user-images.githubusercontent.com/1409710/354033706-d5a97ee1-4981-4222-bb1f-3993bff9adcb.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NDM3MTE0NTYsIm5iZiI6MTc0MzcxMTE1NiwicGF0aCI6Ii8xNDA5NzEwLzM1NDAzMzcwNi1kNWE5N2VlMS00OTgxLTQyMjItYmIxZi0zOTkzYmZmOWFkY2IucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI1MDQwMyUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNTA0MDNUMjAxMjM2WiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9OGIzNTQ0ZWNjOTE3NDdiNWQxZjA3ZjMyOTc3OWVmMGQ0ZmJmMjY5ZGUwNTM4NTIyNTQwYTQ2NmRjZGZlZmZjYiZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QifQ.c6dsVZ6iGDtspslIGODmt9guTNTw3G4FULA5mOaEQKo\"><img src=\"https://private-user-images.githubusercontent.com/1409710/354033706-d5a97ee1-4981-4222-bb1f-3993bff9adcb.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NDM3MTE0NTYsIm5iZiI6MTc0MzcxMTE1NiwicGF0aCI6Ii8xNDA5NzEwLzM1NDAzMzcwNi1kNWE5N2VlMS00OTgxLTQyMjItYmIxZi0zOTkzYmZmOWFkY2IucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI1MDQwMyUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNTA0MDNUMjAxMjM2WiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9OGIzNTQ0ZWNjOTE3NDdiNWQxZjA3ZjMyOTc3OWVmMGQ0ZmJmMjY5ZGUwNTM4NTIyNTQwYTQ2NmRjZGZlZmZjYiZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QifQ.c6dsVZ6iGDtspslIGODmt9guTNTw3G4FULA5mOaEQKo\" /></a></li>\n</ol>\n<p><strong>OR</strong></p>\n<ol>\n<li>In MacOS Finder, find the files you want to concatenate</li>\n<li>Open the FileKitty app</li>\n<li>Drag and drop the files into the app</li>\n<li>Select, copy to clipboard, and paste into your prompt</li>\n</ol>\n<p></p><h2>Build</h2><a target=\"_blank\" href=\"https://github.com/banagale/FileKitty#build\"></a><p></p>\n<p></p><h3>Prerequisites</h3><a target=\"_blank\" href=\"https://github.com/banagale/FileKitty#prerequisites\"></a><p></p>\n<ul>\n<li>Poetry is used to manage dependencies and build the app.</li>\n<li>Refer to the <a target=\"_blank\" href=\"https://python-poetry.org/docs/\">Poetry documentation</a> for installation instructions.</li>\n</ul>\n<p></p><h3>Build from source</h3><a target=\"_blank\" href=\"https://github.com/banagale/FileKitty#build-from-source\"></a><p></p>\n<div><pre>poetry install\npoetry run python setup.py py2app</pre></div>\n<ul>\n<li>App should show up in <code>./dist/FileKitty.app</code></li>\n<li>Copy to <code>Applications</code> folder</li>\n</ul>\n<p></p><h2>Linting and Formatting</h2><a target=\"_blank\" href=\"https://github.com/banagale/FileKitty#linting-and-formatting\"></a><p></p>\n<p>This project uses <a target=\"_blank\" href=\"https://docs.astral.sh/ruff/\">Ruff</a> for linting and code formatting.</p>\n<p></p><h3>Run locally</h3><a target=\"_blank\" href=\"https://github.com/banagale/FileKitty#run-locally\"></a><p></p>\n<div><pre>make lint       <span><span>#</span> Check for lint issues</span>\nmake format     <span><span>#</span> Format code</span></pre></div>\n<p>Or using poetry directly:</p>\n<div><pre>poetry run ruff check <span>.</span>\npoetry run ruff format <span>.</span></pre></div>\n<p></p><h2>Contributing</h2><a target=\"_blank\" href=\"https://github.com/banagale/FileKitty#contributing\"></a><p></p>\n<p></p><h3>Pre-commit hooks</h3><a target=\"_blank\" href=\"https://github.com/banagale/FileKitty#pre-commit-hooks\"></a><p></p>\n<p>This project uses <a target=\"_blank\" href=\"https://pre-commit.com/\">pre-commit</a> to enforce linting before each commit.</p>\n<p>To set it up locally:</p>\n<div><pre>poetry install  <span><span>#</span> If not already done</span>\npre-commit install\npre-commit run --all-files  <span><span>#</span> Optional: check everything right away</span></pre></div>\n<p></p><h2>Continuous Integration</h2><a target=\"_blank\" href=\"https://github.com/banagale/FileKitty#continuous-integration\"></a><p></p>\n<ul>\n<li><strong>Linting</strong>: Enforced via GitHub Actions on every push and pull request. See <code>.github/workflows/lint.yml</code>.</li>\n<li><strong>Build Validation</strong>: Ensures the app builds correctly on macOS. See <code>.github/workflows/build.yml</code>.</li>\n</ul>\n</article></div>",
  "author": "",
  "favicon": "https://github.githubassets.com/favicons/favicon.svg",
  "source": "github.com",
  "published": "",
  "ttr": 54,
  "type": "object"
}