Releases: chizhangucb/chronicle
Release list
Chronicle v0.1.10 — sharper "Agent Active" session metric
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
userrole 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
.dmgfor 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
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
.dmgfor 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
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 projectchronicle-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
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
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-quarantineneeded.
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
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
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.jsonversion = 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.comDNS 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 ofrelease/
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
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, cleansrelease/, and relaunches- Arch selection moved from build config to CLI flags:
dist:macbuilds both arches,reinstall:macjust yours
Full changelog: v0.1.2...v0.1.3
🤖 Generated with Claude Code
Chronicle v0.1.2 — sidebar navigation + project analytics
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.logand amailto: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=Nfor time-range filtering
Full changelog: v0.1.1...v0.1.2
🤖 Generated with Claude Code
Chronicle v0.1.1 — macOS installers + Refine polish
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 thechizhangucb/chronicletap):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
Kto 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