A command for adding a news source to Herald from an RSS or Atom feed URL. RSS and Atom are standard formats websites use to publish lists of new articles.

Use it to add a feed URL or provide topic keywords that can guide source selection.

It checks that a supplied feed is valid before suggesting how to add it to the configuration.

news-add — Command for Claude Code by heurema

Install

Getting it into your agent

This one installs as part of its plugin. Adding the marketplace and installing the plugin brings it with everything else the plugin ships.

Claude Code

/plugin marketplace add heurema/herald

Claude Code

/plugin install herald

Made for: Claude Code.

Or install herald, the plugin that ships this one along with the rest of its 1 skill, 7 commands, 1 hook.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/commands/heurema/herald/news-add/github.svg)](https://agentmods.dev/commands/heurema/herald/news-add)

Your own site

<a href="https://agentmods.dev/commands/heurema/herald/news-add"><img src="https://agentmods.dev/badge/commands/heurema/herald/news-add/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/commands/heurema/herald/news-add"><img src="https://agentmods.dev/badge/commands/heurema/herald/news-add.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 17 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.

When invoked 564 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 1 finding. A grade says what 26 rules found in the file — not that it is safe.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.00017	$0.00564
Opus 5	$0.00009	$0.00282
Sonnet 5	$0.00003	$0.00113
Haiku 4.5	$0.00002	$0.00056

Measured 9d ago against content hash dced4617ae4c, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-09, from the pricing page.

Security

Grade A, and why

news-add scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 9d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

curl -sL --max-time 10 -- '<url>' 2>/dev/null | head -5

commands/news-add.md · 55 lines

What it actually says

You are adding a news source to the user's herald config.

Preflight

Find the herald data directory:
```
cd "${CLAUDE_PLUGIN_ROOT}" && PYTHONPATH=. python3 -c "from herald.cli import _default_data_dir; print(_default_data_dir())"
```
Check config.yaml exists there (defaults to ~/.local/share/herald/; use --data-dir or HERALD_DATA_DIR to override). If not: "Run /news-init first."
Read config.

Determine input type

Parse the user's input after /news-add:

If it looks like a URL (starts with http/https): → URL flow
If no argument: ask "Paste an RSS/Atom feed URL"

URL Flow — RSS Feed

Validate feed: Fetch the URL and check it returns valid XML/RSS. Construct the command using the URL as a separate argument to avoid shell injection:
```
curl -sL --max-time 10 -- '<url>' 2>/dev/null | head -5
```
Replace <url> with the literal URL value using single quotes. If the URL contains a single quote, abort and ask the user to provide a valid URL. Look for <?xml, <rss, <feed, <atom markers.
If valid feed: Suggest a source entry:
- id: derive from domain (e.g., simonw from simonwillison.net)
- name: derive from domain or feed title
- weight: 0.2 (default)
- category: community (default) Ask user to confirm or customize.
If not valid: Try RSS autodiscovery:
- Platform heuristics: github.com → /releases.atom, substack → /feed
- Common paths: /feed, /rss, /atom.xml, /feed.xml If found, confirm with user. If not: "Could not find RSS feed."
Add to config: Read config.yaml from the herald data directory (step 1), append to sources list via Edit tool.
Confirm: "Added . Run /news-run to fetch articles."

Config rules

Only edit the config.yaml in the herald data directory (see Preflight)
Use Edit tool, not full rewrite
Check for duplicate URLs or ids before adding

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

9d ago First seen · 55 lines · 17 tokens per session scan A dced4617ae4c

Subscribe to this mod's changes

news-add is a command published in the GitHub repository heurema/herald (4 stars, last pushed 5mo ago), licensed MIT. It adds 17 tokens to every session and 564 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Claude Code ai-agent anthropic claude claude-code-plugin news-digest

recall-save

Generate / overwrite .recall/context.md with Recall's local offline summarizer.

raiyanyahya/recall · 15 tokens

notebook-query

Query the notebook knowledge base (SQLite) built by /agy:notebook — precise, grounded, cited. Ask in natural language ("sum the amounts by category", "which docs mention 'Acme Corp'", "build a project timeline") or pass raw SQL. Read-only. Use this when you need exact aggregates/lookups across a document corpus…

MarcosNahuel/antigravity-plugin-cc · 74 tokens

news-add