Skip to content

Releases: chizhangucb/chronicle

Chronicle v0.1.10 — sharper "Agent Active" session metric

Choose a tag to compare

@chizhangucb chizhangucb released this 12 Jul 23:15

Chronicle v0.1.10 — a sharper "Agent Active" session metric.

Highlights

  • "Agent Active" (renamed from "Active Duration") now measures how long the agent was actually working — and measures it correctly. It still excludes the pause before each of your prompts (your reading/typing/away time), but it no longer counts background-task completions, in-app clicks, or interrupt markers as "you thinking." Those all carry a user role in the session log, so a long background build finishing used to be charged to your idle time — making the number read lower than it should. On a real session this moved Agent Active from 33m to 43m of a 59m span. The tooltip explains the distinction inline.

Everything else is unchanged from v0.1.9.

Install

  • Homebrew: brew install --cask chizhangucb/chronicle/chronicle
  • Direct download: grab the .dmg for your Mac (Apple silicon or Intel) below.

Signed and notarized; existing installs auto-update.

Full changelog: v0.1.9...v0.1.10

Chronicle v0.1.9 — bulk project delete, always-on toolbar, sharper session metrics

Choose a tag to compare

@chizhangucb chizhangucb released this 12 Jul 22:14

Chronicle v0.1.9 — bulk project delete, always-on toolbar, sharper session metrics.

Highlights

  • Multi-select project delete. A new Select mode on the home page turns project cards into checkboxes, so you can remove several projects from Chronicle at once — with Select-all / Clear and an inline confirm. As always, this only forgets projects in Chronicle; your source logs and folders are never touched.
  • Always-on toolbar. Search (⌘K) and + Import Sessions are now available from every view, not just the home page, next to the language switcher.
  • Active Duration now reflects real agent work. It counts all assistant-thinking and tool-execution time in full and excludes only the pause before each of your prompts (your reading/typing/away time). Previously any gap over 5 minutes was dropped, so long builds and deep thinks were undercounted — the number now tracks Total Duration much more honestly.
  • Cache-write cost split by TTL. The Cost & Usage panel now breaks cache-write tokens and dollars into 5-minute and 1-hour TTL tiers (labeled tags), matching how each is billed.
  • Readable tooltips. The ⓘ info tooltips open downward and are wider, so the full explanation is always visible.

Install

  • Homebrew: brew install --cask chizhangucb/chronicle/chronicle
  • Direct download: grab the .dmg for your Mac (Apple silicon or Intel) below.

Signed and notarized; existing installs auto-update.

Full changelog: v0.1.8...v0.1.9

Chronicle v0.1.8 — getchronicle.dev download site + developer docs

Choose a tag to compare

@chizhangucb chizhangucb released this 10 Jul 00:17

Chronicle v0.1.8 — getchronicle.dev download site + developer docs

A website + documentation release — no app changes since v0.1.7, so there's nothing to install or auto-update (like the v0.1.4 docs release).

🌐 getchronicle.dev

  • One-click download page — auto-detects your OS and offers a single signed & notarized download, replacing the raw GitHub Releases list. macOS defaults to Apple Silicon (Intel one row down); Windows/Linux link to source until those builds ship.
  • Live release tracking — the page reads the latest GitHub release at load, so new versions (and future Windows/Linux builds) appear automatically with no page edits.
  • Light + dark, mobile-responsive, with a real in-app Playback (time-travel) screenshot and a copy-to-clipboard Homebrew one-liner.
  • Built as a new website/ deployable (Vercel project chronicle-web), live at getchronicle.dev.

📚 Developer documentation

  • A layered docs/ set — guide, architecture, and reference — covering install, time-travel, MCP & Skills, parsers, packaging, security, and configuration.

No new DMGs — the desktop app is unchanged from v0.1.7. Download the current app from getchronicle.dev or brew install --cask chronicle.

Chronicle v0.1.7 — session UX polish

Choose a tag to compare

@chizhangucb chizhangucb released this 09 Jul 19:10

Chronicle v0.1.7 — session UX polish

Auto-update delivers these on top of v0.1.6:

  • ⇧⌘U — keyboard shortcut for per-session Sync Update
  • Active Duration stat on the session Overview: real working time (gaps under 5 min) vs wall-clock Total Duration, with an ⓘ tooltip explaining the math
  • Refine → delete by type — keep or drop whole message kinds (User / Assistant / Tool Call / …) in one click
  • Consolidated chat labels — Playback and Refine now use the same role-accurate wording
  • Replay — cleaner sandbox toolbar
  • Feedback — optional sender email, set as Reply-To so replies reach you
  • Language switch keeps your place instead of bouncing to Home

