contextzip 0.3.4__tar.gz → 0.3.5__tar.gz

{contextzip-0.3.4 → contextzip-0.3.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: contextzip
-Version: 0.3.4
+Version: 0.3.5
 Summary: Intelligently package your codebase for AI tools
 Author-email: Deepesh <akadeepesh@gmail.com>
 License-Expression: MIT
@@ -47,13 +47,13 @@ contextzip eliminates that entirely. Run it from your project root — it detect
 
 ## Features
 
-- **Smart framework detection** — automatically identifies Node.js, Next.js, Python, Django, FastAPI, Rust, Go, and Ruby, applying the right exclusion rules for each
+- **Smart framework detection** — automatically identifies Node.js, Next.js, Python, Django, FastAPI, Rust, Go, and Ruby, applying the right exclusion rules for each. Detection isn't limited to the project root: a shallow, bounded scan of subdirectories means a monorepo (`frontend/` + `backend/`, etc.) gets every ecosystem it contains detected and excluded correctly, not just whatever sits at the top level
 - **Respects `.gitignore`** — your existing ignore patterns are honoured automatically
 - **Git-aware packaging** — use `--git-changes` to package only modified, staged, and untracked files; perfect for incremental debugging and PR review sessions
 - **AI-powered file selection** — describe your task in plain English with `--prompt` and Gemini selects the minimum relevant files automatically, no manual hunting required
 - **Terminal error watcher** — wrap any dev server with `contextzip watch` to auto-detect errors and package a ready-to-upload debug context in one keypress
-- **End-of-day / handoff prompts** — `contextzip eod` and `contextzip handoff` turn a Claude/ChatGPT conversation export plus today's code changes into a paste-ready prompt, copied straight to your clipboard
-- **Persistent workspace** — all generated ZIPs land in `.contextzip/` at your project root, discoverable, reusable, and git-ignored automatically
+- **Configurable workspace location** — `.contextzip/` lives at the git root by default, but you can pin it elsewhere per-machine (`contextzip config --set-workspace`) or for the whole team via a committed `.contextzip.json`
+- **Persistent workspace** — all generated ZIPs land in `.contextzip/`, discoverable, reusable, and git-ignored automatically
 - **Warns before it's a problem** — flags large (≥ 1 MB) and binary files that AI tools can't read, before you waste an upload
 - **Handles edge cases** — dangling symlinks, unreadable files, and paths outside the project tree are caught and reported, never silently dropped
 - **Full CLI control** — `--include`, `--exclude`, `--dry-run`, `--output`, all composable
@@ -118,7 +118,7 @@ contextzip [OPTIONS]
 | `--no-clipboard` | Skip the clipboard / folder-open step |
 | `--no-gitignore` | Ignore the project's `.gitignore` |
 
-**Subcommands:** `exclude`, `include`, `watch`, `config`, `eod`, `handoff` — run `contextzip --help` for full details.
+**Subcommands:** `exclude`, `include`, `watch`, `config` — run `contextzip --help` for full details.
 
 ---
 
@@ -244,60 +244,53 @@ Press **D** and contextzip immediately writes `.contextzip/debug-context.zip`. Y
 
 ---
 
-## End-of-day reports and chat handoffs
-
-If you work through a problem in a Claude or ChatGPT conversation and need to either (a) summarize what you did for an end-of-day report, or (b) continue the same work in a fresh chat after hitting a usage limit, `eod` and `handoff` build the prompt for you — contextzip does no summarizing itself; that's left to whichever AI tool you paste the result into.
-
-```bash
-contextzip eod
-contextzip handoff
-```
+## What gets excluded
 
-**Setup:** export your conversation (any markdown export works) and drop the `.md` file into `exports/` at your project root. Both commands pick the most recently modified file there automatically.
+contextzip stacks exclusion rules based on your detected stack, on top of your `.gitignore`.
 
-**What gets built:**
+**Always excluded:** `.git/`, `.env` files, logs, caches, editor config (`.vscode/`, `.idea/`), OS files (`.DS_Store`, `Thumbs.db`), common binary formats, and contextzip's own `.contextzip/` working folder.
 
-- The conversation itself — pasted directly into the prompt if it's short, or referenced as an attachment if it's long enough that inlining it would burn through the next chat's context budget
-- Whatever code changed, resolved per file in priority order:
-  1. **Not pushed** — diffed against your upstream branch, plus the complete current file
-  2. **Diverged from Claude** — diffed against the version Claude last produced (if you've set up a session key — see below), plus the complete current codebase file
-  3. **Since last run** — diffed against a per-branch checkpoint that `eod`/`handoff` remember automatically, plus the complete current file
-- New, untracked files are included as full content (there's nothing to diff them against)
-- `eod` ends the prompt with a flat instruction to produce a work-log table; `handoff` frames it as continuing the project in a new chat
+**By framework:**
 
-The result is copied straight to your clipboard, and also saved to `.contextzip/` if you want to look it over first.
+| Stack | Additional exclusions |
+|---|---|
+| Node.js / Next.js | `node_modules/`, `.next/`, `dist/`, `build/`, lock files, `*.min.js`, `*.d.ts` |
+| Python / Django / FastAPI | `__pycache__/`, `.venv/`, `*.pyc`, `migrations/`, `.pytest_cache/`, lock files |
+| Rust | `target/`, `Cargo.lock`, `*.rlib` |
+| Go | `vendor/`, `go.sum`, `bin/` |
 
-**Optional — diffing against Claude's own version (case 2):** if you give contextzip your Claude.ai session key, `eod`/`handoff` will fetch the files Claude actually produced and compare them against your codebase, catching drift even after everything's pushed and in sync.
+Detection is additive — a monorepo with both `package.json` and `pyproject.toml` gets both rule sets applied. Marker files don't have to sit at the project root: contextzip also does a shallow, bounded scan of subdirectories (2 levels deep, skipping `node_modules/`, `.venv/`, `.git/`, and other dependency/build dirs it would never want to look inside anyway), so a layout like
 
-```bash
-contextzip config --set-session-key
 ```
-
-This is best-effort by design — it depends on an undocumented Claude.ai endpoint, so a missing key, an expired cookie, or the endpoint changing shape just skips this check with a warning rather than failing the whole command.
-
-```bash
-contextzip eod --dry-run        # preview without advancing the checkpoint
-contextzip handoff --no-fetch   # skip the Claude-artifact fetch for this run
+root/
+  frontend/package.json
+  backend/requirements.txt
 ```
 
----
+detects both Node.js and Python from `root/`, without either marker existing at the top level. Run with default output (not `--dry-run --verbose`) and you'll see which subdirectory each ecosystem came from, e.g. `Next.js (frontend/) + FastAPI (backend/)`.
 
-## What gets excluded
+---
 
-contextzip stacks exclusion rules based on your detected stack, on top of your `.gitignore`.
+## Workspace location
 
-**Always excluded:** `.git/`, `.env` files, logs, caches, editor config (`.vscode/`, `.idea/`), OS files (`.DS_Store`, `Thumbs.db`), common binary formats, and contextzip's own `.contextzip/` and `exports/` working folders.
+By default, `.contextzip/` is created at your git root — that's `_find_git_root()` walking up from the current directory until it finds a `.git` folder; outside a repo, it falls back to the current directory. This can be overridden two ways, in order of priority:
 
-**By framework:**
+1. **`CONTEXTZIP_WORKSPACE_LOCATION` environment variable** — for a one-off override on a single run
+2. **A committed `.contextzip.json` at the project root** — team-shared, applies to everyone who clones the repo:
+   ```json
+   { "workspace_location": "git-root" }
+   ```
+3. **Your personal config** — a per-machine default that doesn't get committed:
+   ```bash
+   contextzip config --set-workspace cwd          # always use ./.contextzip wherever you run it
+   contextzip config --set-workspace git-root      # back to the default
+   contextzip config --set-workspace ~/zips        # a fixed custom location, anywhere
+   contextzip config --reset-workspace             # clear your personal override
+   ```
 
-| Stack | Additional exclusions |
-|---|---|
-| Node.js / Next.js | `node_modules/`, `.next/`, `dist/`, `build/`, lock files, `*.min.js`, `*.d.ts` |
-| Python / Django / FastAPI | `__pycache__/`, `.venv/`, `*.pyc`, `migrations/`, `.pytest_cache/`, lock files |
-| Rust | `target/`, `Cargo.lock`, `*.rlib` |
-| Go | `vendor/`, `go.sum`, `bin/` |
+Accepted values are `"git-root"`, `"cwd"`, or any path (absolute, or relative to the git root). Run `contextzip config` with no flags to see which value is currently active and where it came from.
 
-Detection is additive — a monorepo with both `package.json` and `pyproject.toml` gets both rule sets applied.
+This matters most for monorepos where you sometimes run contextzip from a subdirectory (`cd frontend && contextzip`) — with the default `git-root` setting, the workspace still lands at the repo root no matter where you ran it from, so you don't end up with scattered `.contextzip/` folders across `frontend/`, `backend/`, etc. Set `workspace_location: "cwd"` in a project's `.contextzip.json` instead if you'd rather each subproject keep its own.
 
 ---
 

{contextzip-0.3.4 → contextzip-0.3.5}/README.md

@@ -18,13 +18,13 @@ contextzip eliminates that entirely. Run it from your project root — it detect
 
 ## Features
 
-- **Smart framework detection** — automatically identifies Node.js, Next.js, Python, Django, FastAPI, Rust, Go, and Ruby, applying the right exclusion rules for each
+- **Smart framework detection** — automatically identifies Node.js, Next.js, Python, Django, FastAPI, Rust, Go, and Ruby, applying the right exclusion rules for each. Detection isn't limited to the project root: a shallow, bounded scan of subdirectories means a monorepo (`frontend/` + `backend/`, etc.) gets every ecosystem it contains detected and excluded correctly, not just whatever sits at the top level
 - **Respects `.gitignore`** — your existing ignore patterns are honoured automatically
 - **Git-aware packaging** — use `--git-changes` to package only modified, staged, and untracked files; perfect for incremental debugging and PR review sessions
 - **AI-powered file selection** — describe your task in plain English with `--prompt` and Gemini selects the minimum relevant files automatically, no manual hunting required
 - **Terminal error watcher** — wrap any dev server with `contextzip watch` to auto-detect errors and package a ready-to-upload debug context in one keypress
-- **End-of-day / handoff prompts** — `contextzip eod` and `contextzip handoff` turn a Claude/ChatGPT conversation export plus today's code changes into a paste-ready prompt, copied straight to your clipboard
-- **Persistent workspace** — all generated ZIPs land in `.contextzip/` at your project root, discoverable, reusable, and git-ignored automatically
+- **Configurable workspace location** — `.contextzip/` lives at the git root by default, but you can pin it elsewhere per-machine (`contextzip config --set-workspace`) or for the whole team via a committed `.contextzip.json`
+- **Persistent workspace** — all generated ZIPs land in `.contextzip/`, discoverable, reusable, and git-ignored automatically
 - **Warns before it's a problem** — flags large (≥ 1 MB) and binary files that AI tools can't read, before you waste an upload
 - **Handles edge cases** — dangling symlinks, unreadable files, and paths outside the project tree are caught and reported, never silently dropped
 - **Full CLI control** — `--include`, `--exclude`, `--dry-run`, `--output`, all composable
@@ -89,7 +89,7 @@ contextzip [OPTIONS]
 | `--no-clipboard` | Skip the clipboard / folder-open step |
 | `--no-gitignore` | Ignore the project's `.gitignore` |
 
-**Subcommands:** `exclude`, `include`, `watch`, `config`, `eod`, `handoff` — run `contextzip --help` for full details.
+**Subcommands:** `exclude`, `include`, `watch`, `config` — run `contextzip --help` for full details.
 
 ---
 
@@ -215,60 +215,53 @@ Press **D** and contextzip immediately writes `.contextzip/debug-context.zip`. Y
 
 ---
 
-## End-of-day reports and chat handoffs
-
-If you work through a problem in a Claude or ChatGPT conversation and need to either (a) summarize what you did for an end-of-day report, or (b) continue the same work in a fresh chat after hitting a usage limit, `eod` and `handoff` build the prompt for you — contextzip does no summarizing itself; that's left to whichever AI tool you paste the result into.
-
-```bash
-contextzip eod
-contextzip handoff
-```
+## What gets excluded
 
-**Setup:** export your conversation (any markdown export works) and drop the `.md` file into `exports/` at your project root. Both commands pick the most recently modified file there automatically.
+contextzip stacks exclusion rules based on your detected stack, on top of your `.gitignore`.
 
-**What gets built:**
+**Always excluded:** `.git/`, `.env` files, logs, caches, editor config (`.vscode/`, `.idea/`), OS files (`.DS_Store`, `Thumbs.db`), common binary formats, and contextzip's own `.contextzip/` working folder.
 
-- The conversation itself — pasted directly into the prompt if it's short, or referenced as an attachment if it's long enough that inlining it would burn through the next chat's context budget
-- Whatever code changed, resolved per file in priority order:
-  1. **Not pushed** — diffed against your upstream branch, plus the complete current file
-  2. **Diverged from Claude** — diffed against the version Claude last produced (if you've set up a session key — see below), plus the complete current codebase file
-  3. **Since last run** — diffed against a per-branch checkpoint that `eod`/`handoff` remember automatically, plus the complete current file
-- New, untracked files are included as full content (there's nothing to diff them against)
-- `eod` ends the prompt with a flat instruction to produce a work-log table; `handoff` frames it as continuing the project in a new chat
+**By framework:**
 
-The result is copied straight to your clipboard, and also saved to `.contextzip/` if you want to look it over first.
+| Stack | Additional exclusions |
+|---|---|
+| Node.js / Next.js | `node_modules/`, `.next/`, `dist/`, `build/`, lock files, `*.min.js`, `*.d.ts` |
+| Python / Django / FastAPI | `__pycache__/`, `.venv/`, `*.pyc`, `migrations/`, `.pytest_cache/`, lock files |
+| Rust | `target/`, `Cargo.lock`, `*.rlib` |
+| Go | `vendor/`, `go.sum`, `bin/` |
 
-**Optional — diffing against Claude's own version (case 2):** if you give contextzip your Claude.ai session key, `eod`/`handoff` will fetch the files Claude actually produced and compare them against your codebase, catching drift even after everything's pushed and in sync.
+Detection is additive — a monorepo with both `package.json` and `pyproject.toml` gets both rule sets applied. Marker files don't have to sit at the project root: contextzip also does a shallow, bounded scan of subdirectories (2 levels deep, skipping `node_modules/`, `.venv/`, `.git/`, and other dependency/build dirs it would never want to look inside anyway), so a layout like
 
-```bash
-contextzip config --set-session-key
 ```
-
-This is best-effort by design — it depends on an undocumented Claude.ai endpoint, so a missing key, an expired cookie, or the endpoint changing shape just skips this check with a warning rather than failing the whole command.
-
-```bash
-contextzip eod --dry-run        # preview without advancing the checkpoint
-contextzip handoff --no-fetch   # skip the Claude-artifact fetch for this run
+root/
+  frontend/package.json
+  backend/requirements.txt
 ```
 
----
+detects both Node.js and Python from `root/`, without either marker existing at the top level. Run with default output (not `--dry-run --verbose`) and you'll see which subdirectory each ecosystem came from, e.g. `Next.js (frontend/) + FastAPI (backend/)`.
 
-## What gets excluded
+---
 
-contextzip stacks exclusion rules based on your detected stack, on top of your `.gitignore`.
+## Workspace location
 
-**Always excluded:** `.git/`, `.env` files, logs, caches, editor config (`.vscode/`, `.idea/`), OS files (`.DS_Store`, `Thumbs.db`), common binary formats, and contextzip's own `.contextzip/` and `exports/` working folders.
+By default, `.contextzip/` is created at your git root — that's `_find_git_root()` walking up from the current directory until it finds a `.git` folder; outside a repo, it falls back to the current directory. This can be overridden two ways, in order of priority:
 
-**By framework:**
+1. **`CONTEXTZIP_WORKSPACE_LOCATION` environment variable** — for a one-off override on a single run
+2. **A committed `.contextzip.json` at the project root** — team-shared, applies to everyone who clones the repo:
+   ```json
+   { "workspace_location": "git-root" }
+   ```
+3. **Your personal config** — a per-machine default that doesn't get committed:
+   ```bash
+   contextzip config --set-workspace cwd          # always use ./.contextzip wherever you run it
+   contextzip config --set-workspace git-root      # back to the default
+   contextzip config --set-workspace ~/zips        # a fixed custom location, anywhere
+   contextzip config --reset-workspace             # clear your personal override
+   ```
 
-| Stack | Additional exclusions |
-|---|---|
-| Node.js / Next.js | `node_modules/`, `.next/`, `dist/`, `build/`, lock files, `*.min.js`, `*.d.ts` |
-| Python / Django / FastAPI | `__pycache__/`, `.venv/`, `*.pyc`, `migrations/`, `.pytest_cache/`, lock files |
-| Rust | `target/`, `Cargo.lock`, `*.rlib` |
-| Go | `vendor/`, `go.sum`, `bin/` |
+Accepted values are `"git-root"`, `"cwd"`, or any path (absolute, or relative to the git root). Run `contextzip config` with no flags to see which value is currently active and where it came from.
 
-Detection is additive — a monorepo with both `package.json` and `pyproject.toml` gets both rule sets applied.
+This matters most for monorepos where you sometimes run contextzip from a subdirectory (`cd frontend && contextzip`) — with the default `git-root` setting, the workspace still lands at the repo root no matter where you ran it from, so you don't end up with scattered `.contextzip/` folders across `frontend/`, `backend/`, etc. Set `workspace_location: "cwd"` in a project's `.contextzip.json` instead if you'd rather each subproject keep its own.
 
 ---
 

{contextzip-0.3.4 → contextzip-0.3.5}/contextzip/__init__.py

@@ -1,6 +1,6 @@
 """contextzip — intelligent codebase packager for AI tools."""
 
-__version__ = "0.3.4"
+__version__ = "0.3.5"
 
 from contextzip.api import (
     FileCollection,

{contextzip-0.3.4 → contextzip-0.3.5}/contextzip/cli.py

@@ -15,19 +15,16 @@ from contextzip import __version__
 from contextzip.config import (
     get_api_key,
     delete_api_key,
-    get_session_key,
-    delete_session_key,
     config_path,
     diagnose_api_key,
+    save_workspace_location,
+    delete_workspace_location,
 )
 from contextzip.detector import detect
 from contextzip.filters import build_spec, resolve_files, resolve_files_from_git
 from contextzip.git import get_changed_files, GitError
 from contextzip.packager import create_zip
-from contextzip.clipboard import (
-    handle as clipboard_handle,
-    handle_text as clipboard_handle_text,
-)
+from contextzip.clipboard import handle as clipboard_handle
 
 from contextzip.cli_display import (
     print_detection,
@@ -37,14 +34,13 @@ from contextzip.cli_display import (
     print_package_result,
     print_zip_write_warnings,
     print_clipboard_result,
-    print_brief_result,
 )
 from contextzip.cli_ai import (
     normalize_pattern,
     run_ai_selection,
     run_ai_selection_preview,
 )
-from contextzip.cli_onboard import onboard_api_key, onboard_session_key
+from contextzip.cli_onboard import onboard_api_key
 
 console = Console()
 
@@ -377,166 +373,6 @@ def cmd_watch(command: tuple[str, ...]) -> None:
     raise SystemExit(exit_code)
 
 
-@main.command("eod")
-@click.option(
-    "--exports-dir",
-    default=None,
-    metavar="DIR",
-    help="Folder containing conversation exports (default: ./exports).",
-)
-@click.option(
-    "--no-clipboard",
-    is_flag=True,
-    default=False,
-    help="Skip copying the prompt to the clipboard.",
-)
-@click.option(
-    "--no-fetch",
-    is_flag=True,
-    default=False,
-    help="Don't auto-fetch Claude's artifact files even if a session key is configured.",
-)
-@click.option(
-    "--dry-run",
-    "-n",
-    is_flag=True,
-    default=False,
-    help="Build the prompt without advancing the eod marker.",
-)
-def cmd_eod(
-    exports_dir: str | None, no_clipboard: bool, no_fetch: bool, dry_run: bool
-) -> None:
-    """
-    Build a paste-ready end-of-day prompt from today's conversation + code changes.
-
-    \b
-    EXAMPLES
-      contextzip eod
-      contextzip eod --dry-run
-      contextzip eod --exports-dir ~/claude-exports
-
-    Picks the most recently modified .md file in exports/, packages whatever
-    code changed since the last time eod ran (diffs for files that already
-    existed, full content for new ones), and copies a ready-to-paste prompt
-    to your clipboard. contextzip does no summarizing itself — that's the
-    job of whatever AI tool you paste the prompt into.
-    """
-    _run_brief("eod", exports_dir, no_clipboard, no_fetch, dry_run)
-
-
-@main.command("handoff")
-@click.option(
-    "--exports-dir",
-    default=None,
-    metavar="DIR",
-    help="Folder containing conversation exports (default: ./exports).",
-)
-@click.option(
-    "--no-clipboard",
-    is_flag=True,
-    default=False,
-    help="Skip copying the prompt to the clipboard.",
-)
-@click.option(
-    "--no-fetch",
-    is_flag=True,
-    default=False,
-    help="Don't auto-fetch Claude's artifact files even if a session key is configured.",
-)
-@click.option(
-    "--dry-run",
-    "-n",
-    is_flag=True,
-    default=False,
-    help="Build the prompt without advancing the handoff marker.",
-)
-def cmd_handoff(
-    exports_dir: str | None, no_clipboard: bool, no_fetch: bool, dry_run: bool
-) -> None:
-    """
-    Build a paste-ready prompt to continue this project in a fresh chat.
-
-    \b
-    EXAMPLES
-      contextzip handoff
-      contextzip handoff --dry-run
-
-    Use this when you've hit a usage limit and need to start a new chat
-    without losing context: picks the latest conversation export, packages
-    the code changed since the last handoff (or eod), and copies a prompt
-    ready to paste into the new chat.
-    """
-    _run_brief("handoff", exports_dir, no_clipboard, no_fetch, dry_run)
-
-
-def _run_brief(
-    kind: str,
-    exports_dir: str | None,
-    no_clipboard: bool,
-    no_fetch: bool,
-    dry_run: bool,
-) -> None:
-    """Shared implementation for cmd_eod and cmd_handoff — see brief.py for the actual logic."""
-    from contextzip.brief import run_brief, BriefError
-
-    project_dir = Path(os.getcwd()).resolve()
-
-    console.print()
-    console.print(
-        Panel.fit(
-            f"[bold cyan]contextzip[/] [dim]{kind}[/]\n"
-            f"[dim]Project:[/] [white]{project_dir}[/]",
-            border_style="cyan",
-            padding=(0, 2),
-        )
-    )
-    console.print()
-
-    exports_path = Path(exports_dir).resolve() if exports_dir else None
-
-    try:
-        with console.status(f"[cyan]Building {kind} prompt…[/]", spinner="dots"):
-            result = run_brief(
-                kind=kind,
-                project_dir=project_dir,
-                exports_dir=exports_path,
-                auto_fetch_artifacts=not no_fetch,
-                dry_run=dry_run,
-            )
-    except BriefError as exc:
-        console.print(
-            Panel.fit(
-                f"[red]{exc}[/]",
-                border_style="red",
-                padding=(0, 2),
-            )
-        )
-        raise SystemExit(1)
-
-    print_brief_result(result)
-
-    if dry_run:
-        console.print()
-        console.print(
-            Panel.fit(
-                "[yellow]Dry run:[/] the prompt and any changes zip above were "
-                "still written so you can review them, but the checkpoint was "
-                "[bold]not[/] advanced.\n"
-                "[dim]Run again without --dry-run once you're happy with this — "
-                "it'll pick up the same files.[/]",
-                border_style="yellow",
-                padding=(0, 2),
-            )
-        )
-        return
-
-    if not no_clipboard:
-        console.print()
-        with console.status("[cyan]Preparing clipboard…[/]", spinner="dots"):
-            cb = clipboard_handle_text(result.prompt_text, result.prompt_path)
-        print_clipboard_result(cb)
-
-
 @main.command("config")
 @click.option(
     "--reset-key",
@@ -545,16 +381,17 @@ def _run_brief(
     help="Clear the stored Gemini API key and re-run the setup prompt.",
 )
 @click.option(
-    "--set-session-key",
-    is_flag=True,
-    default=False,
-    help="Set up the Claude.ai session key used by eod/handoff's case-2 fetching.",
+    "--set-workspace",
+    default=None,
+    metavar="LOCATION",
+    help='Set your personal default for where .contextzip/ lives: "git-root", '
+    '"cwd", or a path.',
 )
 @click.option(
-    "--reset-session-key",
+    "--reset-workspace",
     is_flag=True,
     default=False,
-    help="Clear the stored Claude session key and re-run its setup prompt.",
+    help="Clear your personal workspace location override.",
 )
 @click.option(
     "--show-key-path",
@@ -564,8 +401,8 @@ def _run_brief(
 )
 def cmd_config(
     reset_key: bool,
-    set_session_key: bool,
-    reset_session_key: bool,
+    set_workspace: str | None,
+    reset_workspace: bool,
     show_key_path: bool,
 ) -> None:
     """
@@ -573,25 +410,45 @@ def cmd_config(
 
     \b
     EXAMPLES
-      contextzip config --reset-key            # clear Gemini key, re-onboard
-      contextzip config --set-session-key      # set up the Claude session key
-      contextzip config --reset-session-key    # clear it and re-run setup
-      contextzip config --show-key-path        # print config file location
+      contextzip config --reset-key                # clear Gemini key, re-onboard
+      contextzip config --set-workspace cwd         # always use ./.contextzip here
+      contextzip config --set-workspace git-root    # back to the default
+      contextzip config --set-workspace ~/zips      # a fixed custom location
+      contextzip config --reset-workspace           # clear the personal override
+      contextzip config --show-key-path             # print config file location
+
+    \b
+    A workspace location can also be pinned for the whole team by committing
+    a .contextzip.json file at the project root:
+      {"workspace_location": "git-root"}
+    Project config (if present) takes priority over this personal setting —
+    see the README for the full precedence order.
     """
     if show_key_path:
         console.print(f"\n  [dim]Config file:[/] [cyan]{config_path()}[/]\n")
         return
 
-    if set_session_key or reset_session_key:
-        if reset_session_key:
-            removed = delete_session_key()
+    if set_workspace is not None or reset_workspace:
+        if reset_workspace:
+            removed = delete_workspace_location()
             if removed:
                 console.print(
-                    f"\n  [green]✓[/]  Session key removed from [dim]{config_path()}[/]"
+                    f"\n  [green]✓[/]  Workspace override removed from "
+                    f"[dim]{config_path()}[/]"
                 )
             else:
-                console.print("\n  [dim]No session key was stored.[/]")
-        onboard_session_key()
+                console.print("\n  [dim]No personal workspace override was set.[/]")
+            if set_workspace is None:
+                return
+
+        if set_workspace is not None:
+            save_workspace_location(set_workspace)
+            console.print(
+                f"\n  [green]✓[/]  Personal workspace location set to "
+                f"[cyan]{set_workspace}[/] in [dim]{config_path()}[/]\n"
+                f"  [dim]A project-level .contextzip.json, if present, still "
+                f"takes priority over this.[/]"
+            )
         return
 
     if reset_key:
@@ -645,46 +502,25 @@ def cmd_config(
         )
 
     console.print()
-    session_key = get_session_key()
-    session_from_env = bool(os.environ.get("CLAUDE_SESSION_KEY", "").strip())
-
-    if session_key:
-        masked = (
-            session_key[:6] + "…" + session_key[-4:]
-            if len(session_key) > 10
-            else "****"
-        )
-        source = (
-            "[dim](from environment variable)[/]"
-            if session_from_env
-            else f"[dim]({config_path()})[/]"
-        )
-        console.print(
-            Panel(
-                f"  [dim]Claude session key:[/]  [green]{masked}[/]  {source}\n\n"
-                "  [dim]Used by [cyan]eod[/]/[cyan]handoff[/] for case-2 fetching. "
-                "Run [cyan]contextzip config --reset-session-key[/] to change it.[/]",
-                title="[bold]contextzip config[/]",
-                border_style="cyan",
-                padding=(0, 2),
-            )
-        )
-    else:
-        console.print(
-            Panel(
-                "  No Claude session key configured.\n\n"
-                "  [dim]Optional — only needed for eod/handoff's diverged-from-Claude "
-                "check.[/]\n"
-                "  Run [cyan]contextzip config --set-session-key[/] to set one up.",
-                title="[bold]contextzip config[/]",
-                border_style="yellow",
-                padding=(0, 2),
-            )
+
+    from contextzip.packager import _resolve_workspace_location
+
+    ws_location, ws_source = _resolve_workspace_location(Path(os.getcwd()).resolve())
+    console.print(
+        Panel(
+            f"  [dim]Workspace location:[/]  [green]{ws_location}[/]  [dim]({ws_source})[/]\n\n"
+            "  [dim]Run [cyan]contextzip config --set-workspace <location>[/] to set "
+            "a personal default,\n"
+            "  or commit a [cyan].contextzip.json[/] at the project root to share "
+            "one with your team.[/]",
+            title="[bold]contextzip config[/]",
+            border_style="cyan",
+            padding=(0, 2),
         )
+    )
     console.print()
 
 
-# ---------------------------------------------------------------------------
 # Core execution logic (shared by main command + all subcommands)
 # ---------------------------------------------------------------------------