Hntui: 터미널에서 해커뉴스 목록을 vim 스타일로 탐색하는 텍스트 기반 인터페이스

해커뉴스를 터미널에서 바로 볼 수 있는 도구가 필요하면 Hntui를 한 번 써보세요. 최신, 새 글, 베스트, 질문, 보여주기, 일자리 목록을 탭처럼 전환하면서 vim 방식 키 조작으로 빠르게 이동할 수 있습니다. 마우스로도 대부분의 동작을 지원해 손목에 무리가 가지 않게 편리하게 사용할 수 있습니다. 게시물을 읽다가 마음에 들면 단축키 하나로 저장 목록에 넣고 나중에 다시 열어볼 수 있습니다. 저장된 목록은 로컬 JSON 파일에 보관돼 세션이 바뀌어도 사라지지 않습니다. 다크와 라이트 두 가지 테마를 제공해 주변 조명에 맞게 화면을 조정할 수 있고, 로딩 중에는 스캐너 효과가 눈길을 끌어요. 이번 글에서는 Hntui의 핵심 기능부터 설치·업데이트 방법까지 구체적인 예시와 함께 단계별로 안내합니다.

=

Hntui: 터미널에서 해커뉴스 목록을 vim 스타일로 탐색하는 텍스트 기반 인터페이스

1. 기본 탐색 방식

Hntui는 터미널 창 안에서 해커뉴스의 여섯 가지 목록을 차례대로 넘겨볼 수 있게 설계했습니다. 위쪽 영역에 위치한 탭을 클릭하거나 키보드의 숫자 키를 누르면 최신, 새 글, 베스트, 질문, 보여주기, 일자리 사이를 즉시 이동할 수 있습니다. 각 목록에서는 위·아래 화살표 또는 vim에서 사용하는 j와 k 키로 항목을 하나씩 움직일 수 있습니다. 페이지 단위로 빠르게 이동하고 싶다면 스페이스바로 반 페이지 아래로, Shift+스페이스바로 반 페이지 위로 스크롤할 수 있습니다. 목록 맨 위나 맨 아래로 바로 가고 싶다면 g와 G 키를 활용하면 됩니다. 현재 보고 있는 피드를 새로 고침하고 싶다면 y 키를 누르면 스캐너 효과와 함께 최신 데이터를 불러옵니다. 마우스 사용자에게는 목록 위에서 클릭만으로도 같은 동작을 수행할 수 있어 키보드에 익숙하지도 않은 사람도 쉽게 적응할 수 있습니다. 이렇게 직관적인 탐색 방식 덕분에 터미널 초보자도 해커뉴스를 빠르게 훑어볼 수 있습니다.

2. 댓글 보기와 링크 처리

게시물 목록에서 원하는 제목을 엔터 키로 선택하면 해당 글의 댓글 트리가 화면에 펼쳐집니다. 댓글 목록에서는 nuevamente j와 k로 위아래 이동하면서 개별 댓글을 읽을 수 있습니다. 댓글 안에 달린 대댓글은 좌우 화살표 혹은 h와 l 키로 트리를 접고 펼칠 수 있어 깊이 있는 대화를 한눈에 파악하기 쉽습니다. 트리에서 특정 댓글을 더 자세히 보고 싶다면 해당 줄을 두 번 클릭하면 본문이 확대되어 보여집니다. 댓글 내부에는 종종 외부 링크가 포함되어 있는데, 이를 클릭하면 작은 팝업 창이 뜨고 링크를 그대로 열거나 복사할 수 있습니다. 팝업 밖을 클릭하거나 esc 키를 누르면 창이 닫혀 이전 화면으로 돌아갑니다. 마우스를 선호하는 사용자는 댓글 헤더를 클릭해서 트리를 접고 펼치고, 본문을 더블 클릭하면 링크 팝업을 띄울 수 있습니다. 이렇게 댓글 트리와 링크 처리를 모두 키보드와 마우스로 자유롭게 제어할 수 있어 읽기 흐름이 끊기지 않습니다.

3. 저장 목록과 테마 변경

