Add Codex plugin integration

.agents/plugins/marketplace.json

@@ -0,0 +1,20 @@
+{
+  "name": "ralphex",
+  "interface": {
+    "displayName": "Ralphex"
+  },
+  "plugins": [
+    {
+      "name": "ralphex",
+      "source": {
+        "source": "local",
+        "path": "./plugins/ralphex"
+      },
+      "policy": {
+        "installation": "AVAILABLE",
+        "authentication": "ON_INSTALL"
+      },
+      "category": "Developer Tools"
+    }
+  ]
+}

.claude-plugin/marketplace.json

@@ -9,7 +9,7 @@
       "name": "ralphex",
       "source": "./",
       "description": "Autonomous plan execution with Claude Code - task execution, monitoring, and plan creation",
-      "version": "0.20.0",
+      "version": "0.20.1",
       "author": {
         "name": "umputun"
       }

.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "ralphex",
-  "version": "0.20.0",
+  "version": "0.20.1",
   "description": "Autonomous plan execution with Claude Code - task execution, monitoring, and plan creation",
   "author": {
     "name": "umputun",

Makefile

@@ -13,6 +13,7 @@ build:
 	cp .bin/ralphex.$(BRANCH) .bin/ralphex
 
 test:
+	uv run --with pyyaml python scripts/validate-portable-plugin.py
 	go clean -testcache
 	go test -race -coverprofile=coverage.out ./...
 	grep -v "_mock.go" coverage.out | grep -v mocks > coverage_no_mocks.out

README.md

@@ -1434,6 +1434,22 @@ The `/ralphex` command runs ralphex in the background and provides status update
 
 > **Note:** ralphex automatically strips the `CLAUDECODE` env var from child processes, allowing it to run from inside Claude Code. However, running from a standalone terminal is still recommended for the best experience. If the nested session error is somehow encountered, ralphex detects it via error pattern matching and exits gracefully.
 
+## Codex Integration (Optional)
+
+Ralphex also provides a skills-only Codex plugin. The standalone CLI behavior is unchanged.
+
+```bash
+codex plugin marketplace add umputun/ralphex
+codex plugin add ralphex@ralphex
+```
+
+After installation, start a new Codex conversation and use `/skills` to discover the four workflows:
+
+- `$ralphex` launches and monitors an existing plan.
+- `$ralphex-plan` creates a structured implementation plan.
+- `$ralphex-adopt` converts an existing specification or task list into a Ralphex plan.
+- `$ralphex-update` merges updated defaults into customized Ralphex configuration.
+
 ## For LLMs
 
 See [llms.txt](llms.txt) for LLM-optimized documentation.

assets/claude/skills/ralphex-adopt/SKILL.md

@@ -1,6 +1,7 @@
 ---
+name: ralphex-adopt
 description: Convert plans from various source formats (OpenSpec, spec-kit, GitHub/GitLab issues with checklists, generic task-lists, free-form markdown) into ralphex-format plans in docs/plans/. Triggers on "ralphex-adopt", "adopt plan", "convert plan to ralphex", "import plan as ralphex".
-allowed-tools: [Bash, Read, Write, Glob, Grep, AskUserQuestion]
+allowed-tools: Bash Read Write Glob Grep AskUserQuestion
 ---
 
 # ralphex-adopt - Convert Plans Into ralphex Format

assets/claude/skills/ralphex-plan/SKILL.md

@@ -1,4 +1,5 @@
 ---
+name: ralphex-plan
 description: Create structured implementation plan in docs/plans/
 ---
 

assets/claude/skills/ralphex-update/SKILL.md

@@ -1,6 +1,7 @@
 ---
+name: ralphex-update
 description: Smart-merge updated ralphex defaults into customized prompts/agents
-allowed-tools: [Bash, Read, Write, Glob, AskUserQuestion]
+allowed-tools: Bash Read Write Glob AskUserQuestion
 ---
 
 # ralphex-update - Smart Prompt Merging

assets/claude/skills/ralphex/SKILL.md

@@ -1,7 +1,7 @@
 ---
+name: ralphex
 description: Run ralphex autonomous plan execution with progress monitoring
-argument-hint: 'optional plan file path'
-allowed-tools: [Bash, Read, AskUserQuestion, TaskOutput, Glob]
+allowed-tools: Bash Read AskUserQuestion TaskOutput Glob
 ---
 
 # ralphex - Autonomous Plan Execution

plugins/ralphex/.codex-plugin/plugin.json

@@ -0,0 +1,38 @@
+{
+  "name": "ralphex",
+  "version": "0.20.1",
+  "description": "Plan-driven implementation, review, adoption, and configuration workflows for Ralphex",
+  "author": {
+    "name": "umputun",
+    "email": "umputun@gmail.com",
+    "url": "https://github.com/umputun"
+  },
+  "homepage": "https://ralphex.com/docs/#codex-integration-optional",
+  "repository": "https://github.com/umputun/ralphex",
+  "license": "MIT",
+  "keywords": [
+    "automation",
+    "planning",
+    "code-review",
+    "task-execution"
+  ],
+  "skills": "./skills/",
+  "interface": {
+    "displayName": "Ralphex",
+    "shortDescription": "Run and maintain Ralphex workflows",
+    "longDescription": "Create or adopt executable plans, launch autonomous Ralphex runs, monitor progress, and merge updated defaults from Codex.",
+    "developerName": "umputun",
+    "category": "Developer Tools",
+    "capabilities": [
+      "Interactive",
+      "Write"
+    ],
+    "websiteURL": "https://ralphex.com",
+    "defaultPrompt": [
+      "Use $ralphex-plan to create an executable implementation plan.",
+      "Use $ralphex to launch an existing plan.",
+      "Use $ralphex-adopt to convert an existing specification."
+    ],
+    "brandColor": "#D97706"
+  }
+}

plugins/ralphex/plugin.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
+  "name": "ralphex",
+  "version": "0.20.1",
+  "description": "Plan-driven implementation, review, adoption, and configuration workflows for Ralphex",
+  "author": { "name": "umputun", "email": "umputun@gmail.com", "url": "https://github.com/umputun" },
+  "homepage": "https://ralphex.com/docs/#codex-integration-optional",
+  "repository": "https://github.com/umputun/ralphex",
+  "license": "MIT",
+  "keywords": ["automation", "planning", "code-review", "task-execution"]
+}