Skip to content

docs(readme): align with launch-plan skeleton#124

Merged
naorsabag merged 6 commits into
masterfrom
docs/readme-launch-skeleton-fixes
May 11, 2026
Merged

docs(readme): align with launch-plan skeleton#124
naorsabag merged 6 commits into
masterfrom
docs/readme-launch-skeleton-fixes

Conversation

@naorsabag
Copy link
Copy Markdown
Owner

@naorsabag naorsabag commented May 11, 2026

Addresses the four gaps you flagged against `openhop-launch/03-readme-and-landing.md`.

# Gap Fix
5 No `/docs` link in header (also "Link to Discord and /docs from the header") Added Docs + Discord entries to the header nav. Docs → Pages playground (live, working docs surface today). Discord → `https://discord.gg/openhop\` per skeleton — replace if a different invite URL is canonical.
6 Local-first / privacy sub-line not in hero (currently buried in Features #6) Added a dedicated bold sub-line directly under the tagline: "Local-first. Your code never leaves your machine. No telemetry." Kept the Features bullet too — they reinforce, not duplicate.
7 Missing `/plugin install naorsabag/openhop` block with `[Y/n]`, `--yes`, `--skip-cli` Added as Path C — Claude Code native plugin install alongside the existing Path A (`npx openhop init`) and Path B (OpenSkills). Flags documented inline.
8 No architecture-note callout as a standalone block Added a GFM `> [!IMPORTANT]` callout at the bottom of Install Options restating the local-first promise. Inlined "URL-fragment sharing" mention since the hosted playground at https://naorsabag.github.io/openhop/ now ships — the skeleton noted it as post-launch, but we're there.

🤖 Generated with Claude Code

Summary by CodeRabbit

  • Documentation
    • Added Discord link to navigation.
    • Expanded installation documentation with new instructions for Claude Code native plugin installation.
    • Added architecture clarification about the local-first approach and how data sharing works.

Review Change Stack

Addresses four gaps from `openhop-launch/03-readme-and-landing.md`:

1. **Local-first sub-line in the hero.** Was buried in Features
   bullet #6 ("Local-first, no telemetry"). The skeleton calls it
   out as a dedicated conversion-driver sub-line:
   "Local-first. Your code never leaves your machine. No telemetry."

2. **`/docs` + Discord links in the header nav.** Skeleton line 188:
   "Docs signal 'this is serious.'" Docs link goes to the Pages
   playground (the live, working docs surface today); Discord
   placeholder points at the canonical openhop invite from the
   skeleton.

3. **Claude Code native plugin install path (`/plugin install
   naorsabag/openhop`).** Added as Path C alongside `npx openhop init`
   and OpenSkills, with the `[Y/n]`, `--yes`, and `--skip-cli` flags
   documented per skeleton.

4. **Architecture note as a standalone block.** Inline GFM
   `> [\!IMPORTANT]` callout at the bottom of Install Options,
   restating the local-first promise in the specific shape the
   skeleton recommends.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented May 11, 2026

Warning

Rate limit exceeded

@naorsabag has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 11 minutes and 55 seconds before requesting another review.

You’ve run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: 26229cc8-14ca-4de3-b871-d73e84198451

📥 Commits

Reviewing files that changed from the base of the PR and between 5d8aef0 and 69379ce.

📒 Files selected for processing (6)
  • README.md
  • docs/README.md
  • docs/architecture.md
  • docs/cli.md
  • docs/install.md
  • docs/yaml.md

Walkthrough

README.md was enhanced with navigation updates, a local-first branding callout beneath the logo, a new Claude Code plugin installation path, and clarifying architecture documentation. The changes add community links and expand installation and sharing guidance without altering code functionality.

Changes

Documentation Updates

Layer / File(s) Summary
Header and Navigation
README.md
Added local-first emphasis callout under the logo and updated top navigation with Examples, Docs, and Discord links.
Claude Code Plugin Installation
README.md
Added "Path C" installation section for Claude Code native plugin with plugin browser instructions and --yes and --skip-cli CLI flags.
Architecture Documentation
README.md
Added architecture note clarifying that OpenHop v0.1 is local-first with no hosted backend, and sharing works via YAML or URL-fragment hash.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Possibly related PRs

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title 'docs(readme): align with launch-plan skeleton' clearly and accurately reflects the main change—updating README documentation to align with launch-plan requirements.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/readme-launch-skeleton-fixes

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

naorsabag and others added 5 commits May 11, 2026 07:48
Two refinements on top of the launch-skeleton alignment:

- Stripped the `[Y/n]` / `--yes` / `--skip-cli` text from the
  Claude Code plugin install block. Those flag names were carried
  forward from the launch-plan skeleton but aren't actually
  Claude Code `/plugin` CLI flags — keeping them in invented
  contract.

- Created docs/ as an in-repo doc surface so the "Docs" header
  link points somewhere real. Initial pages:
    docs/README.md       — index
    docs/install.md      — every install path, per-client
    docs/yaml.md         — full schema reference (sourced from
                            zod + SKILL.md)
    docs/cli.md          — every CLI command + flag (sourced
                            from packages/cli/src/index.ts)
    docs/architecture.md — what runs where + the local-first
                            guarantees

Also: clarified that `/plugin install naorsabag/openhop` is
Claude Code-specific. Cursor / Windsurf / Cline have their own
extension surfaces and reach OpenHop via Path A (`npx openhop init`)
or Path B (OpenSkills).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
…ystem

Earlier wording implied Cursor "uses native skills" *instead of* having
plugins. That undersells Cursor — it has a full plugin marketplace
(Settings → Marketplace, team marketplaces, cursor.directory, MCP
deeplinks). What it doesn't have is an ad-hoc `/plugin install
<github-repo>` slash command equivalent to Claude Code's.

Reword Path C in both README.md and docs/install.md to say:
  - the *syntax* `/plugin install naorsabag/openhop` is CC-specific
  - Cursor / Windsurf / Cline reach OpenHop via Path A (native skills
    surface), and Cursor users can also discover it via their
    marketplace once we list it

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
… paragraph

Per feedback, Path C is just a command + "…or from your agent GUI" —
no per-client breakdown of plugin surfaces in this section.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@naorsabag naorsabag merged commit 77a0333 into master May 11, 2026
8 checks passed
@naorsabag naorsabag deleted the docs/readme-launch-skeleton-fixes branch May 15, 2026 16:00
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant