agentpack-cli 0.1.26__tar.gz → 0.1.28__tar.gz

{agentpack_cli-0.1.26 → agentpack_cli-0.1.28}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentpack-cli
-Version: 0.1.26
+Version: 0.1.28
 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.25).** 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.28).** 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.
 
@@ -102,8 +102,7 @@ agentpack quickstart --task "fix auth token expiry"
 
 # One-time setup per project
 cd your-project
-agentpack init             # creates config, session, task.md — nothing else needed
-agentpack install          # auto-detects your IDE (optional but recommended)
+agentpack init             # creates config/session/task.md + detected agent integration
 
 # Every terminal session
 agentpack watch            # keeps context fresh automatically — that's it
@@ -240,7 +239,7 @@ AgentPack is not a coding assistant. It's a context preparation tool. The output
 
 These tools have native file access via tool calls. Claude reads exactly the files it needs, on demand, per turn. Pre-packing context adds overhead without much benefit on small-to-medium repos.
 
-AgentPack's value here is different: `agentpack install --agent <x>` configures your agent to auto-inject a ranked context pack on session start and auto-repack whenever you commit. On large repos where tool-call exploration piles up across turns, this front-loads the cost once instead of paying per-turn.
+AgentPack's value here is different: `agentpack init --agent <x>` configures your agent to read or inject a ranked context pack and auto-repack when the repo changes. On large repos where tool-call exploration piles up across turns, this front-loads the cost once instead of paying per-turn.
 
 ### Where agentpack genuinely wins
 
@@ -305,8 +304,7 @@ The full workflow:
 
 ```bash
 # One-time project setup
-agentpack init             # creates config, session, task.md
-agentpack install          # configure your agent (optional but recommended)
+agentpack init             # creates config/session/task.md + detected agent integration
 
 # Every terminal session — just one command
 agentpack watch            # auto-resumes session, refreshes context on file/task changes
@@ -321,11 +319,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 |
-| 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` |
+| Claude Code (hook) | Highest | `init` writes `CLAUDE.md`, `.claude/settings.json` hooks, and `.mcp.json` |
+| 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 |
 | Generic | Basic | `watch` mode + read `context.md` |
 
 ### Honest limitations
@@ -342,8 +340,7 @@ Then open Claude Code / Cursor / Codex and write your coding task normally.
 ```bash
 pip install agentpack-cli
 cd your-project
-agentpack init             # one-time setup: config + session + task.md
-agentpack install          # auto-detects your IDE (Claude Code, Cursor, Windsurf, Codex, Antigravity)
+agentpack init             # one-time setup: config/session/task.md + detected agent integration
 agentpack watch            # in another terminal — keeps context fresh automatically
 ```
 
@@ -357,20 +354,20 @@ agentpack global-install             # apply
 source ~/.zshrc
 ```
 
-Then opt each project in: `cd your-project && agentpack init`. After that git hooks repack on commit and the Claude Code hook injects context on every session start — no manual steps.
+Then opt each project in: `cd your-project && agentpack init`. After that repo hooks or shell hooks keep context fresh, and Claude Code gets prompt-time context hints — no manual steps.
 
 ---
 
 ## Agent setup
 
-Run once per project. Each command is idempotent — safe to re-run, never clobbers unrelated config.
+`agentpack init` is the normal one-command project setup. It creates `.agentpack/` state and installs the detected agent integration. Re-run it any time; integration writes are idempotent and never clobber unrelated config.
 
-`agentpack install` without `--agent` auto-detects the active IDE from environment variables and project files. Pass `--agent` explicitly to override.
+Use `--agent` explicitly to override detection. `agentpack install` remains available when you only want to repair or reconfigure agent files without reinitializing project state.
 
 ### Claude Code
 
 ```bash
-agentpack install --agent claude
+agentpack init --agent claude
 ```
 
 Configures:
@@ -384,7 +381,7 @@ After this, context is injected automatically into every Claude Code session. No
 ### Cursor
 
 ```bash
-agentpack install --agent cursor
+agentpack init --agent cursor
 ```
 
 Configures:
@@ -396,7 +393,7 @@ Configures:
 ### Windsurf
 
 ```bash
-agentpack install --agent windsurf
+agentpack init --agent windsurf
 ```
 
 Configures:
@@ -407,32 +404,32 @@ Configures:
 ### Codex
 
 ```bash
