claudenews — DevFeed for Claude Code

Switching to another task while Claude works costs you context.
Just staring at the terminal is boring. claudenews fills those short
waits with dev news — so the idle time isn't wasted and you never lose
your place.

Claude가 다른 명령을 처리하는 동안 다른 일을 하자니 컨텍스트 스위칭
비용이 들고, 터미널만 보고 있자니 심심하셨죠? 그 짧은 시간을 개발
뉴스로 채우고, 흐름은 그대로 유지하세요.

A Claude Code plugin that surfaces Hacker News, GitHub Trending, and
per-language dev & news sources in the status line during agent wait time —
auto-translated into your OS language, with short summaries that fade in as
Claude fetches them in the background.

The title is a clickable link, ▲ score / 💬 comments show for HN
items, and the trailing hint rotates through the commands (dropped
automatically if the terminal is too narrow). Korean / Japanese /
Chinese users see the same item auto-translated — no configuration:

Install (30 seconds)

Inside Claude Code:

/plugin marketplace add bhpark1013/claudenews
/plugin install claudenews@claudenews
/reload-plugins
/claudenews:setup

/reload-plugins activates the hooks and slash commands without a full
restart. Then restart Claude Code once so the status line takes effect —
the next time the agent thinks, a news item rotates in.

Why you might want this

• No API key. Translation and summary use your existing Claude Code session
  (Haiku, background-priced). No OpenAI key, no separate billing.
• Auto-detects your OS language. macOS AppleLocale, then $LANG,
  then Python locale. Korean, Japanese, Chinese, Spanish, etc. all work without
  configuration. English users get titles untranslated.
• Coexists with your existing status line. OMC HUD, git status, custom
  scripts — point at them via parentStatusLine in ~/.claudenews/config.json
  and claudenews appends underneath rather than replacing.
• Auto-fits your terminal width. Detects cmux → tmux → iTerm2 → stty so
  titles & summaries truncate to the actual column count, not a static 120.
• GitHub repo summaries are accurate. When a GitHub repo's description is
  empty, claudenews falls back to the README's first paragraph via the GitHub
  API instead of showing "Contribute to … by creating an account on GitHub".
• No separate windows. Everything happens inline in your Claude Code
  session — the source list is a plain menu you read and toggle by id.

Commands

The source list is the menu: run /claudenews:list to see every source
(id + flag + on/off) and toggle by id. You can also just ask Claude in
plain language — "show my news sources", "이 뉴스 자세히 보여줘",
"change the news language to Korean", "send claudenews feedback" — and
the right command runs automatically.

Keyboard navigation (optional, macOS)

By default the status line auto-rotates through news while the agent thinks.
If you'd rather step through items yourself, turn on key navigation:

/claudenews:nav on

• ctrl+shift+→ next · ctrl+shift+← previous
• Remap the keys: set navKeys in ~/.claudenews/config.json (any
  ctrl/shift/cmd/alt combo + prev/next keys), then rerun
  /claudenews:nav on — see Power-user config below.
• News becomes global: every Claude Code session shows the same item, so
  stepping moves them all together.
• Works in iTerm2, Apple Terminal, WezTerm, kitty. In any other app the
  shortcut is left untouched (so it still selects text in your browser/editor).

The key is captured by a tiny Hammerspoon tap,
so nav on needs Hammerspoon installed:

brew install --cask hammerspoon

The only manual step is a one-time macOS Accessibility grant for Hammerspoon
— macOS pops the prompt the first time; click Open System Settings and toggle
it on. nav on restarts Hammerspoon for you and sets the status-line refresh to
1s so stepping feels instant. Disable it (and restore auto-rotation) anytime
with /claudenews:nav off.

Updating

/claudenews:update
/reload-plugins

