Skip to content
Herald Docs

What's New in v0.6

The v0.6 beta line turned Herald into a source-aware mail and calendar workspace. It is now a historical release line; the current beta line starts at v0.7.0-beta.1.

Release Delta

Section titled “Release Delta”

These are the changes most visible to people using Herald every day. The theme of the release is provider-aware setup, safer mutations, and richer reading workflows without leaving the terminal.

  • Gmail OAuth now uses Herald’s Gmail API mail source for core sync, body reads, drafts, mailbox mutations, and send, while Gmail App Password remains the IMAP/SMTP fallback.
  • Google Calendar OAuth and CalDAV calendar sources are first-class account sources, with cache-backed Week, Day, 3-Day, Agenda, Search, and Event Detail views.
  • Calendar mutations are provider-backed: create, edit, delete, RSVP, attendee editing, reminders, recurrence edits, and endpoint-specific travel timezones write through the provider before cache updates.
  • Email previews can import text/calendar parts and .ics attachments into a selected writable calendar, including duplicate UID update/skip handling.
  • Multi-account mail behavior is source-aware, including account-scoped folder trees, source badges, From routing in Compose, draft handling, and scoped MCP/daemon mutation guards.
  • Preview rendering is safer: bounded native image previews, opt-in remote HTML image reveal with tracker sanitization, sanitized OSC 8 link targets, and local fallback links/placeholders.
  • Read-only previews gained practical cursor selection, mouse drag selection, visual-range copy, line/body copy, and richer clipboard payloads where the platform supports them.
  • Compose gained an external-editor body flow, preserved reply/forward context, account-scoped signatures, AI toolbar polish, and Gmail API draft/send parity.
  • Contacts can import from native macOS Contacts where supported, and layout-correct keyboard routing keeps printable text safe in Compose, search, prompts, settings, and editor-like fields.
  • Local notifications and herald://mail/... deep links can return to folder, message, sender, search, or compose context where platform support exists.
  • First-run and Settings flows are faster and safer, with Google account setup, account/calendar source management, AI repair states, privacy-safe logs, and explicit -unsafe-logs diagnostics.

Beta Notes

Section titled “Beta Notes”

Each beta in the v0.6 line tightened a different part of the new source platform. This breakdown helps testers decide what to re-check after upgrading.

  • v0.6.0-beta.1 graduates Google OAuth onboarding and the Gmail API mail source.
  • v0.6.1-beta.1 fixes calendar agenda clock drift, live multi-account folder refresh, and two-account mail operations.
  • v0.6.2-beta.1 adds the latest calendar create guidance and preview cursor-selection/rich-copy polish.
  • v0.6.3-beta.1 fixes live signature newline preservation and Timeline-initiated Compose navigation regressions before the v0.7 capability release.

Demo Highlights

Section titled “Demo Highlights”

The new demo media focuses on flows that changed after v0.5. These GIFs run against deterministic demo data, so they do not touch a real inbox or provider account.

Calendar workspace demo

Calendar invitation import demo

Preview selection and linked image demo

Preserved reply Compose demo

How To Try It

Section titled “How To Try It”

Demo mode is the fastest way to explore the v0.6 workflows without connecting mail. Use a release or Homebrew binary for OAuth defaults; source builds need local OAuth defaults before Gmail OAuth or Google Calendar OAuth can open a browser flow.

Terminal window
make build
./bin/herald --demo
./bin/herald --demo --demo-keys
./bin/herald --demo --open 'herald://mail/search?folder=INBOX&q=invoice'

Press 3 for Calendar, Ctrl+N or n to create an event in the default profile, e to edit one, / to search events, and i from an email preview containing an invitation to create or update a calendar event. Emacs-profile users keep Ctrl+N for movement and use n to create events.

Next Release

Section titled “Next Release”

The v0.7 release introduced Herald Memories, Compose Radar, Gollem-backed chat intents, macOS preview printing, and AI role assignment polish. See What’s New in v0.7 for the current release checklist.

Previous Release

Section titled “Previous Release”

The v0.5 release introduced Calendar as a top-level surface and landed the first broad source-identity work. See What’s New in v0.5 for that historical release checklist.