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.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

contextzip-0.4.0.tar.gz (101.6 kB view details)

Uploaded Aug 26, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

contextzip-0.4.0-py3-none-any.whl (115.4 kB view details)

Uploaded Aug 26, 2026 Python 3

File details

Details for the file contextzip-0.4.0.tar.gz.

File metadata

Download URL: contextzip-0.4.0.tar.gz
Upload date: Aug 26, 2026
Size: 101.6 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for contextzip-0.4.0.tar.gz
Algorithm	Hash digest
SHA256	`88035c025e0deca0dcc5bf44ef0232dfebb3addf4f5d4534b49845817419bc1e`
MD5	`4b2e7c4c98fc76584c224a3e484ecb8e`
BLAKE2b-256	`77d05d2743d9c1d7b540d0e426f26f8e30b07a8c8d085f3ebe864013d3a3000a`

See more details on using hashes here.

Provenance

The following attestation bundles were made for contextzip-0.4.0.tar.gz:

Publisher: python-publish.yml on akadeepesh/contextzip

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: contextzip-0.4.0.tar.gz
- Subject digest: 88035c025e0deca0dcc5bf44ef0232dfebb3addf4f5d4534b49845817419bc1e
- Sigstore transparency entry: 2604309900
- Sigstore integration time: Aug 26, 2026
Source repository:
- Permalink: akadeepesh/contextzip@35f7fb6ad86caad910939aa4a90ecd85126ca34a
- Branch / Tag: refs/tags/v0.4.0
- Owner: https://github.com/akadeepesh
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: python-publish.yml@35f7fb6ad86caad910939aa4a90ecd85126ca34a
- Trigger Event: release