agentpack-cli 0.1.7__tar.gz → 0.1.9__tar.gz

{agentpack_cli-0.1.7 → agentpack_cli-0.1.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentpack-cli
-Version: 0.1.7
+Version: 0.1.9
 Summary: Token-aware context packing for AI coding agents — Claude, Cursor, Windsurf, and Codex
 License: MIT
 License-File: LICENSE
@@ -23,17 +23,15 @@ Requires-Dist: tomli-w>=1.0.0
 Requires-Dist: tomli>=2.0.0; python_version < '3.11'
 Requires-Dist: typer>=0.12.0
 Provides-Extra: all
-Requires-Dist: anthropic>=0.39.0; extra == 'all'
-Requires-Dist: openai>=1.0.0; extra == 'all'
+Requires-Dist: mcp>=1.0.0; extra == 'all'
 Requires-Dist: watchdog>=4.0.0; extra == 'all'
 Provides-Extra: dev
 Requires-Dist: mypy; extra == 'dev'
 Requires-Dist: pytest; extra == 'dev'
 Requires-Dist: ruff; extra == 'dev'
 Requires-Dist: tomli>=2.0.0; (python_version < '3.11') and extra == 'dev'
-Provides-Extra: llm
-Requires-Dist: anthropic>=0.39.0; extra == 'llm'
-Requires-Dist: openai>=1.0.0; extra == 'llm'
+Provides-Extra: mcp
+Requires-Dist: mcp>=1.0.0; extra == 'mcp'
 Provides-Extra: watch
 Requires-Dist: watchdog>=4.0.0; extra == 'watch'
 Description-Content-Type: text/markdown
@@ -45,7 +43,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.5).** 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.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.
 >
 > **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.
 
@@ -81,12 +79,13 @@ The result: your agent starts every session with a focused, accurate picture of
 ```bash
 pip install agentpack-cli
 
-# Session mode: start once, then work normally
+# One-time setup per project
 cd your-project
-agentpack init
-agentpack install          # auto-detects your IDE
-agentpack session start
-agentpack watch   # in another terminal — keeps context fresh automatically
+agentpack init             # creates config, session, task.md — nothing else needed
+agentpack install          # auto-detects your IDE (optional but recommended)
+
+# Every terminal session
+agentpack watch            # keeps context fresh automatically — that's it
 ```
 
 Then open Claude Code / Cursor / Windsurf / Codex / Antigravity and write your task normally. AgentPack keeps `.agentpack/context.md` current.
@@ -221,17 +220,20 @@ Requires Python 3.10+.
 
 ## Start Once, Then Work Normally
 
-The recommended workflow for repeated development sessions:
+The full workflow:
 
 ```bash
-agentpack install          # configure your agent (once per project)
-agentpack session start    # create session state + generate initial context
-agentpack watch            # in another terminal — refreshes context on file/task changes
+# One-time project setup
+agentpack init             # creates config, session, task.md
+agentpack install          # configure your agent (optional but recommended)
+
+# Every terminal session — just one command
+agentpack watch            # auto-resumes session, refreshes context on file/task changes
 ```
 
 Then open Claude Code / Cursor / Codex and write your coding task normally.
 
-- AgentPack keeps `.agentpack/context.md` fresh while `watch` is running.
+- 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`
@@ -242,11 +244,11 @@ Then open Claude Code / Cursor / Codex and write your coding task normally.
 | Agent | Automation level | Method |
 |---|---|---|
 | Claude Code (hook) | Highest | `UserPromptSubmit` hook auto-injects context |
-| Claude Code (session) | High | `session start` + `watch` + read `context.md` |
-| Codex | Medium | `AGENTS.md` + `session start` + `watch` |
-| Cursor | Medium | `.cursor/rules/agentpack.mdc` + `session start` + `watch` |
-| Windsurf | Medium | `.windsurfrules` + `session start` + `watch` |
-| Antigravity | Medium | `.agent/skills/agentpack/SKILL.md` + `GEMINI.md` + `session start` + `watch` |
+| 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` |
+| Antigravity | Medium | `.agent/skills/agentpack/SKILL.md` + `GEMINI.md` + `init` + `watch` |
 | Generic | Basic | `watch` mode + read `context.md` |
 
 ### Honest limitations
