🤖 docs: RFC for Mux plugins and marketplaces#3485
Open
dcieslak19973 wants to merge 5 commits into
Open
Conversation
Scopes a declarative plugin bundle (.mux-plugin/plugin.json) + marketplace aligned to the Claude Code / Codex convention, mapping components onto Mux's existing skills/hooks/MCP/agents, with a trust model built on policyService. Includes a spec-level comparison of Claude Code, Codex CLI, and opencode. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Adopt .agents/plugin.json and .agents/plugins/marketplace.json (matching
Codex's vendor-neutral namespace) instead of a mux-branded .mux-plugin dir;
keep resolved installs + trust state mux-owned under ~/.mux. Canonical hook
env is ${AGENT_PLUGIN_ROOT} with ${CLAUDE_PLUGIN_ROOT} alias.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Frame which events to add first around mux's parallel-lane lifecycle (Stop, worktree teardown, compaction, resume), call out the worktree-teardown gap, and note the structured JSON decision protocol as a Phase 3 prerequisite. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
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.
Summary
Adds an RFC (
rfc/20260607_plugins-and-marketplaces.md) proposing a Mux plugin + marketplace system: a declarative, vendor-neutral plugin bundle that packages Mux's existing extension primitives (skills, hooks, MCP servers, agents, commands) and a marketplace to distribute/install/version/trust them as a unit.Background
Mux already supports the individual primitives but configures each independently — there's no way to bundle, distribute, or version a coherent set. The ecosystem has converged on a declarative-bundle-plus-marketplace model (Claude Code and Codex share nearly the same manifest shape; opencode took a code-module + npm route). This RFC documents that prior art and proposes a Mux design that reuses its existing loaders and trust model.
What's in the RFC
.agents/plugin.json+.agents/plugins/marketplace.json(matching Codex's neutral namespace), while accepting.claude-plugin/.codex-pluginfor import compatibility. Resolved installs + trust state stay Mux-owned under~/.mux/(the same split Codex uses) so a trust grant to one agent doesn't implicitly authorize another.Stop, worktree teardown,Pre/PostCompact,SessionStartresume,UserPromptSubmit), and the structured decision protocol as a prerequisite.policyService+ runtime isolation as a differentiator.Docs-only; no code changes. Intended as a planning artifact for review and steering.
Generated with
mux• Model:claude-opus-4-8