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

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.6
File	Size	Uploaded
contextzip-0.4.6.tar.gz	126.7 kB	Oct 7, 2026	Details

Built distribution (wheel)

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

Total release size: 270.0 kB

Release files / contextzip-0.4.6.tar.gz

Download URL	contextzip-0.4.6.tar.gz
Size	126.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`04dd48e81223d45d5e0e8875f928e3a04fcb654328b61cc04a33a0c2babaf301`
BLAKE2b-256 checksum How to use checksums	`e88652aea29c300da5111cf3c199a94178e521adb98932c5ebf15bf84a2ab0a6`
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/5d7d8016701a6d4c6fa3f5666cbebabab5fd08c0

Workflow

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

Artifact

Subject: contextzip-0.4.6.tar.gz
SHA-256 checksum: 04dd48e81223d45d5e0e8875f928e3a04fcb654328b61cc04a33a0c2babaf301 Verifying attestations

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

Download URL	contextzip-0.4.6-py3-none-any.whl
Size	143.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`a16d23e9d5e3dbb5373859c1f46d5b51bcaa9487809f405e38f89f0dcb78ca68`
BLAKE2b-256 checksum How to use checksums	`23ba3e1d659e93c3271a5b543ae04e45ab5d90ee7d45b91c04294b26e059afd6`
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/5d7d8016701a6d4c6fa3f5666cbebabab5fd08c0

Workflow

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

Artifact

Subject: contextzip-0.4.6-py3-none-any.whl
SHA-256 checksum: a16d23e9d5e3dbb5373859c1f46d5b51bcaa9487809f405e38f89f0dcb78ca68 Verifying attestations