mirror of
https://github.com/akadeepesh/contextzip.git
synced 2026-10-20 08:36:20 +02:00
Adding zip the git changes feature in README
This commit is contained in:
@@ -25,6 +25,7 @@ contextzip eliminates that entirely. Run it from your project root, it detects y
|
||||
|
||||
- **Smart framework detection** : automatically identifies Node.js, Next.js, Python, Django, FastAPI, Rust, Go, Ruby and applies the right exclusion rules for each
|
||||
- **Respects your `.gitignore`** : patterns from your existing gitignore are honoured automatically
|
||||
- **Git-aware packaging** : package only modified, staged, unstaged, and untracked files with `--git-changes` — perfect for AI review sessions, incremental debugging, and PR workflows
|
||||
- **Warns before it's a problem** : flags large files (≥ 1 MB) and binary files that AI tools can't read, before you waste an upload
|
||||
- **Handles the messy stuff** : dangling symlinks, unreadable files, and files outside the project tree are all caught and reported, never silently dropped
|
||||
- **Full CLI control** : `--include`, `--exclude`, `--dry-run`, `--verbose`, `--output`, all composable
|
||||
@@ -83,6 +84,7 @@ contextzip [OPTIONS]
|
||||
|---|---|
|
||||
| `-i`, `--include PATH` | Only include files under this path. Repeatable. |
|
||||
| `-e`, `--exclude PATTERN` | Extra exclusion patterns (gitignore syntax). Repeatable. |
|
||||
| `--git-changes` | Only include files reported by git as modified, staged, or untracked. |
|
||||
| `-n`, `--dry-run` | Preview what would be included, no ZIP created. |
|
||||
| `-o`, `--output FILE` | Custom output path for the ZIP file. |
|
||||
| `--no-clipboard` | Skip the clipboard / folder-open step. |
|
||||
@@ -110,6 +112,11 @@ contextzip --include src --include app
|
||||
contextzip --exclude "*.log" --exclude "*.sqlite" --exclude "tests/"
|
||||
```
|
||||
|
||||
**Only package files changed in git:**
|
||||
```bash
|
||||
contextzip --git-changes
|
||||
```
|
||||
|
||||
**Save ZIP to a specific path:**
|
||||
```bash
|
||||
contextzip --output ~/Desktop/my-project-context.zip
|
||||
@@ -202,6 +209,7 @@ contextzip/
|
||||
│ ├── cli.py # Click entry point, all flags, rich output
|
||||
│ ├── detector.py # framework/language detection engine
|
||||
│ ├── filters.py # pathspec-based file filtering + ResolveResult
|
||||
│ ├── git.py # git status parsing + changed-file detection
|
||||
│ ├── packager.py # ZIP creation, compression stats, PackageResult
|
||||
│ ├── clipboard.py # tiered clipboard strategy (all platforms)
|
||||
│ └── rules/
|
||||
|
||||
Reference in New Issue
Block a user