hearthling — watch your AI agents work

How it works동작 방식

No account. No cloud. No telemetry. 계정 없음. 클라우드 없음. 전송 없음.

Claude Code already writes session transcripts to your disk. hearthling just reads them. Claude Code는 이미 세션 기록을 내 디스크에 남깁니다. hearthling는 그것을 읽기만 합니다.

A tiny local server작은 로컬 서버

One Node process, zero dependencies. It tails ~/.claude session logs and serves a dashboard on localhost only. 의존성 없는 Node 프로세스 하나가 ~/.claude 세션 기록을 읽어 localhost 전용 대시보드로 제공합니다.

Sessions become workers세션이 워커가 된다

Live sessions and background agents appear as villagers, labeled with their model and generated tokens. Tool calls drive what they do. 라이브 세션과 백그라운드 에이전트가 마을 주민으로 나타나고, 모델명과 생성 토큰이 이름표에 붙습니다. 도구 호출이 행동을 정합니다.

Work becomes a village작업이 마을이 된다

Reads, greps and bash runs turn into mining, logging and hauling. When an agent completes its task, the construction site becomes a finished building. 읽기·검색·명령 실행이 채굴·벌목·운반이 됩니다. 에이전트가 작업을 마치면 공사 중이던 자리에 건물이 완성됩니다.

What you get무엇이 담겼나

A second monitor worth watching 두 번째 모니터에 켜 둘 이유

Live agent watchtower에이전트 관제탑

Running several sessions in parallel? See at a glance which one is grinding, which one is idle, and which one just finished — without cycling through terminals. 세션을 여러 개 돌릴 때, 어떤 세션이 일하는 중이고 어떤 세션이 놀고 있는지 터미널을 오가지 않고 한 화면에서 봅니다.

Token ledger토큰 장부

Daily and weekly generated-token totals per model, indexed incrementally from your transcripts. Cache reads excluded, so the number tracks real work. 모델별 일별·주별 생성 토큰 집계. 캐시 재읽기는 빼고 세므로 숫자가 실제 작업량을 따라갑니다.

Local-only by design설계부터 로컬 전용

Binds to 127.0.0.1. Your prompts and code never leave your machine — there is nothing to send them to. 127.0.0.1에만 열립니다. 프롬프트와 코드는 기기 밖으로 나가지 않습니다 — 보낼 곳 자체가 없습니다.

Install설치

One command명령 한 줄

npx hearthling

or git clone https://github.com/sungeunstar/hearthling && cd hearthling && npm start

Requires Node.js 18+ and Claude Code. Opens at localhost:4577. Options: --port, --claude-home, --no-open. Node.js 18 이상과 Claude Code가 필요합니다. localhost:4577에서 열립니다. 옵션: --port, --claude-home, --no-open.

FAQ

Does any of my data leave my machine?내 데이터가 밖으로 나가나요?

No. The server binds to 127.0.0.1, makes no outbound requests, and has no accounts or telemetry. It only reads the transcript files Claude Code already stores locally. 아니요. 서버는 127.0.0.1에만 열리고, 바깥으로 요청을 보내지 않으며, 계정도 수집도 없습니다. Claude Code가 이미 로컬에 저장한 기록 파일을 읽기만 합니다.

Which platforms are supported?어떤 플랫폼을 지원하나요?

Windows is tested today. macOS and Linux are supported in code (path detection, browser open) — reports and fixes are welcome on GitHub. Windows에서 검증되었습니다. macOS와 Linux는 코드상 대응되어 있습니다(경로 탐지·브라우저 열기). 문제 제보는 GitHub으로 환영합니다.

What happens if Claude Code changes its log format?Claude Code 기록 형식이 바뀌면요?

The transcript format is unofficial, so hearthling parses defensively: unknown lines are skipped, the server never crashes on them, and the dashboard tells you if it stops recognizing the format. 기록 형식은 비공식이라 방어적으로 읽습니다. 모르는 줄은 건너뛰고, 그것 때문에 서버가 죽지 않으며, 형식을 알아보지 못하게 되면 화면에 알립니다.

Your AI agents,
at work in a living village AI 에이전트가 일하는
살아 있는 마을