viralman

viralman

You ship code. We ship reach.
Build it — viralman handles the hype.

English · 한국어 · 中文 · 日本語

---

viralman takes your project description and drafts Twitter/X posts, Reddit threads, and cold emails to developers who starred similar repos on GitHub — then waits for you to say go. Works for anything you built: OSS, side project, indie tool.

viralman                 # opens http://localhost:8765

Features

• Multi-platform drafts — /viral turns one intent into Reddit / X / LinkedIn drafts that don't sound like a chatbot.
• Local dashboard — black 4-step wizard. Project → Generate → Targets → Send. One unified login at the top.
• gitmail outreach — find GitHub repos like yours, walk their stargazers, send each a short personalized note. Up to 1,500 recipients per run (uses GraphQL bulk profile lookup + REST PushEvent fallback to fit GitHub's two separate 5,000/hr buckets); one-click unsubscribe link baked in.
• Twitter reply candidates — /twitter-reply searches recent X posts where it's natural to say "I built this — want to take a look?", pushes them to the dashboard /twitter-reply page as cards (body, author, link, engagement) so you can browse before deciding. Reply step is opt-in and gated on per-tweet confirmation.
• AI-tell sniffer — ~30 heuristics scan every draft for clichés, em-dash floods, balanced tricolons, and missing anchors. Three rewrite passes; refuses to auto-post a still-flagged draft.
• OAuth or manual — sign in to X / Reddit / LinkedIn from the dashboard, or paste tokens. Secrets pipe through read -s and never enter the LLM context.
• Multi-LLM — Claude, OpenAI, or Gemini, your choice (auto-detected from saved keys).

Use cases

• Launching v1.0 — describe what shipped; get a Reddit post for r/programming, an X thread, a LinkedIn announcement, and an outreach list of devs who starred related tools.
• Side project announcement — one-shot multi-channel post without writing three different versions.
• Finding the right place to post — let viralman scrape and suggest subreddits, hashtags, and recent threads to comment on, instead of guessing.
• Re-engaging old stargazers of similar tools — gitmail builds a recipient list from public profile and commit emails, with a personalized opener mentioning the repo they starred.
• Avoiding the AI-slop tax — most "AI social posters" produce content that gets called out instantly. The sniffer is the headline feature.

Install

Three paths. Path 1 is the easy default; Path 2 if you don't use Claude Code; Path 3 for CI / scripting.

You can follow the manual setup below, but installing the Claude Code plugin (Path 1) and asking the agent to walk you through setup is the recommended path.

Path 1 — Claude Code plugin (recommended)

Marketplace/plugin install (recommended for most Claude Code users). These are Claude Code slash commands — enter them one at a time (pasting both lines at once will fail):

/plugin marketplace add https://github.com/art8engine/viralman

Then:

/plugin install viralman

From a local clone of the repo, swap the URL for ./:

/plugin marketplace add ./

Once installed, just talk to the agent — "open the dashboard", "set up viralman", "email people who starred async-profiler" — and it dispatches the right slash command (/dashboard, /viralman-setup, /gitmail, /viral). Before any send, it asks (1) language (2) subject style (3) final OK.

Path 2 — pipx install (no Claude Code needed)

If you prefer the local dashboard + bare CLI without Claude Code:

pipx install git+https://github.com/art8engine/viralman
viralman   # → http://localhost:8765

pipx installs into an isolated venv and exposes viralman on your $PATH. Plain pip install git+... also works inside an existing venv. The 4-tab dashboard (Twitter / Reddit / Gitmail / Setup) covers everything; slash commands require Claude Code.

Path 3 — Clone + run (CI / headless / automation)

For explicit CLI args from a script or CI pipeline:

git clone https://github.com/art8engine/viralman && cd viralman
pip install .
./scripts/gitmail.py run --description "..." --max-users 100 --dry-run

See Usage below for the full gitmail / viral flag list.

Examples

Block A — Natural language inside Claude Code (Path 1)

Just say it in plain English — the agent picks the right slash command:

"set up viralman for me"
"email people who starred async-profiler about our JVM monitoring tool"
"write a post for r/programming, make it not feel AI"
"open the dashboard"
"set up viralman"