Signed + notarized (Developer ID Application: Chi Zhang). Apple Silicon + Intel.

Chronicle v0.1.6 — code signing + notarization, one-click auto-update, getchronicle.dev feedback

Choose a tag to compare

@chizhangucb chizhangucb released this 09 Jul 16:35

Chronicle v0.1.6 — the first signed & notarized release. 🎉

What's new

  • One-click auto-update. An in-app "Updated to X.Y.Z / Relaunch to apply" toast now installs updates and cleanly relaunches — no more pkill/reinstall dance. (Powered by electron-updater on a notarized Developer ID build.)
  • Feedback moved to getchronicle.dev.
  • Signed + notarized (Developer ID: Chi Zhang, Team 9W7B6USGG9), so macOS no longer quarantines it — no --no-quarantine needed.

Upgrading from 0.1.5? 0.1.5 was unsigned, so it can't auto-update to this one (signatures must match). Upgrade once manually — brew upgrade --cask chronicle, or download the DMG below. Every update after 0.1.6 is automatic.

Chronicle v0.1.5 — cost & usage, global search, session titles, Japanese

Choose a tag to compare

@chizhangucb chizhangucb released this 08 Jul 03:22

Chronicle v0.1.5 — Cost & usage, global search, session titles, Japanese

A big session-analytics and navigation update, plus the fix that makes your Claude Code session renames finally show up.

✨ New

  • Cost & Usage panel on every session overview — per-model token totals (input / output / cache read / cache write) with a dollar breakdown per line and a session total. Cost is computed locally from the current Anthropic list prices (no network) with separate 5-minute and 1-hour cache-write pricing, matching Claude Code's /usage.
  • Global search palette (🔍 on the home page, or ⌘K anywhere) — search across all session content with All / Code / Chat scopes, time and project filters, "Recent Access" recents, highlighted snippets, and keyboard navigation.
  • Skill Distribution & MCP Distribution donut cards on the session overview — Skills grouped by name, MCP calls grouped by server.
  • Japanese (日本語) UI language, alongside English and 中文.
  • Project switcher dropdown in the project breadcrumb — jump between projects (name · session count · last active) without going home.
  • "Today" time filter on the project analytics page.

🔧 Session titles & renaming

  • Chronicle now reads Claude Code custom session titles (/rename) — every session you renamed in Claude Code shows its real name in Chronicle, across all projects, and stays in sync on every re-import.
  • Session names appear in the project list, breadcrumb, session picker, and overview, with the first prompt kept as a subline reminder.
  • Inline rename on the session overview (replaces a brittle prompt() dialog that failed in embedded browsers) — persists across re-imports.
  • Per-session Sync Update button in the session toolbar (icon), so you can refresh a single session without syncing the whole project.

🩹 Fixes

  • Corrected model pricing to the current Anthropic table (Opus 4.8 tier is $5/$25, not the old $15/$75) and split 5m vs 1h cache writes — cost figures now match /usage.
  • Filtered Claude Code's token-less <synthetic> model from the cost card.
  • Project dropdown is readable (opens rightward, no longer clipped by the sidebar) and uses relative time ("today", "2 days ago").

🤖 Generated with Claude Code

Chronicle v0.1.4 — documentation release

Choose a tag to compare

@chizhangucb chizhangucb released this 08 Jul 01:42

Documentation release — no functional changes since v0.1.3.

📖 Contributor docs

CLAUDE.md (the AI-assisted-contributor guide) now captures the architecture decisions, patterns, and gotchas accumulated over the last development cycle:

  • Architecture: the global sidebar navigation model (SessionView registers its modes into the sidebar via onRailChange), the latest-cwd-wins policy for resolving moved repos, the minimal-runtime-deps packaging philosophy, and the feedback relay design
  • Release checklist: the exact order that keeps package.json version = git tag = DMG contents = cask checksums
  • Gotchas: client deps belong in devDependencies (misplacing one fattens every DMG), ULFO is the strongest DMG compression electron-builder supports, transient uploads.github.com DNS failures and how to retry, single-instance/port-41730 conflict debugging, the duplicated error heuristic (server + client), formsubmit's one-time activation, and the anatomy of release/

DMGs are attached for updater consistency; they contain the same app as v0.1.3.

Full changelog: v0.1.3...v0.1.4

🤖 Generated with Claude Code

Chronicle v0.1.3 — moved-repo fix + sync-all

Choose a tag to compare

@chizhangucb chizhangucb released this 07 Jul 18:04

Moved-repo fix, one-click sync-all, and developer conveniences.

🐛 Fixed: moved repos no longer resurrect their old paths

