agentpack-cli 0.3.24__tar.gz → 0.3.25__tar.gz

{agentpack_cli-0.3.24 → agentpack_cli-0.3.25}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentpack-cli
-Version: 0.3.24
+Version: 0.3.25
 Summary: Local context engine for AI coding agents that ranks relevant repo files and builds compact task-focused context packs for Claude Code, Codex, Cursor, Windsurf, MCP, and CI workflows.
 Project-URL: Homepage, https://github.com/vishal2612200/agentpack
 Project-URL: Documentation, https://vishal2612200.github.io/agentpack/
@@ -61,7 +61,9 @@ Description-Content-Type: text/markdown
 
 <p align="center">
   <a href="https://pypi.org/project/agentpack-cli/"><img alt="PyPI version" src="https://img.shields.io/pypi/v/agentpack-cli.svg"></a>
+  <a href="https://pepy.tech/projects/agentpack-cli"><img alt="PyPI downloads" src="https://static.pepy.tech/personalized-badge/agentpack-cli?period=total&units=INTERNATIONAL_SYSTEM&left_color=BLACK&right_color=GREEN&left_text=downloads"></a>
   <a href="https://www.npmjs.com/package/@vishal2612200/agentpack"><img alt="npm version" src="https://img.shields.io/npm/v/@vishal2612200/agentpack.svg"></a>
+  <a href="https://www.npmjs.com/package/@vishal2612200/agentpack"><img alt="npm downloads" src="https://img.shields.io/npm/dm/@vishal2612200/agentpack.svg"></a>
   <a href="https://github.com/vishal2612200/agentpack/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/vishal2612200/agentpack/actions/workflows/ci.yml/badge.svg"></a>
   <a href="https://opensource.org/licenses/MIT"><img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-yellow.svg"></a>
 </p>
@@ -69,6 +71,8 @@ Description-Content-Type: text/markdown
 <p align="center">
   <code>local preflight</code>
   <code>ranked files</code>
+  <code>skill routing</code>
+  <code>warm cache</code>
   <code>tests + commands</code>
   <code>receipts</code>
   <code>no cloud index</code>
@@ -83,6 +87,7 @@ AgentPack does the repo-orientation pass first.
 ```text
 agentpack route --task "fix auth token expiry"
 -> files that probably matter
+-> skills and rules that fit the task
 -> tests that probably prove it
 -> rules, commands, warnings
 -> compact context before the agent edits
@@ -101,7 +106,9 @@ No cloud index. No embeddings. No model calls for scan/rank/pack. Just local rep
 
 It is not a repo dump. It is not a second brain. It is not a promise that your agent will be right.
 
-It is a preflight map: likely files, likely tests, repo rules, commands, warnings, and a compact pack your agent can inspect before touching code.
+It is a preflight map: likely files, likely tests, the right local skill or rule, commands, warnings, and a compact pack your agent can inspect before touching code.
+
+The first run builds local summaries and repo signals. Later runs reuse that cache, so agents do less repeat discovery and spend more of their budget on the actual change.
 
 ## Quick Start
 
@@ -145,6 +152,7 @@ agentpack route --task "fix billing webhook retry handling"
 ```
 
 AgentPack returns likely files, tests, rules, commands, and warnings without changing source files.
+It also recommends matching skills or agent rules when the task points at a known workflow, framework, language, or repo convention.
 
 Build context pack next:
 
