Skip to content
Back to search

godwit

Open-source, AI-native desktop email client for macOS, Windows and Linux. Your mail stays yours: data is masked locally before any model sees it.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked yesterday

Check it deeper on your machine

It has changed since its scan on 18 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/godwit-email/godwit with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/godwit-email/godwit'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/godwit-email--godwit/badge.svg)](/listings/godwit-email--godwit)

HTML

<a href="/listings/godwit-email--godwit"><img src="/api/listings/godwit-email--godwit/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

Download the latest build from [godwit.email](https://godwit.email/#download):

- **macOS**: the `.dmg`, or with [Homebrew](https://brew.sh):

  brew install godwit-email/tap/godwit

- **Windows**: the installer, which installs for the current user without admin rights, or [Godwit on the Microsoft Store](https://apps.microsoft.com/detail/9NS3Q2CGWD12), which the Store updates. - **Linux**: the `.deb`, or install for the current user (no root) with:

  curl -fsSL https://dl.godwit.email/install.sh | sh

Verify a download

Every release is built from its tag by [release.yml](.github/workflows/release.yml), which signs [build provenance](https://docs.github.com/en/actions/security-for-github-actions/using-artifact-attestations/using-artifact-attestations-to-establish-provenance-for-builds) for each file it uploads. Check that a download was built here, and from which commit, with the [GitHub CLI](https://cli.github.com):

gh attestation verify godwit-1.30.0-arm64.dmg --repo godwit-email/godwit

For the Microsoft Store version, verify `Godwit.exe` in its install folder (`Get-AppxPackage BaranWang.Godwit` shows where). The app also records its commit: `go version -m` on the executable prints it as `vcs.revision`.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 177 lines · 1 finding marked
  1. <p align="center"><img src="assets/icon.png" width="128" alt=""></p>
  2. <h1 align="center">Godwit</h1>
  3. <p align="center">An open-source, AI-native email client you can extend.<br>AI helps with your mail. Your mail stays yours.</p>
  4. <p align="center">
  5. <a href="https://godwit.email/#download">Download</a> ·
  6. <a href="https://godwit.email">Website</a> ·
  7. <a href="CHANGELOG.md">Changelog</a>
  8. </p>
  9. https://github.com/user-attachments/assets/29ee980c-73a5-47f0-a736-b01828c22785
  10. Godwit is a desktop email client for macOS, Windows and Linux. It works with any IMAP/SMTP account and ships with an AI assistant, Wit, that reads, summarizes, translates and drafts mail with the model you choose. Before anything goes to a cloud model, names, account numbers, phone numbers and keys are masked on your machine. Everything AI in it, the built-in features included, runs through the same extension points open to you: drop in a `SKILL.md` and a button appears.
  11. The name comes from the bar-tailed godwit, which holds the record for the longest non-stop bird flight.
  12. ## Features
  13. - **Mail**: IMAP/SMTP accounts with sync, offline changes, conversations, and HTML compose with reply, forward, CC/BCC, drafts and recipients completed from your contacts. Setup is detected for Gmail, Outlook (sign in with Microsoft), iCloud, Yahoo, AOL, QQ Mail, 163/126 Mail, Tencent Exmail, Lark/Feishu and DingTalk Mail, hosted corporate mail by its MX records, and any other IMAP server. Local `.eml` files can be imported into a local archive.
  14. - **Views**: questions that stay open in the sidebar, such as *To handle*, built from conditions and groups, across all your accounts. They never change the mail itself.
  15. - **Sign-in codes and links**: codes and magic links in 14 languages are recognized as they arrive, with a banner to copy or open them and a list of recent ones in the tray.
  16. - **Organize**: labels, set by the model or by hand and synced as IMAP keywords; local rules (when … if … then …) with condition groups; one-click unsubscribe (RFC 8058); and a **Contacts** page with unsubscribe, archive all and block per sender.
  17. - **Search**: ⌘K finds mail, conversations, contacts and attachments.
  18. - **Wit**: an agent that answers questions about your mail, reads attachments (PDF, Office, CSV) and drafts replies. It writes drafts and never sends. Anything that leaves your machine, such as an unsubscribe or an opened link, waits for your approval, which names where it goes.
  19. - **Privacy masking**: text bound for a cloud model or translation service is checked on your machine, with a local recognition model, for keys, ID and financial numbers, codes, phone numbers, email addresses, names, addresses and accounts. Each kind is masked (replaced by a placeholder and put back only on your side), warned about, or blocked, and every request is in the masking log.
  20. - **Security**: sender verification badges, display-name spoofing protection and AI fraud classification; remote images load through a privacy proxy.
  21. - **AI actions**: summarize, translate, adjust tone and length, and quick replies, on a message, a selection or a draft. On macOS 26 and later, mail can also be translated on the Mac with the system's own translation, free and without a model (Settings › Intelligence › Features › Translate with › System translation).
  22. - **Your models**: any OpenAI-compatible (Chat Completions or Responses) or Anthropic-compatible service, including local ones like Ollama and LM Studio. API keys stay in the system keychain.
  23. - **Extensions**:
  24. - **Skills**: a `SKILL.md` ([Agent Skills](https://agentskills.io)) in the data directory's `skills/` folder becomes a Wit skill, or an action button with `godwit-action-*` metadata.
  25. - **Plugins**: install from the plugin directory in Settings › Extensions, or write your own: TypeScript plugins with declared permissions add hooks, actions, cards and Wit tools. Types are in [`sdk/godwit.d.ts`](sdk/godwit.d.ts), published as `@godwit/sdk` (`npm i -D @godwit/sdk`). Plugins can read mail and write drafts; none can send.
  26. - **Native plugins**: a shared library behind a small C ABI ([`sdk/native/godwit_plugin.h`](sdk/native/godwit_plugin.h)), for what a sandbox cannot do. It runs with all of Godwit's rights, so Godwit shows the risk and asks you to allow that exact file; a changed file needs your permission again.
  27. - **MCP servers**: give Wit external tools. Each server is approved once, and each write call every time.
  28. - **For other agents**: `godwit mcp` is an MCP server that lets Claude, Claude Code, Codex, Cursor and any other MCP app read your mail and create drafts. Sending through MCP is your setting: by default each send waits for you to confirm it, and you can turn it off or let it send directly. Turn on the Local API under **Settings › Intelligence › AI apps** and copy the client configuration from there.
  29. - **Updates itself** from dl.godwit.email (the Microsoft Store version is updated by the Store).
  30. ## Install
  31. Download the latest build from [godwit.email](https://godwit.email/#download):
  32. - **macOS**: the `.dmg`, or with [Homebrew](https://brew.sh):
  33. ```sh
  34. brew install godwit-email/tap/godwit
  35. ```
  36. - **Windows**: the installer, which installs for the current user without admin rights, or [Godwit on the Microsoft Store](https://apps.microsoft.com/detail/9NS3Q2CGWD12), which the Store updates.
  37. - **Linux**: the `.deb`, or install for the current user (no root) with:
  38. ```sh
  39. curl -fsSL https://dl.godwit.email/install.sh | sh
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 52 on GitHub
  40. ```
  41. ### Verify a download
  42. Every release is built from its tag by [release.yml](.github/workflows/release.yml), which signs [build provenance](https://docs.github.com/en/actions/security-for-github-actions/using-artifact-attestations/using-artifact-attestations-to-establish-provenance-for-builds) for each file it uploads. Check that a download was built here, and from which commit, with the [GitHub CLI](https://cli.github.com):
  43. ```sh
  44. gh attestation verify godwit-1.30.0-arm64.dmg --repo godwit-email/godwit
  45. ```
  46. For the Microsoft Store version, verify `Godwit.exe` in its install folder (`Get-AppxPackage BaranWang.Godwit` shows where). The app also records its commit: `go version -m` on the executable prints it as `vcs.revision`.
  47. ## Command line
  48. ```
  49. godwit [--data-dir DIR] the desktop app
  50. godwit --headless [--data-dir DIR] serve the Local API without a window
  51. godwit call [--data-dir DIR] METHOD [JSON_ARGS_ARRAY] call the running Godwit once
  52. godwit mcp [--data-dir DIR] an MCP server on stdio for agents
  53. godwit dev-sync-db replace the dev database from production (development builds only)
  54. godwit --version
  55. ```
  56. ### Receive mail from login on Linux
  57. On macOS and Windows, 后台收信 › 一直继续 starts Godwit's backend when you log in. Linux leaves that to you: run `godwit --headless` as a systemd user service, and the desktop app connects to it when you open it. Save this as `~/.config/systemd/user/godwit.service` (adjust the path to `godwit`):
  58. ```ini
  59. [Unit]
  60. Description=Godwit backend
  61. # After the desktop session has exported DISPLAY or WAYLAND_DISPLAY: the
  62. # backend decides at start whether it can show notifications and a tray.
  63. After=graphical-session.target
  64. PartOf=graphical-session.target
  65. [Service]
  66. ExecStart=%h/.local/bin/godwit --headless
  67. Restart=on-failure
  68. [Install]
  69. WantedBy=graphical-session.target
  70. ```
  71. ```sh
  72. systemctl --user enable --now godwit
  73. ```
  74. A backend you start this way keeps running when the app quits and always serves the Local API to other programs of your user.
  75. ### Credentials on a server without a keychain
  76. Godwit keeps passwords, refresh tokens and API keys in the system keychain. A Linux server with no desktop session or Secret Service has none; there you can choose an encrypted file instead (AES-256-GCM), with the key in a separate file you manage. Set both variables for the backend (`godwit --headless`), for example in the systemd unit's `[Service]` section:
  77. ```sh
  78. mkdir -p ~/.config/godwit ~/.local/share/godwit
  79. (umask 077 && openssl rand -hex 32 > ~/.config/godwit/keyring.key)
  80. ```
  81. ```ini
  82. Environment=GODWIT_KEYRING_FILE=%h/.local/share/godwit/keyring
  83. Environment=GODWIT_KEYRING_KEY_FILE=%h/.config/godwit/keyring.key
  84. ```
  85. The key file holds 64 hex characters and must not be readable by anyone else (0600 or narrower), or the backend refuses to start; so does setting only one of the two variables. Godwit creates the keyring file (0600), and a `.lock` file beside it, on the first credential it saves; its directory must exist. Backends of several data directories can share one keyring file. This works on Linux and macOS; on Windows, which always has its credential manager, the variables are refused. Without the variables nothing changes: credentials stay in the system keychain, and Godwit never falls back to a file on its own. Anyone with both files can read your credentials, so keep the key off backups that also hold the keyring.
  86. ## Development
  87. Godwit is written in Go on [MyGo](https://github.com/egoist/mygo): the main window is native UI, while compose, the Wit page and the message reader are React pages in `web/`. [mise](https://mise.jdx.dev) installs the pinned Go and Bun:
  88. ```sh
  89. mise install
  90. mise run generate # install web dependencies and generate Go/TypeScript code before Go tests
  91. mise run dev # run the app, reloading on changes
  92. mise run dev:sync-db # replace the dev database from production; stop both apps first
  93. go test ./... # Go tests
  94. mise run web:check
  95. mise run build # package for this machine into dist/
  96. ```
  97. Native and web UI translations share `internal/i18n/en.json` and `zh-Hans.json`, using ICU MessageFormat. Edit these catalogs, run `mise run generate` to update the Go and TypeScript accessors, and validate with `go tool mygo i18n check`. MyGo's generated Go/TypeScript accessors and client are ignored by Git; do not edit them directly. Development, packaging and `mise run web:check` / `web:test` generate them automatically; run `mise run generate` before using Go commands directly.
  98. Development builds (`mygo dev` and `go run`) use a separate `Godwit-dev` data
  99. directory beside production's `Godwit` directory (on Windows, `~/.godwit-dev`
  100. beside `~/.godwit`). GUI, headless, `call` and `mcp` all use the matching default;
  101. an explicit `--data-dir` still takes precedence. Release builds keep their existing
  102. directory. `MYGO_ENV=production` selects production defaults for an unpackaged binary.
  103. To start dev with production mail and settings, quit both instances and run
  104. `mise run dev:sync-db`, then `mise run dev`. This **overwrites the dev database**.
  105. It copies committed WAL data, validates and migrates only the copy, and leaves
  106. the production database untouched. It refuses to run while either directory is
  107. owned by a running instance. A database already upgraded by an older dev run is
  108. not downgraded by this command.
  109. The sync copies only the database. Dev gets a fresh keychain identity, so enter
  110. account credentials and model/plugin/MCP secrets again in dev. Cached attachments
  111. are downloaded again; draft attachments and outbox files are not copied, and their
  112. file references are cleared to avoid using production or stale dev files. Re-add
  113. draft attachments before sending from dev. Skills and plugin files are not
  114. copied. After you sign in, dev can sync and change the same remote mailbox.
  115. Layout:
  116. | Path | |
  117. |---|---|
  118. | `core/` | the mail engine and service: sync, storage, send, AI, plugins, skills |
  119. | `app/` | the native UI |
  120. | `web/`, `webui/` | the web pages and their Go side |
  121. | `cmd/godwit/` | the executable: GUI, headless, `call`, `mcp` |
  122. | `mcpserver/`, `rpc/` | the MCP server and the Local API |
  123. | `sdk/` | plugin types |
  124. | `docs/` | design specs and plans |
  125. | `site/` | [godwit.email](https://godwit.email), a Cloudflare Worker (`mise run site:dev`) |
  126. The homepage's demo window and main download button share browser-platform detection. macOS shows traffic lights; Windows shows the app caption and right-hand window controls; Linux also uses right-hand controls. The window controls are decorative, not actions that close or resize the website.
  127. Client CI always runs a lightweight changes check, but skips the desktop matrix and embedded-web checks when all changed paths are under `site/`. The separate Site workflow checks the website and deploys it from main. Shared configuration changes, such as `mise.toml`, and mixed site/client changes still run client CI.
  128. Commit messages and PR titles follow [Conventional Commits](https://www.conventionalcommits.org); [release-please](https://github.com/googleapis/release-please) turns them into versions and the changelog. Merging its release PR builds every platform and uploads the installers and updates to the R2 bucket behind dl.godwit.email; each platform's update manifest goes up last, and installed apps update from it as soon as it is there.
  129. Commits whose changed files are all under `site/` are excluded from the application's version calculation and changelog by release-please's `exclude-paths`. Mixed changes, including a site change together with the root `README.md`, still participate in application releases. The same filter drops commits that change no files, so a `Release-As:` footer only takes effect on a commit that changes a file outside `site/`.
  130. ## License
  131. [Apache-2.0](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.