agentpack-cli 0.1.27__tar.gz → 0.1.29__tar.gz

{agentpack_cli-0.1.27 → agentpack_cli-0.1.29}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentpack-cli
-Version: 0.1.27
+Version: 0.1.29
 Summary: Task-aware context packing for AI coding agents — Claude, Cursor, Windsurf, Codex, and Antigravity
 License: MIT
 License-File: LICENSE
@@ -44,7 +44,7 @@ Description-Content-Type: text/markdown
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![CI](https://github.com/vishal2612200/agentpack/actions/workflows/ci.yml/badge.svg)](https://github.com/vishal2612200/agentpack/actions/workflows/ci.yml)
 
-> **Status: alpha (v0.1.27).** 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.29).** 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.
 
@@ -320,7 +320,7 @@ Then open Claude Code / Cursor / Codex and write your coding task normally.
 | Agent | Automation level | Method |
 |---|---|---|
 | Claude Code (hook) | Highest | `init` writes `CLAUDE.md`, `.claude/settings.json` hooks, and `.mcp.json` |
-| Codex | Medium | `init` writes `AGENTS.md` + git hooks |
+| Codex | Medium | `init` writes `AGENTS.md`, `.codex/hooks.json` + git hooks |
 | Cursor | Medium | `init` writes `.cursorrules`, `.cursor/rules/agentpack.mdc`, VS Code task + git hooks |
 | Windsurf | Medium | `init` writes `.windsurfrules`, VS Code task + git hooks |
 | Antigravity | Medium | `init` writes `GEMINI.md`, VS Code task + git hooks |
@@ -409,6 +409,7 @@ agentpack init --agent codex
 
 Configures:
 - `AGENTS.md` — tells Codex to write current task, repack, and read the context pack before each task
+- `.codex/hooks.json` — Codex app lifecycle hooks for prompt-time AgentPack refresh hints
 - `.git/hooks/post-commit`, `post-merge`, `post-checkout` — background repack on tree change
 
 ### Antigravity
@@ -428,7 +429,7 @@ Configures:
 
 | Mechanism | Claude Code | Cursor | Windsurf | Codex | Antigravity |
 |---|---|---|---|---|---|
-| Config file patched | `CLAUDE.md` + `.claude/settings.json` | `.cursorrules` + `.cursor/rules/*.mdc` | `.windsurfrules` | `AGENTS.md` | `GEMINI.md` + generated `.agent/skills/agentpack/SKILL.md` after pack |
+| Config file patched | `CLAUDE.md` + `.claude/settings.json` | `.cursorrules` + `.cursor/rules/*.mdc` | `.windsurfrules` | `AGENTS.md` + `.codex/hooks.json` | `GEMINI.md` + generated `.agent/skills/agentpack/SKILL.md` after pack |
 | Auto-inject on startup | ✅ `UserPromptSubmit` hook | ✅ `alwaysApply` | ✅ rules file | ✅ `AGENTS.md` | ✅ Skill auto-activation |
 | Auto-repack when stale | ✅ hook (content hash via `root_hash`, ~1ms when fresh) | ✅ git hooks | ✅ git hooks | ✅ git hooks | ✅ git hooks |
 | Manual repack shortcut | ✅ `/agentpack` slash cmd | ✅ VS Code task | ✅ VS Code task | `agentpack pack` | ✅ VS Code task |
@@ -652,7 +653,7 @@ Also installs the detected agent integration:
 - Claude: `CLAUDE.md`, `.claude/settings.json` hooks, `.mcp.json`
 - Cursor: `.cursorrules`, `.cursor/rules/agentpack.mdc`, git hooks, VS Code task
 - Windsurf: `.windsurfrules`, git hooks, VS Code task
-- Codex: `AGENTS.md`, git hooks
+- Codex: `AGENTS.md`, `.codex/hooks.json`, git hooks
 - Antigravity: `GEMINI.md`, git hooks, VS Code task
 - Generic: no agent-specific files
 
@@ -667,7 +668,7 @@ agentpack install                      # auto-detect IDE
 agentpack install --agent claude       # CLAUDE.md + .claude/settings.json hooks
 agentpack install --agent cursor       # .cursorrules + .mdc + git hooks + VS Code tasks
 agentpack install --agent windsurf     # .windsurfrules + git hooks + VS Code tasks