@@ -154,13 +162,16 @@ agentpack pack --task auto
 ```
 
 AgentPack writes local context under `.agentpack/`, including selected files, omitted-file receipts, freshness checks, and token stats.
+It reuses cached file summaries and snapshot metadata so repeated packs do not start from zero.
 
 ## What AgentPack Gives Your Agent
 
 - ranked files for current task
+- skill and rule routing for current task
 - likely tests and commands
 - repo rules and agent instructions
 - compact context pack under budget
+- cached summaries for faster repeated orientation
 - omitted-file receipts for review
 - freshness warnings when task or git state changes
 - local benchmark data when selected context misses real changed files
@@ -229,7 +240,8 @@ See [`docs/agent-plugins.md`](docs/agent-plugins.md) and [`docs/codex-plugin.md`
 | Repo dumpers | Dump selected or all files | AgentPack ranks files by task |
 | Coding agents | Edit code | AgentPack prepares context before editing |
 | IDE search | Finds files on demand | AgentPack pre-routes before agent starts |
-| Skills/rules | Change agent behavior | AgentPack changes the context the agent sees |
+| Skills/rules | Change agent behavior | AgentPack routes the matching skill or rule for the task |
+| Cache warmers | Speed repeated scans | AgentPack reuses summaries and snapshots inside the context workflow |
 
 ## When To Use It
 
@@ -241,6 +253,8 @@ Use AgentPack when:
 - CI or PR review needs reproducible context
 - agents waste tool calls opening irrelevant files
 - tasks often miss tests, config, generated rules, or repo conventions
+- teams have useful skills/rules but agents do not reliably pick the right one
+- repeated agent sessions keep rediscovering the same repo structure
 
 Do not use AgentPack when:
 
@@ -252,9 +266,9 @@ Do not use AgentPack when:
 
 ## How It Works
 
-AgentPack scans repo locally, combines filename, git, config, dependency, summary, and benchmark signals, ranks likely files for task, then renders a compact context pack.
+AgentPack scans repo locally, builds and reuses file summaries, indexes local skills and rules, combines filename, git, config, dependency, summary, and benchmark signals, ranks likely files for task, then renders a compact context pack.
 
-It can expose same workflow through CLI, markdown files, MCP tools, hooks, and CI.
+It can expose the same workflow through CLI, markdown files, MCP tools, hooks, plugins, and CI.
 
 Deep dive: [`docs/architecture.md`](docs/architecture.md), [`docs/how-agentpack-works.md`](docs/how-agentpack-works.md), and [`docs/commands.md`](docs/commands.md).
 
@@ -307,7 +321,7 @@ pipx ensurepath
 
 ## Status
 
-Alpha: `0.3.24`.
+Alpha: `0.3.25`.
 
 Works, tested, and used in real sessions. Python and JavaScript/TypeScript have strongest support. APIs may change before 1.0.
 

{agentpack_cli-0.3.24 → agentpack_cli-0.3.25}/README.md

@@ -14,7 +14,9 @@
 
 <p align="center">
   <a href="https://pypi.org/project/agentpack-cli/"><img alt="PyPI version" src="https://img.shields.io/pypi/v/agentpack-cli.svg"></a>
+  <a href="https://pepy.tech/projects/agentpack-cli"><img alt="PyPI downloads" src="https://static.pepy.tech/personalized-badge/agentpack-cli?period=total&units=INTERNATIONAL_SYSTEM&left_color=BLACK&right_color=GREEN&left_text=downloads"></a>
   <a href="https://www.npmjs.com/package/@vishal2612200/agentpack"><img alt="npm version" src="https://img.shields.io/npm/v/@vishal2612200/agentpack.svg"></a>
+  <a href="https://www.npmjs.com/package/@vishal2612200/agentpack"><img alt="npm downloads" src="https://img.shields.io/npm/dm/@vishal2612200/agentpack.svg"></a>
   <a href="https://github.com/vishal2612200/agentpack/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/vishal2612200/agentpack/actions/workflows/ci.yml/badge.svg"></a>
   <a href="https://opensource.org/licenses/MIT"><img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-yellow.svg"></a>
 </p>
@@ -22,6 +24,8 @@
 <p align="center">
   <code>local preflight</code>
   <code>ranked files</code>
+  <code>skill routing</code>
+  <code>warm cache</code>
   <code>tests + commands</code>
   <code>receipts</code>
   <code>no cloud index</code>
@@ -36,6 +40,7 @@ AgentPack does the repo-orientation pass first.
 ```text
 agentpack route --task "fix auth token expiry"
 -> files that probably matter