-agentpack install --agent codex
+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
 
 ```bash
-agentpack install --agent antigravity
+agentpack init --agent antigravity
 ```
 
 Configures:
-- `.agent/skills/agentpack/SKILL.md` — AgentPack context as a Skill; Antigravity activates it automatically for coding tasks
 - `GEMINI.md` — registers the agentpack skill reference and task-switch protocol
 - `.git/hooks/post-commit`, `post-merge`, `post-checkout` — background repack on tree change
 - `.vscode/tasks.json` — "AgentPack: Repack context" in Command Palette + `runOn: folderOpen`
 
-The Skill descriptor activates AgentPack automatically — no `--task` flag required when working in Antigravity.
+`agentpack pack` writes `.agent/skills/agentpack/SKILL.md`, which Antigravity can activate automatically for coding tasks.
 
 ### Auto-repack comparison
 
 | Mechanism | Claude Code | Cursor | Windsurf | Codex | Antigravity |
 |---|---|---|---|---|---|
-| Config file patched | `CLAUDE.md` + `.claude/settings.json` | `.cursorrules` + `.cursor/rules/*.mdc` | `.windsurfrules` | `AGENTS.md` | `.agent/skills/agentpack/SKILL.md` + `GEMINI.md` |
+| 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 |
@@ -546,7 +543,7 @@ agentpack global-install --agent antigravity   # Antigravity
 What it does:
 - **Git template hooks** (`~/.git-templates/hooks/`) — git copies these into every repo on `git init` / `git clone`. On `post-commit`, `post-merge`, `post-checkout`: silently repacks **only if `.agentpack/config.toml` exists** — no-op in repos that haven't opted in.
 - **Shell cd hook** (`~/.zshrc` or `~/.bashrc`) — on `cd`, repacks if stale **only in opted-in repos**. Never touches repos without `.agentpack/config.toml`. Never auto-inits.
-- **Agent config** — same as `agentpack install --agent <x>` for the current project.
+- **Agent config** — same agent-specific files that `agentpack init --agent <x>` or `agentpack install --agent <x>` writes for the current project.
 
 All changes are idempotent, reversible, and non-destructive. Existing hooks and rc files are appended to, never overwritten. Repos you haven't explicitly run `agentpack init` in are never touched.
 
@@ -637,6 +634,7 @@ Initialize AgentPack in the current directory.
 ```bash
 agentpack init                  # interactive mode picker
 agentpack init --yes            # non-interactive, use defaults (good for CI)
+agentpack init --agent codex    # force an agent integration
 agentpack init --share-cache    # commit cache/ to git for team sharing
 ```
 
@@ -651,19 +649,27 @@ Creates:
   snapshots/              # file hash snapshots
 ```
 
+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`, `.codex/hooks.json`, git hooks
+- Antigravity: `GEMINI.md`, git hooks, VS Code task
+- Generic: no agent-specific files
+
 ---
 
 ### `agentpack install`
 
-Configure agentpack for your AI coding agent.
+Repair or reconfigure agent-specific files without reinitializing project state.
 
 ```bash
 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 antigravity  # .agent/skills/agentpack/SKILL.md + GEMINI.md + git hooks + VS Code tasks
+agentpack install --agent codex        # AGENTS.md + .codex/hooks.json + git hooks
+agentpack install --agent antigravity  # GEMINI.md + git hooks + VS Code tasks
 ```
 
 All installs are idempotent — safe to re-run, merge with existing config, never duplicate.
@@ -1290,8 +1296,8 @@ 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
-    antigravity.py             # AntigravityInstaller: GEMINI.md + .agent/skills/ + auto-repack
+    codex.py                   # CodexInstaller: AGENTS.md + .codex/hooks.json + git hooks
+    antigravity.py             # AntigravityInstaller: GEMINI.md + auto-repack
 
   integrations/                # system/tool integration (not core domain)
     git_hooks.py               # install/remove .git/hooks post-commit/merge/checkout
