Repository navigation
Releases
v2.5.3 — Saved preferences and Kotlin references
This patch fixes saved review preferences and Kotlin class-reference lookup.
- Remember your view settings. Split/Unified and Scroll/Wrap now follow you across repositories, worktrees and new or resumed reviews. Desktop and mobile keep separate preferences, and older sessions do not overwrite newer choices. (#51)
- Find Kotlin class references without extra setup. Built-in lookup follows packages and imports, including aliases, across repository source files. It keeps unrelated same-named types and lexical shadows separate. Ambiguous declarations and unsupported lookups retain an explicit fallback. (#52)
Kotlin results are bounded syntax candidates. Compiler type inference, dependency sources and KMP source-set selection still require a project-aware provider.
Update with diffcompass update.
Full changelog: v2.5.2...v2.5.3
v2.5.2 — Stop comments and tour grounding
Fixes
- Stop comments: Keep the form usable after saving, so you can add comments on different stops and edit existing comments without reloading. Failed saves preserve the draft for retry. (#49)
- Tour questions: Strengthen the generation and attached-agent instructions to check actual control flow and state transitions before raising review questions, and to state uncertainty explicitly. (#47)
- CI reliability: Wait for Monaco file navigation before opening What changed summaries, and capture browser traces when these checks fail. (#48)
Includes binaries for macOS, Linux and Windows on ARM64 and x64, both installers, and SHA-256 checksums.
Full changelog: v2.5.1...v2.5.2
v2.5.1
DiffCompass 2.5.1 fixes Media clutter, Kotlin reference lookup and Monaco scrolling.
- Curated Media by default: show only files supplied with
--media, and hide the tab when none were supplied. Changed PNGs remain reviewable in Changes. Use--media-include-changed-imagesor.diffcompass.json→media.includeChangedImages: trueto include them in Media with lazy loading. The choice survives resume. - Built-in Kotlin lookup: find same-file declaration and usage candidates without an external language server, respecting explicit scopes and shadowing. Cross-file and type-dependent resolution still require a project-aware provider. Bounded fallback searches now prioritize the selected file.
- Stable Monaco clicks: prevent first-click and right-click scroll jumps while preserving Shift-click and drag selection in split and unified views.
Includes #44 and #45. Installers and release archives are available for macOS, Linux and Windows on Intel/AMD and ARM.
v2.5.0
DiffCompass gives Tour, Questions, and Comments their own sidebar tabs, makes Briefing source easier to explore, and adds resizable evidence panes in presented diagrams.
New and improved
- Review sidebar tabs: switch between Tour, Questions, and Comments, each using the available height. Drafts, reading positions, conversation selection, and tour progress are preserved. Keyboard arrows, Home, and End navigate the tabs.
- Briefing file navigation: click an excerpt's filename to inspect the file in Changes. The tour pauses, and Back to Briefing restores your reading position and selected evidence.
- Resizable presentation evidence: drag the divider or use the keyboard to resize code beside a fullscreen diagram on desktop, or below it on narrow screens. Your chosen dimensions are remembered.
- Author intent: pass
--intent-file PATHto give the Briefing author-stated context from a text file. - Kotlin references: connect Find references to
kotlin-lsp --stdioorkotlin-language-server, preserve the selected cursor column, and explain why name search is used when semantic lookup is unavailable. A compatible language server must be installed separately; Kotlin project support depends on that provider.
Fixes
- Replace Monaco's native browser comment-deletion prompt with themed inline confirmation, including Cancel, Escape, and retry after an error.
- Keep stop-comment drafts attached to the original stop when navigating before saving.
- Handle Unicode language-server messages, server configuration requests, and exact source positions more reliably.
- Stabilize browser checks around editor readiness, the new Comments tab, and requests still running during browser teardown.
Documentation
The feature guide includes screenshots of all three sidebar tabs, and the README includes a demo video.
Install or update
Run diffcompass update for an existing installation. Restart running DiffCompass sessions to use the new version. The release includes macOS, Linux, and Windows archives for ARM64 and x64, both installer scripts, and SHA-256 checksums.
v2.4.0 — Session discovery and review improvements
DiffCompass now remembers your preferred renderer, cleans up completed PR review workspaces, and lets external tools rediscover live review pages.
New and improved
- Persistent renderer preference: keep Monaco or Shiki selected across new and resumed reviews, repositories, and browser ports.
- Live session discovery: private session locks expose the review URL and attached bridge URL for tools such as the Herdr cockpit. URLs disappear on normal shutdown; readers must ignore locks whose process has exited.
- Domain glossaries: read
GLOSSARY.mdalongsideCONTEXT.md, use the nearest glossary for code bindings, and keep separate glossary files as separate domain models. - About: show the supported code-analysis languages.
Fixes
- Remove clean, tool-owned PR worktrees after a completed review, while preserving open or modified workspaces. Resuming a completed review recreates its workspace at the recorded revision.
- Hide the duplicate component-details card inside Briefing diagrams.
- Return promptly from command timeouts when a child process still holds an output pipe open.
Development foundations
Add captured-tree change facts, caller discovery, TypeScript/Kotlin import resolution, and Briefing excerpt coverage calculations. Scans are bounded and can use an existing CodeGraph index when it matches the captured source. These helpers are not yet connected to Briefing generation.
Install or update
Run diffcompass update for an existing installation. The release includes macOS, Linux, and Windows archives for ARM64 and x64, both installer scripts, and SHA-256 checksums.
v2.3.1 — Preview and Briefing fixes
This patch improves Markdown previews, Briefing presentation, and generated dry-run plans.
- Markdown previews follow Split/Unified in both Shiki and Monaco. Unified shows retained list items once, and preview highlights identify changed list items and table rows precisely. #28
- Present keeps diagrams expanded while inspecting code. Evidence appears beside the diagram on desktop and below it on narrow screens. #23
- The comparison-range menu explains unavailable options. “Since last review” indicates when a checkpoint is needed or the active tour must be exited. #28
- Malformed dry-run plans get bounded correction attempts. Generation uses an explicit shared schema, including
source.anchors, and retries validation failures up to twice without accepting invalid evidence. #27 - Updated the README with the Briefing reader, a dedicated guide, and fresh screenshots. #30
- Improved browser-check synchronization around navigation, pending requests, and suggestion menus. #23
Update with:
diffcompass updateDownloads include macOS, Linux, and Windows builds for Intel/AMD and ARM, both installer scripts, and SHA-256 checksums.
Full changelog: v2.3.0...v2.3.1
v2.3.0
What's Changed
- Install and update DiffCompass without the GitHub CLI by @rcosteira79 in #21
Full Changelog: v2.2.4...v2.3.0
v2.2.4 — Verified Briefing source links
Briefing diagrams now inspect captured repository source to fill missing code links during generation and regeneration, including unchanged supporting files. Returned IDs and exact quotes are validated; invalid responses receive up to two repair attempts. When an element cannot be linked, its inspector and exports explain the source limitation.
- Opening a Briefing citation in Changes pauses the active tour and reveals the source across phase boundaries. Back to Briefing restores the reader; resuming the tour clears that return button.
- Fixed Monaco diff colors bleeding into Split-view gutters and improved gutter spacing in Briefing code cards.
- Added source-linking, navigation, and gutter regression coverage. Existing Briefings gain the new source inspection when regenerated.
- Release packages now include the repository's Sustainable Use License 1.0.
Update with diffcompass update.
v2.2.3 — Briefing first, then the code tour
Reviews with a saved Briefing now open on the Briefing tab, and newly prepared tours show their Briefing first. The existing automatic Briefing preference is respected.
At the bottom of a Briefing, Tour the code → opens Changes at the current tour stop. It also resumes an exited tour without resetting progress, and appears only when a tour is available.
Validated with 999 passing tests and browser coverage for startup, preference handling, tour handoff, and progress preservation.
v2.2.2 — consistent Archify Briefings
Briefing now uses the same Archify viewers as Diagrams for sequence, architecture, lifecycle, data-model and domain maps. Call-flow trees also share one renderer across the live reader, preview and offline export.
- Start with the complete diagram visible, then retain user zoom while inspecting code.
- Keep diagram selections and captured diffs in sync. Clicking an evidence card preserves its position in the pane.
- Keep saved viewers attached to their Briefing snapshot. If a viewer is unavailable, its element list and evidence remain accessible.
- Preserve these interactions in self-contained HTML exports without network access.
Validated with every diagram family in the production reader and offline export, plus two pinned real-world comparisons.