Sessions resumed after a repo move carry the old directory in their early log records. Chronicle used to take the first cwd it saw, so a moved project kept showing up as importable under its dead old path. The scanner and importer now use the latest cwd (where the project — and its Git history — actually lives), and subdirectory cwds are collapsed up to the project root so grouping doesn't fragment.

If a moved project is affected on your machine, run Sync Update (project gear menu) or the new sidebar sync-all to re-home its sessions.

🔄 Sync-all button

A button next to Projects in the sidebar re-imports the latest sessions for every project in one click — spins while running, skips projects whose source logs are gone, refreshes when done.

🔧 Developer conveniences

  • npm run reinstall:mac — quits the running app, rebuilds (arm64 only), replaces /Applications/Chronicle.app, cleans release/, and relaunches
  • Arch selection moved from build config to CLI flags: dist:mac builds both arches, reinstall:mac just yours

Full changelog: v0.1.2...v0.1.3

🤖 Generated with Claude Code

Chronicle v0.1.2 — sidebar navigation + project analytics

Choose a tag to compare

@chizhangucb chizhangucb released this 07 Jul 08:21

Sidebar navigation and project analytics.

🧭 Global sidebar

  • Collapsible left sidebar replacing the topbar tabs: Projects on top, session modes (Overview / Playback / Refine / Replay / Security Check) while a session is open, and MCP Hub / Skills / Security / Feedback / Collapse pinned at the bottom — collapse state persists
  • Feedback button: modal with ⌘+Enter to send — relays to email with a local copy in ~/.chronicle/feedback.log and a mailto: fallback

📊 Project home page

  • 8 stat cards: Sessions, Total Duration, Active Days, Error Rate, Avg Duration, Tool Calls, Messages, Errors (error detection heuristic runs server-side)
  • Activity Trend chart with line and bar styles
  • Tool Distribution donut (sessions by source tool) and Call Ranking bars with friendly names (Shell Command, Edit File, …)
  • Time range dropdown: All time (default) / 7 Days / 30 Days / 1 Year — filters every card and chart
  • Sessions list moved below the charts

🧵 Session navigation

  • Breadcrumbs on project and session pages: 📁 project › 💬 session
  • Session switcher dropdown with search, message counts, and relative dates — jump between sessions without going back
  • Session ID shown on the session home page with a one-click Copy button

🔧 Under the hood

  • Windows (dist:win → NSIS) and Linux (dist:linux → AppImage + deb) build targets cross-compile from macOS (installers not yet shipped — untested on real machines)
  • Skills Hub uses junctions on Windows (no admin rights needed)
  • Project analytics endpoint accepts ?days=N for time-range filtering

Full changelog: v0.1.1...v0.1.2

🤖 Generated with Claude Code

Chronicle v0.1.1 — macOS installers + Refine polish

Choose a tag to compare

@chizhangucb chizhangucb released this 07 Jul 02:57

First installable release, plus Refine mode polish and open-source housekeeping.

📦 macOS installers (FR-IMP-1)

  • DMG installers for Apple Silicon (Chronicle-0.1.1-arm64.dmg) and Intel (Chronicle-0.1.1-x64.dmg), built with electron-builder — attached below
  • Homebrew cask ready in packaging/homebrew/ (published via the chizhangucb/chronicle tap):
    brew tap chizhangucb/chronicle
    brew install --cask chronicle --no-quarantine
  • The app is not yet code-signed/notarized: install with --no-quarantine, or run
    xattr -dr com.apple.quarantine "/Applications/Chronicle.app" after installing
  • New build command: npm run dist:mac
  • Slimmed 116 MB → 102 MB: client-only deps pruned from the app bundle, Electron locales stripped to EN + 中文, LZFSE DMG compression

✂️ Refine mode improvements

  • Keep All / Delete All bulk buttons at the top of the message list — both single undoable steps
  • Pre-deleted noise restored: tool results and thinking start deleted again, so the compressed preview is useful immediately (press K to resurrect what matters)
  • Clearer savings bar: the confusing two-bar display (static reference bar + compressed-size bar + a mismatched percentage) is now a single green progress bar that fills as you delete, labeled with exactly what it shows — e.g. 69% saved

📖 Open-source housekeeping

  • MIT license added
  • README overhauled: install instructions, all six importers documented, current feature list (4-step import wizard, Session Overview, mode rail, context-window bar), accurate remaining-work section
  • PRD gains a decision log (§9) resolving all open questions: Electron over Tauri, heuristic no-LLM causality, zero-backend share links, and implementation status through Phase 5
  • Contributor docs (CLAUDE.md) refreshed with packaging and release gotchas

Full changelog: v0.1.0...v0.1.1

🤖 Generated with Claude Code