@@ -263,10 +265,9 @@ Then open Claude Code / Cursor / Codex and write your coding task normally.
 ```bash
 pip install agentpack-cli
 cd your-project
-agentpack init
+agentpack init             # one-time setup: config + session + task.md
 agentpack install          # auto-detects your IDE (Claude Code, Cursor, Windsurf, Codex, Antigravity)
-agentpack session start    # generate initial context
-agentpack watch            # in another terminal — keeps context fresh
+agentpack watch            # in another terminal — keeps context fresh automatically
 ```
 
 Then open your agent and write your task normally.
@@ -592,14 +593,14 @@ All installs are idempotent — safe to re-run, merge with existing config, neve
 
 ### `agentpack summarize`
 
-Build or refresh the offline summary cache. **No API calls.**
+Build or refresh the offline summary cache. **No API calls, ever.**
 
 ```bash
 agentpack summarize              # build summaries for all files not yet cached
 agentpack summarize --refresh    # force rebuild all
 ```
 
-Run this once after `init`. After that, pack automatically rebuilds summaries only for changed files.
+Summaries are built with parallel AST/regex analysis — no network, no tokens spent. Run once after `init`. After that, pack automatically rebuilds summaries only for changed files (hash-keyed cache).
 
 ---
 
@@ -629,6 +630,7 @@ Options:
 | `--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:**
 
@@ -642,22 +644,23 @@ Options:
 
 ### `agentpack session`
 
-Manage AgentPack sessions — the "start once, work normally" workflow.
+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                      # create session, generate initial context
+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"     # set initial task
+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
 ```
 
-`session start` creates:
+`agentpack init` creates (idempotently):
 - `.agentpack/session.json` — session state
-- `.agentpack/task.md` — current task (written by Claude or `session refresh --task`)
-- `.agentpack/context.md` — readable context pack
+- `.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
 
 ---
@@ -688,7 +691,48 @@ Launch Claude CLI with an up-to-date context.
 agentpack claude
 ```
 
-Requires an active session (`agentpack session start`). Refreshes context, prints the context path, then launches `claude` if found. Transparent about what it does — no fake prompt injection.
+Requires an initialized project (`agentpack init`). Refreshes context, prints the context path, then launches `claude` if found. Transparent about what it does — no fake prompt injection.
+
+---
+
+### `agentpack mcp`
+
+Run AgentPack as an MCP server — exposes context packing as tools that Claude Code (and any MCP-compatible agent) can call directly.
+
+```bash
+pip install "agentpack-cli[mcp]"
+agentpack mcp
+```
+
+Register in Claude Code settings (`~/.claude/settings.json`):
+
+```json
+{
+  "mcpServers": {
+    "agentpack": {
+      "command": "agentpack",
+      "args": ["mcp"]
+    }
+  }
+}
+```
+
+**Tools exposed:**
+
+| Tool | Description |
+|---|---|
+| `pack_context(task, mode, budget, max_tokens)` | Generate a ranked context pack for a task. Returns packed markdown, truncated to `max_tokens` (default 20,000). |
+| `get_context()` | Return the latest pre-built pack instantly (no repack). Prepends a freshness/staleness header so you know if it's stale. |
+| `refresh()` | Refresh using the current `task.md` or git-inferred task. |
+
+**Staleness detection:** `get_context()` compares the snapshot hash from when the pack was built against the current repo snapshot. If files changed since last pack, it prepends:
+```
+> **Stale context** — repo changed since last pack (generated: ...). Run pack_context() to refresh.
+```
+
+**Smart truncation:** `pack_context()` keeps headers intact and trims file content blocks to fit the token budget, appending a note about how many files were omitted.
+
+Zero API calls — all analysis is offline. Summary cache keyed by file hash: cold run parallelises AST parsing across CPU cores; warm cache hits are instant.
 
 ---
 
@@ -913,10 +957,6 @@ include_tests = true
 include_configs = true
 include_receipts = true
 
