vasilievyakov

Miracle Claude Sessions — Development skill for Claude Code

Development community

Native macOS app for browsing Claude Code session history — built in 32 minutes.

How to install Miracle Claude Sessions

This entry records only its repository, not the path inside it, so there is no exact command to give. Open vasilievyakov/miracle-claude-sessions and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Miracle Claude Sessions does

Native macOS app for browsing Claude Code session history — built in 32 minutes.

Alternatives in Development

Clarc — Native macOS client for Claude Code — a GUI desktop app built with SwiftUI 363 ★
Calyx — A native macOS terminal app built on Ghostty for running and supervising coding agents 298 ★
Quosparr — 🐦 Native menu bar & tray app for macOS, Windows and Linux: track Codex, Claude Code and Grok quotas, resets 288 ★

README

Claude Sessions

A native macOS app that turns your Claude Code conversation history into a browsable, searchable interface — with cost tracking, tool visualization, and automatic project detection.

**Built from scratch in 32 minutes using Claude Code.** [Here's how.](#built-in-32-minutes)

[![CI](https://github.com/vasilievyakov/ClaudeSessions/actions/workflows/ci.yml/badge.svg)](https://github.com/vasilievyakov/ClaudeSessions/actions/workflows/ci.yml) ![macOS](https://img.shields.io/badge/macOS-14%2B-blue) ![Swift](https://img.shields.io/badge/Swift-6.0-orange) ![License](https://img.shields.io/badge/license-MIT-green) ![Zero Dependencies](https://img.shields.io/badge/dependencies-0-brightgreen) ![Tests](https://img.shields.io/badge/tests-120%2B-brightgreen)

![ClaudeSessions — three-column session browser](screenshot.png)

Why

Claude Code stores every conversation as a JSONL file in `~/.claude/projects/`. These files contain rich data — token counts, tool calls, model info, costs, durations — but there's no built-in way to browse them. You can `--resume` a session if you remember its ID, but you can't:

See all sessions across projects at a glance
Know how much each session cost you
Find that conversation from Tuesday where you fixed the auth bug
Understand which tools Claude used and how often

This app fills that gap. Think [NetNewsWire](https://netnewswire.com/), but for your AI conversations.

Features

See where your money goes — per-session cost estimates based on current Anthropic pricing, with token breakdowns (input, output, cache read, cache write)
Find any conversation instantly — full-text search across all sessions, plus smart filters: Today, This Week, Large >100K, per-project
Understand how Claude works — colored tool badges show Read/Write/Bash/Grep/Task call counts at a glance
Auto-detected projects — 5-level detection cascade analyzes file paths, working directory, and message content. No configuration n