Skip to content

elvisun/newsjack

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

242 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

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 install https://newsjack.sh from the github repo and setup a daily newsjack monitoring for my company.

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
  • πŸ“° Clip the coverage β€” turn a live article URL into a branded press-clip PDF: the outlet's own logo and layout kept, ads and clutter stripped, the client's mention highlighted (local agent only)

🧭 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
  • πŸ“… Build a PR calendar β€” plan six months of source-backed upcoming hooks, with prior-year coverage patterns for angle inspiration
  • πŸ“Š 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 βœ… ⚠️ βœ… βœ… βœ… βœ… βœ… βœ…
pr-calendar πŸ”§ ⚠️ πŸ”§ πŸ”§ πŸ”§ πŸ”§ πŸ”§ βœ…
newsworthiness-check βœ… ⚠️ βœ… βœ… βœ… βœ… βœ… βœ…
Act
angle-generator βœ… ⚠️ βœ… βœ… βœ… βœ… βœ… βœ…
headline-generator βœ… ⚠️ βœ… βœ… βœ… βœ… βœ… βœ…
meanest-editor βœ… ⚠️ βœ… βœ… βœ… βœ… βœ… βœ…
crisis-holding βœ… ⚠️ βœ… βœ… βœ… βœ… βœ… βœ…
reactive-comment βœ… ⚠️ βœ… βœ… βœ… βœ… βœ… βœ…
fact-check βœ… ⚠️ βœ… βœ… βœ… βœ… βœ… βœ…
journalist-fit-check βœ… ⚠️ βœ… βœ… βœ… βœ… βœ… βœ…
voice-extractor ⚠️ ⚠️ βœ… βœ… βœ… βœ… βœ… βœ…
find-journalists πŸ”§ ⚠️ πŸ”§ πŸ”§ πŸ”§ πŸ”§ πŸ”§ βœ…
press-clip ❌ ❌ ❌ βœ… βœ… βœ… βœ… πŸ”œ
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 β€” requires or 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 here β€” needs a local agent. The two setup skills (newsjack-monitor-setup, coverage-tracker-setup) only save a profile or config and schedule it; press-clip drives a real Chrome/Edge browser via Playwright to render and clip the live page, which chat apps can't do.

pr-calendar is setup-required but portable: it works anywhere the agent can use the newsjack CLI or a connected Medialyst MCP/connector. The calendar endpoint is free; login is required only to prevent abuse. ChatGPT is the exception for now because of the same skill-loading limitation called out above.

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.

Prefer a video? Watch the Newsjack installation walkthrough.

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, PR calendar lookup, and journalist enrichment. In local agent harnesses, run newsjack login and approve the printed Medialyst link. If you don't have an account you can create a free one on the Medialyst signup page.
  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

595 stars

Watchers

1 watching

Forks

Packages

 
 
 

Contributors