docs: document SSH prerequisite and MCP fallback for /plugin marketplace add - #5
Open
Makabeez wants to merge 1 commit into
Open
docs: document SSH prerequisite and MCP fallback for /plugin marketplace add#5Makabeez wants to merge 1 commit into
Makabeez wants to merge 1 commit into
Conversation
…ace add The marketplace add command clones via SSH; users without GitHub SSH keys configured see "Permission denied (publickey)" with no explanation. This blocks the entire documented setup path — /keeperhub:login and /keeperhub:status never become available. Adds a callout above the setup steps with: - explanation of why SSH is required - link to GitHub's SSH key setup guide - direct MCP alternative (claude mcp add --transport http) that works without SSH keys at all Found during a fresh Linux/WSL2 onboarding run (2026-08-06).
Author
|
CLI onboarding friction companion PR: KeeperHub/cli#88 |
This was referenced Aug 6, 2026
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.
Problem
/plugin marketplace add KeeperHub/claude-pluginsclones this repo over SSH. Users without a GitHub SSH key configured see:This silently blocks the entire documented setup path —
/keeperhub:loginand/keeperhub:statusnever become available, and there's no hint about why or what to do next.Fix
Added a callout block before the setup steps with:
claude mcp add --transport http) that bypasses the plugin system entirely and works with no SSH keysThe MCP path is worth documenting here regardless, since it's simpler and works on any machine.
Related
Companion PR for other onboarding friction points in the CLI repo: KeeperHub/cli#88
Found during a fresh Linux/WSL2 onboarding run (2026-08-06) — no GitHub SSH keys, no Homebrew, headless environment.