Repomix Runner

April 9, 2025 ยท View on GitHub

You can support this project by giving a star on GitHub ! โญ๏ธ ๐Ÿ”ญ ๐Ÿ™

GitHub Version Installs License: MIT

Repomix Runner is a VSCode extension that allows you to easily bundle files into a single output for AI processing. It uses the great Repomix tool.

โœจ Features

  • ๐Ÿ“ Pack your selection of files into a single output for AI processing.
  • ๐Ÿ“ฆ Create reusable bundles for parts of your project you frequently package.
  • ๐Ÿ“Ž Two copy modes for clipboard: content or file. -> you can paste a whole file not just content.
  • ๐Ÿ—‘๏ธ Optional output file cleanup. -> But you still have it in clipboard! ๐Ÿ˜€
  • ๐Ÿ› ๏ธ Easy settings in vscode and/or support a repomix.config.json file.

๐Ÿ“– Usage

With the REPOMIX custom view, all is in one place ๐ŸŽ‰ :

(keep in mind the output-file is also in your clipboard).

โฌ‡๏ธ - Run Repomix on selection

https://github.com/user-attachments/assets/21272ff9-0bf1-48dc-a583-34355bb35ced

โฌ‡๏ธ - Create a bundle with custom config

https://github.com/user-attachments/assets/134e7fdf-1e98-429f-b16c-a76e99dc761f

โš™๏ธ Commands

Open the palette with Cmd+Shift+P or Ctrl+Shift+P then:

  • Repomix Run to run repomix on the root folder of your project
  • Repomix Run On Open Files to run repomix on the open files in the workspace
  • Repomix Create New Bundle to create a new bundle
  • Repomix Run Bundle to select a bundle to run
  • Repomix Edit Bundle to edit bundle name, config file, description and tags
  • Repomix Refresh Bundles to refresh the bundles list if you mannually change the .repomix/bundles.json file
  • Repomix Settings for a quick access to the settings
  • Repomix Output to open the repomix output channel

๐Ÿš€ Installation

  1. Open VS Code
  2. Press Cmd+P (macOS) or Ctrl+P (Windows/Linux)
  3. Type ext install DorianMassoulier.repomix-runner
  4. Press Enter

๐Ÿ› ๏ธ Configuration

  • The extension support the repomix.config.json file in your project root folder, it will override the settings in the extension. Except for the runner settings.

๐Ÿ“‹ Requirements

  • VS Code 1.93.0 or higher
  • Node.js and npm installed (for npx)
  • macOS for file copy mode
  • xclip installed for file copy mode on linux

โš ๏ธ Known Issues

  • File copy mode is only available on macOS and linux (you need to install xclip for file copy mode on linux)

๐Ÿค Contributing

Any feedback, issue or feature request is much appreciated !

๐Ÿ“ License

This project is licensed under the MIT License - see the LICENSE.md file for details.