agentpack-cli 0.1.0__tar.gz → 0.1.2__tar.gz

{agentpack_cli-0.1.0 → agentpack_cli-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentpack-cli
-Version: 0.1.0
+Version: 0.1.2
 Summary: Token-aware context packing for AI coding agents — Claude, Cursor, Windsurf, and Codex
 License: MIT
 License-File: LICENSE
@@ -38,7 +38,12 @@ Description-Content-Type: text/markdown
 
 # AgentPack
 
-> **Status: alpha (v0.1.0).** 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.
+[![PyPI version](https://img.shields.io/pypi/v/agentpack-cli.svg)](https://pypi.org/project/agentpack-cli/)
+[![Python versions](https://img.shields.io/pypi/pyversions/agentpack-cli.svg)](https://pypi.org/project/agentpack-cli/)
+[![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.2).** 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.
 
@@ -389,10 +394,19 @@ Token counts use tiktoken `cl100k_base` — a close approximation to Claude's ac
 
 ## CI/CD: pack per PR
 
-Add to `.github/workflows/agentpack.yml`:
+### agentpack's own CI
+
+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)
+
+### Add context packing to your repo
+
+Add to `.github/workflows/agentpack-context.yml`:
 
 ```yaml
-name: AgentPack context
+name: AgentPack context pack
 
 on:
   pull_request:
@@ -1217,7 +1231,7 @@ agentpack pack --agent claude --task "refactor database connection pooling" --mo
 
 ### CI: automated context on every PR
 
-Add to `.github/workflows/agentpack.yml` — see the full example in [CI/CD: pack per PR](#cicd-pack-per-pr). Reviewers and CI bots get focused context without cloning the repo.
+Add to `.github/workflows/agentpack-context.yml` — see the full example in [CI/CD: pack per PR](#cicd-pack-per-pr). Reviewers and CI bots get focused context without cloning the repo.
 
 ---
 

{agentpack_cli-0.1.0 → agentpack_cli-0.1.2}/README.md

@@ -1,6 +1,11 @@
 # AgentPack
 
-> **Status: alpha (v0.1.0).** 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.
+[![PyPI version](https://img.shields.io/pypi/v/agentpack-cli.svg)](https://pypi.org/project/agentpack-cli/)
+[![Python versions](https://img.shields.io/pypi/pyversions/agentpack-cli.svg)](https://pypi.org/project/agentpack-cli/)
+[![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.2).** 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.
 
@@ -351,10 +356,19 @@ Token counts use tiktoken `cl100k_base` — a close approximation to Claude's ac
 
 ## CI/CD: pack per PR
 
-Add to `.github/workflows/agentpack.yml`:
+### agentpack's own CI
+
+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)
+
+### Add context packing to your repo
+
+Add to `.github/workflows/agentpack-context.yml`:
 
 ```yaml
-name: AgentPack context
+name: AgentPack context pack
 
 on:
   pull_request:
@@ -1179,7 +1193,7 @@ agentpack pack --agent claude --task "refactor database connection pooling" --mo
 
 ### CI: automated context on every PR
 
-Add to `.github/workflows/agentpack.yml` — see the full example in [CI/CD: pack per PR](#cicd-pack-per-pr). Reviewers and CI bots get focused context without cloning the repo.
+Add to `.github/workflows/agentpack-context.yml` — see the full example in [CI/CD: pack per PR](#cicd-pack-per-pr). Reviewers and CI bots get focused context without cloning the repo.
 
 ---
 

{agentpack_cli-0.1.0 → agentpack_cli-0.1.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "agentpack-cli"
-version = "0.1.0"
+version = "0.1.2"
 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.0 → agentpack_cli-0.1.2}/src/agentpack/application/pack_service.py

@@ -90,9 +90,11 @@ class ChangeDetector:
         packable: list[FileInfo],
         root: Path,
         since: str | None,
+        previous_snap: dict | None = None,
     ) -> ChangeSet:
         current_snap = build_snapshot(packable)
-        previous_snap = load_snapshot(root)
+        if previous_snap is None:
+            previous_snap = load_snapshot(root)
         snap_diff = diff_snapshots(previous_snap, current_snap)
         changed_from_snap: set[str] = set(snap_diff.added + snap_diff.modified)
 
@@ -160,7 +162,8 @@ class PackPlanner:
         phase_times: dict[str, float] = {}
 
         t0 = time.perf_counter()
-        scan_result = scan(root, ignore_spec, cfg.context.max_file_tokens)
+        previous_snap = load_snapshot(root)
+        scan_result = scan(root, ignore_spec, cfg.context.max_file_tokens, previous_snapshot=previous_snap)
         phase_times["scan"] = time.perf_counter() - t0
 
         packable = scan_result.packable
@@ -175,7 +178,7 @@ class PackPlanner:
         phase_times["deps"] = time.perf_counter() - t0
 
         t0 = time.perf_counter()
-        changes = ChangeDetector().detect(packable, root, request.since)
+        changes = ChangeDetector().detect(packable, root, request.since, previous_snap=previous_snap)
         phase_times["changes"] = time.perf_counter() - t0
 
         t0 = time.perf_counter()

{agentpack_cli-0.1.0 → agentpack_cli-0.1.2}/src/agentpack/commands/session.py

@@ -25,9 +25,12 @@ def register(app: typer.Typer) -> None:
         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:
         """Start a session: create state files and generate initial context."""
         root = _root()
+        if silent:
+            console.quiet = True
         state = create_session(root, agent=agent, mode=mode)
 
         if task:

{agentpack_cli-0.1.0 → agentpack_cli-0.1.2}/src/agentpack/commands/watch.py

@@ -117,6 +117,11 @@ def _watch_with_watchdog(
     try:
         while True:
             time.sleep(0.5)
+            current_state = load_session(root)
+            if current_state is not None and not current_state.active:
+                console.print("\n[dim]Session stopped — watch exiting.[/]")
+                observer.stop()
+                break
             if _pending[0]:
                 now = time.monotonic()
                 if now - _last_refresh[0] >= debounce:
@@ -164,6 +169,10 @@ def _watch_polling(
     try:
         while True:
             time.sleep(_POLL_INTERVAL)
+            current_state = load_session(root)
+            if current_state is not None and not current_state.active:
+                console.print("\n[dim]Session stopped — watch exiting.[/]")
+                break
             curr = _collect_mtimes()
             changed = {p for p, m in curr.items() if prev.get(p) != m}
             changed |= set(prev) - set(curr)

{agentpack_cli-0.1.0 → agentpack_cli-0.1.2}/src/agentpack/core/git.py

@@ -77,7 +77,8 @@ def changed_files_since(root: Path, ref: str) -> set[str]:
 def infer_task_from_git(root: Path) -> str:
     """Infer a task description from branch name, changed files, and recent commits.
 
-    Priority: branch name (explicit intent) → changed file paths (current work) → recent commit.
+    Priority: branch name + changed files → branch name → changed files →
+              recent commit messages (up to 3) → recently modified files → fallback.
     """
     branch: str | None = None
     branch_out = _run(["git", "rev-parse", "--abbrev-ref", "HEAD"], root)
@@ -91,9 +92,9 @@ def infer_task_from_git(root: Path) -> str:
     changed = changed_files(root)
     file_topic = _topic_from_paths(changed) if changed else None
 
-    # Fallback: most recent non-merge commit
-    commit: str | None = None
-    log_out = _run(["git", "log", "--oneline", "-5"], root)
+    # Collect recent non-merge commit messages (up to 3) for richer fallback
+    commit_msgs: list[str] = []
+    log_out = _run(["git", "log", "--oneline", "-10"], root)
     if log_out:
         for line in log_out.splitlines():
             line = line.strip()
@@ -101,17 +102,29 @@ def infer_task_from_git(root: Path) -> str:
                 continue
             msg = line.split(" ", 1)[1] if " " in line else line
             if not msg.lower().startswith("merge "):
-                commit = msg
+                commit_msgs.append(msg)
+            if len(commit_msgs) == 3:
                 break
 
+    # When branch is clean (no changed files), fall back to recently touched files
+    # so keyword scoring has something to work with beyond the branch name alone.
+    if not file_topic and not branch:
+        recent = recently_modified_files(root, n=10)
+        file_topic = _topic_from_paths(set(recent)) if recent else None
+
     if branch and file_topic:
         return f"{branch}: {file_topic}"
+    if branch and commit_msgs:
+        # Augment bare branch name with latest commit context
+        return f"{branch}: {commit_msgs[0]}"
     if branch:
         return branch
+    if file_topic and commit_msgs:
+        return f"{file_topic}: {commit_msgs[0]}"
     if file_topic:
         return file_topic
-    if commit:
-        return commit
+    if commit_msgs:
+        return "; ".join(commit_msgs[:2])
     return "general development"
 
 

{agentpack_cli-0.1.0 → agentpack_cli-0.1.2}/src/agentpack/core/ignore.py

@@ -51,6 +51,9 @@ Gemfile.lock
 *.csv
 *.jsonl
 *.parquet
+
+# claude code internals
+.claude/worktrees/
 """
 
 

{agentpack_cli-0.1.0 → agentpack_cli-0.1.2}/src/agentpack/core/scanner.py

@@ -7,7 +7,7 @@ import pathspec
 
 from agentpack.core.ignore import load_spec, is_ignored
 from agentpack.core.models import FileInfo, ScanResult
-from agentpack.core.token_estimator import estimate_tokens
+from agentpack.core.token_estimator import estimate_tokens, estimate_tokens_bytes
 
 BINARY_EXTENSIONS = {
     ".png", ".jpg", ".jpeg", ".gif", ".bmp", ".ico", ".svg",
@@ -54,7 +54,7 @@ LANGUAGE_MAP: dict[str, str] = {
     ".xml": "xml",
 }
 
-ALWAYS_SKIP = {".git", ".agentpack"}
+ALWAYS_SKIP = {".git", ".agentpack", ".claude"}
 
 
 def file_hash(path: Path) -> str:
@@ -79,11 +79,14 @@ def scan(
     root: Path,
     ignore_spec: pathspec.PathSpec,
     max_file_tokens: int = 4000,
+    previous_snapshot: dict | None = None,
 ) -> ScanResult:
     packable: list[FileInfo] = []
     ignored: list[FileInfo] = []
     binary: list[FileInfo] = []
 
+    prev_files: dict[str, dict] = (previous_snapshot or {}).get("files", {})
+
     for abs_path in root.rglob("*"):
         if not abs_path.is_file():
             continue
@@ -125,6 +128,27 @@ def scan(
 
         size = abs_path.stat().st_size
         lang = LANGUAGE_MAP.get(abs_path.suffix.lower())
+        fhash = file_hash(abs_path)
+
+        # Unchanged file: reuse cached token count, skip content read.
+        # Content is loaded lazily by context_pack.select_files() when needed.
+        prev = prev_files.get(rel_str)
+        if prev and prev.get("hash") == fhash:
+            cached_tokens = prev.get("estimated_tokens", estimate_tokens_bytes(size))
+            too_large = cached_tokens > max_file_tokens
+            packable.append(
+                FileInfo(
+                    path=rel_str,
+                    abs_path=abs_path,
+                    language=lang,
+                    size_bytes=size,
+                    estimated_tokens=cached_tokens,
+                    hash=fhash,
+                    too_large=too_large,
+                    content=None,
+                )
+            )
+            continue
 
         try:
             text = abs_path.read_text(errors="replace")
@@ -141,7 +165,7 @@ def scan(
                 language=lang,
                 size_bytes=size,
                 estimated_tokens=tokens,
-                hash=file_hash(abs_path),
+                hash=fhash,
                 too_large=too_large,
                 content=text,
             )

agentpack_cli-0.1.2/src/agentpack/core/token_estimator.py

@@ -0,0 +1,40 @@
+from __future__ import annotations
+
+import os
+
+_encoder = None
+
+
+def _get_encoder():
+    global _encoder
+    if _encoder is None:
+        try:
+            import tiktoken
+            # Only load tiktoken if its vocab cache already exists — avoids
+            # a blocking network download when running inside git hooks.
+            cache_dir = os.environ.get(
+                "TIKTOKEN_CACHE_DIR",
+                os.path.join(os.path.expanduser("~"), ".cache", "huggingface", "hub"),
+            )
+            tiktoken_cache = os.path.join(os.path.expanduser("~"), ".cache", "tiktoken")
+            cache_warm = os.path.isdir(tiktoken_cache) and any(
+                True for _ in os.scandir(tiktoken_cache)
+            ) if os.path.isdir(tiktoken_cache) else False
+            if cache_warm or os.environ.get("AGENTPACK_FORCE_TIKTOKEN"):
+                _encoder = tiktoken.get_encoding("cl100k_base")
+            else:
+                _encoder = False
+        except ImportError:
+            _encoder = False
+    return _encoder
+
+
+def estimate_tokens(text: str) -> int:
+    enc = _get_encoder()
+    if enc:
+        return max(1, len(enc.encode(text, disallowed_special=())))
+    return max(1, len(text) // 4)
+
+
+def estimate_tokens_bytes(size_bytes: int) -> int:
+    return max(1, size_bytes // 4)

{agentpack_cli-0.1.0 → agentpack_cli-0.1.2}/src/agentpack/installers/claude.py

@@ -124,7 +124,17 @@ class ClaudeInstaller:
             "                         stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)\n"
             "if not ctx.exists(): sys.exit(0)\n"
             "content = ctx.read_text()\n"
-            "if len(content) > 60000: content = content[:60000] + '\\n... [truncated]'\n"
+            "if len(content) > 60000:\n"
+            "    lines = content.splitlines(keepends=True)\n"
+            "    kept, total, omit_start = [], 0, None\n"
+            "    for i, line in enumerate(lines):\n"
+            "        if total + len(line) > 60000:\n"
+            "            omit_start = i\n"
+            "            break\n"
+            "        kept.append(line)\n"
+            "        total += len(line)\n"
+            "    omitted = len(lines) - (omit_start or len(lines))\n"
+            "    content = ''.join(kept) + f'\\n\\n... [truncated: {omitted} lines omitted]'\n"
             "sentinel.write_text(current_hash or '1')\n"
             "print(json.dumps({'hookSpecificOutput': {'hookEventName': 'UserPromptSubmit',\n"
             "    'additionalContext': '[agentpack: context injected]\\n\\n' + content}}))\n"

{agentpack_cli-0.1.0 → agentpack_cli-0.1.2}/src/agentpack/integrations/global_install.py

@@ -12,26 +12,28 @@ from pathlib import Path
 _GIT_TEMPLATE_DIR = Path.home() / ".git-templates"
 _AGENTPACK_MARKER = "# agentpack:global"
 
+_REPACK_CMD = """\
+  ( agentpack pack --task auto --mode balanced >/dev/null 2>&1 &
+    _ap_pid=$! ; ( sleep 30 && kill $_ap_pid 2>/dev/null ) &
+  )"""
+
 _POST_CHECKOUT_SCRIPT = """\
 #!/bin/sh
 # agentpack:global
 # Repack only if this repo has already been opted in to agentpack.
-[ -f .agentpack/config.toml ] && agentpack pack --task auto --mode balanced >/dev/null 2>&1 &
-"""
+[ -f .agentpack/config.toml ] && """ + _REPACK_CMD.strip() + "\n"
 
 _POST_COMMIT_SCRIPT = """\
 #!/bin/sh
 # agentpack:global
 # Repack only if this repo has already been opted in to agentpack.
-[ -f .agentpack/config.toml ] && agentpack pack --task auto --mode balanced >/dev/null 2>&1 &
-"""
+[ -f .agentpack/config.toml ] && """ + _REPACK_CMD.strip() + "\n"
 
 _POST_MERGE_SCRIPT = """\
 #!/bin/sh
 # agentpack:global
 # Repack only if this repo has already been opted in to agentpack.
-[ -f .agentpack/config.toml ] && agentpack pack --task auto --mode balanced >/dev/null 2>&1 &
-"""
+[ -f .agentpack/config.toml ] && """ + _REPACK_CMD.strip() + "\n"
 
 _HOOK_SCRIPTS = {
     "post-checkout": _POST_CHECKOUT_SCRIPT,
@@ -142,7 +144,11 @@ _agentpack_chpwd() {
   # Only act on repos explicitly opted in (have .agentpack/config.toml).
   # Does NOT auto-init unknown repos — that's an explicit 'agentpack init' decision.
   if [ -f .agentpack/config.toml ]; then
-    agentpack status >/dev/null 2>&1 || agentpack pack --task auto --mode balanced >/dev/null 2>&1 &
+    if [ ! -f .agentpack/context.md ] && [ ! -f .agentpack/session.json ]; then
+      agentpack session start --silent >/dev/null 2>&1 &
+    else
+      agentpack status >/dev/null 2>&1 || agentpack pack --task auto --mode balanced >/dev/null 2>&1 &
+    fi
   fi
 }
 autoload -Uz add-zsh-hook
@@ -154,7 +160,11 @@ _BASH_HOOK = """\
 _agentpack_chpwd() {
   # Only act on repos explicitly opted in (have .agentpack/config.toml).
   if [ -f .agentpack/config.toml ]; then
-    agentpack status >/dev/null 2>&1 || agentpack pack --task auto --mode balanced >/dev/null 2>&1 &
+    if [ ! -f .agentpack/context.md ] && [ ! -f .agentpack/session.json ]; then
+      agentpack session start --silent >/dev/null 2>&1 &
+    else
+      agentpack status >/dev/null 2>&1 || agentpack pack --task auto --mode balanced >/dev/null 2>&1 &
+    fi
   fi
 }
 if [[ "$PROMPT_COMMAND" != *"_agentpack_chpwd"* ]]; then

agentpack_cli-0.1.0/src/agentpack/core/token_estimator.py

@@ -1,26 +0,0 @@
-from __future__ import annotations
-
-_encoder = None
-
-
-def _get_encoder():
-    global _encoder
-    if _encoder is None:
-        try:
-            import tiktoken
-            _encoder = tiktoken.get_encoding("cl100k_base")
-        except ImportError:
-            _encoder = False
-    return _encoder
-
-
-def estimate_tokens(text: str) -> int:
-    enc = _get_encoder()
-    if enc:
-        return max(1, len(enc.encode(text, disallowed_special=())))
-    return max(1, len(text) // 4)
-
-
-def estimate_tokens_bytes(size_bytes: int) -> int:
-    # byte-level fallback when text is unavailable
-    return max(1, size_bytes // 4)