docs: split install steps into numbered marketplace + plugin commands

Claude Code's `/plugin marketplace add` parses on whitespace, so pasting
the two slash-commands as a single multi-line block makes the parser
swallow the newline and the second command into the marketplace path
(URL fails with "Malformed input to a URL function"). Numbering the
steps and putting each command in its own code block makes the copy
intent unambiguous.

Codex split mirrors the same pattern: shell command for marketplace
registration, then the `/plugins` picker inside the session.

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

Author: Aditya Thiruvengadam

README.md

@@ -37,22 +37,38 @@ Apps -> Search -> Klarity -> Connect
 
 ## Install — Claude Code
 
-From a Claude Code session:
+From a Claude session, run these two commands one after the other.
+
+**1. First**, install the marketplace:
 
 ```text
 /plugin marketplace add klarity-ai/klarity-mcp
+```
+
+**2. Next**, install the plugin:
+
+```text
 /plugin install klarity@klarity
 ```
 
 ## Install — Codex
 
-From a Codex session:
+Codex splits this into two steps. First, from your **shell**, register the
+Klarity marketplace with Codex:
+
+```bash
+codex plugin marketplace add Klarity-AI/klarity-mcp
+```
+
+Then, from a **Codex session**, open the plugin picker:
 
 ```text
-/plugin marketplace add klarity-ai/klarity-mcp
-/plugin install klarity@klarity
+/plugins
 ```
 
+In the picker, switch to the **Klarity** marketplace, open **klarity**, and
+select **Install plugin**.
+
 ## Install — Gemini CLI
 
 ```bash

docs/install/claude-code.mdx

@@ -15,10 +15,17 @@ Two install paths are supported. The plugin path is preferred — it ships the b
 
 ## Plugin install (preferred, OAuth)
 
-From a Claude Code session:
+From a Claude session, run these two commands one after the other.
+
+**1. First**, install the marketplace:
 
 ```text
 /plugin marketplace add klarity-ai/klarity-mcp
+```
+
+**2. Next**, install the plugin:
+
+```text
 /plugin install klarity@klarity
 ```
 

docs/install/codex.mdx

@@ -15,14 +15,21 @@ Two install paths are supported. The plugin path is preferred — it ships the b
 
 ## Plugin install (preferred, OAuth)
 
-From a Codex session:
+Codex splits this into two steps — a shell command to register the marketplace, then a slash command inside Codex to install the plugin.
+
+**1. From your shell**, add the Klarity marketplace to Codex:
+
+```bash
+codex plugin marketplace add Klarity-AI/klarity-mcp
+```
+
+**2. From a Codex session**, open the plugin picker:
 
 ```text
-/plugin marketplace add klarity-ai/klarity-mcp
-/plugin install klarity@klarity
+/plugins
 ```
 
-The first request that hits a Klarity tool will prompt you to sign in.
+In the picker, switch to the **Klarity** marketplace, open **klarity**, and select **Install plugin**. The first request that hits a Klarity tool will prompt you to sign in.
 
 ## Config file install (API key)