@@ -1396,7 +1402,7 @@ Add to `.github/workflows/agentpack-context.yml` — see the full example in [CI
 
 ```bash
 # One-time project setup
-agentpack init                     # creates config, session, task.md
+agentpack init                     # creates config/session/task.md + detected agent integration
 # Edit .agentpack/task.md to set your task
 
 # Every terminal session — just one command
@@ -1499,7 +1505,7 @@ agentpack pack --task "fix bug" --budget 40000   # explicit token cap
 ### Watch mode for active sessions
 
 ```bash
-agentpack init                  # one-time setup (creates session + task.md)
+agentpack init                  # one-time setup (creates session/task.md + detected agent integration)
 agentpack watch                 # in another terminal — auto-resumes each time
 ```
 

{agentpack_cli-0.1.26 → agentpack_cli-0.1.28}/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.25).** 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.28).** 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.
 
@@ -63,8 +63,7 @@ agentpack quickstart --task "fix auth token expiry"
 
 # One-time setup per project
 cd your-project
-agentpack init             # creates config, session, task.md — nothing else needed
-agentpack install          # auto-detects your IDE (optional but recommended)
+agentpack init             # creates config/session/task.md + detected agent integration
 
 # Every terminal session
 agentpack watch            # keeps context fresh automatically — that's it
@@ -201,7 +200,7 @@ AgentPack is not a coding assistant. It's a context preparation tool. The output
 
 These tools have native file access via tool calls. Claude reads exactly the files it needs, on demand, per turn. Pre-packing context adds overhead without much benefit on small-to-medium repos.
 
-AgentPack's value here is different: `agentpack install --agent <x>` configures your agent to auto-inject a ranked context pack on session start and auto-repack whenever you commit. On large repos where tool-call exploration piles up across turns, this front-loads the cost once instead of paying per-turn.
+AgentPack's value here is different: `agentpack init --agent <x>` configures your agent to read or inject a ranked context pack and auto-repack when the repo changes. On large repos where tool-call exploration piles up across turns, this front-loads the cost once instead of paying per-turn.
 
 ### Where agentpack genuinely wins
 
@@ -266,8 +265,7 @@ The full workflow:
 
 ```bash
 # One-time project setup
-agentpack init             # creates config, session, task.md
-agentpack install          # configure your agent (optional but recommended)
+agentpack init             # creates config/session/task.md + detected agent integration
 
 # Every terminal session — just one command
 agentpack watch            # auto-resumes session, refreshes context on file/task changes
@@ -282,11 +280,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 |
-| 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` |
+| Claude Code (hook) | Highest | `init` writes `CLAUDE.md`, `.claude/settings.json` hooks, and `.mcp.json` |
+| 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 |
 | Generic | Basic | `watch` mode + read `context.md` |
 
 ### Honest limitations
@@ -303,8 +301,7 @@ Then open Claude Code / Cursor / Codex and write your coding task normally.
 ```bash
 pip install agentpack-cli
 cd your-project
-agentpack init             # one-time setup: config + session + task.md
-agentpack install          # auto-detects your IDE (Claude Code, Cursor, Windsurf, Codex, Antigravity)
+agentpack init             # one-time setup: config/session/task.md + detected agent integration
 agentpack watch            # in another terminal — keeps context fresh automatically
 ```
 
@@ -318,20 +315,20 @@ agentpack global-install             # apply
 source ~/.zshrc
 ```
 
-Then opt each project in: `cd your-project && agentpack init`. After that git hooks repack on commit and the Claude Code hook injects context on every session start — no manual steps.
+Then opt each project in: `cd your-project && agentpack init`. After that repo hooks or shell hooks keep context fresh, and Claude Code gets prompt-time context hints — no manual steps.
 
 ---
 
 ## Agent setup
 
-Run once per project. Each command is idempotent — safe to re-run, never clobbers unrelated config.
+`agentpack init` is the normal one-command project setup. It creates `.agentpack/` state and installs the detected agent integration. Re-run it any time; integration writes are idempotent and never clobber unrelated config.
 
-`agentpack install` without `--agent` auto-detects the active IDE from environment variables and project files. Pass `--agent` explicitly to override.
+Use `--agent` explicitly to override detection. `agentpack install` remains available when you only want to repair or reconfigure agent files without reinitializing project state.
 
 ### Claude Code
 
 ```bash
-agentpack install --agent claude
+agentpack init --agent claude
 ```
 
 Configures:
@@ -345,7 +342,7 @@ After this, context is injected automatically into every Claude Code session. No
 ### Cursor
 
 ```bash
-agentpack install --agent cursor
+agentpack init --agent cursor
 ```
 
 Configures:
@@ -357,7 +354,7 @@ Configures:
 ### Windsurf
 
 ```bash
-agentpack install --agent windsurf
+agentpack init --agent windsurf
 ```
 
 Configures:
@@ -368,32 +365,32 @@ Configures:
 ### Codex
 
 ```bash
-agentpack install --agent codex
+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
 
 ```bash
-agentpack install --agent antigravity
+agentpack init --agent antigravity
 ```
 
 Configures:
-- `.agent/skills/agentpack/SKILL.md` — AgentPack context as a Skill; Antigravity activates it automatically for coding tasks
 - `GEMINI.md` — registers the agentpack skill reference and task-switch protocol
 - `.git/hooks/post-commit`, `post-merge`, `post-checkout` — background repack on tree change
 - `.vscode/tasks.json` — "AgentPack: Repack context" in Command Palette + `runOn: folderOpen`
 
-The Skill descriptor activates AgentPack automatically — no `--task` flag required when working in Antigravity.
+`agentpack pack` writes `.agent/skills/agentpack/SKILL.md`, which Antigravity can activate automatically for coding tasks.
 
 ### Auto-repack comparison
 
 | Mechanism | Claude Code | Cursor | Windsurf | Codex | Antigravity |
 |---|---|---|---|---|---|
-| Config file patched | `CLAUDE.md` + `.claude/settings.json` | `.cursorrules` + `.cursor/rules/*.mdc` | `.windsurfrules` | `AGENTS.md` | `.agent/skills/agentpack/SKILL.md` + `GEMINI.md` |
+| 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 |
@@ -507,7 +504,7 @@ agentpack global-install --agent antigravity   # Antigravity
 What it does:
 - **Git template hooks** (`~/.git-templates/hooks/`) — git copies these into every repo on `git init` / `git clone`. On `post-commit`, `post-merge`, `post-checkout`: silently repacks **only if `.agentpack/config.toml` exists** — no-op in repos that haven't opted in.
 - **Shell cd hook** (`~/.zshrc` or `~/.bashrc`) — on `cd`, repacks if stale **only in opted-in repos**. Never touches repos without `.agentpack/config.toml`. Never auto-inits.
-- **Agent config** — same as `agentpack install --agent <x>` for the current project.
+- **Agent config** — same agent-specific files that `agentpack init --agent <x>` or `agentpack install --agent <x>` writes for the current project.
 
 All changes are idempotent, reversible, and non-destructive. Existing hooks and rc files are appended to, never overwritten. Repos you haven't explicitly run `agentpack init` in are never touched.
 
@@ -598,6 +595,7 @@ Initialize AgentPack in the current directory.
 ```bash
 agentpack init                  # interactive mode picker
 agentpack init --yes            # non-interactive, use defaults (good for CI)
+agentpack init --agent codex    # force an agent integration
 agentpack init --share-cache    # commit cache/ to git for team sharing
 ```
 
@@ -612,19 +610,27 @@ Creates:
   snapshots/              # file hash snapshots
 ```
 
+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`, `.codex/hooks.json`, git hooks
+- Antigravity: `GEMINI.md`, git hooks, VS Code task
+- Generic: no agent-specific files
+
 ---
 
 ### `agentpack install`
 
-Configure agentpack for your AI coding agent.
+Repair or reconfigure agent-specific files without reinitializing project state.
 
 ```bash
 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 antigravity  # .agent/skills/agentpack/SKILL.md + GEMINI.md + git hooks + VS Code tasks
+agentpack install --agent codex        # AGENTS.md + .codex/hooks.json + git hooks
+agentpack install --agent antigravity  # GEMINI.md + git hooks + VS Code tasks
 ```
 
 All installs are idempotent — safe to re-run, merge with existing config, never duplicate.
@@ -1251,8 +1257,8 @@ 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
-    antigravity.py             # AntigravityInstaller: GEMINI.md + .agent/skills/ + auto-repack
+    codex.py                   # CodexInstaller: AGENTS.md + .codex/hooks.json + git hooks
+    antigravity.py             # AntigravityInstaller: GEMINI.md + auto-repack
 
   integrations/                # system/tool integration (not core domain)
     git_hooks.py               # install/remove .git/hooks post-commit/merge/checkout
@@ -1357,7 +1363,7 @@ Add to `.github/workflows/agentpack-context.yml` — see the full example in [CI
 
 ```bash
 # One-time project setup
-agentpack init                     # creates config, session, task.md
+agentpack init                     # creates config/session/task.md + detected agent integration
 # Edit .agentpack/task.md to set your task
 
 # Every terminal session — just one command
@@ -1460,7 +1466,7 @@ agentpack pack --task "fix bug" --budget 40000   # explicit token cap
 ### Watch mode for active sessions
 
 ```bash
-agentpack init                  # one-time setup (creates session + task.md)
+agentpack init                  # one-time setup (creates session/task.md + detected agent integration)
 agentpack watch                 # in another terminal — auto-resumes each time
 ```
 

{agentpack_cli-0.1.26 → agentpack_cli-0.1.28}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "agentpack-cli"
-version = "0.1.26"
+version = "0.1.28"
 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.26 → agentpack_cli-0.1.28}/src/agentpack/__init__.py

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

{agentpack_cli-0.1.26 → agentpack_cli-0.1.28}/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.26 → agentpack_cli-0.1.28}/src/agentpack/commands/init.py

@@ -59,6 +59,58 @@ def _patch_repo_gitignore(root, share_cache: bool = False) -> str:
     return "updated"
 
 
+def _install_agent_integration(root, agent: str) -> dict[str, str]:
+    """Install repo-local agent integration files after `agentpack init`."""
+    results: dict[str, str] = {}
+
+    if agent == "claude":
+        from agentpack.installers.claude import ClaudeInstaller
+
+        installer = ClaudeInstaller()
+        results["CLAUDE.md"] = installer.patch_claude_md(root)
+        results[".claude/settings.json"] = installer.patch_claude_settings(root, global_install=False)
+        results[".mcp.json"] = installer.patch_mcp_server(root, global_install=False)
+    elif agent == "cursor":
+        from agentpack.installers.cursor import CursorInstaller
+
+        installer = CursorInstaller()
+        results[".cursorrules"] = installer.patch_cursor_rules(root)
+        results[".cursor/rules/agentpack.mdc"] = installer.patch_cursor_mdc(root)
+        results.update(installer.install_auto_repack(root))
+    elif agent == "windsurf":
+        from agentpack.installers.windsurf import WindsurfInstaller
+
+        installer = WindsurfInstaller()
+        results[".windsurfrules"] = installer.patch_windsurfrules(root)
+        results.update(installer.install_auto_repack(root))
+    elif agent == "codex":
+        from agentpack.installers.codex import CodexInstaller
+
+        installer = CodexInstaller()
+        results["AGENTS.md"] = installer.patch_agents_md(root)
+        results.update(installer.install_auto_repack(root))
+    elif agent == "antigravity":
+        from agentpack.installers.antigravity import AntigravityInstaller
+
+        installer = AntigravityInstaller()
+        results["GEMINI.md"] = installer.patch_gemini_md(root)
+        results.update(installer.install_auto_repack(root))
+
+    return results
+
+
+def _print_agent_integration_results(results: dict[str, str]) -> None:
+    for key, action in results.items():
+        if action == "unchanged":
+            continue
+        if key.startswith("git:"):
+            console.print(f"[green].git/hooks/{key[4:]} {action}[/]")
+        elif key == "vscode:tasks":
+            console.print(f"[green].vscode/tasks.json {action}[/]")
+        else:
+            console.print(f"[green]{key} {action}[/]")
+
+
 def register(app: typer.Typer) -> None:
     @app.command()
     def init(
@@ -150,6 +202,7 @@ def register(app: typer.Typer) -> None:
         from agentpack.core.config import load_config
         resolved_mode = load_config(root).context.default_mode
         existing_session = load_session(root)
+        resolved_agent = agent
         if existing_session is None or force:
             from agentpack.adapters.detect import detect_agent
             resolved_agent = agent if agent != "auto" else detect_agent(root)
@@ -158,6 +211,10 @@ def register(app: typer.Typer) -> None:
             console.print(f"[green]Created[/] {TASK_FILE}  [dim]edit to set your task[/]")
         else:
             console.print(f"[dim]Skipped[/] {SESSION_FILE} (exists)")
+            if agent == "auto":
+                resolved_agent = existing_session.agent
+
+        _print_agent_integration_results(_install_agent_integration(root, resolved_agent))
 
         console.print("\n[bold green]AgentPack initialized.[/]")
         console.print("Run [bold]agentpack watch[/] to start auto-refreshing context.")

agentpack_cli-0.1.28/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.26/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