agentpack-cli 0.1.11__tar.gz → 0.1.13__tar.gz

{agentpack_cli-0.1.11 → agentpack_cli-0.1.13}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentpack-cli
-Version: 0.1.11
+Version: 0.1.13
 Summary: Token-aware context packing for AI coding agents — Claude, Cursor, Windsurf, and Codex
 License: MIT
 License-File: LICENSE
@@ -44,7 +44,7 @@ Description-Content-Type: text/markdown
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![CI](https://github.com/vishal2612200/agentpack/actions/workflows/ci.yml/badge.svg)](https://github.com/vishal2612200/agentpack/actions/workflows/ci.yml)
 
-> **Status: alpha (v0.1.9).** Works, tested, used in real sessions. Python and JavaScript/TypeScript are the best-supported languages. Not yet validated across a wide range of repos. API may change before 1.0.
+> **Status: alpha (v0.1.11).** Works, tested, used in real sessions. Python and JavaScript/TypeScript are the best-supported languages. Not yet validated across a wide range of repos. API may change before 1.0.
 >
 > **Platform note:** macOS and Linux are fully supported. Windows support is not yet implemented (git hooks use POSIX shell; the Claude Code session hooks use `python3`/`rm -f`). Contributions welcome.
 
@@ -235,17 +235,13 @@ agentpack watch            # auto-resumes session, refreshes context on file/tas
 Then open Claude Code / Cursor / Codex and write your coding task normally.
 
 - AgentPack keeps `.agentpack/context.md` and `.agentpack/context.claude.md` fresh while `watch` is running.
-- To change the task: `agentpack session refresh --task "new task"` — or just tell Claude and it updates `task.md` itself.
-- Check session state: `agentpack session status`
-- Force a refresh: `agentpack session refresh`
-- Stop: `agentpack session stop`
+- To change the task: edit `.agentpack/task.md` directly, or tell Claude — it updates the file itself. `watch` picks up the change automatically.
 
 ### Agent integration matrix
 
 | Agent | Automation level | Method |
 |---|---|---|
 | Claude Code (hook) | Highest | `UserPromptSubmit` hook auto-injects context |
-| Claude Code (session) | High | `init` + `watch` + read `context.md` |
 | Codex | Medium | `AGENTS.md` + `init` + `watch` |
 | Cursor | Medium | `.cursor/rules/agentpack.mdc` + `init` + `watch` |
 | Windsurf | Medium | `.windsurfrules` + `init` + `watch` |
@@ -404,8 +400,8 @@ Token counts use tiktoken `cl100k_base` — a close approximation to Claude's ac
 
 agentpack uses two workflows:
 
-- **`ci.yml`** — runs tests on Python 3.10–3.13 on every push and pull request to `main`
-- **`release.yml`** — runs tests then publishes to PyPI on every `v*` tag push (uses PyPI trusted publishing)
+- **`ci.yml`** — runs tests (Python 3.10–3.13) + ruff lint + 80% coverage gate on every push and PR to `main`
+- **`publish.yml`** — runs on every `v*` tag push; requires tag from a `release/*` branch and a CHANGELOG.md entry for the version before building and publishing to PyPI (trusted publishing)
 
 ### Add context packing to your repo
 
@@ -627,11 +623,10 @@ Options:
 | `--agent` | `auto` | Target agent (`auto` \| `claude` \| `cursor` \| `windsurf` \| `codex` \| `antigravity` \| `generic`). `auto` detects the active IDE from env and project files. |
 | `--task` | `auto` | Task description, or `auto` to infer from git |
 | `--mode` | `balanced` | Budget mode: `minimal`, `balanced`, `deep` |
-| `--budget` | 25000 | Token budget |
+| `--budget` | 0 (uses config default 25000) | Token budget |
 | `--since` | — | Only include files changed since this git ref |
 | `--session` | off | Re-pack on every file change (watch mode) |
 | `--refresh` | off | Force rebuild summaries before packing |
-| `--budget` | 25000 | Token budget override |
 
 **Budget modes:**
 
@@ -643,26 +638,9 @@ Options:
 
 ---
 
-### `agentpack session`
+### `agentpack session` _(removed)_
 
-Optional session management. `agentpack init` bootstraps the session automatically — `session start` is only needed to change agent/mode after init or force a fresh pack.
-
-```bash
-agentpack session start                      # re-run to change agent/mode or force refresh
-agentpack session start --agent claude       # set agent (claude|cursor|codex|generic)
-agentpack session start --task "fix bug"     # change task + refresh context
-agentpack session status                     # show session state + context size
-agentpack session refresh                    # regenerate context now
-agentpack session refresh --task "new task"  # change task + refresh
-agentpack session stop                       # mark session inactive
-```
-
-`agentpack init` creates (idempotently):
-- `.agentpack/session.json` — session state
-- `.agentpack/task.md` — current task (edit directly or use `session refresh --task`)
-- `.agentpack/context.md` — readable context pack (updated by `watch`)
-- `.agentpack/context.claude.md` — Claude Code format (always written alongside context.md)
-- `.agentpack/context.compact.md` — compact protocol format
+Session management was removed in v0.1.11. `agentpack init` bootstraps the session automatically. Use `agentpack watch` to keep context current. To change the task, edit `.agentpack/task.md`.
 
 ---
 
@@ -1280,13 +1258,14 @@ Add to `.github/workflows/agentpack-context.yml` — see the full example in [CI
 
 ```bash
 # One-time project setup
-agentpack init --task "refactor auth"   # or edit .agentpack/task.md directly
+agentpack init                     # creates config, session, task.md
+# Edit .agentpack/task.md to set your task
 
 # Every terminal session — just one command
-agentpack watch   # auto-resumes session, refreshes context on every save
+agentpack watch                    # keeps context fresh automatically
 
-# Change task mid-session
-agentpack session refresh --task "new task"
+# Change task mid-session: edit .agentpack/task.md directly
+# watch detects the change and refreshes automatically
 ```
 
 ---
@@ -1360,7 +1339,7 @@ agentpack init                  # one-time setup (creates session + task.md)
 agentpack watch                 # in another terminal — auto-resumes each time
 ```
 
-Refreshes `.agentpack/context.md` every time you save a file. Change the task with `agentpack session refresh --task "..."` — or tell Claude and it writes `task.md` itself.
+Refreshes `.agentpack/context.md` every time you save a file. Change the task by editing `.agentpack/task.md` directly — or tell Claude and it writes the file itself. `watch` picks up the change automatically.
 
 ### Debug file selection with `explain`
 

{agentpack_cli-0.1.11 → agentpack_cli-0.1.13}/README.md

@@ -5,7 +5,7 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![CI](https://github.com/vishal2612200/agentpack/actions/workflows/ci.yml/badge.svg)](https://github.com/vishal2612200/agentpack/actions/workflows/ci.yml)
 
-> **Status: alpha (v0.1.9).** Works, tested, used in real sessions. Python and JavaScript/TypeScript are the best-supported languages. Not yet validated across a wide range of repos. API may change before 1.0.
+> **Status: alpha (v0.1.11).** Works, tested, used in real sessions. Python and JavaScript/TypeScript are the best-supported languages. Not yet validated across a wide range of repos. API may change before 1.0.
 >
 > **Platform note:** macOS and Linux are fully supported. Windows support is not yet implemented (git hooks use POSIX shell; the Claude Code session hooks use `python3`/`rm -f`). Contributions welcome.
 
@@ -196,17 +196,13 @@ agentpack watch            # auto-resumes session, refreshes context on file/tas
 Then open Claude Code / Cursor / Codex and write your coding task normally.
 
 - AgentPack keeps `.agentpack/context.md` and `.agentpack/context.claude.md` fresh while `watch` is running.
-- To change the task: `agentpack session refresh --task "new task"` — or just tell Claude and it updates `task.md` itself.
-- Check session state: `agentpack session status`
-- Force a refresh: `agentpack session refresh`
-- Stop: `agentpack session stop`
+- To change the task: edit `.agentpack/task.md` directly, or tell Claude — it updates the file itself. `watch` picks up the change automatically.
 
 ### Agent integration matrix
 
 | Agent | Automation level | Method |
 |---|---|---|
 | Claude Code (hook) | Highest | `UserPromptSubmit` hook auto-injects context |
-| Claude Code (session) | High | `init` + `watch` + read `context.md` |
 | Codex | Medium | `AGENTS.md` + `init` + `watch` |
 | Cursor | Medium | `.cursor/rules/agentpack.mdc` + `init` + `watch` |
 | Windsurf | Medium | `.windsurfrules` + `init` + `watch` |
@@ -365,8 +361,8 @@ Token counts use tiktoken `cl100k_base` — a close approximation to Claude's ac
 
 agentpack uses two workflows:
 
-- **`ci.yml`** — runs tests on Python 3.10–3.13 on every push and pull request to `main`
-- **`release.yml`** — runs tests then publishes to PyPI on every `v*` tag push (uses PyPI trusted publishing)
+- **`ci.yml`** — runs tests (Python 3.10–3.13) + ruff lint + 80% coverage gate on every push and PR to `main`
+- **`publish.yml`** — runs on every `v*` tag push; requires tag from a `release/*` branch and a CHANGELOG.md entry for the version before building and publishing to PyPI (trusted publishing)
 
 ### Add context packing to your repo
 
@@ -588,11 +584,10 @@ Options:
 | `--agent` | `auto` | Target agent (`auto` \| `claude` \| `cursor` \| `windsurf` \| `codex` \| `antigravity` \| `generic`). `auto` detects the active IDE from env and project files. |
 | `--task` | `auto` | Task description, or `auto` to infer from git |
 | `--mode` | `balanced` | Budget mode: `minimal`, `balanced`, `deep` |
-| `--budget` | 25000 | Token budget |
+| `--budget` | 0 (uses config default 25000) | Token budget |
 | `--since` | — | Only include files changed since this git ref |
 | `--session` | off | Re-pack on every file change (watch mode) |
 | `--refresh` | off | Force rebuild summaries before packing |
-| `--budget` | 25000 | Token budget override |
 
 **Budget modes:**
 
@@ -604,26 +599,9 @@ Options:
 
 ---
 
-### `agentpack session`
+### `agentpack session` _(removed)_
 
-Optional session management. `agentpack init` bootstraps the session automatically — `session start` is only needed to change agent/mode after init or force a fresh pack.
-
-```bash
-agentpack session start                      # re-run to change agent/mode or force refresh
-agentpack session start --agent claude       # set agent (claude|cursor|codex|generic)
-agentpack session start --task "fix bug"     # change task + refresh context
-agentpack session status                     # show session state + context size
-agentpack session refresh                    # regenerate context now
-agentpack session refresh --task "new task"  # change task + refresh
-agentpack session stop                       # mark session inactive
-```
-
-`agentpack init` creates (idempotently):
-- `.agentpack/session.json` — session state
-- `.agentpack/task.md` — current task (edit directly or use `session refresh --task`)
-- `.agentpack/context.md` — readable context pack (updated by `watch`)
-- `.agentpack/context.claude.md` — Claude Code format (always written alongside context.md)
-- `.agentpack/context.compact.md` — compact protocol format
+Session management was removed in v0.1.11. `agentpack init` bootstraps the session automatically. Use `agentpack watch` to keep context current. To change the task, edit `.agentpack/task.md`.
 
 ---
 
@@ -1241,13 +1219,14 @@ Add to `.github/workflows/agentpack-context.yml` — see the full example in [CI
 
 ```bash
 # One-time project setup
-agentpack init --task "refactor auth"   # or edit .agentpack/task.md directly
+agentpack init                     # creates config, session, task.md
+# Edit .agentpack/task.md to set your task
 
 # Every terminal session — just one command
-agentpack watch   # auto-resumes session, refreshes context on every save
+agentpack watch                    # keeps context fresh automatically
 
-# Change task mid-session
-agentpack session refresh --task "new task"
+# Change task mid-session: edit .agentpack/task.md directly
+# watch detects the change and refreshes automatically
 ```
 
 ---
@@ -1321,7 +1300,7 @@ agentpack init                  # one-time setup (creates session + task.md)
 agentpack watch                 # in another terminal — auto-resumes each time
 ```
 
-Refreshes `.agentpack/context.md` every time you save a file. Change the task with `agentpack session refresh --task "..."` — or tell Claude and it writes `task.md` itself.
+Refreshes `.agentpack/context.md` every time you save a file. Change the task by editing `.agentpack/task.md` directly — or tell Claude and it writes the file itself. `watch` picks up the change automatically.
 
 ### Debug file selection with `explain`
 

{agentpack_cli-0.1.11 → agentpack_cli-0.1.13}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "agentpack-cli"
-version = "0.1.11"
+version = "0.1.13"
 description = "Token-aware context packing for AI coding agents — Claude, Cursor, Windsurf, and Codex"
 readme = "README.md"
 requires-python = ">=3.10"

{agentpack_cli-0.1.11 → agentpack_cli-0.1.13}/src/agentpack/__init__.py

@@ -1,3 +1,3 @@
 """AgentPack — token-aware context packing for AI coding agents."""
 
-__version__ = "0.1.11"
+__version__ = "0.1.13"

{agentpack_cli-0.1.11 → agentpack_cli-0.1.13}/src/agentpack/cli.py

@@ -1,7 +1,7 @@
 from __future__ import annotations
 
 import typer
-from agentpack.commands import init, scan, diff, status, stats, summarize, pack, install, monitor, explain, doctor, session, watch, claude_cmd, benchmark, mcp_cmd
+from agentpack.commands import init, scan, diff, status, stats, summarize, pack, install, monitor, explain, doctor, watch, claude_cmd, benchmark, mcp_cmd
 from agentpack import __version__
 
 
@@ -21,7 +21,7 @@ def _main(
     pass
 
 
-for mod in [init, scan, diff, status, stats, summarize, pack, install, monitor, explain, doctor, session, watch, claude_cmd, benchmark, mcp_cmd]:
+for mod in [init, scan, diff, status, stats, summarize, pack, install, monitor, explain, doctor, watch, claude_cmd, benchmark, mcp_cmd]:
     mod.register(app)
 
 

agentpack_cli-0.1.13/src/agentpack/commands/_shared.py

@@ -0,0 +1,105 @@
+from __future__ import annotations
+
+import hashlib
+import os
+import tempfile
+from datetime import datetime, timezone
+from pathlib import Path
+from typing import Optional
+
+from rich.console import Console
+
+from agentpack.session.state import CONTEXT_FILE, COMPACT_FILE, TASK_FILE
+
+console = Console()
+
+_ROOT = Path(".")
+
+
+def _root() -> Path:
+    return _ROOT
+
+
+def _now_iso() -> str:
+    return datetime.now(timezone.utc).isoformat()
+
+
+def _file_hash(path: Path) -> str:
+    if not path.exists():
+        return ""
+    return hashlib.sha256(path.read_bytes()).hexdigest()[:16]
+
+
+def _atomic_write(path: Path, text: str) -> None:
+    """Write to a temp file in the same dir, then rename — atomic on POSIX."""
+    dir_ = path.parent
+    try:
+        fd, tmp = tempfile.mkstemp(dir=dir_, prefix=".tmp_")
+        try:
+            with os.fdopen(fd, "w", encoding="utf-8") as fh:
+                fh.write(text)
+            os.replace(tmp, path)
+        except Exception:
+            try:
+                os.unlink(tmp)
+            except OSError:
+                pass
+            raise
+    except OSError:
+        path.write_text(text, encoding="utf-8")
+
+
+def run_refresh(
+    root: Path,
+    agent: str,
+    mode: str,
+    budget: int,
+) -> Optional[dict]:
+    """Run PackService and write context + compact files. Returns stats dict or None on error."""
+    try:
+        from agentpack.application.pack_service import PackService, PackRequest
+        from agentpack.core import git
+        from agentpack.renderers.compact import render_compact
+        from agentpack.renderers.markdown import render_generic, render_claude
+
+        task_path = root / TASK_FILE
+        if task_path.exists():
+            raw = task_path.read_text(encoding="utf-8").strip()
+            lines = [line for line in raw.splitlines() if line.strip() and not line.startswith("#")]
+            task = lines[0].strip() if lines else ""
+        else:
+            task = ""
+
+        if not task:
+            if git.is_git_repo(root):
+                task = git.infer_task_from_git(root)
+            else:
+                task = "Current branch changes and likely related files"
+
+        result = PackService().run(PackRequest(
+            root=root,
+            agent=agent,
+            task=task,
+            mode=mode,
+            budget=budget,
+            since=None,
+            refresh=False,
+        ))
+
+        context_path = root / CONTEXT_FILE
+        context_path.parent.mkdir(parents=True, exist_ok=True)
+        _atomic_write(context_path, render_generic(result.pack))
+        _atomic_write(root / ".agentpack/context.claude.md", render_claude(result.pack))
+
+        compact_path = root / COMPACT_FILE
+        _atomic_write(compact_path, render_compact(result.pack))
+
+        return {
+            "files": len(result.pack.selected_files),
+            "tokens": result.packed_tokens,
+            "saving": result.saving_pct,
+            "out_path": result.out_path,
+        }
+    except Exception as e:
+        console.print(f"[red]Error during refresh: {e}[/]")
+        return None

{agentpack_cli-0.1.11 → agentpack_cli-0.1.13}/src/agentpack/commands/claude_cmd.py

@@ -1,13 +1,11 @@
 from __future__ import annotations
 
-import hashlib
 import shutil
 import subprocess
 
 import typer
 
-from agentpack.commands._shared import console, _root
-from agentpack.commands.session import _run_refresh, _now_iso
+from agentpack.commands._shared import console, _root, run_refresh, _now_iso, _file_hash
 from agentpack.session.state import CONTEXT_FILE, TASK_FILE, load_session, log_activity, save_session
 
 
@@ -19,12 +17,11 @@ def register(app: typer.Typer) -> None:
         state = load_session(root)
 
         if state is None or not state.active:
-            console.print("[yellow]No active session.[/]")
-            console.print("Start one with: [bold]agentpack session start[/]")
+            console.print("[yellow]No active session. Run: agentpack init[/]")
             raise typer.Exit(1)
 
         console.print("Session active. Refreshing context...")
-        result = _run_refresh(root, state.agent, state.mode, budget=0)
+        result = run_refresh(root, state.agent, state.mode, budget=0)
         if result:
             console.print(
                 f"[green]✓[/] refreshed: {result['files']} files, "
@@ -32,9 +29,7 @@ def register(app: typer.Typer) -> None:
             )
             state.last_refresh_at = _now_iso()
             state.refresh_count += 1
-            task_path = root / TASK_FILE
-            if task_path.exists():
-                state.last_task_hash = hashlib.sha256(task_path.read_bytes()).hexdigest()[:16]
+            state.last_task_hash = _file_hash(root / TASK_FILE)
             save_session(root, state)
             log_activity(root, f"claude cmd — {result['files']} files, {result['tokens']:,} tokens")
         else:

{agentpack_cli-0.1.11 → agentpack_cli-0.1.13}/src/agentpack/commands/watch.py

@@ -7,7 +7,7 @@ from pathlib import Path
 
 import typer
 
-from agentpack.commands._shared import console, _root
+from agentpack.commands._shared import console, _root, run_refresh, _file_hash, _now_iso
 from agentpack.session.state import TASK_FILE, load_session, save_session, log_activity
 
 
@@ -15,10 +15,17 @@ _IGNORE_DIRS = {
     ".git", "node_modules", ".venv", "venv", "dist", "build", ".next",
     "__pycache__", ".yarn", ".mypy_cache", ".ruff_cache", ".pytest_cache",
     ".tox", ".eggs", "*.egg-info",
+    # IDE state dirs — written constantly by editors, never user source
+    ".vscode", ".idea", ".fleet",
 }
 _IGNORE_NAMES = {"context.md", "context.compact.md"}
+_IGNORE_SUFFIXES = {".tsbuildinfo"}  # TypeScript incremental build artifacts
 # Ignore all .agentpack/ generated files; task.md is the sole exception (user-edited, triggers refresh)
 
+# Adapter output paths written outside .agentpack/ (e.g. antigravity writes .agent/skills/agentpack/SKILL.md).
+# Populated at runtime from run_refresh() return value so new adapters are covered automatically.
+_WRITTEN_PATHS: set[str] = set()
+
 _MAX_POLL_FILES = 50_000
 
 
@@ -75,21 +82,32 @@ def _should_ignore(path: str) -> bool:
     name = Path(path).name
     if name in _IGNORE_NAMES:
         return True
+    if any(name.endswith(suf) for suf in _IGNORE_SUFFIXES):
+        return True
     norm = path.replace("\\", "/")
     # Ignore everything under .agentpack/ except task.md
     if norm.startswith(".agentpack/") and norm != TASK_FILE:
         return True
+    # Ignore adapter output files written outside .agentpack/ during refresh
+    if norm in _WRITTEN_PATHS:
+        return True
     return False
 
 
 def _run_refresh(root: Path, agent: str, mode: str, budget: int) -> None:
-    from agentpack.commands.session import _run_refresh as do_refresh, _file_hash, _now_iso
     try:
-        result = do_refresh(root, agent, mode, budget)
+        result = run_refresh(root, agent, mode, budget)
     except Exception as e:
         console.print(f"[dim][{_ts()}][/] [red]refresh error: {e}[/]")
         return
     if result:
+        # Register adapter output path so _should_ignore suppresses the write event
+        out_path = result.get("out_path")
+        if out_path is not None:
+            try:
+                _WRITTEN_PATHS.add(str(Path(out_path).relative_to(root)).replace("\\", "/"))
+            except ValueError:
+                pass
         ts = _ts()
         console.print(
             f"[dim][{ts}][/] [green]refreshed:[/] {result['files']} files, "
@@ -124,7 +142,7 @@ def _watch_with_watchdog(
     _run_refresh(root, agent, mode, budget)
 
     class Handler(FileSystemEventHandler):
-        def on_any_event(self, event):  # type: ignore[override]
+        def _handle(self, event) -> None:  # type: ignore[override]
             if event.is_directory:
                 return
             try:
@@ -137,6 +155,24 @@ def _watch_with_watchdog(
                 console.print(f"[dim][{_ts()}][/] task changed")
             _pending[0] = True
 
+        # Only react to mutations — not reads (avoids inotify IN_ACCESS loop on Linux)
+        on_created = _handle
+        on_modified = _handle
+        on_deleted = _handle
+
+        def on_moved(self, event) -> None:  # type: ignore[override]
+            if event.is_directory:
+                return
+            # Check both src (rename from) and dest (rename to)
+            for raw in (event.src_path, event.dest_path):
+                try:
+                    path = str(Path(raw).relative_to(root))
+                except ValueError:
+                    continue
+                if not _should_ignore(path):
+                    _pending[0] = True
+                    return
+
     observer = Observer()
     try:
         observer.schedule(Handler(), str(root), recursive=True)

{agentpack_cli-0.1.11 → agentpack_cli-0.1.13}/src/agentpack/mcp_server.py

@@ -174,7 +174,7 @@ def serve() -> None:
         Equivalent to running `agentpack session refresh`.
         Returns summary of what was packed.
         """
-        from agentpack.commands.session import _run_refresh
+        from agentpack.commands._shared import run_refresh
         from agentpack.session.state import load_session
         from agentpack.adapters.detect import detect_agent
 
@@ -183,7 +183,7 @@ def serve() -> None:
         agent = state.agent if state else detect_agent(root)
         mode = state.mode if state else "balanced"
 
-        result = _run_refresh(root, agent, mode, 0)
+        result = run_refresh(root, agent, mode, 0)
         if result is None:
             return "Refresh failed."
         return (

agentpack_cli-0.1.11/src/agentpack/commands/_shared.py

@@ -1,13 +0,0 @@
-from __future__ import annotations
-
-from pathlib import Path
-
-from rich.console import Console
-
-console = Console()
-
-_ROOT = Path(".")
-
-
-def _root() -> Path:
-    return _ROOT

agentpack_cli-0.1.11/src/agentpack/commands/session.py

@@ -1,234 +0,0 @@
-from __future__ import annotations
-
-import hashlib
-import os
-from pathlib import Path
-from typing import Optional
-
-import typer
-from rich.table import Table
-from rich import box
-
-from agentpack.commands._shared import console, _root
-from agentpack.session.state import (
-    CONTEXT_FILE, COMPACT_FILE, TASK_FILE, SESSION_FILE,
-    create_session, load_session, save_session, stop_session, log_activity,
-)
-
-
-def register(app: typer.Typer) -> None:
-    session_app = typer.Typer(help="Manage AgentPack sessions.")
-    app.add_typer(session_app, name="session")
-
-    @session_app.command("start")
-    def start(
-        agent: str = typer.Option("auto", "--agent", help="Target agent (auto|claude|cursor|windsurf|codex|antigravity|generic)."),
-        mode: str = typer.Option("balanced", "--mode", help="Pack mode (minimal|balanced|deep)."),
-        task: str = typer.Option("", "--task", help="Initial task description."),
-        budget: int = typer.Option(0, "--budget", help="Token budget (0 = config default)."),
-        silent: bool = typer.Option(False, "--silent", help="Suppress all output (for use in hooks/scripts)."),
-    ) -> None:
-        """Refresh session and generate context. Optional — `agentpack init` already bootstraps the session.
-
-        Use this to change agent/mode after init, or to force a fresh context pack.
-        Idempotent: resumes existing session rather than recreating it.
-        """
-        root = _root()
-        if silent:
-            console.quiet = True
-
-        existing = load_session(root)
-        if existing is not None:
-            # Resume: update agent/mode only if explicitly passed, then refresh
-            if agent != "auto":
-                existing.agent = agent
-            if mode != "balanced" or existing.agent == "generic":
-                # only override mode if user explicitly chose non-default
-                if mode != "balanced":
-                    existing.mode = mode
-            existing.active = True
-            save_session(root, existing)
-            state = existing
-            console.print("[dim]Session resumed.[/]")
-        else:
-            state = create_session(root, agent=agent, mode=mode)
-            console.print()
-            console.print("[bold green]AgentPack session initialized.[/]")
-            console.print()
-            console.print(f"  [green]✓[/] {SESSION_FILE}  [dim]session state[/]")
-            console.print(f"  [green]✓[/] {TASK_FILE}  [dim]edit to set your task[/]")
-
-        if task:
-            (root / TASK_FILE).write_text(f"# Current Task\n\n{task}\n", encoding="utf-8")
-
-        result = _run_refresh(root, state.agent, state.mode, budget)
-        if result:
-            console.print(f"  [green]✓[/] {CONTEXT_FILE}  [dim]{result['files']} files, {result['tokens']:,} tokens[/]")
-            log_activity(root, f"session start — {result['files']} files, {result['tokens']:,} tokens")
-        else:
-            console.print("  [dim]✗ context generation failed — run agentpack session refresh[/]")
-            log_activity(root, "session start (context generation failed)")
-
-        console.print()
-        console.print("[bold]Next:[/]")
-        console.print("  - Run [bold]agentpack watch[/] in another terminal to auto-refresh context.")
-        console.print("  - Open your agent (Claude Code / Cursor / Windsurf / Codex / Antigravity) and ask your task normally.")
-        console.print("  - To change the task: [bold]agentpack session refresh --task \"new task\"[/]")
-        console.print()
-
-    @session_app.command("stop")
-    def stop() -> None:
-        """Stop the current session."""
-        root = _root()
-        state = load_session(root)
-        if state is None or not state.active:
-            console.print("[yellow]No active session.[/]")
-            raise typer.Exit(1)
-        stop_session(root)
-        log_activity(root, "session stopped")
-        console.print("[dim]Session stopped.[/]")
-
-    @session_app.command("status")
-    def status() -> None:
-        """Show current session status."""
-        root = _root()
-        state = load_session(root)
-        if state is None:
-            console.print("[yellow]No session found. Run: agentpack session start[/]")
-            raise typer.Exit(1)
-
-        tbl = Table(box=box.SIMPLE, show_header=False, padding=(0, 2))
-        tbl.add_column(style="dim")
-        tbl.add_column(style="bold")
-        tbl.add_row("active", "[green]yes[/]" if state.active else "[red]no[/]")
-        tbl.add_row("agent", state.agent)
-        tbl.add_row("mode", state.mode)
-        tbl.add_row("started", state.started_at or "—")
-        tbl.add_row("last refresh", state.last_refresh_at or "—")
-        tbl.add_row("refresh count", str(state.refresh_count))
-        tbl.add_row("context", str(root / CONTEXT_FILE))
-        console.print(tbl)
-
-        context_path = root / CONTEXT_FILE
-        if context_path.exists():
-            from agentpack.core.token_estimator import estimate_tokens
-            tokens = estimate_tokens(context_path.read_text(encoding="utf-8"))
-            console.print(f"[dim]context size: ~{tokens:,} tokens[/]")
-
-    @session_app.command("refresh")
-    def refresh(
-        task: str = typer.Option("", "--task", help="Override task for this refresh."),
-        budget: int = typer.Option(0, "--budget", help="Token budget override."),
-    ) -> None:
-        """Refresh context pack for the current session."""
-        root = _root()
-        state = load_session(root)
-        if state is None:
-            console.print("[yellow]No session. Run: agentpack session start[/]")
-            raise typer.Exit(1)
-
-        if task:
-            (root / TASK_FILE).write_text(f"# Current Task\n\n{task}\n", encoding="utf-8")
-
-        result = _run_refresh(root, state.agent, state.mode, budget)
-        if result:
-            state.last_refresh_at = _now_iso()
-            state.refresh_count += 1
-            state.last_task_hash = _file_hash(root / TASK_FILE)
-            save_session(root, state)
-            log_activity(root, f"refreshed — {result['files']} files, {result['tokens']:,} tokens")
-            console.print(f"[green]✓[/] refreshed: {result['files']} files, {result['tokens']:,} tokens, {result['saving']:.1f}% saving")
-        else:
-            console.print("[red]Refresh failed.[/]")
-            raise typer.Exit(1)
-
-
-def _run_refresh(
-    root: Path,
-    agent: str,
-    mode: str,
-    budget: int,
-) -> Optional[dict]:
-    """Run PackService and write context + compact files. Returns stats dict or None on error."""
-    try:
-        from agentpack.application.pack_service import PackService, PackRequest
-        from agentpack.core import git
-        from agentpack.renderers.compact import render_compact
-
-        task_path = root / TASK_FILE
-        if task_path.exists():
-            raw = task_path.read_text(encoding="utf-8").strip()
-            lines = [line for line in raw.splitlines() if line.strip() and not line.startswith("#")]
-            task = lines[0].strip() if lines else ""
-        else:
-            task = ""
-
-        if not task:
-            if git.is_git_repo(root):
-                task = git.infer_task_from_git(root)
-            else:
-                task = "Current branch changes and likely related files"
-
-        result = PackService().run(PackRequest(
-            root=root,
-            agent=agent,
-            task=task,
-            mode=mode,
-            budget=budget,
-            since=None,
-            refresh=False,
-        ))
-
-        # Write context files atomically — avoids partial reads if interrupted mid-write
-        from agentpack.renderers.markdown import render_generic, render_claude
-        context_path = root / CONTEXT_FILE
-        context_path.parent.mkdir(parents=True, exist_ok=True)
-        _atomic_write(context_path, render_generic(result.pack))
-
-        # Always write the claude-specific format too — the Claude Code hook reads this
-        # regardless of which agent the session was started with.
-        _atomic_write(root / ".agentpack/context.claude.md", render_claude(result.pack))
-
-        compact_text = render_compact(result.pack)
-        compact_path = root / COMPACT_FILE
-        _atomic_write(compact_path, compact_text)
-
-        return {
-            "files": len(result.pack.selected_files),
-            "tokens": result.packed_tokens,
-            "saving": result.saving_pct,
-        }
-    except Exception as e:
-        console.print(f"[red]Error during refresh: {e}[/]")
-        return None
-
-
-def _atomic_write(path: Path, text: str) -> None:
-    """Write to a temp file in the same dir, then rename — atomic on POSIX."""
-    import tempfile
-    dir_ = path.parent
-    try:
-        fd, tmp = tempfile.mkstemp(dir=dir_, prefix=".tmp_")
-        try:
-            with os.fdopen(fd, "w", encoding="utf-8") as fh:
-                fh.write(text)
-            os.replace(tmp, path)
-        except Exception:
-            try:
-                os.unlink(tmp)
-            except OSError:
-                pass
-            raise
-    except OSError:
-        path.write_text(text, encoding="utf-8")
-
-
-def _now_iso() -> str:
-    from datetime import datetime, timezone
-    return datetime.now(timezone.utc).isoformat()
-
-
-def _file_hash(path: Path) -> str:
-    if not path.exists():
-        return ""
-    return hashlib.sha256(path.read_bytes()).hexdigest()[:16]