Skip to content

elvisun/newsjack

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

211 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


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

Pick the path for the harness you're using.

Supported runtimes

Runtime Status Experience Install path
Claude Code Recommended Full Mode curl, npm, or plugin
Codex Recommended Full Mode curl or npm
OpenClaw Recommended Full Mode curl or npm
Hermes Recommended Full Mode curl or npm
Claude.ai chat Limited only Limited Mode plugin/upload/manual skills
ChatGPT chat Limited only Limited Mode manual skills
Claude Cowork Limited only Limited Mode plugin/upload/manual skills

Full Mode: Claude Code, Codex, OpenClaw, Hermes

Use the curl installer when your full agent harness can reach GitHub Release assets:

curl -fsSL newsjack.sh | bash

Or review the script before running it:

curl -fsSL https://newsjack.sh

No surprises: that's the exact, unminified install.sh in this repo β€” newsjack.sh serves this file and every release bundles it unchanged, so what you read here is what runs. Read it before you pipe it to a shell.

The routing is open too: apps/site/proxy.ts is the Next.js handler behind newsjack.sh β€” it rewrites installer user-agents (curl/wget) to install.sh and 308-redirects everyone else to this repo.

The installer detects your agent runtime and installs the CLI-backed skills automatically.

If shell installers or GitHub Release assets are blocked, use npm instead:

npm i -g newsjack
newsjack install

After install, agents and skills should call the CLI as newsjack.

Windows

No script, no git, no Node. One PowerShell line downloads the CLI and runs setup (requires v0.1.10 or later):

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12; iwr https://github.com/elvisun/newsjack/releases/latest/download/newsjack_windows_amd64.exe -OutFile newsjack.exe; Unblock-File newsjack.exe; .\newsjack.exe setup

The TLS line makes the download work on stock Windows PowerShell 5.1 (it's a no-op on PowerShell 7).

newsjack setup downloads the skills bundle, verifies its checksum, installs the CLI to %USERPROFILE%\.newsjack\bin, and walks you through the same guided setup as macOS/Linux β€” including installing Claude Code through its own native Windows installer if you don't have it yet. Updates are automatic, same as the curl install.

Limited mode: Running on Claude.ai, ChatGPT, Claude Cowork

Newsjack needs a local agent for Full Mode. On Claude.ai, ChatGPT, or Claude Cowork it automatically falls back to Limited Mode β€” no install, no CLI, no setup. Paste your startup URL or your news and you get a real PR operator on the spot.

Every skill still works. PR strategy, newsworthiness scoring, story angles, pitch drafting and honest critique, journalist-fit reasoning, fit-checked media lists, reactive source-query responses, voice fingerprinting, and fact-checking against pasted or searchable evidence all run right in the chat β€” paste what you've got and go.

The only things that change are the two always-on monitors β€” newsjack monitoring (watching your space for newsjacking opportunities) and coverage monitoring (Google Alerts-style keyword tracking). Without a local agent they can't keep saved profiles, run on a schedule, or remember what they've already flagged, so they fall back to best-effort, one-shot scans you trigger by hand. Want them running on autopilot? Set up Full Mode with the CLI harness and a local agent.

For Claude.ai plugin-style setup:

  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

Then install the Newsjack plugin from that marketplace:

  • Marketplace: elvisun/newsjack
  • Plugin: newsjack@newsjack

A community marketplace plugin (newsjack@claude-community) is pending review and will be added soon.


What gets installed

~/.newsjack/
β”œβ”€β”€ bin/newsjack          # CLI
└── newsjack/             # managed bundle

skills installed to your detected runtime(s):
  newsjack-monitor-setup  create a company monitoring profile
  newsjack-detector       find newsworthy moments before the wave breaks
  newsworthiness-check    score whether your news clears the bar
  angle-generator         turn one update into ten pitchable hooks
  headline-generator      headlines and subject lines from raw story facts
  find-journalists        build small, fit-checked media 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.

Npm-installed Newsjack uses npm for CLI updates:

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