docs: distribution install matrix + name-collision decision (D6)#124
Merged
Conversation
Resolves the D6 name-collision blocker with data: `mcpm` is already the homebrew-core formula for the unrelated mcpm.sh project (and it squats PyPI), with its own `mcpm` bin. Decision: don't fight for `brew install mcpm` or the `mcpm` mise short-name — distribute through collision-free scoped channels. - README Quick start: an install matrix (npm / npx / pnpm / mise) all resolving @getmcpm/cli. mise uses its built-in npm: backend (mise use -g npm:@getmcpm/cli), verified against mise docs — no registry entry needed. - docs/DISTRIBUTION.md: documents the matrix, the name-collision decision, and the deferred external-repo work (homebrew tap, mise registry short-name, devcontainer). Docs-only. The homebrew tap + mise registry PR are outward-facing / cross-repo and left for owner authorization, documented as deferred (not blocking).
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
Wave-1 item D6 (the in-repo slice). Docs-only.
The name-collision blocker — resolved with data
The roadmap gated D6 on resolving the
mcpm.shname collision. Confirmed:mcpmis already the homebrew-core formula for the unrelated mcpm.sh project (Path Integral, v2.15.0, "MCP server and client manager") — and it squats themcpmname on PyPI. Its bin is alsomcpm.Decision: don't publish a colliding
brew install mcpmor claim themcpmmise short-name (fighting over a name we don't own, and conflicting on themcpmbinary). Distribute through the collision-free scoped channels instead.Changes (docs-only)
@getmcpm/cli. mise uses its built-innpm:backend (mise use -g npm:@getmcpm/cli) — verified against mise's docs, no registry entry required.docs/DISTRIBUTION.md(new) — the matrix, the name-collision decision, and the deferred external work.### Documentation), ROADMAP-ADOPTION (D6 → ✅ SHIPPED), CLAUDE.md decisions log.Deferred (documented, not blocking)
The
getmcpm/homebrew-mcpmtap and a mise registry short-name PR are external-repo / outward-facing actions (a new repo under the org; a non-colliding formula name + bin decision; a PR to the mise registry). Left for owner authorization rather than done speculatively. The devcontainer feature stays deferred behind a project-scope adapter.Note
Pure docs — no code, no test changes.