facts

이번에 공개된 newsline은 Claude Code의 세션 하단 상태줄(HUD) 아래에 지역 맞춤형 뉴스 헤드라인을 추가하는 도구다. 기존 상태줄을 교체하지 않고 한 줄을 덧붙이는 방식으로 작동하며, 기본 6초 주기로 헤드라인이 회전 표시된다. 사용자는 설정에서 헤드라인 색상과 회전 주기를 조정할 수 있다.

지원 언어는 한국어를 포함해 총 8개 언어이며, 테크, 비즈니스, 스포츠 등 분야(topic) 선택이 가능하다. 뉴스 소스는 로케일별 신뢰도 높은 현지 매체를 1순위로 가져온다. 한국은 연합뉴스, 일본은 NHK, 프랑스는 Le Monde, 독일은 Tagesschau/Spiegel, 스페인은 El País, 브라질은 G1, 영어권은 BBC/NPR을 우선하며, 해당 매체 접속이 불가능할 경우 Google News 로케일 피드로 자동 폴백(Fallback)한다.

설치는 다음의 네 가지 경로를 통해 가능하다.

- 쉘 스크립트: `curl -fsSL https://raw.githubusercontent.com/itdar/newsline/master/install.sh | sh`

- npm: `npm i -g newsline-cli && newsline init`

- Homebrew

- Claude Code 플러그인 마켓플레이스: `/plugin marketplace add itdar/newsline`

설치 후 다음 메시지 전송 시점부터 즉시 적용되며, `newsline uninstall` 명령어로 이전 상태줄을 복원할 수 있다.

how-it-works

newsline의 핵심 구조는 네트워크 지연이 상태줄 렌더링에 영향을 주지 않도록 설계된 캐싱 파이프라인이다. Claude Code는 상태줄을 매우 빈번하게 호출하므로, 호출 시점에 네트워크 요청을 보내면 인터페이스 지연이 발생한다. 이를 해결하기 위해 newsline은 다음과 같은 처리 방식을 사용한다.

첫째, 백그라운드 프로세스가 Python 3 표준 라이브러리만을 사용하여 RSS 피드를 로컬로 가져온다. 별도의 외부 의존성 없이 표준 라이브러리만 사용해 가벼운 실행 환경을 유지한다. 둘째, 가져온 헤드라인 N개를 로컬 캐시에 저장한다. 셋째, 상태줄 호출 시 네트워크 연결 없이 캐시된 데이터를 즉시 렌더링하며, 벽시계(Wall-clock) 기준으로 회전시킨다.

데이터 갱신 과정에서는 'single-flight' 락(lock) 메커니즘을 적용했다. 이는 동일한 갱신 요청이 여러 번 발생하더라도 실제 네트워크 요청은 하나만 수행되도록 제어하여 중복 실행과 리소스 낭비를 방지하는 구조다.

출력되는 헤드라인은 OSC 8(Operating System Command 8) 하이퍼링크 규격을 따른다. 이를 통해 사용자는 터미널 환경에서도 헤드라인을 클릭해 해당 기사 원문으로 즉시 이동할 수 있다.

implementation-impact

개발자와 실무자가 도입 시 고려해야 할 핵심은 기존 워크플로우의 보존과 프라이버시 제어다. 대부분의 상태줄 도구가 기존 HUD를 완전히 교체하는 것과 달리, newsline은 한 줄을 추가하는 방식이므로 기존에 사용하던 상태줄 설정과 충돌 없이 병행 사용할 수 있다.

운영 측면에서는 네트워크 지연 시간이 렌더링 경로에서 완전히 분리되어 있다는 점이 중요하다. 백그라운드에서 캐싱이 이뤄지므로 뉴스 피드 서버의 응답 속도가 Claude Code의 인터페이스 반응 속도에 영향을 주지 않는다.

프라이버시 설정은 `~/.config/newsline/config.json` 파일을 통해 제어한다. 기본적으로 수집과 표시는 로컬에서 수행되며, 외부로는 언어, 국가, 분야 등 지역 소스 선정을 위한 최소한의 컨텍스트만 전송된다(트래킹 ID 미포함). 만약 완전한 로컬 모드가 필요하다면 설정 파일에 다음과 같은 필드를 추가하여 뉴스 피드 외의 모든 외부 접속을 차단할 수 있다.

{

"api": "off",

"endpoint": "off"

}

관련 소스 코드는 GitHub(https://github.com/itdar/newsline)에서 확인할 수 있다.