Troubleshooting

Common issues when installing or using the Splashify Pro plugin in Claude Code, and how to fix them. Start with splashify doctor — it checks most of these automatically.

Issues with the splashify CLI itself (connecting, tokens, sending messages) are covered in splashify CLI → Troubleshooting. This page covers the Claude Code plugin layer.

`splashify doctor` checklist

splashify doctor

Check	If it fails
config	Run `splashify connect` to save your backend URL and token.
access token	The token is invalid, revoked, or expired — create a new one in Settings → Developer → Access Tokens.
waba	Finish the Meta Embedded Signup at app.splashifypro.com → WhatsApp → Connect Number. WhatsApp sends will fail until this is connected; other features (email, contacts, analytics, billing) still work.

The doctor's openclaw and splashify skill checks are about the OpenClaw integration — they do not apply to Claude Code and can be ignored if you only use the plugin.

Common problems

`splashify: command not found`

The CLI is not on your PATH. Re-run the installer:

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/splashifypro/cli/main/install.sh | bash

# Windows (PowerShell)
iwr -useb https://raw.githubusercontent.com/splashifypro/cli/main/install.ps1 | iex

The installer prints the install directory at the end. Add that directory to your PATH, open a new shell, and run splashify --version to confirm.

`/plugin install` says "marketplace not found"

Add the marketplace first:

/plugin marketplace add splashifypro/claude-plugin

Then install:

/plugin install splashifypro@splashifypro

Both forms also work from the shell:

claude plugin marketplace add splashifypro/claude-plugin
claude plugin install splashifypro@splashifypro

Claude says it doesn't have a Splashify skill

Confirm the plugin is installed:
bash
```
claude plugin list
```
You should see splashifypro. If it is listed but greyed out, run:
bash
```
claude plugin enable splashifypro
```
Restart Claude Code after installing — skills are loaded at session start. Close the terminal / IDE and re-open it.
Ask Claude explicitly: "Using the Splashify Pro plugin, list my contacts." Skills auto-load by description match; naming the plugin forces it.

Claude asks Claude to run a command but the CLI fails

The plugin runs the splashify CLI under the hood, so a failing action is usually a CLI problem:

Run the same command yourself, e.g. splashify contacts, to see the real error.
Run splashify doctor.
See splashify CLI → Troubleshooting for token, send, and rate-limit errors.

Claude won't confirm before sending — it just sends

That is a bug. The plugin's skills require a confirmation prompt before any state-mutating action. Possible causes:

An older plugin version is installed. Update:
bash
```
claude plugin update splashifypro
```
Restart Claude Code.
A different skill is running, perhaps from a competing plugin. Run claude plugin list and check for similarly-named plugins.
Real bug — please open an issue at github.com/splashifypro/claude-plugin/issues with the exact prompt you used.

Claude refuses to do something I clearly authorised

The plugin's skills are conservative by design — they require a destination phone or email in your own current-session message before sending. If you asked "send the message to John" without specifying which John, Claude will ask first. That is intentional.

If Claude refuses an admin-shaped request (e.g. "list all clients on the platform"), that is also by design — oc_live_ tokens are scoped to your own account; admin endpoints are unreachable. Use the reseller panel or the partner API instead.

Wrong skill keeps loading

Claude Code picks a skill based on its description: frontmatter matching your prompt. If the wrong one fires, name it explicitly:

"Using the splashify-broadcasts skill, show me my recent campaigns."

The seven skill names are: splashify-setup, splashify-messaging, splashify-broadcasts, splashify-automation, splashify-analytics, splashify-email, splashify-account-admin.

Plugin install was approved but skills don't appear

Restart Claude Code. New skills are loaded once per session at start.

How do I see exactly what the plugin tells Claude?

The plugin is open source — every instruction Claude reads is a markdown file at github.com/splashifypro/claude-plugin/tree/main/skills. You can also inspect the local install:

macOS / Linux: ~/.claude/plugins/splashifypro/
Windows: %USERPROFILE%\.claude\plugins\splashifypro\

Still stuck?

Re-run splashify doctor and read each line.
Reproduce the failing action directly with the splashify CLI to isolate whether the problem is the plugin or the CLI.
Contact Splashify Pro support with the output of splashify doctor and claude plugin list.