Skip to content

feat: add unofficial Codex plugin surface - #96

Open
WilliamBergamin wants to merge 3 commits into
mainfrom
codex-support
Open

feat: add unofficial Codex plugin surface#96
WilliamBergamin wants to merge 3 commits into
mainfrom
codex-support

Conversation

@WilliamBergamin

@WilliamBergamin WilliamBergamin commented Jul 17, 2026

Copy link
Copy Markdown
Contributor

Summary

Adds unofficial Codex support to this plugin by exposing the Slack skills through a Codex plugin surface. This mirrors the existing Claude Code and Cursor surfaces.

  • New .codex-plugin/plugin.json manifest that exposes the skills to Codex, version-matched to the other plugin manifests.
  • scripts/sync_versions.py now keeps the Codex manifest version in lockstep with package.json, the Claude, and Cursor manifests.

The hosted MCP server is not yet wired into the Codex surface, this ships the skills only for now.

Preview

Screenshot 2026-07-23 at 1 45 24 PM

Test plan

  • codex plugin marketplace add ./ then codex plugin add slack@slack-dev installs the plugin from a local checkout
  • Skills are invocable in a Codex session (e.g. $block-kit)
  • make lint / make typecheck / make test-unit pass

🤖 Generated with Claude Code

Expose the Slack skills to Codex via a new .codex-plugin/plugin.json
manifest and a repo-scoped .agents/plugins/marketplace.json for local
installation. sync_versions.py now keeps the Codex manifest version in
lockstep with the other plugin surfaces, and the maintainers guide
documents how to test in Codex.

The hosted MCP server is not yet wired into the Codex surface; this
ships the skills only for now.

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
@changeset-bot

changeset-bot Bot commented Jul 17, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 8805c70

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package
Name Type
slack Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@WilliamBergamin WilliamBergamin self-assigned this Jul 17, 2026
@WilliamBergamin WilliamBergamin added enhancement New feature or request semver:minor Changes trigger a minor version bump labels Jul 17, 2026
Replace the placeholder metadata in .codex-plugin/plugin.json, where
description, shortDescription, and longDescription were all the same
generic sentence. Give each field distinct, capability-accurate copy
following Codex's documented field semantics, and point homepage at the
publisher docs hub (docs.slack.dev) and websiteURL at the official Slack
MCP server docs page.

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
Set an empty mcpServers object in .codex-plugin/plugin.json so Codex does
not fall back to reading the repo-root .mcp.json, which would silently load
the Slack MCP server under Claude Code's OAuth client ID. Add the required
interface.defaultPrompt so the manifest passes Codex's plugin validator, and
rewrite the install-surface copy to describe the skills rather than an MCP
server that isn't wired into this surface. Align the dev marketplace category
with the manifest (Productivity).

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
@WilliamBergamin
WilliamBergamin marked this pull request as ready for review July 23, 2026 17:49
@WilliamBergamin
WilliamBergamin requested a review from a team as a code owner July 23, 2026 17:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request semver:minor Changes trigger a minor version bump

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant