copyfiles-cli
copyfiles-cli is a tiny CLI that scans a project, respects .gitignore-style rules, and produces a single copyfiles.txt with:
- an indented project tree, and
- each kept file’s contents (wrapped in language-tagged code fences).
Perfect for pasting clean, complete context into LLMs or sharing a compact code snapshot.
Installation
pip install copyfiles-cli
# CLI command is `copyfiles`
Requires Python 3.8+
Quick Start
# From your project root
copyfiles
# Writes ./copyfiles.txt (tree + file contents)
Options (short & sweet)
| Flag | Default | What it does |
|---|---|---|
--root PATH |
. |
Directory to scan. |
--out FILE |
copyfiles.txt |
Output file path. |
--config FILE |
– | Extra ignore patterns (one per line, .gitignore syntax). |
--max-bytes N |
100000 |
Truncate each file after N bytes. |
--skip-large KB |
– | Skip files larger than KB kilobytes entirely. |
-v, --verbose |
off | Show scanning/filtering progress. |
--no-color |
off | Disable colored output (or set NO_COLOR=1). |
-V, --version |
– | Print version and exit. |
-h, --help |
– | Show full help. |
Examples
# Minimal: create copyfiles.txt from current directory
copyfiles
# Different output name + lower per-file limit
copyfiles --out project.txt --max-bytes 50_000
# Skip very large binaries/logs and be chatty
copyfiles --skip-large 200 -v
# Use extra ignore rules
copyfiles --config .cfignore
Notes
- Honors your repo’s
.gitignoreplus any patterns you add via--config. - Binary files are skipped automatically.
- The output is plain Markdown so you can paste it directly into ChatGPT/Gemini/Copilot.
Metadata
Release files for copyfiles-cli 0.1.8
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| copyfiles_cli-0.1.8.tar.gz | 9.8 kB | Without provenance | Details for copyfiles_cli-0.1.8.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| copyfiles_cli-0.1.8-py3-none-any.whl | Python 3 | none | any | Details for copyfiles_cli-0.1.8-py3-none-any.whl |
Total release size: 18.3 kB
Release files / copyfiles_cli-0.1.8.tar.gz
| Download URL | copyfiles_cli-0.1.8.tar.gz |
|---|---|
| Size | 9.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ffab4ea40c17894080f64b15b5adcfc14b96fa0d7f82a68ef575a4d1c6dea165
|
|
BLAKE2b-256 checksum How to use checksums |
9bc85019d8366402a69bcb02ff1e1a110306e5b3cc60688a1e92996fcc596ea2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.12.11
|
Release files / copyfiles_cli-0.1.8-py3-none-any.whl
| Download URL | copyfiles_cli-0.1.8-py3-none-any.whl |
|---|---|
| Size | 8.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
df4d446c8ada289b50689326a57411daa53019bb5036c795e376bae3109f4741
|
|
BLAKE2b-256 checksum How to use checksums |
78efafd7e2fe2ea5308a4f7fe1068105362135a0e02ee4aa849839544d2be1c4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.12.11
|
Security for copyfiles-cli 0.1.8
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.