/claudenews:update pulls the latest version, refreshes the cache, and
updates the status-line launcher in one step. /reload-plugins then
activates the new hooks and commands (a Claude Code runtime action a
plugin can't do itself). You never need to re-run /claudenews:setup —
the status line auto-tracks the newest installed version.

Sources

Sources are a catalog you choose from with /claudenews:list:

• Hacker News — top 50 (on by default, all users)
• GitHub Trending — popular repos created in the last 7 days (on by default, all users)
• Per-language native dev communities — the one matching your OS language
  turns on automatically; all are toggleable for anyone:
  • geeknews GeekNews — Korean (ko)
  • qiita Qiita 人気 — Japanese (ja) · zenn, hatena-it (opt-in)
  • v2ex V2EX — Chinese (zh) · infoq-cn (opt-in)
  • habr Habr — Russian (ru)
  • jdh Journal du hacker — French (fr)
  • heise-dev heise Developer — German (de)
  • tabnews TabNews — Portuguese / Brazil (pt)
• Global English (opt-in): lobsters Lobsters, devto DEV Community
• General world / national news (opt-in, not dev-focused, off by default):
  cnn CNN, bbc BBC News, nyt NYT World, yonhap 연합뉴스, hani 한겨레
  (Naver News has no public general RSS; Yonhap is the KR wire-service feed)
• More can be added server-side without a plugin update

The plugin picks sensible defaults on first run from your OS language.
/claudenews:list prints the full menu; /claudenews:list cnn bbc hn
toggles one or more by id. Public sources are fetched and cached by the
backend; your selection just tells it what to merge.

Power-user config (~/.claudenews/config.json)

A few optional knobs you can set by hand (the plugin manages the rest):

• clientFeeds — add any RSS/Atom feed the backend can't reach, fetched
  from your own machine instead. Reddit is the headline case: it 403s
  datacenter IPs, but www.reddit.com/r/<sub>/.rss works from a normal
  machine. Items flow through rotation / nav / translation / summary exactly
  like built-in sources — there's no per-source code, just URLs.

  Easiest way to add one: /claudenews:list add r/<sub> (or just ask
  Claude — "add r/rust"); /claudenews:list rmfeed r/<sub> removes it. The
  command writes this for you, and you can also edit it by hand:

  "clientFeeds": [
    {"name": "👽 r/ClaudeAI", "url": "https://www.reddit.com/r/ClaudeAI/.rss"},
    {"name": "🐘 #rust", "url": "https://mastodon.social/tags/rust.rss", "lang": "en"}
  ]
  

• navKeys — remap the keyboard-nav combo (default ctrl+shift+←/→). Set
  the modifiers and the prev/next keys, then rerun /claudenews:nav on to apply:

  "navKeys": { "modifiers": ["ctrl", "shift"], "prev": "left", "next": "right" }
  

  modifiers is any of ctrl/shift/cmd/alt (held together); prev/next
  are any key names (left, right, [, ], …). Keep to a combo the shell
  doesn't use (the ctrl+shift family) — picking one it does (e.g. cmd/alt
  +arrow) means losing that shortcut inside the terminal.

• summaryColor — SGR color for the summary lines (default 38;5;245, a
  readable gray). e.g. "37" plain white, "38;5;250" lighter, "38;5;240"
  dimmer.

• parentStatusLine — the status line claudenews chains underneath; set
  automatically at setup from whatever you had before.

Privacy

• No prompts, no code, no keystrokes collected
• News is fetched on prompt submit, rate-limited to 30s per session
• Translation/summary uses your local Claude Code session — content never
  leaves your machine except to fetch the article meta description and the
  GitHub API for repo summaries
• All caches live under ~/.claudenews/
• Anonymous install count: /claudenews:setup pings the backend once.
  The server only increments a single counter — no IP, user-agent, or
  identifier is read, stored, or logged. Offline just skips it silently.
• Feedback (/claudenews:feedback) is explicit and opt-in: only the
  message you type and the plugin version are sent and stored — no IP,
  user-agent, machine info, or identifier.

Uninstall

/claudenews:teardown
/plugin remove claudenews

teardown restores whatever status line you had before install (from the
backup created at setup time) and removes ~/.claudenews/.

Development

cd web
npm install
npm run dev

Backend is a stateless Next.js 16 app on Vercel. /api/news interleaves
your selected sources (HN, GitHub Trending, and RSS feeds), cached 5 min
in-memory per function instance. No database and no per-user tracking —
the only persisted state is privacy-safe anonymous counters (install
count, feedback) with no IP/identifier ever stored.

License

MIT