Skip to content

Releases: jhlee0409/claude-code-history-viewer

v1.5.3

24 Feb 07:42

Choose a tag to compare

v1.5.3

Highlights

토큰 통계의 일관성 문제를 전면 개선했습니다. 빌링(비용 추적)과 대화(컨텍스트 윈도우) 두 가지 관점으로 통계를 분리하여, 글로벌/프로젝트/세션 수준에서 수치가 정확히 일치하도록 수정했습니다.

Closes #150 — "inconsistency in token calculations?"

New Features

  • 통합 토큰 통계 모드billing_total (sidechain 포함, 비용 추적용)과 conversation_only (sidechain 제외, 컨텍스트 추적용) 두 가지 모드 도입
  • 빌링 브레이크다운 카드Billing Total = Conversation Only + Tool/System 분해 표시
  • 프로바이더 분포 차트 — 멀티 프로바이더 환경에서 각 프로바이더별 토큰 비율 시각화
  • 메트릭 모드 토글 — 빌링/대화 모드를 UI에서 전환 가능
  • 앱 버전 표시 — 상태바 하단에 현재 버전 표시

Bug Fixes

  • 글로벌 통계와 프로젝트별 통계 간 수치 불일치 해소
  • 날짜 필터가 per-message 수준까지 전파되도록 수정 (end-of-day 정규화 포함)
  • 세션 카운트 및 토큰 카드 hover 상태 수정
  • 프로젝트 트리에서 글로벌 통계 진입 시 열린 노드 자동 접힘
  • 7일 트렌드 윈도우 빈 날짜 채우기 동작 개선

Improvements

  • Rust stats 커맨드 전체에 stats_mode 파라미터 추가 (get_global_stats_summary, get_project_stats_summary, get_project_token_stats, get_session_token_stats, get_session_comparison)
  • 크로스 스코프 일관성 검증 테스트 추가
  • 프로바이더 능력(sidechain 메타데이터 가용성) 기반 UX 메시징
  • i18n: 5개 언어 analytics 키 확장

CI/CD

  • 릴리즈 retry 워크플로우 추가 (updater-release-retry.yml)
  • Homebrew cask 동기화 시 commit ref 기반 검증으로 변경

Full Changelog: v1.5.2...v1.5.3

v1.5.2

21 Feb 20:50

Choose a tag to compare

Highlights

  • Updater errors are now mapped by stage (install vs restart), reducing false Download failed guidance after successful downloads.
  • The auto-update modal now displays release notes directly from updater metadata.
  • Update failures can be reported with one click via feedback modal prefilled with updater diagnostics.

Added

  • Release name and release notes rendering inside the auto-update modal.
  • Updater diagnostics formatter and UI test coverage for failure/report flows.

Improved

  • Auto-update UX now explicitly reflects downloading, installing, and restarting stages.
  • Feedback modal supports prefilled subject/body/type from caller context.

Fixed

  • Improved updater fallback handling for restart-required scenarios.
  • Updated release workflow authentication handling for main repo vs tap repo access.

Breaking Changes

  • No breaking changes.

Migration Notes

  • No migration required.

Full Changelog

v1.5.1

21 Feb 19:34

Choose a tag to compare

Highlights

  • Provider filters are now synchronized across Project Tree, explorer counts, Global Search, and Global Stats.
  • The updater flow now preserves real install errors and shows a clear localized fallback when automatic relaunch fails after download.
  • Project Tree behavior is more predictable: clicking the chevron now selects and expands the project, and empty projects without session files are hidden.
  • Token/statistics handling is more robust for large histories, with improved stability and faster global stats loading.

Added

  • No new end-user features in this patch release.

Improved

  • Provider tab behavior is more consistent when switching or reselecting providers.
  • Global Search groups results by project and provider to reduce ambiguity in multi-provider setups.
  • Update error messaging is localized and easier to act on.

Fixed

  • Fixed a token overflow panic in large session/global stats calculations.
  • Fixed race conditions that could surface stale token stats or global stats during rapid view/filter changes.
  • Fixed provider filtering mismatches between explorer data and analytics views.
  • Fixed updater edge cases where downloaded updates could fail to relaunch without a clear user-facing instruction.

Breaking Changes

  • No breaking changes.

Migration Notes

  • No migration steps required.

Full Changelog

v1.5.0

21 Feb 15:43

Choose a tag to compare

What's Changed

Full Changelog: v1.4.0...v1.5.0

v1.4.0

21 Feb 14:25

Choose a tag to compare

v1.4.0 — Multi-Provider Support & Activity Timeline

This release brings first-class support for Codex CLI and OpenCode alongside Claude Code, a new Activity Timeline on the Session Board, Homebrew installation for macOS, and dozens of UX refinements.

Highlights

Multi-Provider Support

You can now browse conversation history from three AI coding assistants in a single app:

  • Claude Code (~/.claude) — existing support, now with improved parsing
  • Codex CLI (~/.codex) — full session parsing with tool execution rendering
  • OpenCode (~/.local/share/opencode/) — step-finish token parsing and file/patch rendering

Filter sessions by provider, view provider-specific analytics, and seamlessly switch between histories — all in one unified interface.

Activity Timeline

The Session Board now features an interactive bar chart timeline that visualizes your coding activity over time. Click any bar to filter sessions for that day. Includes localized tooltips, timezone-safe date handling, and responsive sizing.

