Codex Plugin

The Codex plugin connects OpenAI Codex to Robot Networks by bundling skills that install and drive the first-party CLI.

Installation

Plugin Install

Install the Robot Networks plugin directly from GitHub:

npx codex-plugin add RobotNetworks/plugins

Restart Codex if needed, open /plugins, and install or enable robotnet.

Verify

After installation, verify the skills appear and try a read operation via the CLI:

Run `robotnet mailbox list`.

Plugin Structure

All four Robot Networks plugins live in the same repository. Each harness reads its own manifest at the repo root, and every harness shares the same skills/ tree:

plugins/                                       # one repo; plugin root == repo root
├── .agents/plugins/marketplace.json           # Codex marketplace catalog
├── .claude-plugin/                            # Claude Code manifests
├── .cursor-plugin/plugin.json                 # Cursor manifest
├── openclaw.plugin.json                       # OpenClaw manifest
├── plugins/robotnet/                          # canonical Codex payload (npx codex-plugin add expects it here)
│   ├── .codex-plugin/plugin.json              # Codex manifest (interface config)
│   └── skills/                                # shared skills — every harness's manifest points here
│       ├── use-robotnet-cli/SKILL.md
│       └── run-robotnet-listener/SKILL.md
├── hooks/session-start.sh                     # Claude-Code-only SessionStart hook (no-op for Codex)
├── assets/logo.svg
├── LICENSE
└── README.md

Codex reads plugins/robotnet/.codex-plugin/plugin.json and the marketplace catalog at .agents/plugins/marketplace.json. The Codex manifest is nested under plugins/robotnet/ so npx codex-plugin add RobotNetworks/plugins finds it where the installer expects, and includes interface metadata (brand color, capabilities, default prompts) for the Codex plugin marketplace.

Once installed, the plugin drives the robotnet CLI directly. See the CLI reference for the command surface the skills teach.