agentpack-cli 0.1.6__tar.gz → 0.1.8__tar.gz

{agentpack_cli-0.1.6 → agentpack_cli-0.1.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentpack-cli
-Version: 0.1.6
+Version: 0.1.8
 Summary: Token-aware context packing for AI coding agents — Claude, Cursor, Windsurf, and Codex
 License: MIT
 License-File: LICENSE
@@ -24,6 +24,7 @@ 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: mcp>=1.0.0; extra == 'all'
 Requires-Dist: openai>=1.0.0; extra == 'all'
 Requires-Dist: watchdog>=4.0.0; extra == 'all'
 Provides-Extra: dev
@@ -34,6 +35,8 @@ 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
@@ -81,12 +84,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 +225,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 +249,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 +270,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.
@@ -642,22 +648,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 +695,7 @@ 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.
 
 ---
 
@@ -1240,13 +1247,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 +1324,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.
@@ -1360,7 +1368,7 @@ config_file     = 60   # was 25 — configs always matter here
 - **Local-first**: `init`, `scan`, `diff`, `pack`, `stats`, `summarize` make zero API calls by default
 - **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
 
 ---

{agentpack_cli-0.1.6 → agentpack_cli-0.1.8}/README.md

@@ -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.
@@ -602,22 +605,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 +652,7 @@ 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.
 
 ---
 
@@ -1200,13 +1204,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 +1281,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.
@@ -1320,7 +1325,7 @@ config_file     = 60   # was 25 — configs always matter here
 - **Local-first**: `init`, `scan`, `diff`, `pack`, `stats`, `summarize` make zero API calls by default
 - **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
 
 ---

{agentpack_cli-0.1.6 → agentpack_cli-0.1.8}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "agentpack-cli"
-version = "0.1.6"
+version = "0.1.8"
 description = "Token-aware context packing for AI coding agents — Claude, Cursor, Windsurf, and Codex"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -40,10 +40,15 @@ 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 = [

{agentpack_cli-0.1.6 → agentpack_cli-0.1.8}/src/agentpack/analysis/ranking.py

@@ -282,6 +282,7 @@ def score_files(
     include_tests: bool = True,
     include_configs: bool = True,
     weights: ScoringWeights | None = None,
+    summaries: dict | None = None,
 ) -> list[tuple[FileInfo, float, list[str]]]:
     from agentpack.core.models import DependencyGraph as _DG
     if not isinstance(dep_graph, _DG):
@@ -312,7 +313,13 @@ def score_files(
             reasons.append("filename keyword match")
 
         node = dep_graph.get(fi.path)
-        sym_names: list[str] = []  # symbols aren't stored on DependencyNode; scoring uses path/content only
+        sym_names: list[str] = []
+        if summaries and fi.path in summaries:
+            raw_syms = summaries[fi.path].get("symbols", [])
+            sym_names = [
+                (s["name"] if isinstance(s, dict) else s.name)
+                for s in raw_syms
+            ]
         if _symbol_matches_keywords(sym_names, keywords):
             score += w.symbol_keyword
             reasons.append("symbol keyword match")

{agentpack_cli-0.1.6 → agentpack_cli-0.1.8}/src/agentpack/application/pack_service.py

@@ -128,6 +128,7 @@ class FileRanker:
         dep_graph: DependencyGraph,
         task: str,
         cfg: Any,
+        summaries: dict | None = None,
     ) -> RankResult:
         keywords = extract_keywords(task)
         keywords = enrich_keywords_from_files(keywords, changes.all_changed, packable)
@@ -147,6 +148,7 @@ class FileRanker:
             include_tests=cfg.context.include_tests,
             include_configs=cfg.context.include_configs,
             weights=cfg.scoring,
+            summaries=summaries,
         )
         return RankResult(keywords=keywords, scored=scored)
 
@@ -163,7 +165,12 @@ class PackPlanner:
 
         t0 = time.perf_counter()
         previous_snap = load_snapshot(root)
-        scan_result = scan(root, ignore_spec, cfg.context.max_file_tokens, previous_snapshot=previous_snap)
+        scan_result = scan(
+            root, ignore_spec, cfg.context.max_file_tokens,
+            previous_snapshot=previous_snap,
+            include_globs=cfg.project.include_globs or None,
+            exclude_globs=cfg.project.exclude_globs or None,
+        )
         phase_times["scan"] = time.perf_counter() - t0
 
         packable = scan_result.packable
@@ -182,7 +189,7 @@ class PackPlanner:
         phase_times["changes"] = time.perf_counter() - t0
 
         t0 = time.perf_counter()
-        rank_result = FileRanker().rank(packable, changes, dep_graph, request.task, cfg)
+        rank_result = FileRanker().rank(packable, changes, dep_graph, request.task, cfg, summaries=summaries)
         phase_times["rank"] = time.perf_counter() - t0
 
         t0 = time.perf_counter()

{agentpack_cli-0.1.6 → agentpack_cli-0.1.8}/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)