2.0.5

What's new in 2.0.5

A quota-accuracy release: the live subscription numbers now refresh when they actually change, and stop costing you anything when nobody is looking at them.

• Quota refreshes when the window resets — Lens schedules a refresh for each rate limit window's own reset moment, the 5-hour and the 7-day one separately, instead of waiting for the next poll to happen to land. A window that has rolled over shows as refreshing rather than leaving a stale "limit reached" bar on screen.
• No probing while Lens is hidden — the Claude quota probe is a real API call against your own subscription. Lens now pauses it while the window is hidden or the app sits in the tray, and catches up the moment you come back. Concurrent triggers are merged into a single probe.
• Honest quota labels — Anthropic's raw status values map to a localized badge, the countdown ticks between refreshes instead of sitting frozen, and a failed refresh is stated instead of silently leaving the last known numbers looking current.
• Prompt-less sessions are hidden — starting a CLI session and closing it without typing anything still writes a file. Those rows are filtered out of the list, the cache, and the History count.
• Transcript stays scrollable after switching sessions — fixes a case where the message list rendered too short to scroll, leaving older turns unreachable.
• Codex thinking level in session info — and the CLI version row is now labeled per source, Claude Code or Codex, instead of always reading "CC version".

Everything from 2.0.4 is unchanged — instant Claude Code ⇄ Codex switching, bounded session caches, grouped Codex subagents, clean session titles, search timeline, inline subagent and workflow transcripts, custom profile, workspace browser, light and dark themes, UI in 10 languages, and no network beyond the opt-in quota probe.

Downloads

• macOS Apple Silicon — Lens-2.0.5-arm64-mac.zip
• macOS Intel — Lens-2.0.5-mac.zip
• Windows x64 — Lens-2.0.5-win.zip
• Linux x64 — Lens-2.0.5-linux-x86_64.AppImage

Builds are not signed. On macOS strip the quarantine flag once:

xattr -dr com.apple.quarantine "/Applications/Lens.app"

On Windows, SmartScreen → More info → Run anyway.

On Linux, make the AppImage executable once:

chmod +x Lens-2.0.5-linux-x86_64.AppImage

Then run it directly:

./Lens-2.0.5-linux-x86_64.AppImage

Source

Architecture notes, IPC protocol, security model: see CLAUDE.md.

Full Changelog: 2.0.4...2.0.5

2.0.4

What's new in 2.0.4

A performance and reliability release for large Claude Code and Codex histories.

• Instant Claude Code ⇄ Codex switching — Lens keeps each source's session inventory and Usage snapshot ready in memory, paints the selected source immediately, and refreshes only that source in the background.
• A session cache that stays under control — Claude Code and Codex now use separate compact cache files. Recent token events stay exact for rolling windows, older events fold into daily totals, long session previews are capped, and large inventories are stored in bounded atomic shards instead of one ever-growing file.
• More reliable history refreshes — source-scoped revisions prevent stale or empty responses from replacing newer results. Transient filesystem errors preserve the last complete snapshot instead of making sessions disappear.
• Accurate Claude subagent usage — parent sessions track the exact subagent set that was folded into their totals, preventing repeated scans from double-counting tokens while retaining the last complete result during partial read failures.
• Better Usage recovery — Usage data is cached independently for Claude Code and Codex, refreshed after source activation, and now shows a retry action when loading fails.

Everything from 2.0.3 is unchanged — Linux AppImage support, grouped Codex subagents, clean session titles, stable history navigation, search timeline, inline subagent and workflow transcripts, custom profile, workspace browser, light and dark themes, UI in 10 languages, and no network beyond the opt-in quota probe.

Downloads

• macOS Apple Silicon — Lens-2.0.4-arm64-mac.zip
• macOS Intel — Lens-2.0.4-mac.zip
• Windows x64 — Lens-2.0.4-win.zip
• Linux x64 — Lens-2.0.4-linux-x86_64.AppImage

Builds are not signed. On macOS strip the quarantine flag once:

xattr -dr com.apple.quarantine "/Applications/Lens.app"

On Windows, SmartScreen → More info → Run anyway.

On Linux, make the AppImage executable once:

chmod +x Lens-2.0.4-linux-x86_64.AppImage

Then run it directly:

