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.4

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.4
File	Size	Uploaded
contextzip-0.4.4.tar.gz	117.0 kB	Sep 21, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for contextzip 0.4.4
File	Interpreter	ABI	Platform	Reset
contextzip-0.4.4-py3-none-any.whl 133.0 kB Sep 21, 2026	Python 3	none	any	Details

Total release size: 250.0 kB

Release files / contextzip-0.4.4.tar.gz

Download URL	contextzip-0.4.4.tar.gz
Size	117.0 kB
Tags	Source
SHA-256 checksum How to use checksums	`9bb627f6a1aba5906689cb9af5ac969240ee815d0fbdfb3111b98617b18cfe90`
BLAKE2b-256 checksum How to use checksums	`2672e4908d207d2c2a71683fc4c1520f624395e67074642d7b8585832ec02847`
Upload date	Sep 21, 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/7f01c450bb932dc8eb81dd86883be42c8a95e5fe

Workflow

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

Artifact

Subject: contextzip-0.4.4.tar.gz
SHA-256 checksum: 9bb627f6a1aba5906689cb9af5ac969240ee815d0fbdfb3111b98617b18cfe90 Verifying attestations

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

Download URL	contextzip-0.4.4-py3-none-any.whl
Size	133.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`0b8d9cb973b605f01854270082f587313d016d3aa60100443b208c67a911b25f`
BLAKE2b-256 checksum How to use checksums	`56e3247399e6e2c577b1ea1dffc498bd1eb927bacc824136f33576e438a2701e`
Upload date	Sep 21, 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/7f01c450bb932dc8eb81dd86883be42c8a95e5fe

Workflow

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

Artifact

Subject: contextzip-0.4.4-py3-none-any.whl
SHA-256 checksum: 0b8d9cb973b605f01854270082f587313d016d3aa60100443b208c67a911b25f Verifying attestations