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,