Add Codex plugin packaging for browser-harness#453
Closed
ShawnPana wants to merge 1 commit into
Closed
Conversation
Makes browser-harness installable from Codex without touching the
load-bearing root SKILL.md (which Claude + the global config import use).
Codex requires a plugin to be a self-contained subdir with
skills/<name>/SKILL.md (the dir is copied into Codex's cache), so it can't
reference the repo-root SKILL.md the way the Claude plugin does. This adds:
- .agents/plugins/marketplace.json — Codex catalog (its own marketplace)
- codex/browser-harness/.codex-plugin/plugin.json — Codex manifest
- codex/browser-harness/skills/browser/SKILL.md — COPY of the root skill
- codex/browser-harness/README.md — notes the copy + sync caveat
Validated with codex-cli 0.133.0: marketplace add -> plugin list ->
plugin add all succeed and the skill lands in the cache. Root SKILL.md is
unchanged. De-dupe (generate this copy from the root) is a later cleanup.
Install: `codex plugin marketplace add browser-use/browser-harness`
`codex plugin add browser-harness@browser-harness`
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
![cubic-dev-ai[bot]](https://avatars.githubusercontent.com/in/1082092?s=60&v=4){kind=small}
Contributor
Author
|
Closing — browser-harness is better treated as a CLI dependency than a standalone Codex plugin. The curated marketplace plugins (Linear, Cloudflare, etc.) avoid local installs by being hosted (remote MCP / OAuth); browser-harness needs a local CLI, and the Codex plugin form here was a thin copy of SKILL.md with dangling references to repo files (interaction-skills/, install.md) that don't get copied. qa already declares the browser-harness CLI as a prerequisite, which is the cleaner model. The real fix for install-free, cross-host use is a working hosted MCP. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Makes browser-harness installable from Codex — without touching the load-bearing root
SKILL.md(which the Claude plugin and the global~/browser-harness/SKILL.mdimport both use).Why a copy
Codex requires a plugin to be a self-contained subdir with
skills/<name>/SKILL.md(it copies the directory into its cache), so it can't point back at the repo-rootSKILL.mdthe way the Claude plugin (which remote-sources the whole repo) does. The root file stays canonical; this is a copy. RootSKILL.mdis unchanged.Validated with codex-cli 0.133.0
Install (once merged)
Still needs the
browser-harnessCLI (one-time uv/pip install) — the plugin ships the skill, the CLI is the tool it drives.Follow-up
The
skills/browser/SKILL.mdcopy can drift from the root. A small build step (generate the copy from rootSKILL.md) removes that — worth doing once more hosts/plugins land.🤖 Generated with Claude Code
Summary by cubic
Make
browser-harnessinstallable from Codex by adding a self-contained plugin undercodex/browser-harness/, without changing the rootSKILL.md. This enables marketplace installation and keeps the root skill as the canonical source.New Features
.agents/plugins/marketplace.json.codex/browser-harness/.codex-plugin/plugin.json.skills/browser/SKILL.mdas a copy of the root skill to satisfy Codex’s self-contained plugin requirement.codex/browser-harness/README.mdwith usage notes.codex-cli 0.133.0.Migration
codex plugin marketplace add browser-use/browser-harness.codex plugin add browser-harness@browser-harness.browser-harnessCLI separately once (viauv/pip). The plugin ships only the skill.Written for commit 8fcce35. Summary will update on new commits.