./Lens-2.0.4-linux-x86_64.AppImage

Source

Architecture notes, IPC protocol, security model: see CLAUDE.md.

Full Changelog: 2.0.3...2.0.4

2.0.3

What's new in 2.0.3

A focused patch release that makes session history cleaner, more stable, and available on Linux.

• Linux x64 download — Lens is now available as a portable AppImage. It uses a static runtime with no installer, root access, or FUSE2 dependency.
• No more duplicate Codex subagent sessions — Codex rollouts that belong to the same root thread are grouped into a single history item, with the real root conversation preferred over its subagents.
• Cleaner, smarter session titles — pasted-image placeholders such as [Image #1] and <image ...> no longer leak into Claude Code or Codex titles. Sessions that begin with ABP support, GitHub, or Taskever links now show concise labels with useful reference details.
• More stable history navigation — switching sources, filters, sorting, projects, or time ranges resets the virtualized list correctly, preventing stale rows from the previous view.
• Improved row layout — long project and branch names truncate cleanly without hiding token or message counts, and the quick-favorite action no longer shifts the row layout.

Everything from 2.0.2 is unchanged — the search timeline, subagent and workflow transcripts, merged token totals, custom profile, Claude Code ⇄ Codex switching, workspace browser, light and dark themes, UI in 10 languages, and no network beyond the opt-in quota probe.

Downloads

• macOS Apple Silicon — Lens-2.0.3-arm64-mac.zip
• macOS Intel — Lens-2.0.3-mac.zip
• Windows x64 — Lens-2.0.3-win.zip
• Linux x64 — Lens-2.0.3-linux-x86_64.AppImage

Builds are not signed. On macOS strip the quarantine flag once:

xattr -dr com.apple.quarantine "/Applications/Lens.app"

On Windows, SmartScreen → More info → Run anyway.

On Linux, make the AppImage executable once:

chmod +x Lens-2.0.3-linux-x86_64.AppImage

Then run it directly:

./Lens-2.0.3-linux-x86_64.AppImage

Source

Architecture notes, IPC protocol, security model: see CLAUDE.md.

Full Changelog: 2.0.2...2.0.3

2.0.2

What's new in 2.0.2

Another small patch on top of 2.0.1.

• Better session titles — titles now prefer a named label from the conversation (e.g. a URL you pasted) over the auto-generated summary, so the list reads closer to what the session was actually about. Image-only turns are counted, and the project label is derived from the launch cwd for a more accurate workspace.
• Search is a timeline — the in-conversation search dropped the old list / card layouts for a single timeline. Results are grouped under relative date headers (Today / Yesterday / …) and each row shows when the session was created.
• Steadier window activation — switching back to Lens no longer flickers on activation.
• Cross-platform wording — UI strings that used macOS-only terms like "Finder" / "iTerm" / "menu bar icon" now use neutral wording across all 10 languages, so Windows and Linux read correctly.

Everything from 2.0.0 / 2.0.1 is unchanged — subagent & workflow transcripts, in-conversation search, merged token totals, custom profile, Claude Code ⇄ Codex switching, the workspace browser, light / dark themes, UI in 10 languages, and no network beyond the opt-in quota probe.

Downloads

• macOS Apple Silicon — Lens-2.0.2-arm64-mac.zip
• macOS Intel — Lens-2.0.2-mac.zip
• Windows x64 — Lens-2.0.2-win.zip

Builds are not signed. On macOS strip the quarantine flag once:

xattr -dr com.apple.quarantine "/Applications/Lens.app"

On Windows, SmartScreen → More info → Run anyway.

Source

Architecture notes, IPC protocol, security model: see CLAUDE.md.

Full Changelog: 2.0.1...2.0.2

2.0.1

What's new in 2.0.1

A small patch release on top of 2.0.0.

• Smoother history scrollback — scrolling up to load older turns in a conversation no longer snaps the view back to the latest message. The turn you
  were reading stays exactly where it was. (Chromium's native scroll anchoring was double-correcting the position the loader already restored.)
• Demo mode polish — demo mode now covers deep search (snippets + “matched in” chips on the sample data), and no longer renders your real profile
  avatar in the sample conversation.

Everything from 2.0.0 is unchanged — subagent & workflow transcripts, in-conversation search, merged token totals, custom profile, Claude Code ⇄ Codex
switching, the workspace browser, light / dark themes, UI in 10 languages, and no network beyond the opt-in quota probe.

Downloads

• macOS Apple Silicon — Lens-2.0.1-arm64-mac.zip
• macOS Intel — Lens-2.0.1-mac.zip
• Windows x64 — Lens-2.0.1-win.zip

Builds are not signed. On macOS strip the quarantine flag once:

xattr -dr com.apple.quarantine "/Applications/Lens.app"

On Windows, SmartScreen → More info → Run anyway.

Source

Architecture notes, IPC protocol, security model: see CLAUDE.md.

Full Changelog: 2.0.0...2.0.1

Full Changelog: 2.0.0...2.0.1

2.0.0

What's new in 2.0.0

• Subagent & workflow transcripts — expand any Agent or Workflow tool call inside a conversation to read the subagent's full transcript inline:
  its prompt, reasoning, every tool call and result — the part the CLI hides. Workflow runs render as a phase → agent tree with per-agent tokens and
  status. Deep search and the token dashboards now cover subagent and workflow activity too.
• In-conversation search — search inside an open session with match highlighting and prev/next navigation, on top of the global ⌘K full-text search.
• More accurate token totals — Usage now merges Claude Code's own ~/.claude/stats-cache.json, so the dashboards line up with what /stats reports.
• Custom profile — set a display name and avatar (uploaded image or initial), per source.
• Rebuilt internals — the Electron main process was split from a single 3,000-line file into ~25 focused modules (parsers, IPC, search, usage, auth,
  fs-safety). Streaming JSONL parsing, atomic writes, path containment and symlink rejection throughout.

Everything from 1.0.0 is still here: ⌘K search across ~/.claude/projects/ and ~/.codex/sessions/, one-click resume in Terminal / iTerm, token
dashboards with heatmap, opt-in live subscription quota, the workspace browser, Claude Code ⇄ Codex switching, light / dark themes, UI in 10 languages,
and no network beyond the opt-in quota probe.

Downloads

• macOS Apple Silicon — Lens-2.0.0-arm64-mac.zip
• macOS Intel — Lens-2.0.0-mac.zip
• Windows x64 — Lens-2.0.0-win.zip

Builds are not signed. On macOS strip the quarantine flag once:

xattr -dr com.apple.quarantine "/Applications/Lens.app"

On Windows, SmartScreen → More info → Run anyway.

Source

Architecture notes, IPC protocol, security model: see CLAUDE.md.

Full Changelog: 1.0.0...2.0.0

Full Changelog: 1.0.0...2.0.0

1.0.0

First public release of Lens — a desktop browser for local Claude Code and OpenAI Codex session history.

What's in it

• Search every conversation across ~/.claude/projects/ and ~/.codex/sessions/ by title, project, branch, model, or full-text JSONL grep. ⌘K opens
  search anywhere.
• Resume in one click — open the session in Terminal / iTerm at the original cwd, or copy the claude --resume <id> / codex resume <id> command.
• Token-spend dashboards — 5h / 24h / 7d / 30d buckets, broken down by model and project, with an activity heatmap.
• Live subscription quota — opt-in probe of Anthropic for real 5h / weekly remaining; Codex limits come from a local codex app-server JSON-RPC
  probe. Off by default, behind explicit consent.
• Workspace browser — CLAUDE.md / AGENTS.md, Skills, Commands, Hooks / Rules, Plugins, Settings — everything that shapes the agent, in one view.
• Multi-tool, one app — flip between Claude Code and Codex from the sidebar; sessions, favorites, charts all rescope to the active source.
• Light / Dark themes, UI in 10 languages.
• No network beyond the opt-in quota probe. All session content stays on disk.

Downloads

• macOS Apple Silicon — Lens-1.0.0-arm64-mac.zip
• macOS Intel — Lens-1.0.0-mac.zip
• Windows x64 — Lens-1.0.0-win.zip

Builds are not signed yet. On macOS strip the quarantine flag once:

xattr -dr com.apple.quarantine "/Applications/Lens.app"

On Windows, SmartScreen → More info → Run anyway.

Source

Architecture notes, IPC protocol, security model: see CLAUDE.md.

Full Changelog: https://github.com/maliming/Lens/commits/1.0.0