NodeOps-app · BhautikChudasama · Aug 5, 2026 · Aug 5, 2026 · Aug 5, 2026 · Aug 5, 2026
diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json
@@ -1,12 +1,17 @@
 {
   "name": "createos",
-  "description": "NodeOps CreateOS plugins for Claude Code — disposable sandbox compute and live dev sessions.",
+  "description": "NodeOps CreateOS plugins — disposable sandbox compute for Claude Code, Codex, and more.",
   "owner": { "name": "NodeOps", "url": "https://createos.sh" },
   "plugins": [
     {
       "name": "@createos/claude-code",
       "source": "./packages/claude-code-plugin",
       "description": "Run ad-hoc/heavy/untrusted code in disposable CreateOS Sandboxes; offload, parallel fanout, scratch shell, reusable box with sync, port tunnel, public expose, network clusters, S3 disks, WireGuard VPN, fork, pause/resume, and custom images."
+    },
+    {
+      "name": "@createos/codex",
+      "source": "./packages/codex-plugin",
+      "description": "Codex plugin for disposable CreateOS Sandboxes — skill + createos CLI for sandbox lifecycle, networking, disks, and VPN."
     }
   ]
 }
diff --git a/README.md b/README.md
@@ -2,12 +2,13 @@
 
 # CreateOS Integrations
 
