https://github.com/user-attachments/assets/91913ad6-6161-430d-9075-b0fa76498021

contextzip

Package exactly the right parts of your codebase and paste it into any AI tool — in one command.

pip install contextzip

📖 Full docs, every flag, every config option: contextzip.vercel.app

Why contextzip

Every AI session starts the same way: hunt down the relevant files, skip node_modules and build artifacts by hand, zip it, find the zip, upload it — then do it all again next session.

contextzip eliminates that. Run it from your project root — it detects your stack, applies smart exclusions, and produces a lean ZIP ready to paste into Claude, ChatGPT, or any AI tool. When the AI hands changes back, contextzip apply-zip writes them into your project safely.

Quick start

cd ~/projects/my-app
contextzip

That's it — no flags required. contextzip detects your framework, excludes the noise, and writes a ZIP to .contextzip/.

The essentials

Command	What it does
`contextzip`	Detect stack, exclude noise, package the project
`contextzip --prompt "task"`	Let Gemini pick only the files relevant to a task
`contextzip --git-changes`	Package only modified/staged/untracked files
`contextzip apply-zip`	Write an AI-returned ZIP back into your project, safely
`contextzip watch -- npm run dev`	Auto-package debug context the moment an error appears
`contextzip config --ui`	Set include/exclude rules visually in a local browser tab

Every command supports --dry-run, --verbose, --include, --exclude, and more — see the full CLI reference.

contextzip respects your .gitignore, detects Node.js, Next.js, Python, Django, FastAPI, Rust, Go, and Ruby (including in monorepos), and never packages secrets — SSH keys, cloud credentials, and Terraform state are always excluded. Details: contextzip.vercel.app/features.

Also a Python library

from contextzip import get_git_changes, create_zip

collection = get_git_changes()
pkg = create_zip(collection, output="/tmp/changes.zip")

Full function reference: contextzip.vercel.app/cli#python-api

Learn more

Packaging & detection — frameworks, exclusion rules, safety
AI-powered file selection — --prompt, Gemini setup
Terminal error watcher — contextzip watch
Applying changes back — apply-zip, manifest diffing, safety
Configuration — personal & project config, visual config UI
CLI & Python API reference

Contributing

Contributions are welcome — especially new framework rule sets and edge-case fixes. See CONTRIBUTING.md. Please open an issue before starting a large PR.

License

MIT — see LICENSE for details.

Metadata

Release files for contextzip 0.4.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for contextzip 0.4.5
File	Size	Uploaded
contextzip-0.4.5.tar.gz	118.8 kB	Oct 7, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for contextzip 0.4.5
File	Interpreter	ABI	Platform	Reset
contextzip-0.4.5-py3-none-any.whl 134.8 kB Oct 7, 2026	Python 3	none	any	Details

Total release size: 253.6 kB

Release files / contextzip-0.4.5.tar.gz

Download URL	contextzip-0.4.5.tar.gz
Size	118.8 kB
Tags	Source
SHA-256 checksum How to use checksums	`0bbc10872c067d86f74192d024191918e6c0b48118897b4d6936cbb31c46c437`
BLAKE2b-256 checksum How to use checksums	`508c4d3780a0d66976f70a8a4fa2a9fa5b21b9e70693f7f14fd9d3c90a5bd8fe`
Upload date	Oct 7, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

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.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/akadeepesh/contextzip
Publishing commit: github.com/akadeepesh/contextzip/tree/c927bca5fb7173d72d68ab0061ca6803bb16fdd5

Workflow

Publishing configuration: github.com/akadeepesh/contextzip/blob/c927bca5fb7173d72d68ab0061ca6803bb16fdd5/.github/workflows/python-publish.yml
Publishing logs: github.com/akadeepesh/contextzip/actions/runs/37628364392/attempts/1

Artifact

Subject: contextzip-0.4.5.tar.gz
SHA-256 checksum: 0bbc10872c067d86f74192d024191918e6c0b48118897b4d6936cbb31c46c437 Verifying attestations

Release files / contextzip-0.4.5-py3-none-any.whl

Download URL	contextzip-0.4.5-py3-none-any.whl
Size	134.8 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`992254aa468ff21aae4a4bee3589f25d1e6cb878be391117c770ef8effcd1e94`
BLAKE2b-256 checksum How to use checksums	`80da09b07c1f738341db52e51edc1b21012a191411f2e5a8551138769b92f9d8`
Upload date	Oct 7, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/akadeepesh/contextzip
Publishing commit: github.com/akadeepesh/contextzip/tree/c927bca5fb7173d72d68ab0061ca6803bb16fdd5

Workflow

Publishing configuration: github.com/akadeepesh/contextzip/blob/c927bca5fb7173d72d68ab0061ca6803bb16fdd5/.github/workflows/python-publish.yml
Publishing logs: github.com/akadeepesh/contextzip/actions/runs/37628364392/attempts/1

Artifact

Subject: contextzip-0.4.5-py3-none-any.whl
SHA-256 checksum: 992254aa468ff21aae4a4bee3589f25d1e6cb878be391117c770ef8effcd1e94 Verifying attestations