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, backups, 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.3

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.3
File	Size	Uploaded
contextzip-0.4.3.tar.gz	113.9 kB	Sep 20, 2026	Details

Built distribution (wheel)

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

Total release size: 243.9 kB

Release files / contextzip-0.4.3.tar.gz

Download URL	contextzip-0.4.3.tar.gz
Size	113.9 kB
Tags	Source
SHA-256 checksum How to use checksums	`7225b2b6346619cea3ca1d17229a8cb84f9a1962721b8e1246746d456f616c58`
BLAKE2b-256 checksum How to use checksums	`821307e0ea332ad05724a071b4ea148e4a75a9ab339e12ef61c63dc9e5251e99`
Upload date	Sep 20, 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/4f185984e14e0f3e91ba0ee10ced6168ae645cc9

Workflow

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

Artifact

Subject: contextzip-0.4.3.tar.gz
SHA-256 checksum: 7225b2b6346619cea3ca1d17229a8cb84f9a1962721b8e1246746d456f616c58 Verifying attestations

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

Download URL	contextzip-0.4.3-py3-none-any.whl
Size	130.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`cddd9a58514387bdba8dc4d528ebf72b29c026a472a4e6dc46f8410cccd07381`
BLAKE2b-256 checksum How to use checksums	`49cab11f03ac9b9c10f4069a8710b53d2d883217ef8834f82c0e2d96f2533ed5`
Upload date	Sep 20, 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/4f185984e14e0f3e91ba0ee10ced6168ae645cc9

Workflow

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

Artifact

Subject: contextzip-0.4.3-py3-none-any.whl
SHA-256 checksum: cddd9a58514387bdba8dc4d528ebf72b29c026a472a4e6dc46f8410cccd07381 Verifying attestations