overlord-cli 3.5.3 → 3.5.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "overlord-cli",
-  "version": "3.5.3",
+  "version": "3.5.4",
   "description": "Overlord CLI — launch AI agents on tickets from anywhere",
   "type": "module",
   "bin": {
@@ -11,7 +11,8 @@
     "access": "public"
   },
   "files": [
-    "bin/"
+    "bin/",
+    "plugins/"
   ],
   "engines": {
     "node": ">=18"

package/plugins/overlord/.codex-plugin/plugin.json

@@ -0,0 +1,35 @@
+{
+  "name": "overlord",
+  "version": "0.1.0",
+  "description": "Chat-driven access to Overlord ticket protocol workflows.",
+  "author": {
+    "name": "Cooperativ",
+    "url": "https://github.com/cooperativ"
+  },
+  "homepage": "https://github.com/cooperativ/overlord",
+  "repository": "https://github.com/cooperativ/overlord",
+  "license": "UNLICENSED",
+  "keywords": ["overlord", "tickets", "agents", "workflow", "protocol", "mcp", "codex-plugin"],
+  "skills": "./skills/",
+  "mcpServers": "./.mcp.json",
+  "interface": {
+    "displayName": "Overlord",
+    "shortDescription": "Run Overlord ticket workflows from Codex chat",
+    "longDescription": "Connect Codex to Overlord's local ticket workflow through the existing `ovld protocol` CLI. The plugin bundles workflow skills plus MCP tools for ticket attachment, progress updates, shared context, artifacts, delivery, and follow-up ticket creation.",
+    "developerName": "Cooperativ",
+    "category": "Productivity",
+    "capabilities": ["Interactive", "Write"],
+    "websiteURL": "https://www.ovld.ai/docs",
+    "privacyPolicyURL": "https://www.ovld.ai/privacy",
+    "termsOfServiceURL": "https://www.ovld.ai/terms",
+    "defaultPrompt": [
+      "Attach to Overlord ticket 123 and summarize the context before editing code",
+      "Post an execute update to this Overlord ticket after a meaningful implementation step",
+      "Deliver this Overlord ticket with artifacts and change rationales"
+    ],
+    "brandColor": "#1E6B5C",
+    "composerIcon": "./assets/icon.png",
+    "logo": "./assets/logo.png",
+    "screenshots": ["./assets/screenshot.png"]
+  }
+}

package/plugins/overlord/.mcp.json

@@ -0,0 +1,11 @@
+{
+  "mcpServers": {
+    "overlord": {
+      "command": "node",
+      "args": [
+        "./scripts/overlord-mcp.mjs"
+      ],
+      "note": "Local MCP bridge for the Overlord `ovld protocol` CLI. Requires `ovld` on PATH plus valid OVERLORD_URL and AGENT_TOKEN credentials when talking to a live server."
+    }
+  }
+}

package/plugins/overlord/README.md

@@ -0,0 +1,41 @@
+# Overlord Plugin
+
+This plugin exposes the installed `ovld protocol` workflow to Codex as a local plugin bundle.
+
+It now includes:
+
+- MCP tools for the Overlord ticket protocol
+- a bundled Codex skill for the local ticket lifecycle
+- branded plugin assets for the Codex install surfaces
+
+The plugin is designed for personal installs under `~/.codex/plugins/overlord` with a
+personal marketplace entry at `~/.agents/plugins/marketplace.json`.
+
+## Requirements
+
+- Install the Overlord CLI so `ovld` is available on `PATH`.
+- Ensure `OVERLORD_URL` and `AGENT_TOKEN` are available when the target Overlord instance requires them.
+- Optionally set `OVLD_BIN` if the CLI lives at a non-standard path.
+
+## Tool coverage
+
+- Project resolution: `discover_project`
+- Ticket search: `search_tickets` — keyword search + status/filter (direct API call)
+- Ticket session flow: `attach_ticket`, `connect_ticket`, `load_ticket_context`, `spawn_ticket`
+- Progress and review flow: `post_update`, `record_change_rationales`, `ask_blocking_question`, `deliver_ticket`
+- Shared context: `read_shared_context`, `write_shared_context`
+- Artifacts: `artifact_prepare_upload`, `artifact_finalize_upload`, `artifact_download_url`, `artifact_upload_file`
+
+The MCP server shells into the installed `ovld` binary so the plugin stays aligned with the shipped CLI behavior instead of depending on this repository checkout.
+
+## Skill coverage
+
+- `skills/overlord-ticket-workflow/SKILL.md` teaches Codex the durable local workflow:
+  attach first, update during work, ask when blocked, and deliver last.
+
+## App surface status
+
+The Codex plugin docs support an optional `.app.json` file, but the current file format
+expects a real OpenAI-issued `asdk_app_*` or `connector_*` identifier. This repo does not
+yet have an issued Overlord app ID to point at, so the plugin intentionally does not ship
+an `.app.json` mapping yet.

package/plugins/overlord/assets/screenshot.svg

@@ -0,0 +1,28 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 960 640" role="img" aria-labelledby="title">
+  <title>Overlord Codex Plugin Screenshot</title>
+  <rect width="960" height="640" rx="32" fill="#EEE8DC" />
+  <rect x="28" y="28" width="904" height="584" rx="24" fill="#102A26" />
+  <rect x="56" y="56" width="220" height="528" rx="20" fill="#173D37" />
+  <rect x="300" y="56" width="604" height="528" rx="20" fill="#F6F3EC" />
+  <rect x="80" y="88" width="96" height="14" rx="7" fill="#F4B35D" />
+  <rect x="80" y="130" width="160" height="14" rx="7" fill="#D5E4DE" opacity="0.92" />
+  <rect x="80" y="160" width="132" height="14" rx="7" fill="#D5E4DE" opacity="0.62" />
+  <rect x="80" y="226" width="172" height="42" rx="21" fill="#1E6B5C" />
+  <rect x="332" y="96" width="184" height="18" rx="9" fill="#214D43" />
+  <rect x="332" y="146" width="520" height="18" rx="9" fill="#CFD8D3" />
+  <rect x="332" y="180" width="470" height="18" rx="9" fill="#CFD8D3" />
+  <rect x="332" y="214" width="550" height="18" rx="9" fill="#CFD8D3" />
+  <rect x="332" y="276" width="524" height="116" rx="18" fill="#F0EADF" />
+  <rect x="356" y="304" width="168" height="14" rx="7" fill="#173D37" />
+  <rect x="356" y="336" width="468" height="14" rx="7" fill="#B9C7C2" />
+  <rect x="356" y="360" width="384" height="14" rx="7" fill="#B9C7C2" />
+  <rect x="332" y="430" width="180" height="44" rx="22" fill="#1E6B5C" />
+  <rect x="530" y="430" width="140" height="44" rx="22" fill="#E0D8CA" />
+  <text
+    x="332"
+    y="538"
+    fill="#214D43"
+    font-family="IBM Plex Mono, monospace"
+    font-size="24"
+  >Attach, update, ask, deliver</text>
+</svg>