Skip to content

elvisun/newsjack

Repository files navigation

Newsjack.sh

The open-source skills that turn your agent into a full PR team.

Install once. Your agent — Claude Code, Codex, Hermes, OpenClaw — becomes a PR team.

curl -fsSL newsjack.sh | bash

Are you an agent? Check out Getting started

Are you a human? 📋 Copy this prompt to any AI:

help me setup https://newsjack.sh

Jump to platform-specific setup below for per platform breakdown.


What your agent can do once newsjack is installed

Three problems, separate lanes.

🛰️ Detect — surface what matters in your space

  • 📡 Monitor your industry — find newsjacking opportunities: fresh stories you have the standing to jump on before the wave breaks (see a sample run)
  • 🗞️ Track your coverage — Google Alerts-style keyword tracking with LLM filtering for real features
  • 🔭 Track competitors — when they launch, raise, or stumble, you know
  • 🔍 Verify the story is still fresh — who broke it, who owns it, what oxygen's left

🚀 Act — turn signal into output

  • 🎯 Generate story angles — turn one update into hooks framed for different beats
  • 🤝 Fit-check a journalist — will this reporter actually care, or are you spamming?
  • 🎙️ Respond to source queries — triage inbound HARO-style requests, draft only the real fits
  • 🥊 Roast your pitch — honest critique against the rubric editors actually use
  • Fact-check before you send — extract claims, verify each, flag the shaky ones
  • 🗣️ Keep drafts in your voice — fingerprint your real writing, kill the AI tells
  • 📋 Build a fit-checked media list — targeted reporters, not scraped contact dumps

🧭 Strategize — figure out what your story even is

  • 🗺️ Get a PR strategy — opinionated walkthrough if you're not PR-fluent yet: audience first, positioning second, news pegs third, drumbeat over big-bang
  • 📊 Score newsworthiness — cold read on whether it clears the bar before you act

Who this is for

  • Founders doing their own PR because the agency quote was insane
  • PR agencies running more accounts than humans can babysit
  • Marketers at small companies who need leverage, not headcount
  • Anyone whose agent is already running their day-to-day — and should be better at it

Install

Newsjack is a set of open skills — plain-Markdown instructions your agent reads — plus a small open-source CLI. Most skills run anywhere your agent runs. A few reach for a live news index, journalist enrichment, or locally-saved monitoring state — those work best in a local agent.

What runs where

Skill Claude.ai ChatGPT Cowork Claude Code Codex Hermes OpenClaw Medialyst
Strategize
pr-strategist ⚠️
newsworthiness-check ⚠️
Act
angle-generator ⚠️
headline-generator ⚠️
meanest-editor ⚠️
crisis-holding ⚠️
reactive-comment ⚠️
fact-check ⚠️
journalist-fit-check ⚠️
voice-extractor ⚠️ ⚠️
find-journalists 🔧 ⚠️ 🔧 🔧 🔧 🔧 🔧
Detect
news-search ⚠️ 🔧 🔧 🔧 🔧 🔧
story-origin-check 🔧 ⚠️ 🔧 🔧 🔧 🔧 🔧
relevance-coarse-filter ⚠️
newsjack-triage ⚠️
newsjack-detector ⚠️ ⚠️ ⚠️ 🔧 🔧 🔧 🔧 🔜
newsjack-monitor-setup 🔜
coverage-tracker ⚠️ ⚠️ ⚠️ 🔜
coverage-tracker-setup 🔜

Legend:

  • ✅ Runs out of the box — no setup; works anywhere your agent does.
  • 🔧 May need an external connection — works on its own, but does its best work with an external data source connected (e.g. the X API or the Medialyst API).
  • ⚠️ Limited Mode — runs in a chat app, but as a best-effort, one-shot pass with nothing saved between sessions: no stored voice fingerprint, no scheduled monitoring, no repeat-suppression. Connect a local agent for the saved, scheduled version.
  • 🔜 Coming soon — not available here yet.
  • ❌ Not supported — the two setup skills (newsjack-monitor-setup, coverage-tracker-setup) only save a profile or config and schedule it, so they need a local agent.

Set up your agent:

Local agents (Claude Code, Codex, Hermes, OpenClaw)

Technical? One line on macOS / Linux (review install.sh first if you like):

curl -fsSL newsjack.sh | bash

Not technical? 📋 Copy this prompt to any AI:

help me setup https://newsjack.sh

It reads the guide and handles the rest — npm fallback, Windows, credentials — on any platform.

Claude.ai & Cowork - Install as a Claude Plugin

Install the Newsjack plugin:

  1. Open Customize.
  2. Go to Personal plugins.
  3. Click Create plugin.
  4. Choose Add marketplace.
  5. Choose Add from a repository.
  6. In the repository URL field, enter elvisun/newsjack and confirm.
  7. Open the new elvisun/newsjack marketplace, find the newsjack@newsjack plugin, and click Install.
  8. (Optional) Unlock the 🔧 skills by connecting a Medialyst account so your agent can access live news search and journalist enrichment. If you don't have an account you can create a free one here.
  9. (Optional) Back in Claude, find the Medialyst connector under the installed Newsjack plugin page, click Connect on the Medialyst connector and authorize it over OAuth.

Note: A community marketplace plugin, newsjack@claude-community, is pending review and will be added soon.

The two always-on monitors run here in ⚠️ Limited Mode — a best-effort, one-shot scan with nothing saved. For saved, scheduled monitoring, use a local agent.

ChatGPT

ChatGPT runs Newsjack only in a degraded ⚠️ form. Skills aren't available to accounts that are not on ChatGPT Business or Enterprise. For the full toolkit, use OpenAI's Codex.


What gets installed

~/.newsjack/
├── bin/newsjack          # CLI
└── newsjack/             # managed bundle

skills installed to your detected runtime(s):
  newsworthiness-check    score whether your news clears the bar
  headline-generator      headlines and subject lines from raw story facts
  find-journalists        build small, fit-checked journalist lists
  ...and more

The npm package bundles the same CLI and skills, with the newsjack command installed on PATH.

Curl-installed Newsjack auto-updates from the latest GitHub Release before each run. Set NEWSJACK_AUTO_UPDATE=0 to disable.

You can also install the CLI byitself using npm:

npm i -g newsjack@latest

Author: Elvis Sun — LinkedIn · X

About

The open-source skills that turn your agent into a full PR team.

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors