You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@magpie.apache.org by po...@apache.org on 2026/10/08 12:18:19 UTC

(magpie) branch main updated: docs(setup): correct Codex plugin installation instructions (#1556)

This is an automated email from the ASF dual-hosted git repository.

potiuk pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/magpie.git


The following commit(s) were added to refs/heads/main by this push:
     new a74adb82 docs(setup): correct Codex plugin installation instructions (#1556)
a74adb82 is described below

commit a74adb827722883875d23bcbbc7ac830786b87d1
Author: MakerFly <22...@users.noreply.github.com>
AuthorDate: Thu Oct 8 20:18:13 2026 +0800

    docs(setup): correct Codex plugin installation instructions (#1556)
    
    Use the supported add subcommand with explicit marketplace selectors.
    The bare plugin names still fail after changing the verb, and the Codex
    catalogue does not offer the agent-guard plugin shown in the baseline.
    
    Update the companion registry and generated page together so regeneration
    keeps the corrected Superpowers installation command.
    
    Generated-by: Codex (codex-cli 0.159.0-alpha.12.1)
---
 docs/setup/companion-skills.md    |  2 +-
 docs/setup/marketplace-install.md | 22 +++++++++++-----------
 tools/dev/companion-skills.json   |  2 +-
 3 files changed, 13 insertions(+), 13 deletions(-)

diff --git a/docs/setup/companion-skills.md b/docs/setup/companion-skills.md
index 7c4e7deb..6e8b48be 100644
--- a/docs/setup/companion-skills.md
+++ b/docs/setup/companion-skills.md
@@ -111,7 +111,7 @@ codex plugin marketplace add obra/superpowers-marketplace
 Then:
 
 ```text
-codex plugin install superpowers
+codex plugin add superpowers@superpowers-marketplace
 ```
 
 **VS Code / GitHub Copilot**
diff --git a/docs/setup/marketplace-install.md b/docs/setup/marketplace-install.md
index 4d01d9e4..c51d9c81 100644
--- a/docs/setup/marketplace-install.md
+++ b/docs/setup/marketplace-install.md
@@ -34,7 +34,7 @@ registry sits in between.
 
 ## The recommended baseline
 
-Take these three on every machine, whichever agent you use:
+Install `magpie-setup` and `magpie-utilities`, plus `magpie-agent-guard` where your agent's marketplace offers it:
 
 | Plugin | Why |
 |---|---|
@@ -42,9 +42,9 @@ Take these three on every machine, whichever agent you use:
 | `magpie-agent-guard` | The deterministic pre-execution guard — a hook that inspects each shell command before it runs and denies the dangerous shapes outright. Not a family; a safety net under everything else. |
 | `magpie-utilities` | `list-skills` and the rest of the small tools you reach for when you want to know what is actually installed. |
 
-These three are exactly the **floor** a project commits when it adopts Magpie,
-so taking them yourself is taking what a project would recommend to every
-contributor. Then add families against a problem you have today —
+These three are exactly the **floor** a Claude Code project commits when it adopts Magpie.
+Taking the available baseline plugins yourself is taking what a project would recommend to every contributor.
+Then add families against a problem you have today —
 [What each family solves](../quick-start/families.md) is the menu — and run the
 [secure-agent setup](../quick-start.md#step-3--isolate--guard), which is
 part of setting up rather than a later hardening pass.
@@ -114,15 +114,15 @@ because nothing is installed yet to hear the request.
 
 ```bash
 codex plugin marketplace add apache/magpie
-codex plugin install magpie-setup
-codex plugin install magpie-agent-guard
-codex plugin install magpie-utilities
+codex plugin add magpie-setup@apache-magpie
+codex plugin add magpie-utilities@apache-magpie
 ```
 
-`magpie-setup` installs by default when you add the marketplace, so its line is
-only needed if you removed it; the other two baseline plugins are not, so take
-them here. Add further families the same way. Verify with `/plugins` inside
-Codex, or `codex plugin list` from the shell.
+`magpie-setup` installs by default when you add the marketplace, so its line is only needed if you removed it.
+`magpie-utilities` is not installed by default, so add it explicitly.
+`magpie-agent-guard` is not listed in [Magpie's Codex marketplace](../../.agents/plugins/marketplace.json).
+Add further families the same way.
+Verify with `/plugins` inside Codex, or `codex plugin list` from the shell.
 
 Codex has no auto-update setting for marketplaces, so refreshing is a manual
 step — `codex plugin marketplace upgrade` re-pulls the configured Git snapshots.
diff --git a/tools/dev/companion-skills.json b/tools/dev/companion-skills.json
index f76b4ca6..e728c3e9 100644
--- a/tools/dev/companion-skills.json
+++ b/tools/dev/companion-skills.json
@@ -43,7 +43,7 @@
         },
         "codex": {
           "marketplace": "obra/superpowers-marketplace",
-          "install": "codex plugin install superpowers"
+          "install": "codex plugin add superpowers@superpowers-marketplace"
         },
         "cursor": {
           "marketplace": null,