OpenDesign Agent Plugins

This is an agent-first, lightweight distribution repository for OpenDesign plugins. Codex Desktop / Codex CLI is the first supported host.

Give this repository to an agent

Give Codex this instruction:

Read https://github.com/nexu-io/open-design-agent-plugins/blob/main/AGENTS.md and install the OpenDesign plugin into Codex. Follow the Install lane, preserve existing configuration, connect the plugin to the local open-design MCP, and report any OpenDesign or Vela-login prerequisite.

The detailed entrypoint is AGENTS.md; a reusable prompt is in AGENT_PROMPT.md.

Architecture

The distribution plugin is intentionally small and contains no MCP server:

Codex plugin
  -> local open-design MCP
  -> local OpenDesign daemon
  -> bundled Vela CLI
  -> remote Vela / AMR service

Users install OpenDesign and register its local MCP with Codex. The signed runtime starts headlessly when needed; its Electron window does not need to stay open. The plugin's default Cloud workflow uses agent: "amr", browser login through narrow local MCP tools, and the interactive collect_brief card. There is no remote MCP dependency and no Codex-side Vela credential.

Current package

• Marketplace: open-design
• Plugin: open-design
• Display name: OpenDesign
• Stable plugin selector: open-design@open-design
• Plugin version: 0.5.3
• Distribution: published Git marketplace from main
• Host: Codex only
• Minimum OpenDesign: 0.17.0
• Recommended OpenDesign: release/v0.18.0 (1a3cfd0fd625736e8b63249b38163c999b741f36; release branch snapshot, no open-design-v0.18.0 tag observed yet)
• Compatibility baseline: open-design-v0.17.0 (90a660add511da6408464a1bf3d4d5945ad06400); later versions are supported
• Telemetry contract: schema v3, self-reported Plugin attribution
• MCP: local open-design stdio registration
• Cloud runtime: remote Vela/AMR via OpenDesign's bundled Vela CLI
• Optional modes: Local Codex and Local BYOK, explicit and never fallbacks
• Portal upload artifact: build it with pnpm package. A source download from GitHub — "Download ZIP", or any repository/PR archive — is not an installable plugin, because it nests the plugin manifest under <archive>/plugins/codex/open-design/ instead of at the archive root, and the Portal rejects it with "Plugin manifest not found".

Direct installation

codex plugin marketplace add nexu-io/open-design-agent-plugins --ref main --json
codex plugin add open-design@open-design --json

Then install its Codex MCP registration from Settings → MCP server, through the signed packaged --headless --mcp-install codex operation, or with the od mcp install codex command supplied by that OpenDesign installation. Verify:

codex plugin list --json
codex mcp get open-design --json

When Cloud generation needs Vela login, the plugin can open browser authorization through the local MCP without opening the OpenDesign GUI. Start a new Codex task after plugin installation, then invoke @open-design.

See docs/INSTALL_CODEX.md for isolated validation, docs/TELEMETRY.md for measurement boundaries, and docs/SUBMISSION_TEST_CASES.md for the five positive and three negative reviewer cases used for Plugin Portal submission.

Source and release boundary

Product implementation remains in nexu-io/open-design. This repository contains only the portable payload, marketplace metadata, release provenance, and installation documentation.

OpenDesign product releases do not automatically change this repository. Refresh the generated payload only when its plugin manifest, skill, package contract, minimum Codex/OpenDesign version, or installation behavior changes. Pure product fixes behind the stable local MCP contract require a new OpenDesign release, not necessarily a new distribution-plugin version.

Host-specific payloads use plugins/<host>/<plugin-name>/; future Claude or Gemini packages can live beside codex/ without mixing host manifests.