Document plugin visibility troubleshooting

Author: MehediHossain95

README.md

@@ -26,6 +26,31 @@ npx codex-marketplace add ZainTechnologiesLTD/codex-remote-ssh --plugins --globa
 
 See [plugins/remote-ssh/README.md](./plugins/remote-ssh/README.md) for setup, security, and development details.
 
+## Troubleshooting Visibility
+
+After global install, restart Codex. If Remote SSH still does not appear in the plugin UI, confirm that `~/.codex/config.toml` includes both the plugin entry and the marketplace source:
+
+```toml
+[plugins."remote-ssh@codex-marketplace-global"]
+enabled = true
+
+[marketplaces.codex-marketplace-global]
+source_type = "local"
+source = '\\?\C:\Users\<you>'
+```
+
+The global marketplace manifest should exist at:
+
+```text
+~/.agents/plugins/marketplace.json
+```
+
+The installed plugin should exist at:
+
+```text
+~/.codex/plugins/remote-ssh
+```
+
 ## Repository Documents
 
 - [License](./LICENSE)

plugins/remote-ssh/PUBLISHING.md

@@ -47,6 +47,26 @@ npx codex-marketplace add ZainTechnologiesLTD/codex-remote-ssh --plugins --globa
 
 Use `--project` instead of `--global` when documenting a single-workspace install.
 
+## Visibility Troubleshooting
+
+If a global install succeeds but the plugin does not appear in Codex after restart, confirm `~/.codex/config.toml` has:
+
+```toml
+[plugins."remote-ssh@codex-marketplace-global"]
+enabled = true
+
+[marketplaces.codex-marketplace-global]
+source_type = "local"
+source = '\\?\C:\Users\<you>'
+```
+
+Then confirm:
+
+```text
+~/.agents/plugins/marketplace.json
+~/.codex/plugins/remote-ssh
+```
+
 ## GitHub Packages
 
 The package name is:

plugins/remote-ssh/README.md

@@ -49,6 +49,26 @@ npx codex-marketplace add ZainTechnologiesLTD/codex-remote-ssh --plugins --globa
 
 Global installation is recommended so Remote SSH appears across Codex projects after restart. For local development or one-project installs, use `--project` instead of `--global`.
 
+## Troubleshooting Visibility
+
+After installing globally, restart Codex. If Remote SSH is enabled but still not visible, confirm that `~/.codex/config.toml` includes both entries:
+
+```toml
+[plugins."remote-ssh@codex-marketplace-global"]
+enabled = true
+
+[marketplaces.codex-marketplace-global]
+source_type = "local"
+source = '\\?\C:\Users\<you>'
+```
+
+Also confirm the global marketplace and plugin paths exist:
+
+```text
+~/.agents/plugins/marketplace.json
+~/.codex/plugins/remote-ssh
+```
+
 ## Configuration
 
 Most users should add connections conversationally: