Docs

Install & setup

Everything below is typed inside Claude Code, in the project where you install the plugin - the framed blocks are your Claude Code prompt, not a plain terminal.

1. Install the plugin

In Claude Code, add the marketplace and install the plugin:

Claude Code
> /plugin marketplace add trysocialcue/socialcue > /plugin install socialcue@socialcue > /reload-plugins

2. Set up your brands

Run the guided onboarding - it drafts a brand profile from your website, picks platforms (Reddit-first), and checks the browser connection.

Claude Code
> /socialcue-setup

3. Discover opportunities

Kick off a discovery run. It drives your own dedicated, logged-in Chrome profile, scores conversations, and writes ranked opportunities with drafted replies to your local store.

Claude Code
> /socialdiscovery

Open the local dashboard any time to review the queue (discovery runs also open it automatically):

Claude Code
> node "$CLAUDE_PLUGIN_ROOT/lib/cli.js" bridge open # serves the dashboard on 127.0.0.1

4. Activate Pro

After you go Pro, we show your account token once at checkout and email it to you. Paste this into Claude Code once - the plugin then fetches a fresh, offline-verified license key roughly monthly, for as long as your subscription is active:

Claude Code
> /socialcue:activate-pro scacct_your_token_here

Prefer the dashboard? Paste just the token into its License panel instead. Either way, assisted posting and product posts switch on.

5. Post your product somewhere (Pro)

Product posts get a subject - one of your brands, an article or video from your Content Library, or any ad-hoc project (a GitHub URL is enough) - onto a destination: a directory listing, a launch site, a subreddit, Indie Hackers, Show HN, Dev.to, a forum, or any URL with a submit form. Say it in plain English:

Claude Code
> /socialcue:socialcue-post PlugMyPlugin on Product Hunt
Claude Code
> /socialcue:socialcue-post the watermark article to Indie Hackers

Claude loads the shared venue playbook for that site (post types, signup method, rules), creates an account as you if needed - OAuth where offered, otherwise email plus a verification code read from your own webmail in a second tab - digs up the logo, screenshots and description the form wants, and fills it in your Social Cue Chrome window. Then it submits, and logs exactly what went out. Prefer to click submit yourself? Flip dry-run in Settings. Communities whose rules ban self-promotion are still marked skipped. Every attempt and its resulting URL is tracked in the dashboard's Product Posts panel.

6. Automate feed posting (optional, free)

Scheduling and video cross-posting go out through your own Postiz account (cloud or self-hosted). Paste the API key into the Content Library tab once. Don't have Postiz? Get it at postiz.com.

Posting responsibly

Social Cue finds the right conversations; what you say in them is yours. Drafts are scaffolds - edit them into your own words before posting, especially on Hacker News, whose guidelines prohibit AI-generated comments. On Reddit, follow each community's self-promotion norms (the usual rule of thumb: at most 1 in 10 of your posts mentions your product). The scoring brain is tuned to steer you this way; one genuinely useful reply beats five mediocre ones everywhere.

How activation stays private

The token is the only thing your machine sends us, and only to ask for a new key. Keys are Ed25519-signed and verified entirely offline by the plugin - no page content, brands, or opportunities are ever sent to us. If your subscription lapses, the plugin just stops fetching new keys and returns to free discovery.

Lost your token?

Head to your account page, enter your email, and we'll send a fresh one.