+-> skills and rules that fit the task
 -> tests that probably prove it
 -> rules, commands, warnings
 -> compact context before the agent edits
@@ -54,7 +59,9 @@ No cloud index. No embeddings. No model calls for scan/rank/pack. Just local rep
 
 It is not a repo dump. It is not a second brain. It is not a promise that your agent will be right.
 
-It is a preflight map: likely files, likely tests, repo rules, commands, warnings, and a compact pack your agent can inspect before touching code.
+It is a preflight map: likely files, likely tests, the right local skill or rule, commands, warnings, and a compact pack your agent can inspect before touching code.
+
+The first run builds local summaries and repo signals. Later runs reuse that cache, so agents do less repeat discovery and spend more of their budget on the actual change.
 
 ## Quick Start
 
@@ -98,6 +105,7 @@ agentpack route --task "fix billing webhook retry handling"
 ```
 
 AgentPack returns likely files, tests, rules, commands, and warnings without changing source files.
+It also recommends matching skills or agent rules when the task points at a known workflow, framework, language, or repo convention.
 
 Build context pack next:
 
@@ -107,13 +115,16 @@ agentpack pack --task auto
 ```
 
 AgentPack writes local context under `.agentpack/`, including selected files, omitted-file receipts, freshness checks, and token stats.
+It reuses cached file summaries and snapshot metadata so repeated packs do not start from zero.
 
 ## What AgentPack Gives Your Agent
 
 - ranked files for current task
+- skill and rule routing for current task
 - likely tests and commands
 - repo rules and agent instructions
 - compact context pack under budget
+- cached summaries for faster repeated orientation
 - omitted-file receipts for review
 - freshness warnings when task or git state changes
 - local benchmark data when selected context misses real changed files
