ClaudeCodeExplorer: Instructions file for Claude Code

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

What this app is

A WPF (.NET 10, Windows) tray application that scans ~/.claude/projects, parses each Claude Code session transcript (.jsonl), and presents the conversations as searchable, project-grouped tiles. Clicking a tile opens Windows Terminal in that conversation's original working directory and runs claude --resume <sessionId>.

Commands

dotnet build                                   # Debug build
dotnet build -c Release                        # Release (DebugType=none)
dotnet run                                      # build + launch (starts hidden in the tray)
dotnet publish -p:PublishProfile=FolderProfile  # single-file, self-contained, win-x64, R2R

There is no test project and no linter configured — build is the only gate.

Architecture

MVVM, but hand-rolled (no MVVM framework). The single window binds to MainViewModel; all real work lives in stateless static service classes under Services/.

Data flow (read path): ProjectScanner.Scan enumerates ~/.claude/projects/<encoded-path>/*.jsonl → for each file, CacheService.TryGet returns a cached ConversationInfo if the file's last-write-time-ticks and size are unchanged, otherwise JsonlParser.Parse reads it → results sorted by IsFavorite desc, then LastActivityUtc desc → surfaced through MainViewModel.ConversationsView (an ICollectionView that filters by SearchBlob and groups by GroupKey: the WorkingDirectory, or the "<favorites>" sentinel for starred conversations).

Favorites: starred session ids live in settings.json (SettingsService), not in the parse cache — a cache entry is replaced whenever its .jsonl changes, which would drop the flag. IsFavorite is applied after each scan; sorting favorites first is what pins their group on top (groups follow the order of their first item). Favorites are exempt from the search result cap.