@agdf/cli 0.3.5 → 0.4.0

package/README.md

@@ -13,16 +13,24 @@ GitHub Copilot and OpenCode.
 
 ## Quick Start
 
-Run commands inside the target Git repository:
+Prepare one repository:
 
 ```bash
 npx --yes @agdf/cli@latest codex
-npx --yes @agdf/cli@latest opencode
+npx --yes @agdf/cli@latest codex-repo
+npx --yes @agdf/cli@latest claude
+npx --yes @agdf/cli@latest opencode-repo
 npx --yes @agdf/cli@latest copilot
 ```
 
-Install globally when AGDF should be available as a regular command on your
-machine:
+Install the user-wide OpenCode hook:
+
+```bash
+npx --yes @agdf/cli@latest opencode
+```
+
+Install the AGDF CLI globally when `agdf` should be available as a regular
+shell command on your machine:
 
 ```bash
 npm install -g @agdf/cli
@@ -62,8 +70,11 @@ authoritative reusable format, not AGDF's internal project backlog.
 
 | Command | Purpose |
 | --- | --- |
-| `codex` | Add a repository-local Codex marketplace and AGDF plugin copy. |
-| `opencode` | Add OpenCode instructions, agents, permissions and the npm plugin entry. |
+| `codex` | Install the AGDF plugin globally for Codex. |
+| `codex-repo` | Add a repository-local Codex marketplace and AGDF plugin copy. |
+| `claude` | Install the AGDF plugin globally for Claude Code. |
+| `opencode` | Install the AGDF npm plugin as a user-wide OpenCode hook. |
+| `opencode-repo` | Add OpenCode repository instructions, subagents, permissions and control templates. |
 | `copilot` | Add `AGENTS.md`, Copilot instructions, skills and control templates. |
 | `both` | Prepare the repository-file and plugin surfaces together. |
 | `init` | Create durable `.agdf/control` files when repository-owned control state is required. |
@@ -75,6 +86,8 @@ authoritative reusable format, not AGDF's internal project backlog.
 Examples:
 
 ```bash
+npx --yes @agdf/cli@latest opencode
+npx --yes @agdf/cli@latest opencode-repo
 npx --yes @agdf/cli@latest config --language en
 npx --yes @agdf/cli@latest init
 npx --yes @agdf/cli@latest doctor
@@ -87,13 +100,17 @@ They do not replace AGDF skill judgement or user approvals.
 
 ## Surface Notes
 
-- **Codex:** `codex` prepares a repository-local marketplace. For a global
-  installation, use the Codex plugin marketplace commands documented on the
-  [AGDF website](https://agdf.iself.eu/#setup-codex).
-- **Claude Code:** install the AGDF plugin with the Claude Code CLI; this is not
-  an `@agdf/cli` bootstrap target.
-- **OpenCode:** `opencode` writes the npm plugin entry together with the
-  repository instructions, agents and permissions AGDF needs.
+- **Codex:** `codex` installs the AGDF plugin globally for Codex, while
+  `codex-repo` prepares a repository-local marketplace for testing AGDF in one
+  repository.
+- **Claude Code:** `claude` installs the AGDF plugin globally for Claude Code.
+- **OpenCode:** `opencode` installs the user-wide npm plugin hook, while
+  `opencode-repo` writes the repository instructions, agents and permissions
+  AGDF needs. Repository instructions, generated agents and control files remain
+  the AGDF source of truth. The generated
+  OpenCode agents are intentional `mode: subagent` workflow controls, not
+  `.opencode/skills/` entries or primary menu agents; use `@agdf-gate-check`
+  as the visible entry point for new build/change intent.
 - **GitHub Copilot:** `copilot` writes repository instructions and skills. If
   `AGENTS.md` already exists, AGDF preserves it and writes `AGENTS.agdf.md` for
   manual merging.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agdf/cli",
-  "version": "0.3.5",
+  "version": "0.4.0",
   "description": "Primary AGDF CLI for repository-local AI governance, delivery controls and agent setup.",
   "type": "module",
   "files": [
@@ -15,7 +15,7 @@
     "smoke-test": "node ./scripts/smoke-test.js"
   },
   "dependencies": {
-    "create-agdf": "0.3.5"
+    "create-agdf": "0.4.0"
   },
   "keywords": [
     "agdf",