From 624167d6bdf80058359d566f2af50e98489df4ea Mon Sep 17 00:00:00 2001 From: turner Date: Mon, 9 Nov 2026 11:03:42 -0500 Subject: [PATCH] Onboarding: use the tested 4-step Claude card MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Replace the eight-step Claude setup with the card from docs/onboarding-flow, the only sequence confirmed to work in Claude. - README.md and INSTALL-PROMPT.md carry the card verbatim (drift check passes), plus a Sync automatically note, "start a new chat", and the issues link with a screenshot. - INSTALL-PROMPT.md's last check now says Connect → Continue → Add. - docs/install.html mirrors the card in Claude's third person. - "eight short steps" → "four" in install.html and the plugin README. - GLOSSARY: Connect step is the clicks on the Connectors tab. Co-Authored-By: Claude Opus 5.5 --- GLOSSARY.md | 2 +- INSTALL-PROMPT.md | 40 +++++++++++----------------------------- README.md | 38 ++++++++++---------------------------- docs/install.html | 33 +++++++++++++++------------------ plugins/geenee/README.md | 2 +- 5 files changed, 38 insertions(+), 77 deletions(-) diff --git a/GLOSSARY.md b/GLOSSARY.md index 2a47bc4..b3ed75c 100644 --- a/GLOSSARY.md +++ b/GLOSSARY.md @@ -25,4 +25,4 @@ A Connector added by pasting the server address by hand. Not offered to users; i _Avoid_: Option B, manual install, URL install **Connect step**: -The click in Claude that switches on a Plugin's Connector after the Plugin is added. Claude never does it automatically. +The clicks on a Plugin's Connectors tab in Claude that switch on its Connector after the Plugin is added. Claude never does it automatically. diff --git a/INSTALL-PROMPT.md b/INSTALL-PROMPT.md index ab87fda..1292573 100644 --- a/INSTALL-PROMPT.md +++ b/INSTALL-PROMPT.md @@ -34,42 +34,24 @@ Plugins and marketplaces are added to the user's **account**, once, and then fol 3. **Send the steps below word for word.** Your whole message is: one sentence (what Geenee is, and that these steps add it in their Claude settings), then the block between the markers, exactly as written, as Markdown, without the marker comments. Do not shorten, reword, reorder, summarize or merge the steps. Do not add options, alternatives or fallbacks. Do not add a checklist after it. Then wait for the user to say they are done. -You need a paid Claude plan (Pro, Max, Team or Enterprise). There are two parts, adding Geenee and then connecting it. Do both. +Follow these steps to install Geenee. -1. Click **Customize** in the left sidebar → **Plugins** +1. Go to **Customize → Plugins → +Add → Add marketplace → Add from a repository**. Enter this URL: `aidenlab/plugins` +2. Click **Sync** +3. You will be on the **Discover** tab. Click **Add** (Not **+Add**). +4. Select the **Connectors** tab. **Connect → Continue → Add** - *In a web browser you can instead go straight to [claude.ai/customize/plugins](https://claude.ai/customize/plugins). In Cowork, click the **Cowork** tab first.* +**Things to know:** +- You need a paid plan. +- If you see **Sync automatically** next to **aidenlab**, turn it on. That's how Geenee's updates reach you. +- If you still have the old `juicebot` plugin, or a connection to `juicebot-mcp.3dg.io` or `geenee-dev.3dg.io`, remove it. Otherwise you'll get duplicate tools. - ✓ You see a page called **Plugins** with a **Discover** tab. - -2. Click **Add** → **Add marketplace** → **Add from a repository** - - *Already see **aidenlab** in your list of marketplaces? Skip to step 5. No **Add marketplace**? Your organization has turned it off: ask your Claude admin to allow user-added marketplaces, then come back to this step.* - -3. Type `aidenlab/plugins` → click the button that adds it - - ✓ **aidenlab** now appears in your list of marketplaces. - -4. If you see **Sync automatically** next to **aidenlab**, turn it on. This is how Geenee's updates reach you. - -5. Click the **Discover** tab → find **Geenee** → click **Add** - -6. Click **Geenee** → the **Connectors** tab - - ✓ It says **Not added**. That's expected. - -7. Click **Add** if you see it → then click **Connect**. No login is needed. - - ✓ It now says **Connected**. *Skip this step and Geenee looks installed but does nothing.* - -8. Start a new chat → click **+** in the message box → **Connectors** → make sure **Geenee** is switched on. - -Stuck at any step? Open an issue at [github.com/aidenlab/plugins/issues](https://github.com/aidenlab/plugins/issues) and attach a screenshot of what you see. +**To check it worked:** start a new chat and ask me to open Geenee. I'll call `open_geenee` and give you a link to a page with IGV, Juicebox and Spacewalk tabs. Keep that browser tab open while you use it. If a step fails, report it at [github.com/aidenlab/plugins/issues](https://github.com/aidenlab/plugins/issues) with a screenshot. 4. **Confirm the Connect click.** When the user replies, if you have a tool that lists the plugins on their account, call it filtered to `geenee`. Then, unless the user has already said Geenee shows as **Connected**, ask once, as one short message: - > Last check: click **Customize** → **Plugins** → **Geenee** → the **Connectors** tab. Does it say **Connected**? If it says **Not added** or **Not connected**, click **Add** if you see it, then **Connect**. + > Last check: click **Customize** → **Plugins** → **Geenee** → the **Connectors** tab. Does it say **Connected**? If not, click **Connect → Continue → Add** there. If it still does not connect, send them to https://github.com/aidenlab/plugins/issues with a screenshot. On a Team or Enterprise plan, add one sentence: an Owner may need to add Geenee's connector for the organization first. 5. Only once the user has confirmed Connect: the tools appear in a new conversation. End as described under "How to end your reply", and in its first line say that both parts are done (plugin added, server connected). diff --git a/README.md b/README.md index 7487a01..f7b463a 100644 --- a/README.md +++ b/README.md @@ -19,37 +19,19 @@ In the ChatGPT desktop app, open **Codex** first, then paste the line there. Pla ### Claude (desktop app, claude.ai, Cowork): click through once -You need a paid Claude plan (Pro, Max, Team or Enterprise). There are two parts, adding Geenee and then connecting it. Do both. +Follow these steps to install Geenee. -1. Click **Customize** in the left sidebar → **Plugins** +1. Go to **Customize → Plugins → +Add → Add marketplace → Add from a repository**. Enter this URL: `aidenlab/plugins` +2. Click **Sync** +3. You will be on the **Discover** tab. Click **Add** (Not **+Add**). +4. Select the **Connectors** tab. **Connect → Continue → Add** - *In a web browser you can instead go straight to [claude.ai/customize/plugins](https://claude.ai/customize/plugins). In Cowork, click the **Cowork** tab first.* +**Things to know:** +- You need a paid plan. +- If you see **Sync automatically** next to **aidenlab**, turn it on. That's how Geenee's updates reach you. +- If you still have the old `juicebot` plugin, or a connection to `juicebot-mcp.3dg.io` or `geenee-dev.3dg.io`, remove it. Otherwise you'll get duplicate tools. - ✓ You see a page called **Plugins** with a **Discover** tab. - -2. Click **Add** → **Add marketplace** → **Add from a repository** - - *Already see **aidenlab** in your list of marketplaces? Skip to step 5. No **Add marketplace**? Your organization has turned it off: ask your Claude admin to allow user-added marketplaces, then come back to this step.* - -3. Type `aidenlab/plugins` → click the button that adds it - - ✓ **aidenlab** now appears in your list of marketplaces. - -4. If you see **Sync automatically** next to **aidenlab**, turn it on. This is how Geenee's updates reach you. - -5. Click the **Discover** tab → find **Geenee** → click **Add** - -6. Click **Geenee** → the **Connectors** tab - - ✓ It says **Not added**. That's expected. - -7. Click **Add** if you see it → then click **Connect**. No login is needed. - - ✓ It now says **Connected**. *Skip this step and Geenee looks installed but does nothing.* - -8. Start a new chat → click **+** in the message box → **Connectors** → make sure **Geenee** is switched on. - -Stuck at any step? Open an issue at [github.com/aidenlab/plugins/issues](https://github.com/aidenlab/plugins/issues) and attach a screenshot of what you see. +**To check it worked:** start a new chat and ask me to open Geenee. I'll call `open_geenee` and give you a link to a page with IGV, Juicebox and Spacewalk tabs. Keep that browser tab open while you use it. If a step fails, report it at [github.com/aidenlab/plugins/issues](https://github.com/aidenlab/plugins/issues) with a screenshot. This covers every Claude app on your account, Claude Code included. You can also paste the one-line prompt above into a Claude chat: it walks you through these same steps. diff --git a/docs/install.html b/docs/install.html index 140d194..34bd518 100644 --- a/docs/install.html +++ b/docs/install.html @@ -243,7 +243,7 @@

App by app

- + @@ -255,26 +255,23 @@

claude.ai, the Claude desktop app and Cowork

-

You need a paid Claude plan (Pro, Max, Team or Enterprise). There are two parts, adding Geenee and then connecting it. Do both.

+

Follow these steps to install Geenee.

    -
  1. Click Customize in the left sidebar → Plugins
    - In a web browser you can instead go straight to claude.ai/customize/plugins. In Cowork, click the Cowork tab first.
    - ✓ You see a page called Plugins with a Discover tab.
  2. -
  3. Click Add → Add marketplace → Add from a repository
    - Already see aidenlab in your list of marketplaces? Skip to step 5. No Add marketplace? Your organization has turned it off: ask your Claude admin to allow user-added marketplaces, then come back to this step.
  4. -
  5. Type aidenlab/plugins → click the button that adds it
    - ✓ aidenlab now appears in your list of marketplaces.
  6. -
  7. If you see Sync automatically next to aidenlab, turn it on. This is how Geenee’s updates reach you.
  8. -
  9. Click the Discover tab → find Geenee → click Add
  10. -
  11. Click Geenee → the Connectors tab
    - ✓ It says Not added. That’s expected.
  12. -
  13. Click Add if you see it → then click Connect. No login is needed.
    - ✓ It now says Connected. Skip this step and Geenee looks installed but does nothing.
  14. -
  15. Start a new chat → click + in the message box → Connectors → make sure Geenee is switched on.
  16. +
  17. Go to Customize → Plugins → +Add → Add marketplace → Add from a repository. Enter this URL: aidenlab/plugins
  18. +
  19. Click Sync
  20. +
  21. You will be on the Discover tab. Click Add (Not +Add).
  22. +
  23. Select the Connectors tab. Connect → Continue → Add
-

Stuck at any step? Open an issue at github.com/aidenlab/plugins/issues and attach a screenshot of what you see.

+

Things to know:

+ + +

To check it worked: start a new chat and ask Claude to open Geenee. It calls open_geenee and gives you a link to a page with IGV, Juicebox and Spacewalk tabs. Keep that browser tab open while you use it. If a step fails, report it at github.com/aidenlab/plugins/issues with a screenshot.

Claude Code

@@ -301,7 +298,7 @@

Before and after

AppWhat to doToolsSkillHow often
claude.ai, desktop, CoworkAdd the marketplace, add Geenee, then connect it on its Connectors tab: eight short steps in settingsOnce per Claude account
claude.ai, desktop, CoworkAdd the marketplace, add Geenee, then connect it on its Connectors tab: four short steps in settingsOnce per Claude account
Claude CodeNothing, if the account has it. Otherwise one commandOnce per account, or per machine
CodexTwo commandsOnce per machine
ChatGPT desktopOpen Codex, paste the one sentence, click ApproveOnce per machine
- + diff --git a/plugins/geenee/README.md b/plugins/geenee/README.md index 093251d..3f5a8bc 100644 --- a/plugins/geenee/README.md +++ b/plugins/geenee/README.md @@ -12,7 +12,7 @@ In Claude Code or Codex, paste this and the assistant installs everything: Set up Geenee for me: fetch https://geenee-install.3dg.io and follow its instructions for the app you are running in. ``` -In claude.ai, the Claude desktop app and Cowork no prompt can install it: a chat cannot change account settings. Those take eight short steps, listed in the [marketplace README](../../README.md). In ChatGPT, use Codex in the ChatGPT desktop app and paste the one-line prompt there. Geenee is installed only from the marketplace, never by adding the server address by hand. Quickest by hand: Claude Code `/plugin install geenee --marketplace aidenlab/plugins` then `/reload-plugins`; Codex `codex plugin marketplace add aidenlab/plugins` then `codex plugin add geenee@aidenlab`. +In claude.ai, the Claude desktop app and Cowork no prompt can install it: a chat cannot change account settings. Those take four short steps, listed in the [marketplace README](../../README.md). In ChatGPT, use Codex in the ChatGPT desktop app and paste the one-line prompt there. Geenee is installed only from the marketplace, never by adding the server address by hand. Quickest by hand: Claude Code `/plugin install geenee --marketplace aidenlab/plugins` then `/reload-plugins`; Codex `codex plugin marketplace add aidenlab/plugins` then `codex plugin add geenee@aidenlab`. ## Try it
Sending a server addressSending people to the plugin
What people receiveA URL, and directions to a settings pageOne sentence to paste (Claude Code, Codex, ChatGPT’s Codex), or eight short steps (Claude apps)
What people receiveA URL, and directions to a settings pageOne sentence to paste (Claude Code, Codex, ChatGPT’s Codex), or four short steps (Claude apps)
What they getThe toolsThe tools, and a skill that teaches the assistant to use them well
ClaudeA custom connector, set up per accountA plugin on the account, reaching every Claude app
A new server addressEveryone edits their settings by handBump the version; everyone gets it with the next update