@@ -182,7 +193,8 @@ See [`docs/agent-plugins.md`](docs/agent-plugins.md) and [`docs/codex-plugin.md`
 | Repo dumpers | Dump selected or all files | AgentPack ranks files by task |
 | Coding agents | Edit code | AgentPack prepares context before editing |
 | IDE search | Finds files on demand | AgentPack pre-routes before agent starts |
-| Skills/rules | Change agent behavior | AgentPack changes the context the agent sees |
+| Skills/rules | Change agent behavior | AgentPack routes the matching skill or rule for the task |
+| Cache warmers | Speed repeated scans | AgentPack reuses summaries and snapshots inside the context workflow |
 
 ## When To Use It
 
@@ -194,6 +206,8 @@ Use AgentPack when:
 - CI or PR review needs reproducible context
 - agents waste tool calls opening irrelevant files
 - tasks often miss tests, config, generated rules, or repo conventions
+- teams have useful skills/rules but agents do not reliably pick the right one
+- repeated agent sessions keep rediscovering the same repo structure
 
 Do not use AgentPack when:
 
@@ -205,9 +219,9 @@ Do not use AgentPack when:
 
 ## How It Works
 
-AgentPack scans repo locally, combines filename, git, config, dependency, summary, and benchmark signals, ranks likely files for task, then renders a compact context pack.
+AgentPack scans repo locally, builds and reuses file summaries, indexes local skills and rules, combines filename, git, config, dependency, summary, and benchmark signals, ranks likely files for task, then renders a compact context pack.
 
-It can expose same workflow through CLI, markdown files, MCP tools, hooks, and CI.
+It can expose the same workflow through CLI, markdown files, MCP tools, hooks, plugins, and CI.
 
 Deep dive: [`docs/architecture.md`](docs/architecture.md), [`docs/how-agentpack-works.md`](docs/how-agentpack-works.md), and [`docs/commands.md`](docs/commands.md).
 
@@ -260,7 +274,7 @@ pipx ensurepath
 
 ## Status
 
-Alpha: `0.3.24`.
+Alpha: `0.3.25`.
 
 Works, tested, and used in real sessions. Python and JavaScript/TypeScript have strongest support. APIs may change before 1.0.
 

{agentpack_cli-0.3.24 → agentpack_cli-0.3.25}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "agentpack-cli"
-version = "0.3.24"
+version = "0.3.25"
 description = "Local context engine for AI coding agents that ranks relevant repo files and builds compact task-focused context packs for Claude Code, Codex, Cursor, Windsurf, MCP, and CI workflows."
 readme = "README.md"
 requires-python = ">=3.10"

{agentpack_cli-0.3.24 → agentpack_cli-0.3.25}/src/agentpack/__init__.py

@@ -1,3 +1,3 @@
 """AgentPack — task-aware context packing for AI coding agents."""
 
-__version__ = "0.3.24"
+__version__ = "0.3.25"

{agentpack_cli-0.3.24 → agentpack_cli-0.3.25}/src/agentpack/cli.py

@@ -42,6 +42,7 @@ from agentpack.commands import (
     task_cmd,
     threads,
     tune,
+    upgrade,
     verify_wheel,
     watch,
     wrap,
@@ -95,6 +96,7 @@ for mod in [
     diagnose_selection,
     eval_cmd,
     tune,
+    upgrade,
     watch,
     claude_cmd,
     benchmark,

{agentpack_cli-0.3.24 → agentpack_cli-0.3.25}/src/agentpack/commands/ci_cmd.py

@@ -79,6 +79,8 @@ jobs:
     if: github.event_name == 'push'
     steps:
       - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
       - uses: actions/setup-python@v5
         with:
           python-version: "3.11"
@@ -86,5 +88,5 @@ jobs:
         with:
           node-version: "20"
       - run: python -m pip install -e ".[dev]" build
-      - run: python -m agentpack.cli release-check
+      - run: python -m agentpack.cli release-check --profile auto
 """

{agentpack_cli-0.3.24 → agentpack_cli-0.3.25}/src/agentpack/commands/release_check.py

@@ -145,11 +145,44 @@ def _pytest_args_for_profile(root: Path, profile: str) -> list[str]:
 
 
 def _changed_files(root: Path) -> list[str]:
+    ci_changed = _github_event_changed_files(root)
+    if ci_changed:
+        return ci_changed
     tracked = _git_lines(root, ["git", "diff", "--name-only", "HEAD", "--"])
     untracked = _git_lines(root, ["git", "ls-files", "--others", "--exclude-standard"])
     return sorted(set(tracked + untracked))
 
 
+def _github_event_changed_files(root: Path) -> list[str]:
+    event_path = os.environ.get("GITHUB_EVENT_PATH")
+    event_name = os.environ.get("GITHUB_EVENT_NAME", "")
+    if not event_path:
+        return []
+    try:
+        payload = json.loads(Path(event_path).read_text(encoding="utf-8"))
+    except (OSError, json.JSONDecodeError):
+        return []
+    if not isinstance(payload, dict):
+        return []
+
+    base = ""
+    head = ""
+    if event_name == "push":
+        base = str(payload.get("before") or "")
+        head = str(payload.get("after") or os.environ.get("GITHUB_SHA") or "")
+    elif event_name == "pull_request":
+        pull_request = payload.get("pull_request")
+        if isinstance(pull_request, dict):
+            base_ref = pull_request.get("base")
+            head_ref = pull_request.get("head")
+            if isinstance(base_ref, dict) and isinstance(head_ref, dict):
+                base = str(base_ref.get("sha") or "")
+                head = str(head_ref.get("sha") or "")
+    if not base or not head or set(base) == {"0"}:
+        return []
+    return _git_lines(root, ["git", "diff", "--name-only", base, head, "--"])
+
+
 def _git_lines(root: Path, command: list[str]) -> list[str]:
     result = subprocess.run(command, cwd=root, capture_output=True, text=True)
     if result.returncode != 0:

agentpack_cli-0.3.25/src/agentpack/commands/upgrade.py

@@ -0,0 +1,38 @@
+from __future__ import annotations
+
+import typer
+
+from agentpack.commands._shared import console, _root
+from agentpack.commands.install import _install_slash_command, _print_install_results
+from agentpack.integrations.agents import SUPPORTED_AGENTS, expand_agents, install_agent_integration
+
+
+def register(app: typer.Typer) -> None:
+    @app.command()
+    def upgrade(
+        agent: str = typer.Option(
+            "auto",
+            "--agent",
+            help=f"Agent integration to refresh after package upgrade ({' | '.join(SUPPORTED_AGENTS)}).",
+        ),
+    ) -> None:
+        """Refresh the detected AgentPack IDE/agent integration after upgrading the package."""
+        root = _root()
+        if agent not in SUPPORTED_AGENTS:
+            console.print(f"[yellow]Unknown agent: {agent}. Supported: {', '.join(SUPPORTED_AGENTS)}[/]")
+            raise typer.Exit(1)
+
+        agents = expand_agents(agent, root)
+        if agent == "auto":
+            console.print(f"[dim]Auto-detected agent: {agents[0]}[/]")
+
+        for selected in agents:
+            console.print(f"\n[bold]{selected}[/]")
+            results = install_agent_integration(
+                root,
+                selected,
+                install_slash_command=_install_slash_command,
+            )
+            _print_install_results(selected, results)
+
+        console.print("\n[bold green]Upgrade integration refresh complete.[/]")

agentpack_cli-0.3.25/src/agentpack/data/codex_plugin/.codex-plugin/plugin.json

@@ -0,0 +1,36 @@
+{
+  "name": "agentpack",
+  "version": "0.3.25",
+  "description": "Thin Codex plugin for AgentPack ranked repo context.",
+  "author": {
+    "name": "AgentPack",
+    "url": "https://github.com/vishal2612200/agentpack"
+  },
+  "homepage": "https://github.com/vishal2612200/agentpack/blob/main/docs/codex-plugin.md",
+  "repository": "https://github.com/vishal2612200/agentpack",
+  "license": "MIT",
+  "keywords": [
+    "agentpack",
+    "codex",
+    "context",
+    "coding-agents"
+  ],
+  "skills": "./skills/",
+  "interface": {
+    "displayName": "AgentPack",
+    "shortDescription": "Start Codex with ranked repo context.",
+    "longDescription": "AgentPack is a local context engine, not a coding agent. This plugin gives Codex lightweight commands for routing tasks, refreshing context packs, and reviewing diffs with the existing local AgentPack CLI or MCP tools.",
+    "developerName": "AgentPack",
+    "category": "Productivity",
+    "capabilities": [
+      "Interactive"
+    ],
+    "websiteURL": "https://github.com/vishal2612200/agentpack",
+    "defaultPrompt": [
+      "@agentpack-route fix auth token expiry",
+      "@agentpack-pack fix auth token expiry",
+      "@agentpack-review"
+    ],
+    "brandColor": "#1F6FEB"
+  }
+}

agentpack_cli-0.3.25/src/agentpack/data/codex_plugin/skills/agentpack-pack.md

@@ -0,0 +1,30 @@
+---
+name: agentpack-pack
+description: Generate a local AgentPack context pack for Codex before editing.
+---
+
+# AgentPack Pack
+
+Use when the user invokes `@agentpack-pack <task>` or asks Codex to prepare full AgentPack context.
+
+AgentPack prepares context. It does not prove correctness and does not replace code review or tests.
+
+## Steps
+
+1. Write the task:
+
+```bash
+agentpack task set "<task>"
+```
+
+2. Generate fresh context:
+
+```bash
+agentpack pack --task auto
+```
+
+3. Read `.agentpack/context.md`.
+4. Inspect selected files before editing.
+5. Use normal repo search if selected files miss obvious tests, config, routes, or callers.
+
+If AgentPack MCP is available, prefer the pack or context MCP tool and use markdown as fallback.

agentpack_cli-0.3.25/src/agentpack/data/codex_plugin/skills/agentpack-refresh.md

@@ -0,0 +1,29 @@
+---
+name: agentpack-refresh
+description: Refresh AgentPack context when task, git state, or repo files changed.
+---
+
+# AgentPack Refresh
+
+Use when the user invokes `@agentpack-refresh`, context looks stale, or task/git state changed.
+
+## Steps
+
+1. Run the guarded refresh path:
+
+```bash
+agentpack guard --agent codex --repair-stale --refresh-context
+```
+
+2. If the task changed, update it first:
+
+```bash
+agentpack task set "<task>"
+agentpack guard --agent codex --repair-stale --refresh-context
+```
+
+3. Read `.agentpack/context.md` after refresh.
+4. Warn if context still appears stale or task text does not match.
+5. Treat the pack as a map, not proof of correctness.
+
+Prefer AgentPack MCP refresh/get-context behavior when available.

agentpack_cli-0.3.25/src/agentpack/data/codex_plugin/skills/agentpack-review.md

@@ -0,0 +1,32 @@
+---
+name: agentpack-review
+description: Review Codex edits with git diff and AgentPack benchmark capture guidance.
+---
+
+# AgentPack Review
+
+Use when the user invokes `@agentpack-review` after edits.
+
+Do not claim correctness unless relevant checks actually ran.
+
+## Steps
+
+1. Inspect current diff:
+
+```bash
+git diff --stat
+git diff
+```
+
+2. Look for missed tests, config files, callers, broad unrelated diffs, or generated files.
+3. Run or recommend the smallest relevant checks.
+4. When the diff represents a completed task, suggest benchmark capture:
+
+```bash
+agentpack benchmark capture --since main --task "<task>"
+agentpack benchmark --misses
+```
+
+5. Report validation exactly: passed, failed, or not run.
+
+AgentPack benchmark capture records file-selection evidence. It does not prove the code is correct.

agentpack_cli-0.3.25/src/agentpack/data/codex_plugin/skills/agentpack-route.md

@@ -0,0 +1,24 @@
+---
+name: agentpack-route
+description: Run read-only AgentPack task routing for ranked files, tests, rules, commands, and warnings.
+---
+
+# AgentPack Route
+
+Use when the user invokes `@agentpack-route <task>`.
+
+This is read-only. Do not write `.agentpack/context.md` and do not edit source files from route output alone.
+
+## Steps
+
+1. Run:
+
+```bash
+agentpack route --task "<task>"
+```
+
+2. Return ranked files, likely tests, rules or skills, suggested commands, and warnings.
+3. Tell Codex to verify selected files with actual code before editing.
+4. If the task needs fuller context, suggest `@agentpack-pack <task>`.
+
+If AgentPack MCP is available, prefer the equivalent route task tool.

agentpack_cli-0.3.25/src/agentpack/data/codex_plugin/skills/agentpack.md

@@ -0,0 +1,29 @@
+---
+name: agentpack
+description: Explain AgentPack status and choose the next local context step in a Codex session.
+---
+
+# AgentPack
+
+Use when the user invokes `@agentpack` or asks whether AgentPack context is ready.
+
+AgentPack is not a coding agent. AgentPack is a local context engine that helps Codex start with ranked repo context.
+
+## Steps
+
+1. Check whether `.agentpack/context.md` exists.
+2. If it exists, inspect its freshness block and task summary before editing.
+3. If context is missing or stale, suggest `@agentpack-route <task>` for read-only orientation or `@agentpack-pack <task>` for a context pack.
+4. Tell Codex to treat selected files as a starting map, not proof of correctness.
+5. Use normal repo search when AgentPack output looks incomplete.
+
+## Local commands
+
+```bash
+agentpack status
+agentpack route --task "<task>"
+agentpack task set "<task>"
+agentpack pack --task auto
+```
+
+Prefer AgentPack MCP tools when available: route first, then fetch full context only when needed.

{agentpack_cli-0.3.24 → agentpack_cli-0.3.25}/src/agentpack/installers/codex.py

@@ -1,9 +1,13 @@
 from __future__ import annotations
 
 import json
+import os
 import re
+import shutil
+from importlib import resources
 from pathlib import Path
 
+from agentpack import __version__
 from agentpack.integrations.git_hooks import install_git_hooks
 
 _AGENTPACK_BLOCK = """\
@@ -108,3 +112,61 @@ class CodexInstaller:
         hook_results = install_git_hooks(root, agent="auto")
         results.update({f"git:{k}": v for k, v in hook_results.items()})
         return results
+
+    def install_codex_plugin(self, *, codex_home: Path | None = None) -> dict[str, str]:
+        """Install AgentPack's thin Codex plugin package into the local Codex cache."""
+        source = _codex_plugin_source()
+        target = _codex_plugin_target(codex_home)
+        action = _copy_tree_if_changed(source, target)
+        return {str(target): action}
+
+
+def _codex_plugin_target(codex_home: Path | None = None) -> Path:
+    root = codex_home or Path(os.environ.get("CODEX_HOME", "~/.codex")).expanduser()
+    return root / "plugins" / "cache" / "local" / "agentpack" / __version__
+
+
+def _codex_plugin_source() -> Path:
+    checkout_source = Path(__file__).resolve().parents[3] / "src" / "agentpack" / "data" / "codex_plugin"
+    if checkout_source.exists():
+        return checkout_source
+    return Path(str(resources.files("agentpack").joinpath("data", "codex_plugin")))
+
+
+def _copy_tree_if_changed(source: Path, target: Path) -> str:
+    if not source.exists():
+        raise FileNotFoundError(f"AgentPack Codex plugin assets not found: {source}")
+    existed = target.exists()
+    changed = False
+    for source_file in sorted(path for path in source.rglob("*") if path.is_file()):
+        relative = source_file.relative_to(source)
+        target_file = target / relative
+        try:
+            current = target_file.read_bytes()
+        except OSError:
+            current = None
+        desired = source_file.read_bytes()
+        if current != desired:
+            target_file.parent.mkdir(parents=True, exist_ok=True)
+            target_file.write_bytes(desired)
+            changed = True
+    if existed:
+        _remove_stale_files(source, target)
+    elif not target.exists():
+        shutil.copytree(source, target)
+        changed = True
+    if not existed:
+        return "created"
+    return "updated" if changed else "unchanged"
+
+
+def _remove_stale_files(source: Path, target: Path) -> None:
+    expected = {path.relative_to(source) for path in source.rglob("*") if path.is_file()}
+    for target_file in sorted((path for path in target.rglob("*") if path.is_file()), reverse=True):
+        if target_file.relative_to(target) not in expected:
+            target_file.unlink()
+    for directory in sorted((path for path in target.rglob("*") if path.is_dir()), reverse=True):
+        try:
+            directory.rmdir()
+        except OSError:
+            pass

{agentpack_cli-0.3.24 → agentpack_cli-0.3.25}/src/agentpack/integrations/agents.py

@@ -83,7 +83,11 @@ def install_agent_integration(
 
     if agent == "codex":
         installer = CodexInstaller()
-        results = {"AGENTS.md": installer.patch_agents_md(root)}
+        plugin_result = installer.install_codex_plugin()
+        results = {
+            "AGENTS.md": installer.patch_agents_md(root),
+            "~/.codex/plugins/cache/local/agentpack": next(iter(plugin_result.values())),
+        }
         if not global_install:
             results.update(installer.install_auto_repack(root))
         return results