[![Build Status](https://cicd.apps.glenux.net/api/badges/glenux/code-preloader/status.svg)](https://cicd.apps.glenux.net/glenux/code-preloader) ![License LGPL3.0-or-later](https://img.shields.io/badge/license-LGPL3.0--or--later-blue.svg) [![Donate on patreon](https://img.shields.io/badge/patreon-donate-orange.svg)](https://patreon.com/glenux) # Code-Preloader for ChatGPT Code-Preloader is a specialized tool designed to streamline the process of working with ChatGPT on coding projects. It preloads and concatenates files from a specified directory, allowing for the seamless integration of customized prompts. This tool is ideal for those who seek an alternative to tools like GitHub Copilot, enabling a more efficient and tailored interaction with ChatGPT. ## Features * Preload and concatenate files from a given directory. * Customizable header and footer prompts for ChatGPT. * Simple command-line interface for easy operation. ## Limitations **Note:** This tool is optimized for smaller codebases. For larger repositories, performance may not be optimal due to processing constraints and the nature of interactions with ChatGPT. ## Prerequisites Before installing and using Code-Preloader, make sure your system meets the following requirements: 1. **Crystal Language**: Code-Preloader is written in Crystal. Ensure you have the Crystal programming language installed on your system. For installation instructions, refer to the [official Crystal language website](https://crystal-lang.org/install/). 2. **Required Libraries**: The following libraries are necessary for the proper functioning of Code-Preloader: * `libevent`: Used for asynchronous event notification. * `libyaml`: Required for YAML parsing. * `libmagic`: Utilized for file type detection. * `make`: Used to define compilation rules On a Debian-based system, you can install these libraries using the following command: ```bash sudo apt-get install libevent-dev libyaml-dev libmagic-dev make ``` ## Installation To get started with Code-Preloader, ensure that you have the prerequisites installed on your system (see above). Then follow these steps to install: ```bash git clone https://code.apps.glenux.net/glenux/code-preloader cd code-preloader make prepare make build make install ``` ## Usage Run Code-Preloader with the following command-line options: ``` Usage: code-preloader [options] ROOT_DIR -c CONFIG_FILE, --config=CONFIG_FILE Load parameters from CONFIG_FILE -i IGNORE_PATH, --ignore=IGNORE_PATH Ignore file or directory -o OUTPUT_FILE, --output=OUTPUT_FILE Write output to OUTPUT_FILE -H HEADER_PROMPT_FILE, --header-prompt=HEADER_PROMPT_FILE Load header prompt from HEADER_PROMPT_FILE -F FOOTER_PROMPT_FILE, --footer-prompt=FOOTER_PROMPT_FILE Load footer prompt from FOOTER_PROMPT_FILE -h, --help Show this help ``` ### Examples #### Basic Use Case To preload all files in the `src` directory and output to `result.txt`, while ignoring the `git` the `bin` directory, and the result file itself: ```bash ./bin/code-preloader -o result.txt -i .git -i result.txt -i bin/ src ``` #### Advanced Use Case To preload all files in the `src` directory and output to clipboard, prepending and appending prompts, while ignoring the `git` the `bin` directory, and the result file itself: ```bash ./bin/code-preloader \ -i .git -i bin/ -i result.txt -i prompts \ -H prompts/header-context.txt \ -F prompts/footer-write-readme.txt \ src \ | ctrlc ``` __Note__ `ctrlc` is my alias to `xclip -selection clipboard -i` #### Advanced with configuration file You can also do the same by storing all parameters within a configuration file (ex: `code_preloader.yml`). ```yaml --- ignore_list: - .git - code_preloader.yml - bin - prompts output_file_path: null header_prompt_file_path: prompts/header-context.txt footer_prompt_file_path: prompts/footer-write-readme.txt ``` Then type ```bash ./bin/code-preloader -c code_preloader.yml src | ctrlc ``` __Note__ `ctrlc` is my alias to `xclip -selection clipboard -i` ## Contributing Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**. ## Troubleshooting and Support If you encounter any issues or need support, please open an issue in the project's GitHub issue tracker. We strive to be responsive and helpful. ## License Distributed under the LGPL-3.0-or-later License. See `LICENSE` file for more information. ## Acknowledgments * A special thanks to all contributors and users of this project for their valuable feedback and support. * Inspired by the community's need for efficient code preparation tools in the context of AI-assisted programming. ## Related projects * [mpoon/gpt-repository-loader](https://github.com/mpoon/gpt-repository-loader)