A command-line interface for concatenating files leveraging fast-glob.
- Quick and easy concatenation of files on the command line
- Supports robust glob patterns via fast-glob
- Automatically ignores empty files by default (great for use with automated build tools)
- Can output to stdout or a new or existing file
- Provides a sourcemap for the concatenated files by default
npm install --dev glob-concat-cliyarn add --dev glob-concat-cliCurrently, this project supports node v22 and v24. We plan to deprecate support for node v22 by March of 2026.
Type: string[]
Alias: f
Required: true
The files to concatenate. Supports glob patterns via fast-glob. This is the only required option.
Type: string
Alias: o
Default: stdout
The file to output the concatenated files to. If not provided, the concatenated files will be output to stdout.
Type: boolean
Alias: ae
Default: true
Whether to fail the command if no files are found or if any of the provided inputs can't be found. If set to true, the command will exit with a status code of 0 and no output will be written.
Type: boolean
Alias: map
Default: true
Whether to output a sourcemap for the concatenated files. If set to false, no sourcemap will be written to disk.
When leveraging this package, you can also pass in any of the options supported by fast-glob.
Due to how this utility is built, the following options are not supported:
onlyDirectories(this is always set tofalsebecause this utility is meant to concatenate files only)statsobjectMode
Contributions are welcome! Please open an issue or submit a pull request.
This project is licensed under the Apache 2.0 License - see the LICENSE file for details. This means you can use this however you like as long as you provide attribution back to this one. It's nice to share but it's also nice to get credit for your work. 😉
If you find this plugin useful and would like to buy me a coffee/beer as a small thank you, I would greatly appreciate it! Funding links are available in the GitHub UI for this repo.