-agentpack install --agent codex        # AGENTS.md + git hooks
+agentpack install --agent codex        # AGENTS.md + .codex/hooks.json + git hooks
 agentpack install --agent antigravity  # GEMINI.md + git hooks + VS Code tasks
 ```
 
@@ -1295,7 +1296,7 @@ src/agentpack/
     claude.py                  # ClaudeInstaller: CLAUDE.md + .claude/settings.json
     cursor.py                  # CursorInstaller: .cursorrules + .mdc + auto-repack
     windsurf.py                # WindsurfInstaller: .windsurfrules + auto-repack
-    codex.py                   # CodexInstaller: AGENTS.md + git hooks
+    codex.py                   # CodexInstaller: AGENTS.md + .codex/hooks.json + git hooks
     antigravity.py             # AntigravityInstaller: GEMINI.md + auto-repack
 
   integrations/                # system/tool integration (not core domain)

{agentpack_cli-0.1.27 → agentpack_cli-0.1.29}/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.27).** 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.29).** 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.
 
@@ -281,7 +281,7 @@ Then open Claude Code / Cursor / Codex and write your coding task normally.
 | Agent | Automation level | Method |
 |---|---|---|
 | Claude Code (hook) | Highest | `init` writes `CLAUDE.md`, `.claude/settings.json` hooks, and `.mcp.json` |
-| Codex | Medium | `init` writes `AGENTS.md` + git hooks |
+| Codex | Medium | `init` writes `AGENTS.md`, `.codex/hooks.json` + git hooks |
 | Cursor | Medium | `init` writes `.cursorrules`, `.cursor/rules/agentpack.mdc`, VS Code task + git hooks |
 | Windsurf | Medium | `init` writes `.windsurfrules`, VS Code task + git hooks |
 | Antigravity | Medium | `init` writes `GEMINI.md`, VS Code task + git hooks |
@@ -370,6 +370,7 @@ agentpack init --agent codex
 
 Configures:
 - `AGENTS.md` — tells Codex to write current task, repack, and read the context pack before each task
+- `.codex/hooks.json` — Codex app lifecycle hooks for prompt-time AgentPack refresh hints
 - `.git/hooks/post-commit`, `post-merge`, `post-checkout` — background repack on tree change
 
 ### Antigravity
@@ -389,7 +390,7 @@ Configures:
 
 | Mechanism | Claude Code | Cursor | Windsurf | Codex | Antigravity |
 |---|---|---|---|---|---|
-| Config file patched | `CLAUDE.md` + `.claude/settings.json` | `.cursorrules` + `.cursor/rules/*.mdc` | `.windsurfrules` | `AGENTS.md` | `GEMINI.md` + generated `.agent/skills/agentpack/SKILL.md` after pack |
+| Config file patched | `CLAUDE.md` + `.claude/settings.json` | `.cursorrules` + `.cursor/rules/*.mdc` | `.windsurfrules` | `AGENTS.md` + `.codex/hooks.json` | `GEMINI.md` + generated `.agent/skills/agentpack/SKILL.md` after pack |
 | Auto-inject on startup | ✅ `UserPromptSubmit` hook | ✅ `alwaysApply` | ✅ rules file | ✅ `AGENTS.md` | ✅ Skill auto-activation |
 | Auto-repack when stale | ✅ hook (content hash via `root_hash`, ~1ms when fresh) | ✅ git hooks | ✅ git hooks | ✅ git hooks | ✅ git hooks |
 | Manual repack shortcut | ✅ `/agentpack` slash cmd | ✅ VS Code task | ✅ VS Code task | `agentpack pack` | ✅ VS Code task |
@@ -613,7 +614,7 @@ Also installs the detected agent integration:
 - Claude: `CLAUDE.md`, `.claude/settings.json` hooks, `.mcp.json`
 - Cursor: `.cursorrules`, `.cursor/rules/agentpack.mdc`, git hooks, VS Code task
 - Windsurf: `.windsurfrules`, git hooks, VS Code task
-- Codex: `AGENTS.md`, git hooks
+- Codex: `AGENTS.md`, `.codex/hooks.json`, git hooks
 - Antigravity: `GEMINI.md`, git hooks, VS Code task
 - Generic: no agent-specific files
 
@@ -628,7 +629,7 @@ agentpack install                      # auto-detect IDE
 agentpack install --agent claude       # CLAUDE.md + .claude/settings.json hooks
 agentpack install --agent cursor       # .cursorrules + .mdc + git hooks + VS Code tasks
 agentpack install --agent windsurf     # .windsurfrules + git hooks + VS Code tasks
-agentpack install --agent codex        # AGENTS.md + git hooks
+agentpack install --agent codex        # AGENTS.md + .codex/hooks.json + git hooks
 agentpack install --agent antigravity  # GEMINI.md + git hooks + VS Code tasks
 ```
 
@@ -1256,7 +1257,7 @@ src/agentpack/
     claude.py                  # ClaudeInstaller: CLAUDE.md + .claude/settings.json
     cursor.py                  # CursorInstaller: .cursorrules + .mdc + auto-repack
     windsurf.py                # WindsurfInstaller: .windsurfrules + auto-repack
-    codex.py                   # CodexInstaller: AGENTS.md + git hooks
+    codex.py                   # CodexInstaller: AGENTS.md + .codex/hooks.json + git hooks
     antigravity.py             # AntigravityInstaller: GEMINI.md + auto-repack
 
   integrations/                # system/tool integration (not core domain)

{agentpack_cli-0.1.27 → agentpack_cli-0.1.29}/pyproject.toml

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

{agentpack_cli-0.1.27 → agentpack_cli-0.1.29}/src/agentpack/__init__.py

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

{agentpack_cli-0.1.27 → agentpack_cli-0.1.29}/src/agentpack/adapters/codex.py

@@ -22,5 +22,8 @@ class CodexAdapter(BaseAdapter):
     def patch_agents_md(self, root: Path) -> str:
         return CodexInstaller().patch_agents_md(root)
 
+    def patch_codex_hooks(self, root: Path) -> str:
+        return CodexInstaller().patch_codex_hooks(root)
+
     def install_auto_repack(self, root: Path) -> dict[str, str]:
         return CodexInstaller().install_auto_repack(root)

{agentpack_cli-0.1.27 → agentpack_cli-0.1.29}/src/agentpack/commands/install.py

@@ -19,7 +19,7 @@ from agentpack.integrations.global_install import (
 )
 from agentpack.commands._shared import console, _root
 
-_SUPPORTED_AGENTS = ("auto", "claude", "cursor", "windsurf", "codex", "antigravity")
+_SUPPORTED_AGENTS = ("auto", "claude", "cursor", "windsurf", "codex", "antigravity", "generic")
 
 
 def _resolve_install_agent(agent: str, root: "Path") -> str:
@@ -89,6 +89,10 @@ def register(app: typer.Typer) -> None:
             _print_auto_repack_results(installer.install_auto_repack(root))
             console.print("  AgentPack Skill will activate automatically in Antigravity for coding tasks.")
 
+        elif agent == "generic":
+            console.print("[green]Generic agent selected.[/] No agent-specific hooks are required.")
+            console.print("  Run [bold]agentpack pack --agent generic --task \"<task>\"[/] to generate context.")
+
         else:
             console.print(f"[yellow]Unknown agent: {agent}. Supported: {', '.join(_SUPPORTED_AGENTS)}[/]")
             raise typer.Exit(1)
@@ -210,6 +214,9 @@ def register(app: typer.Typer) -> None:
             else:
                 console.print("\n[dim]Would patch: GEMINI.md, .agent/skills/agentpack/SKILL.md[/]")
 
+        elif agent == "generic":
+            console.print("\n[green]Generic agent selected.[/] No agent-specific global config is required.")
+
         else:
             console.print(f"[yellow]Unknown agent: {agent}. Supported: {', '.join(_SUPPORTED_AGENTS)}[/]")
             raise typer.Exit(1)

agentpack_cli-0.1.29/src/agentpack/installers/codex.py

@@ -0,0 +1,106 @@
+from __future__ import annotations
+
+import json
+import re
+from pathlib import Path
+
+from agentpack.integrations.git_hooks import install_git_hooks
+
+_AGENTPACK_BLOCK = """\
+<!-- agentpack:start -->
+## AgentPack Context
+
+At the start of every coding task:
+
+1. Write a one-line task summary to `.agentpack/task.md` (overwrite the whole file).
+2. Run `agentpack pack --task auto` to refresh context.
+3. Read `.agentpack/context.md` — it lists the files most relevant to your task.
+4. Use those files as starting points, but verify with actual code before editing.
+
+When the user switches to a different coding task, repeat steps 1-3 before editing.
+<!-- agentpack:end -->"""
+
+_BLOCK_RE = re.compile(
+    r"<!-- agentpack:start -->.*?<!-- agentpack:end -->",
+    re.DOTALL,
+)
+
+_SESSION_START_HOOK = {
+    "type": "command",
+    "command": "agentpack hook --event SessionStart",
+}
+
+_USER_PROMPT_SUBMIT_HOOK = {
+    "type": "command",
+    "command": "agentpack hook --event UserPromptSubmit",
+    "timeout": 5,
+    "statusMessage": "Checking agentpack index...",
+}
+
+
+class CodexInstaller:
+    """Configures Codex/OpenAI-specific repo files and auto-repack hooks."""
+
+    def patch_agents_md(self, root: Path) -> str:
+        """Insert/update AgentPack block in AGENTS.md. Returns action taken."""
+        agents_md = root / "AGENTS.md"
+
+        if not agents_md.exists():
+            agents_md.write_text(f"{_AGENTPACK_BLOCK}\n")
+            return "created"
+
+        content = agents_md.read_text()
+        if _BLOCK_RE.search(content):
+            new_content = _BLOCK_RE.sub(_AGENTPACK_BLOCK, content)
+            if new_content != content:
+                agents_md.write_text(new_content)
+                return "updated"
+            return "unchanged"
+
+        agents_md.write_text(content.rstrip() + "\n\n" + _AGENTPACK_BLOCK + "\n")
+        return "appended"
+
+    def patch_codex_hooks(self, root: Path) -> str:
+        """Merge AgentPack lifecycle hooks into .codex/hooks.json."""
+        hooks_path = root / ".codex" / "hooks.json"
+        hooks_path.parent.mkdir(parents=True, exist_ok=True)
+        existed = hooks_path.exists()
+
+        existing: dict = {}
+        if existed:
+            try:
+                existing = json.loads(hooks_path.read_text(encoding="utf-8"))
+            except json.JSONDecodeError:
+                existing = {}
+
+        hooks = existing.setdefault("hooks", {})
+        changed = False
+        changed |= self._ensure_hook(hooks, "SessionStart", _SESSION_START_HOOK)
+        changed |= self._ensure_hook(hooks, "UserPromptSubmit", _USER_PROMPT_SUBMIT_HOOK)
+
+        new_content = json.dumps(existing, indent=2) + "\n"
+        if hooks_path.exists() and hooks_path.read_text(encoding="utf-8") == new_content:
+            return "unchanged"
+        hooks_path.write_text(new_content, encoding="utf-8")
+        return "updated" if existed else "created"
+
+    def _ensure_hook(self, hooks: dict, event: str, hook: dict) -> bool:
+        entries = hooks.setdefault(event, [])
+        for entry in entries:
+            for existing_hook in entry.get("hooks", []):
+                if existing_hook.get("type") == hook["type"] and existing_hook.get("command") == hook["command"]:
+                    if existing_hook == hook:
+                        return False
+                    existing_hook.clear()
+                    existing_hook.update(dict(hook))
+                    return True
+        entries.append({"hooks": [dict(hook)]})
+        return True
+
+    def install_auto_repack(self, root: Path) -> dict[str, str]:
+        """Install git hooks for auto-repack. Returns results dict."""
+        results: dict[str, str] = {}
+        results[".codex/hooks.json"] = self.patch_codex_hooks(root)
+        hook_results = install_git_hooks(root, agent="auto")
+        results.update({f"git:{k}": v for k, v in hook_results.items()})
+        return results

agentpack_cli-0.1.27/src/agentpack/installers/codex.py

@@ -1,55 +0,0 @@
-from __future__ import annotations
-
-import re
-from pathlib import Path
-
-from agentpack.integrations.git_hooks import install_git_hooks
-
-_AGENTPACK_BLOCK = """\
-<!-- agentpack:start -->
-## AgentPack Context
-
-At the start of every coding task:
-
-1. Write a one-line task summary to `.agentpack/task.md` (overwrite the whole file).
-2. Run `agentpack pack --task auto` to refresh context.
-3. Read `.agentpack/context.md` — it lists the files most relevant to your task.
-4. Use those files as starting points, but verify with actual code before editing.
-
-When the user switches to a different coding task, repeat steps 1-3 before editing.
-<!-- agentpack:end -->"""
-
-_BLOCK_RE = re.compile(
-    r"<!-- agentpack:start -->.*?<!-- agentpack:end -->",
-    re.DOTALL,
-)
-
-
-class CodexInstaller:
-    """Configures Codex/OpenAI-specific repo files and auto-repack hooks."""
-
-    def patch_agents_md(self, root: Path) -> str:
-        """Insert/update AgentPack block in AGENTS.md. Returns action taken."""
-        agents_md = root / "AGENTS.md"
-
-        if not agents_md.exists():
-            agents_md.write_text(f"{_AGENTPACK_BLOCK}\n")
-            return "created"
-
-        content = agents_md.read_text()
-        if _BLOCK_RE.search(content):
-            new_content = _BLOCK_RE.sub(_AGENTPACK_BLOCK, content)
-            if new_content != content:
-                agents_md.write_text(new_content)
-                return "updated"
-            return "unchanged"
-
-        agents_md.write_text(content.rstrip() + "\n\n" + _AGENTPACK_BLOCK + "\n")
-        return "appended"
-
-    def install_auto_repack(self, root: Path) -> dict[str, str]:
-        """Install git hooks for auto-repack. Returns results dict."""
-        results: dict[str, str] = {}
-        hook_results = install_git_hooks(root, agent="auto")
-        results.update({f"git:{k}": v for k, v in hook_results.items()})
-        return results