# Herald

> Herald is a keyboard-first and mouse-friendly terminal mail and calendar workspace for reading, composing, searching, planning, cleaning up, and automating daily communication. It supports demo mode, IMAP/SMTP setup, calendar sources, optional AI features, MCP integration, and SSH mode.

## Website

- [Homepage](https://herald-mail.app/): Product overview, install command, demo mode, Timeline and Calendar screenshots, MCP examples, limitations, and beta signup.
- [Contact](https://herald-mail.app/contact/): Contact form for questions and beta access requests.
- [Feedback](https://herald-mail.app/feedback/): Product feedback, bug reports, and feature ideas.
- [Privacy Policy](https://herald-mail.app/privacy/): Website and beta privacy practices.
- [Terms of Service](https://herald-mail.app/terms/): Terms for using the Herald website and public beta materials.

## Documentation

- [Docs overview](https://docs.herald-mail.app/): Start here for the full Herald manual and quickest install paths.
- [Install and run](https://docs.herald-mail.app/getting-started/): Installation, first launch, and local development setup.
- [First-run wizard](https://docs.herald-mail.app/first-run-wizard/): Guided account setup flow.
- [Run without email](https://docs.herald-mail.app/demo-mode/): Demo mode using synthetic data.
- [Provider setup](https://docs.herald-mail.app/provider-setup/): Supported provider paths and setup choices.
- [What's New in v0.5](https://docs.herald-mail.app/whats-new-in-v0-5/): v0.5 release delta, Calendar screenshots, multi-account scope, and updated demo evidence.
- [Gmail IMAP](https://docs.herald-mail.app/gmail-setup/): Gmail IMAP and app-password setup.
- [Custom IMAP](https://docs.herald-mail.app/custom-imap/): Custom IMAP/SMTP configuration.
- [Global UI](https://docs.herald-mail.app/using-herald/global-ui/): Navigation, tabs, folder sidebar, status bar, help, logs, and focus behavior.
- [Timeline](https://docs.herald-mail.app/using-herald/timeline/): Reading, previewing, searching, replying to, forwarding, starring, and managing messages.
- [Compose](https://docs.herald-mail.app/using-herald/compose/): New mail, replies, forwards, Markdown preview, attachments, drafts, and AI assistance.
- [Calendar](https://docs.herald-mail.app/using-herald/calendar/): Week, day, three-day, agenda, search, event detail, RSVP, and source rail workflows.
- [Cleanup](https://docs.herald-mail.app/using-herald/cleanup/): Bulk cleanup, sender/domain grouping, archive/delete, rules, unsubscribe, and schedules.
- [Contacts](https://docs.herald-mail.app/using-herald/contacts/): Sender list, contact details, recent mail, and contact search.
- [Search](https://docs.herald-mail.app/features/search/): Keyword, body, and semantic search behavior.
- [AI Features](https://docs.herald-mail.app/features/ai/): Optional AI providers, classification, semantic search, and privacy notes.
- [Chat Panel](https://docs.herald-mail.app/features/chat/): Chat interface over mailbox context.
- [Rules and Automation](https://docs.herald-mail.app/features/rules-automation/): Saved rules and automated cleanup.
- [Attachments](https://docs.herald-mail.app/features/attachments/): Attachment viewing and saving.
- [Text Selection](https://docs.herald-mail.app/features/text-selection/): Copying and selecting message text.
- [Settings](https://docs.herald-mail.app/features/settings/): Runtime and account settings.
- [Themes](https://docs.herald-mail.app/themes/): Built-in theme gallery, one-off `-theme` launch examples, and local YAML theme guidance.
- [Sync and Status](https://docs.herald-mail.app/features/sync-status/): Sync lifecycle, status messages, and progress.
- [Destructive Actions](https://docs.herald-mail.app/features/destructive-actions/): Confirmation and safety behavior for deletes and similar actions.
- [MCP Server](https://docs.herald-mail.app/advanced/mcp/): MCP server usage for trusted clients.
- [MCP setup](https://docs.herald-mail.app/mcp-setup/): MCP setup and client configuration.
- [SSH Mode](https://docs.herald-mail.app/advanced/ssh-mode/): SSH-based Herald access.
- [Daemon Commands](https://docs.herald-mail.app/advanced/daemon/): Background daemon commands.
- [Demo GIF Workflow](https://docs.herald-mail.app/advanced/demo-gifs/): Capturing docs and demo GIF assets.
- [Privacy and Security](https://docs.herald-mail.app/security-privacy/): Security model, data handling, and privacy expectations.
- [All Keybindings](https://docs.herald-mail.app/reference/keybindings/): Full keyboard shortcut reference.
- [Config Reference](https://docs.herald-mail.app/reference/config/): Configuration file reference.
- [Troubleshooting](https://docs.herald-mail.app/troubleshooting/): Common problems and fixes.
- [Uninstall](https://docs.herald-mail.app/uninstall/): Removing Herald and local data.

## GitHub

- [Source repository](https://github.com/herald-email/herald-mail-app): Herald application source, issues, and development history.
- [Issues](https://github.com/herald-email/herald-mail-app/issues): Bug reports and feature requests.
- [Releases](https://github.com/herald-email/herald-mail-app/releases): Published release artifacts and changelogs.
- [v0.5.0-beta.1 release](https://github.com/herald-email/herald-mail-app/releases/tag/v0.5.0-beta.1): Calendar workspace, multi-source identity, Timeline cleanup grouping, account-aware mail behavior, and calendar-aware MCP guardrails.
- [Go install path](https://github.com/herald-email/herald-mail-app/tree/main/cmd/herald): CLI package used by `go install github.com/herald-email/herald-mail-app/cmd/herald@latest`.

## Sitemaps and Crawling

- [Website robots.txt](https://herald-mail.app/robots.txt): Allows crawling and points to the website sitemap index.
- [Website sitemap index](https://herald-mail.app/sitemap-index.xml): Sitemap index for the marketing website.
- [Website sitemap](https://herald-mail.app/sitemap-0.xml): Website page URLs.
- [Docs sitemap index](https://docs.herald-mail.app/sitemap-index.xml): Sitemap index for the docs site.
- [Docs sitemap](https://docs.herald-mail.app/sitemap-0.xml): Full docs page URLs.