읽다가 나중에 다시 보고 싶은 글이나 댓글이 생기면 s 키를 누르면 현재 항목이 저장 목록에 추가됩니다. 저장된 항목 옆에는 작은 별 표시가 생겨 한눈에 어떤 게시물을 저장했는지 알 수 있습니다. 저장 목록을 확인하고 싶다면 화면 오른쪽 끝에 위치한 별 탭을 클릭하거나 S 키를 누르면 바로 이동됩니다. 저장 목록은 사용자 홈 디렉터리 아래 .config/hntui/saved.json 파일에 기록돼 터미널을 종료하고 다시 실행해도 내용이 그대로 유지됩니다. 처음 실행 시 이전 버전의 설정 파일(hackernuis)이 있다면 자동으로 마이그레이션되어 이전 설정을 잃지 않게 됩니다. 화면 테마는 t 키를 누르면 다크와 라이트 사이에서 전환할 수 있으며, 다크 테마는 검정 바탕에 주황 강조 색을 쓰고 라이트 테마는 해커뉴스 웹사이트의 흰 배경과 베이지 행 강조를 따라갑니다. 테마를 바꾸면 즉시 적용돼 눈의 피도를 줄이는 데 도움이 됩니다. 저장과 테마 기능을 모두 간단한 단축키로 처리해 작업 흐름을 끊이지 않게 유지할 수 있습니다.

4. 설치 방법과 실행 환경

Hntui는 별도의 외부 라이브러리를 필요로 하지 않는 독립 실행형 바이너리로 배포됩니다. 공식 배포 페이지에서 macOS용 Apple Silicon 바이너리와 리눅스용 x64·arm64 바이너리를 받을 수 있으니 자신의 운영체제에 맞는 파일을 내려받으면 바로 실행할 수 있습니다. 인텔 기반 맥에서는 bun 패키지 매니저를 이용해 소스를 컴파일하는 방식도 제공되며, 이때 bun 1.2 이상 버전이 필요합니다. 리눅스와 �도도우에서 직접 테스트는 진행하지 않았지만, 터미널이 truecolor 출력과 마우스 입력을 지원하고 UTF‑8 기반 인코딩을 한다면 대부분 문제없이 작동합니다. 실제 테스트는 macOS의 최신 터미널 에뮬레이터인 에서 이루어졌으며, 거기서 키보드와 마우스 입력이 정상 동작함을 확인했습니다. 바이너리를 받은 뒤 실행 파일에 실행 권한을 부여하고 터미널에서 단순히 hntui 명령을 내리면 바로 프로그램이 시작됩니다. 이렇게 간단한 설치 절차 덕분에 별도의 의존성 관리 없이 바로 사용을 시작할 수 있습니다.

5. 업데이트와 출시 워크플로

바이너리 형태로 설치했다면 hntui 업데이트 명령을 입력하면 최신 버전을 확인하고 현재 파일을 교체하는 방식으로 업데이트가 진행됩니다. bun을 이용해 소스에서 설치한 경우라면 일반적인 패키지 매니저 업데이트처럼 bun 업데이트를 실행하면 hntui 패키지도 함께 갱신됩니다. 새 버전이 출시되면 상태 표시줄에 알림이 뜨므로 놓치지 않고 최신 기능을 적용할 수 있습니다. 개발 측은 git 태그를 push할 때 자동으로 바이너리 빌드와 npm 출판 워크플로가 동작하도록 구성했습니다. 바이너리 워크플로는 bun build –compile 명령으로 각 플랫폼용 실행 파일을 만들고, 릴리스 전에 스모크 테스트를 거쳐 최종 압축 파일을 GitHub에 첨부합니다. npm 워크플로는 OIDC 기반 신뢰된 게시를 이용해 패키지 레지스트리에 업로드하며, 기존 버전은 중복 방지를 위해 건너뜁니다. 이렇게 체계화된 출시 과정 덕분에 사용자는 언제나 안정된 버전을 손에 넣을 수 있습니다.

6. 미래 방향과 독자 행동

앞으로는 키보드 레이아웃을 사용자 지정할 수 있게 해서 개인마다 가장 편한 키 맵을 설정할 수 있도록 할 계획입니다. 또한 저장 목록에 태그 기능을 관심 주제별로 글을 분류하고 빠르게 필터링해 볼 수 있게 하려고 합니다. 커뮤니티 피드백을 반영해 마우스 제스처를 확장해서 오른쪽 클릭 메뉴에 자주 쓰는 명령을 더 많이 넣을 예정입니다. 현재는 다크·라이트 두 가지 테마만 있지만, 사용자가 직접 색상을 정의할 수 있는 사용자 정의 테마 옵션을 추가해 더욱 자유로운 화면 구성을 지원할 생각입니다. 이러한 기능들이 차례대로 구현되면 Hntui는 단순한 피드 뷰어를 넘어 터미널 안에서 완전한 뉴스 리더로 자리매김할 것입니다. 오늘 저녁에 터미널을 켜고 hntui를 실행해 보신다면 바로 차이를 느끼실 수 있을 겁니다.

자주 묻는 질문