-[summary]
-provider = "offline"
-schema_version = 1
-
 [agents.claude]
 output = ".agentpack/context.claude.md"
 patch_claude_md = true
@@ -1019,7 +1059,6 @@ Works like `.gitignore`. Default rules exclude:
           │  miss → build from AST/regex, cache it  │
           │                                         │
           │  offline  ──  AST / regex extract       │
-          │  claude   ──  Haiku API (optional)      │
           └────────────────────┬────────────────────┘
                                │
           ┌────────────────────▼────────────────────┐
@@ -1120,8 +1159,7 @@ src/agentpack/
 
   summaries/
     offline.py                 # zero-API: AST/regex → imports, symbols, summary
-    llm.py                     # Claude Haiku API summaries (optional)
-    base.py                    # cache-or-build orchestration
+    base.py                    # cache-or-build orchestration (parallel, ThreadPool+ProcessPool)
 
   adapters/                    # context rendering only — no installation logic
     base.py                    # abstract BaseAdapter (output_path + render + write)
@@ -1240,13 +1278,14 @@ Add to `.github/workflows/agentpack-context.yml` — see the full example in [CI
 ### Session mode: keep context fresh while you work
 
 ```bash
-# Terminal 1: start a session and watch for changes
-agentpack session start --task "refactor auth"
-agentpack watch   # in a second terminal — refreshes context on every save
+# One-time project setup
+agentpack init --task "refactor auth"   # or edit .agentpack/task.md directly
+
+# Every terminal session — just one command
+agentpack watch   # auto-resumes session, refreshes context on every save
 
-# Terminal 2: your editor / agent
-# Save a file → context.md regenerates automatically
-# Change task: agentpack session refresh --task "new task"
+# Change task mid-session
+agentpack session refresh --task "new task"
 ```
 
 ---
@@ -1316,8 +1355,8 @@ agentpack pack --task "fix bug" --budget 40000   # explicit token cap
 ### Watch mode for active sessions
 
 ```bash
-agentpack session start --task "refactor auth"
-agentpack watch   # in another terminal
+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.
@@ -1357,10 +1396,10 @@ config_file     = 60   # was 25 — configs always matter here
 
 ## Principles
 
-- **Local-first**: `init`, `scan`, `diff`, `pack`, `stats`, `summarize` make zero API calls by default
+- **Local-first**: `init`, `scan`, `diff`, `pack`, `stats`, `summarize` make zero API calls — ever. No optional LLM paths, no per-file costs.
 - **Non-destructive**: never overwrites user files; config patching only touches agentpack-managed blocks
 - **Agent-neutral**: architecture is generic; Claude Code is the primary target (deepest integration); Cursor, Windsurf, Codex, and Antigravity are supported but less battle-tested
-- **No daemons**: file watching is opt-in via `agentpack watch`; session management is opt-in via `agentpack session start`; git hooks run in the background and are opt-in via `install`
+- **No daemons**: file watching is opt-in via `agentpack watch`; git hooks run in the background and are opt-in via `install`
 - **Honest**: packed token count reflects real content, not raw repo size
 
 ---
@@ -1379,9 +1418,9 @@ config_file     = 60   # was 25 — configs always matter here
 ## Optional dependencies
 
 ```bash
-pip install "agentpack-cli[llm]"      # anthropic — LLM summaries via Claude Haiku
 pip install "agentpack-cli[watch]"    # watchdog — faster file watching for agentpack watch
-pip install "agentpack-cli[all]"      # llm + watch
+pip install "agentpack-cli[mcp]"      # mcp — expose agentpack as MCP server tools
+pip install "agentpack-cli[all]"      # watch + mcp
 ```
 
 ---

{agentpack_cli-0.1.7 → agentpack_cli-0.1.9}/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.5).** 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.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.
 >
 > **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.
 
@@ -41,12 +41,13 @@ The result: your agent starts every session with a focused, accurate picture of
 ```bash
 pip install agentpack-cli
 
-# Session mode: start once, then work normally
+# One-time setup per project
 cd your-project
-agentpack init
-agentpack install          # auto-detects your IDE
-agentpack session start
-agentpack watch   # in another terminal — keeps context fresh automatically
+agentpack init             # creates config, session, task.md — nothing else needed
+agentpack install          # auto-detects your IDE (optional but recommended)
+
+# Every terminal session
+agentpack watch            # keeps context fresh automatically — that's it
 ```
 
 Then open Claude Code / Cursor / Windsurf / Codex / Antigravity and write your task normally. AgentPack keeps `.agentpack/context.md` current.
@@ -181,17 +182,20 @@ Requires Python 3.10+.
 
 ## Start Once, Then Work Normally
 
-The recommended workflow for repeated development sessions:
+The full workflow:
 
 ```bash
-agentpack install          # configure your agent (once per project)
-agentpack session start    # create session state + generate initial context
-agentpack watch            # in another terminal — refreshes context on file/task changes
+# One-time project setup
+agentpack init             # creates config, session, task.md
+agentpack install          # configure your agent (optional but recommended)
+
+# Every terminal session — just one command
+agentpack watch            # auto-resumes session, refreshes context on file/task changes
 ```
 
 Then open Claude Code / Cursor / Codex and write your coding task normally.
 
-- AgentPack keeps `.agentpack/context.md` fresh while `watch` is running.
+- 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`
@@ -202,11 +206,11 @@ Then open Claude Code / Cursor / Codex and write your coding task normally.
 | Agent | Automation level | Method |
 |---|---|---|
 | Claude Code (hook) | Highest | `UserPromptSubmit` hook auto-injects context |
-| Claude Code (session) | High | `session start` + `watch` + read `context.md` |
-| Codex | Medium | `AGENTS.md` + `session start` + `watch` |
-| Cursor | Medium | `.cursor/rules/agentpack.mdc` + `session start` + `watch` |
-| Windsurf | Medium | `.windsurfrules` + `session start` + `watch` |
-| Antigravity | Medium | `.agent/skills/agentpack/SKILL.md` + `GEMINI.md` + `session start` + `watch` |
+| 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` |
+| Antigravity | Medium | `.agent/skills/agentpack/SKILL.md` + `GEMINI.md` + `init` + `watch` |
 | Generic | Basic | `watch` mode + read `context.md` |
 
 ### Honest limitations
@@ -223,10 +227,9 @@ Then open Claude Code / Cursor / Codex and write your coding task normally.
 ```bash
 pip install agentpack-cli
 cd your-project
-agentpack init
+agentpack init             # one-time setup: config + session + task.md
 agentpack install          # auto-detects your IDE (Claude Code, Cursor, Windsurf, Codex, Antigravity)
-agentpack session start    # generate initial context
-agentpack watch            # in another terminal — keeps context fresh
+agentpack watch            # in another terminal — keeps context fresh automatically
 ```
 
 Then open your agent and write your task normally.
@@ -552,14 +555,14 @@ All installs are idempotent — safe to re-run, merge with existing config, neve
 
 ### `agentpack summarize`
 
-Build or refresh the offline summary cache. **No API calls.**
+Build or refresh the offline summary cache. **No API calls, ever.**
 
 ```bash
 agentpack summarize              # build summaries for all files not yet cached
 agentpack summarize --refresh    # force rebuild all
 ```
 
-Run this once after `init`. After that, pack automatically rebuilds summaries only for changed files.
+Summaries are built with parallel AST/regex analysis — no network, no tokens spent. Run once after `init`. After that, pack automatically rebuilds summaries only for changed files (hash-keyed cache).
 
 ---
 
@@ -589,6 +592,7 @@ Options:
 | `--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:**
 
@@ -602,22 +606,23 @@ Options:
 
 ### `agentpack session`
 
-Manage AgentPack sessions — the "start once, work normally" workflow.
+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                      # create session, generate initial context
+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"     # set initial task
+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
 ```
 
-`session start` creates:
+`agentpack init` creates (idempotently):
 - `.agentpack/session.json` — session state
-- `.agentpack/task.md` — current task (written by Claude or `session refresh --task`)
-- `.agentpack/context.md` — readable context pack
+- `.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
 
 ---
@@ -648,7 +653,48 @@ Launch Claude CLI with an up-to-date context.
 agentpack claude
 ```
 
-Requires an active session (`agentpack session start`). Refreshes context, prints the context path, then launches `claude` if found. Transparent about what it does — no fake prompt injection.
+Requires an initialized project (`agentpack init`). Refreshes context, prints the context path, then launches `claude` if found. Transparent about what it does — no fake prompt injection.
+
+---
+
+### `agentpack mcp`
+
+Run AgentPack as an MCP server — exposes context packing as tools that Claude Code (and any MCP-compatible agent) can call directly.
+
+```bash
+pip install "agentpack-cli[mcp]"
+agentpack mcp
+```
+
+Register in Claude Code settings (`~/.claude/settings.json`):
+
+```json
+{
+  "mcpServers": {
+    "agentpack": {
+      "command": "agentpack",
+      "args": ["mcp"]
+    }
+  }
+}
+```
+
+**Tools exposed:**
+
+| Tool | Description |
+|---|---|
+| `pack_context(task, mode, budget, max_tokens)` | Generate a ranked context pack for a task. Returns packed markdown, truncated to `max_tokens` (default 20,000). |
+| `get_context()` | Return the latest pre-built pack instantly (no repack). Prepends a freshness/staleness header so you know if it's stale. |
+| `refresh()` | Refresh using the current `task.md` or git-inferred task. |
+
+**Staleness detection:** `get_context()` compares the snapshot hash from when the pack was built against the current repo snapshot. If files changed since last pack, it prepends:
+```
+> **Stale context** — repo changed since last pack (generated: ...). Run pack_context() to refresh.
+```
+
+**Smart truncation:** `pack_context()` keeps headers intact and trims file content blocks to fit the token budget, appending a note about how many files were omitted.
+
+Zero API calls — all analysis is offline. Summary cache keyed by file hash: cold run parallelises AST parsing across CPU cores; warm cache hits are instant.
 
 ---
 
@@ -873,10 +919,6 @@ include_tests = true
 include_configs = true
 include_receipts = true
 
-[summary]
-provider = "offline"
-schema_version = 1
-
 [agents.claude]
 output = ".agentpack/context.claude.md"
 patch_claude_md = true
@@ -979,7 +1021,6 @@ Works like `.gitignore`. Default rules exclude:
           │  miss → build from AST/regex, cache it  │
           │                                         │
           │  offline  ──  AST / regex extract       │
-          │  claude   ──  Haiku API (optional)      │
           └────────────────────┬────────────────────┘
                                │
           ┌────────────────────▼────────────────────┐
@@ -1080,8 +1121,7 @@ src/agentpack/
 
   summaries/
     offline.py                 # zero-API: AST/regex → imports, symbols, summary
-    llm.py                     # Claude Haiku API summaries (optional)
-    base.py                    # cache-or-build orchestration
+    base.py                    # cache-or-build orchestration (parallel, ThreadPool+ProcessPool)
 
   adapters/                    # context rendering only — no installation logic
     base.py                    # abstract BaseAdapter (output_path + render + write)
@@ -1200,13 +1240,14 @@ Add to `.github/workflows/agentpack-context.yml` — see the full example in [CI
 ### Session mode: keep context fresh while you work
 
 ```bash
-# Terminal 1: start a session and watch for changes
-agentpack session start --task "refactor auth"
-agentpack watch   # in a second terminal — refreshes context on every save
+# One-time project setup
+agentpack init --task "refactor auth"   # or edit .agentpack/task.md directly
+
+# Every terminal session — just one command
+agentpack watch   # auto-resumes session, refreshes context on every save
 
-# Terminal 2: your editor / agent
-# Save a file → context.md regenerates automatically
-# Change task: agentpack session refresh --task "new task"
+# Change task mid-session
+agentpack session refresh --task "new task"
 ```
 
 ---
@@ -1276,8 +1317,8 @@ agentpack pack --task "fix bug" --budget 40000   # explicit token cap
 ### Watch mode for active sessions
 
 ```bash
-agentpack session start --task "refactor auth"
-agentpack watch   # in another terminal
+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.
@@ -1317,10 +1358,10 @@ config_file     = 60   # was 25 — configs always matter here
 
 ## Principles
 
-- **Local-first**: `init`, `scan`, `diff`, `pack`, `stats`, `summarize` make zero API calls by default
+- **Local-first**: `init`, `scan`, `diff`, `pack`, `stats`, `summarize` make zero API calls — ever. No optional LLM paths, no per-file costs.
 - **Non-destructive**: never overwrites user files; config patching only touches agentpack-managed blocks
 - **Agent-neutral**: architecture is generic; Claude Code is the primary target (deepest integration); Cursor, Windsurf, Codex, and Antigravity are supported but less battle-tested
-- **No daemons**: file watching is opt-in via `agentpack watch`; session management is opt-in via `agentpack session start`; git hooks run in the background and are opt-in via `install`
+- **No daemons**: file watching is opt-in via `agentpack watch`; git hooks run in the background and are opt-in via `install`
 - **Honest**: packed token count reflects real content, not raw repo size
 
 ---
@@ -1339,9 +1380,9 @@ config_file     = 60   # was 25 — configs always matter here
 ## Optional dependencies
 
 ```bash
-pip install "agentpack-cli[llm]"      # anthropic — LLM summaries via Claude Haiku
 pip install "agentpack-cli[watch]"    # watchdog — faster file watching for agentpack watch
-pip install "agentpack-cli[all]"      # llm + watch
+pip install "agentpack-cli[mcp]"      # mcp — expose agentpack as MCP server tools
+pip install "agentpack-cli[all]"      # watch + mcp
 ```
 
 ---

{agentpack_cli-0.1.7 → agentpack_cli-0.1.9}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "agentpack-cli"
-version = "0.1.7"
+version = "0.1.9"
 description = "Token-aware context packing for AI coding agents — Claude, Cursor, Windsurf, and Codex"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -31,19 +31,17 @@ dependencies = [
 agentpack = "agentpack.cli:app"
 
 [project.optional-dependencies]
-llm = [
-  "anthropic>=0.39.0",
-  "openai>=1.0.0"
-]
-
 watch = [
   "watchdog>=4.0.0"
 ]
 
+mcp = [
+  "mcp>=1.0.0"
+]
+
 all = [
-  "anthropic>=0.39.0",
-  "openai>=1.0.0",
-  "watchdog>=4.0.0"
+  "watchdog>=4.0.0",
+  "mcp>=1.0.0"
 ]
 
 dev = [
@@ -55,6 +53,9 @@ dev = [
 
 [tool.pytest.ini_options]
 pythonpath = ["src"]
+markers = [
+    "slow: marks tests as slow (deselect with '-m \"not slow\"')",
+]
 
 [build-system]
 requires = ["hatchling"]

{agentpack_cli-0.1.7 → agentpack_cli-0.1.9}/src/agentpack/__init__.py

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

{agentpack_cli-0.1.7 → agentpack_cli-0.1.9}/src/agentpack/application/pack_service.py

@@ -31,7 +31,6 @@ class PackRequest:
     budget: int
     since: str | None
     refresh: bool
-    summary_provider: str
 
 
 @dataclass
@@ -176,7 +175,7 @@ class PackPlanner:
         packable = scan_result.packable
 
         t0 = time.perf_counter()
-        summaries_objs = build_all_summaries(packable, root, request.summary_provider)
+        summaries_objs = build_all_summaries(packable, root)
         summaries = {p: s.model_dump() for p, s in summaries_objs.items()}
         phase_times["summarize"] = time.perf_counter() - t0
 

{agentpack_cli-0.1.7 → agentpack_cli-0.1.9}/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
+from agentpack.commands import init, scan, diff, status, stats, summarize, pack, install, monitor, explain, doctor, session, 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]:
+for mod in [init, scan, diff, status, stats, summarize, pack, install, monitor, explain, doctor, session, watch, claude_cmd, benchmark, mcp_cmd]:
     mod.register(app)