{"id":20961429,"url":"https://github.com/jasonlovesdoggo/codepack","last_synced_at":"2025-04-11T19:57:46.423Z","repository":{"id":263076284,"uuid":"889288817","full_name":"JasonLovesDoggo/codepack","owner":"JasonLovesDoggo","description":"A lightning fast tool that converts a directory into a single organized .txt file for LLM processing 🚀","archived":false,"fork":false,"pushed_at":"2025-03-16T02:17:09.000Z","size":110,"stargazers_count":22,"open_issues_count":2,"forks_count":3,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-03T02:39:37.809Z","etag":null,"topics":["ai","automation","chatgpt","claude","gemini","gpt-4","llm"],"latest_commit_sha":null,"homepage":"https://codepack.jasoncameron.dev/","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/JasonLovesDoggo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-11-16T01:52:29.000Z","updated_at":"2025-03-31T12:54:45.000Z","dependencies_parsed_at":null,"dependency_job_id":"263d57d4-d2e6-40ee-9dcd-303152b5a37c","html_url":"https://github.com/JasonLovesDoggo/codepack","commit_stats":null,"previous_names":["jasonlovesdoggo/codepack"],"tags_count":23,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JasonLovesDoggo%2Fcodepack","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JasonLovesDoggo%2Fcodepack/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JasonLovesDoggo%2Fcodepack/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JasonLovesDoggo%2Fcodepack/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/JasonLovesDoggo","download_url":"https://codeload.github.com/JasonLovesDoggo/codepack/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248473112,"owners_count":21109628,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","automation","chatgpt","claude","gemini","gpt-4","llm"],"created_at":"2024-11-19T02:13:34.159Z","updated_at":"2025-04-11T19:57:46.415Z","avatar_url":"https://github.com/JasonLovesDoggo.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# `codepack`\n\n[![crates.io](https://img.shields.io/crates/v/codepack.svg)](https://crates.io/crates/codepack) [![Web](https://github.com/JasonLovesDoggo/codepack/actions/workflows/web.yml/badge.svg)](https://github.com/JasonLovesDoggo/codepack/actions/workflows/web.yml) [![Release](https://github.com/JasonLovesDoggo/codepack/actions/workflows/release.yml/badge.svg)](https://github.com/JasonLovesDoggo/codepack/actions/workflows/release.yml)\n\n**`codepack`** transforms directories into _LLM-friendly_ text files.\n\nA _lightning-fast_ tool that converts the contents of a directory into a single, LLM-friendly text file, making it easy to process and analyze data with Large Language Models.\n\n## Installation\n\nFor detailed installation instructions, please visit the [Codepack documentation](https://codepack.jasoncameron.dev/).\n\nAlternatively, you can follow the instructions below to install `codepack`.\n\n### Pre-built Binaries (Recommended)\n\nPlease see [the documentation](https://codepack.jasoncameron.dev)\n\n### Installation via Cargo (Optional)\n\nAlternatively, you can install `codepack` from source with Rust's package manager `cargo`:\n\n```sh\ncargo install codepack\n```\n\nThis will download, build, and install the latest version of codepack.\n\n## Quickstart\n\nOnce installed, simply run:\n\n```bash\ncodepack /path/to/directory\n```\n\nBy default, codepack will process the directory and output a .txt file with the contents of the files inside the directory. If you don't specify an output file, it will generate one based on the directory name and the number of files processed.\n\n## Features\n\n- **Lightning Fast**: `codepack` is optimized for speed, ensuring that even large directories are processed efficiently.\n- **Customizable Output**: Specify the output file name with the `-o` option, or let `codepack` generate one for you.\n- **Selective File Processing**: Use the `-e` or `--extension` flag to include specific file types (e.g., `.rs`, `.toml`).\n- **Suppress Output Prompt**: If you don’t want the default prompt in your output file, use the `--suppress-prompt` option.\n- **Powerful Filtering**: Filter files based on file names, paths, and content using the `-f` or `--filter` option.\n\n### Filtering with codepack\n\nCodepack supports three types of filters:\n\n1. File Name Filters: Filter files based on their names using the file.name= prefix followed by the pattern to match.\n\n\u003e Example: `codepack -f \"file.name=main.py\" /path/to/project` (includes only files named \"main.py\")\n\n2. Path Contains Filters: Filter files based on a substring present anywhere in their path using the path.contains= prefix followed by the substring.\n\n\u003e Example: `codepack -f \"path.contains=src\" .` (includes only files within the \"src\" directory and its subdirectories)\n\n3. Content Contains Filters: Filter files based on a substring present in their content using the content.contains= prefix followed by the substring.\n\nNote: Content filters are applied after the file has been read, so this can be slower than other filter types.\n\n\u003e Example: `codepack -f \"content.contains=function\" /path/to/code` (includes only files containing the word \"function\")\n\nYou can combine multiple filters using multiple `-f` or `--filter` options. Codepack uses `OR` logic for filtering, so a file will be included if it matches any of the provided filters.\n\n## Usage\n\n```bash\ncodepack [OPTIONS] \u003cDIRECTORY_PATH\u003e\n\nConvert local directory contents into a single text file, useful for processing by an LLM.\n\nOptions:\n-h, --help              Show this message\n-e, --extension \u003cEXT\u003e   Include files with the specified extension(s) (e.g., -e rs -e toml)\n-o, --output \u003cOUTPUT\u003e   Specify the output file path (optional)\n--suppress-prompt   Suppress the description of the file format in the output\n--force   Overwrite output file without confirmation\n-f,  --filter \u003cFILTER\u003e      Filter files based on name, path, or content (e.g., -f \"file.name=main.rs\").\n```\n\nExamples\nConvert a directory to a .txt file with a custom output name:\n\n```bash\ncodepack /path/to/my/code -o my_code.txt\n```\n\nProcess only `.rs` and `.toml` files from a directory:\n\n```bash\ncodepack /path/to/my/code -e rs -e toml\n```\n\n## Contributing\n\nWe welcome contributions to codepack! Please feel free to submit issues or pull requests on GitHub.\n\n## License\n\ncodepack is distributed under the terms of the GPL-3.0 License. See the [LICENSE](./LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjasonlovesdoggo%2Fcodepack","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjasonlovesdoggo%2Fcodepack","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjasonlovesdoggo%2Fcodepack/lists"}