-**[Claude Code](https://docs.claude.com/en/docs/claude-code) plugin, [Pi](https://github.com/anthropics/pi) extension & [OpenCode](https://opencode.ai) plugin for disposable sandbox compute.**
+**[Claude Code](https://docs.claude.com/en/docs/claude-code), [Codex](https://github.com/openai/codex), [Pi](https://github.com/anthropics/pi) & [OpenCode](https://opencode.ai) plugins for disposable sandbox compute.**
 
-Run code **off your machine** in disposable [CreateOS](https://createos.sh) Sandboxes — from Claude Code, Pi, or OpenCode.
+Run code **off your machine** in disposable [CreateOS](https://createos.sh) Sandboxes — from Claude Code, Codex, Pi, or OpenCode.
 
 [![Claude Code](https://img.shields.io/badge/Claude%20Code-plugin-6E56CF)](https://docs.claude.com/en/docs/claude-code)
 [![Pi](https://img.shields.io/badge/Pi-extension-F97316)](https://github.com/anthropics/pi)
+[![Codex](https://img.shields.io/badge/Codex-plugin-10A37F)](https://github.com/openai/codex)
 [![OpenCode](https://img.shields.io/badge/OpenCode-plugin-0EA5E9)](https://opencode.ai)
 [![CreateOS](https://img.shields.io/badge/CreateOS-Sandboxes-0EA5E9)](https://createos.sh)
 [![Spawn](https://img.shields.io/badge/create%20to%20first%20command-~200ms-22C55E)](https://createos.sh)
@@ -50,6 +51,19 @@ pi install npm:@createos/pi
 pi --createos
 ```
 
+**Codex:**
+
+```bash
+# 1. Add the marketplace
+codex plugin marketplace add NodeOps-app/createos-claude-plugins
+
+# 2. Install the plugin
+codex plugin add @createos/codex@createos
+
+# 3. Launch codex — the skill teaches createos CLI usage
+codex
+```
+
 **OpenCode:**
 
 ```bash
@@ -68,6 +82,7 @@ The `createos` CLI **auto-installs** on first use. Sign in once with `createos l
 | ------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
 | [**claude-code-plugin**](./packages/claude-code-plugin) | Hooks-based Claude Code plugin — offload, parallel fanout, scratch shell, reusable box with sync, port tunnel, public HTTPS expose, private-network clusters, BYO-S3 disk mounts, WireGuard VPN, and snapshot/fork — all driving the authed `createos` CLI.                                                                                            |
 | [**pi-extension**](./packages/pi-extension)             | Pi coding agent extension that transparently routes all built-in commands (bash, read, write, edit, ls, find, grep) to a remote CreateOS Sandbox, plus 40 additional tools for sandbox lifecycle, configuration, port tunnels, file sync, private networks, persistent disks, custom image templates, remote editors, and device VPN — 47 tools total. |
+| [**@createos/codex**](./packages/codex-plugin)          | Codex plugin — skill that teaches the `createos` CLI for sandbox lifecycle, networking, disks, and VPN.                                                                                                                                                                                                                                                |
 | [**@createos/opencode**](./packages/opencode-plugin)    | OpenCode plugin with 33 sandbox tools (`sandbox_exec`, `sandbox_push`, `sandbox_pull`, networks, disks, VPN, sync) and system prompt injection for sandbox-first workflows.                                                                                                                                                                            |
 
 ## Claude Code — commands at a glance
@@ -187,6 +202,11 @@ createos-claude-plugins/              # marketplace root
 │  │  ├─ index.ts                     # extension entry point
 │  │  ├─ src/                         # tools, CLI wrappers, ops
 │  │  └─ README.md
+│  ├─ codex-plugin/                  # Codex plugin
+│  │  ├─ manifest.json
+│  │  ├─ scripts/cos, session-start.sh
+│  │  ├─ skills/using-createos-sandbox/
+│  │  └─ README.md
 │  └─ opencode-plugin/               # OpenCode plugin
 │     ├─ index.ts                     # plugin entry (CreateOSPlugin)
 │     ├─ src/cli.ts                   # createos CLI wrappers
@@ -210,4 +230,5 @@ Issues and PRs welcome. All three plugins are thin surfaces over the [`createos`
 - [OpenCode plugins](https://opencode.ai/docs/plugins/) — OpenCode plugin docs
 - [Claude Code plugin README](./packages/claude-code-plugin/README.md)
 - [Pi extension README](./packages/pi-extension/README.md)
+- [Codex plugin README](./packages/codex-plugin/README.md)
 - [OpenCode plugin README](./packages/opencode-plugin/README.md)
diff --git a/packages/codex-plugin/.claude-plugin/plugin.json b/packages/codex-plugin/.claude-plugin/plugin.json
@@ -0,0 +1,17 @@
+{
+  "name": "@createos/codex",
+  "displayName": "CreateOS Sandbox",
+  "version": "0.1.0",
+  "description": "Run code off your machine in disposable CreateOS Sandboxes via the createos CLI.",
+  "author": { "name": "NodeOps", "url": "https://createos.sh" },
+  "homepage": "https://createos.sh",
+  "keywords": ["sandbox", "createos", "remote-exec", "isolation"],
+  "skills": "./skills/",
+  "interface": {
+    "displayName": "CreateOS Sandbox",
+    "shortDescription": "Offload code to disposable remote sandboxes",
+    "developerName": "NodeOps",
+    "category": "Developer Tools",
+    "websiteURL": "https://createos.sh"
+  }
+}
diff --git a/packages/codex-plugin/README.md b/packages/codex-plugin/README.md
@@ -0,0 +1,83 @@
+# @createos/codex
+
+Codex plugin that offloads code to disposable [CreateOS](https://createos.sh) Sandboxes.
+Gives Codex a skill that teaches the agent how to use the `createos` CLI
+for sandbox lifecycle, networking, persistent disks, VPN, and more.
+
+## Install
+
+```bash
+# 1. Add the marketplace
+codex plugin marketplace add NodeOps-app/createos-claude-plugins
+
+# 2. Install the plugin
+codex plugin add @createos/codex@createos
+```
+
+## Prerequisites
+
+1. **createos CLI** — auto-installs on first use, or manually:
+
+   ```bash
+   curl -sfL https://raw.githubusercontent.com/NodeOps-app/createos-cli/main/install.sh | sh
+   ```
+
+2. **Login** (one-time):
+   ```bash
+   createos login
+   ```
+
+## How it works
+
+1. Plugin installs a skill that teaches Codex the `createos` CLI commands
+2. When you ask to run code in a sandbox, Codex uses `createos sandbox create` + `createos sandbox exec`
+3. All commands execute inside remote CreateOS Sandboxes, not on your machine
+
+## Commands the skill teaches
+
+| Command                                                       | What                       |
+| ------------------------------------------------------------- | -------------------------- |
+| `createos sandbox create`                                     | Create a sandbox           |
+| `createos sandbox exec <id> -- sh -c '<cmd>'`                 | Run command inside sandbox |
+| `createos sandbox list`                                       | List sandboxes             |
+| `createos sandbox get <id>`                                   | Sandbox status/IP/ingress  |
+| `createos sandbox rm <id> --yes`                              | Destroy sandbox            |
+| `createos sandbox pause/resume <id>`                          | Park/restore               |
+| `createos sandbox pull <id> <path> -`                         | Read file from sandbox     |
+| `createos sandbox tunnel --remote <port> --local <port> <id>` | Port forward               |
+| `createos sandbox network create/attach/show`                 | Private networks           |
+| `createos sandbox disk create/attach`                         | S3 disk mounts             |
+| `createos sandbox devices register`                           | Device VPN setup           |
+
+## Architecture
+
+```
+packages/codex-plugin/
+├── .claude-plugin/
+│   └── plugin.json              # Plugin manifest (name, skills ref)
+├── skills/
+│   └── using-createos-sandbox/
+│       ├── SKILL.md             # Main skill — createos CLI commands
+│       └── references/
+│           ├── offload-and-egress.md
+│           ├── networking.md
+│           └── lifecycle-and-images.md
+├── scripts/
+│   ├── cos                      # CLI driver (advanced offload patterns)
+│   └── session-start.sh         # Session hook
+├── manifest.json
+└── README.md
+```
+
+## Differences from Pi and OpenCode plugins
+
+| Capability       | Pi                            | OpenCode                             | Codex                                       |
+| ---------------- | ----------------------------- | ------------------------------------ | ------------------------------------------- |
+| Tool replacement | Yes — transparent             | No — prompt injection                | No — skill-based                            |
+| Custom tools     | 47 registered tools           | 33 registered tools                  | None — uses bash + createos CLI             |
+| Integration      | `pi.registerTool()`           | `tool()` in plugin                   | Skill teaches CLI commands                  |
+| Install          | `pi install npm:@createos/pi` | `opencode plugin @createos/opencode` | `codex plugin add @createos/codex@createos` |
+
+## License
+
+Apache-2.0
diff --git a/packages/codex-plugin/manifest.json b/packages/codex-plugin/manifest.json
@@ -0,0 +1,29 @@
+{
+  "name": "createos-sandbox",
+  "version": "0.1.0",
+  "description": "Run code off your machine in disposable CreateOS Sandboxes — offload, fanout, scratch shell, reusable box with sync, tunnels, clusters, disks, and VPN.",
+  "keywords": ["createos", "sandbox", "offload", "remote", "compute"],
+  "paths": {
+    "skills": ["skills/using-createos-sandbox"],
+    "hooks": {
+      "Inline": [
+        {
+          "event_name": "session-start",
+          "hooks": [
+            {
+              "type": "command",
+              "command": "./scripts/session-start.sh"
+            }
+          ]
+        }
+      ]
+    }
+  },
+  "interface": {
+    "display_name": "CreateOS Sandbox",
+    "short_description": "Offload code to disposable remote sandboxes",
+    "developer_name": "CreateOS",
+    "category": "compute",
+    "website_url": "https://createos.sh"
+  }
+}