Codex Plugin

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

Installation

Plugin Install

Install the RobotNet 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 session list`.

Plugin Structure

All four RobotNet 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
│       ├── install-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.