Homebrew Support (macOS)

You can now install the app via Homebrew on macOS:

brew install --cask claude-code-history-viewer

The in-app auto-updater continues to work alongside Homebrew installations.

New Features

  • Copy Session ID & Resume Command — Right-click any session to copy its ID, the claude --resume command, or the JSONL file path directly to your clipboard. (Thanks to @cameronsjo — first contribution!)
  • Provider-specific context menus — Native rename actions and labels adapt to each provider (Claude Code, Codex, OpenCode).
  • ANSI terminal color rendering — Command output now renders ANSI color codes with proper syntax highlighting, safely sanitized against XSS.

Improvements

  • Collapsible command output — Command execution results are now collapsed by default, keeping long sessions readable.
  • Smarter session summaries — Multi-tier extraction now pulls meaningful session titles even when the first message is a tool result or command.
  • Horizontal scroll for overflow — Long terminal commands, code blocks, and tool input parameters no longer break the layout.
  • Full project names visible — Project names in the Global Overview ranking list are no longer truncated unexpectedly.
  • Default to Messages view — Selecting a project now opens the Messages view instead of the Board view, matching user expectations.

Stability & Reliability

  • Hardened update flow — Update modal actions are guarded with error handling, skipped versions are tracked defensively, and the restarting UI overlay prevents the brief error flash during binary replacement.
  • CI race condition fix — Resolved a latest.json race condition in the Tauri release workflow that could cause incomplete release artifacts.
  • Improved Codex/OpenCode parsing — Defensive handling for missing renderers and edge cases in both Codex event mapping and OpenCode field mappings.

Accessibility

  • Icon-only buttons now include proper aria-label attributes.
  • Collapsible command renderers have full ARIA support.
  • Tooltip triggers use focusable button elements.

Full Changelog

v1.3.0...v1.4.0

v1.3.0

06 Feb 05:53

Choose a tag to compare

v1.3.0 Changelog

A major release containing 127 commits since v1.2.5.

Major New Features

Session Board - Multi-Session Analysis Tool

  • New board view for comparing and analyzing multiple sessions at a glance
  • Interactive brushing system with filtering by tools, commands, and MCP servers
  • Pixel view: Visualize sessions as compact cards to identify patterns
  • Zoom in/out to switch between detailed and overview modes
  • Badges for work types such as git commits, document edits, etc.
  • Date range filtering and in-depth analysis metrics
  • Draggable tooltips for viewing detailed information

Settings Manager

  • Integrated settings manager for editing Claude Code settings directly within the app
  • Project-level and global scope settings support
  • MCP server preset library (official and community servers)
  • Real-time JSON validation and diagnostics

Real-Time Session File Monitoring

  • Automatic project tree updates when new sessions are created
  • Real-time sync via file system watcher
  • View the latest conversations without manual refresh

Enhanced Search and Navigation

  • Improved global search (performance and UI updates)
  • Enhanced session list sorting and search
  • Bidirectional navigation between board and sidebar
  • Deep linking from token statistics to session board

Internationalization (i18n) Improvements

  • Complete refactoring to namespace-based structure (better maintainability)
  • Synced missing translation keys across all languages
  • Full localization of session board and interaction cards

UI/UX Improvements

  • Unified rendering of slash command output as a single card
  • Improved project tree expand/collapse state sync
  • Linked markdown edits to the recent edits view
  • Auto-fill feedback data into GitHub issue forms

Bug Fixes

Rendering and UI

  • Fixed duplicate tool use rendering
  • Improved brush match count accuracy in session headers
  • Improved readability by adjusting opacity of non-brushed items
  • Fixed pixel view layout and display issues

Session Management

  • Fixed search integration bug when renaming sessions
  • Resolved subdirectory project path decoding issue
  • Fixed project tree expand/collapse sync and worktree grouping edge cases
  • Fixed issues when switching message views

Data Processing

  • Removed unclosed code fences from truncated message previews
  • Used conversation-based timing to prevent data loss
  • Restored markdown detection heuristics

Miscellaneous

  • Fixed /cost and other slash command output rendering
  • Handled 'all' brush value in MCP filtering
  • Escaped angle brackets in Rustdoc comments

Refactoring

  • Split i18n structure into namespace-based files (2-40KB each)
  • Refactored InteractionCard and SessionLane with unit tests
  • Extracted ToolIcon as utility with improved type safety
  • Removed epic session logic and applied strict typing to ClaudeMessage
  • Fixed lint errors (as any → proper type casts)

Miscellaneous

  • Removed Aptabase analytics dependency
  • Added issue analysis automation workflow
  • Added unit tests for brushing utilities

Release Stats: 127 commits | 38 new features | 37 bug fixes | 9 refactors | 11 docs

v1.2.5

25 Jan 16:56

Choose a tag to compare

Full Changelog: v1.2.4...v1.2.5

v1.2.4

25 Jan 14:19

Choose a tag to compare

Full Changelog: v1.2.3...v1.2.4

v1.2.3

25 Jan 10:05

Choose a tag to compare

Full Changelog: v1.2.2...v1.2.3

v1.2.2

25 Jan 09:08

Choose a tag to compare

Full Changelog: v1.2.1...v1.2.2