deniz.in

Markets

Weather

Loading weather

· via Hacker News – Front Page (hnrss.org)

Parcel: open-source Linux mail client written in Zig reaches Hacker News front page

Parcel, an open-source email client for Linux written in Zig, reached Hacker News' front page. It offers a keyboard-driven interface, stacked label filters and local search across Gmail, Fastmail and any JMAP server.

Parcel: open-source Linux mail client written in Zig reaches Hacker News front page

An open-source email client for the Linux desktop called Parcel has drawn attention after reaching the front page of Hacker News. According to the project page linked from the listing, the client is written in Zig together with the siv toolkit and works with Gmail, Fastmail or any other JMAP server. Until an account is added, it displays made-up sample messages so the interface can be explored first.

One list, shaped by stacked label filters

Parcel shows mail as a single list whose contents are chosen by label filters that stack: Inbox on its own, Inbox combined with Work, or any label by itself. A thread opens over the list rather than replacing it. Quoted replies nest, with each nesting level separated by its own horizontal rule, and HTML messages render as the sender laid them out. Multiple accounts each keep a separate list, the header switches between them, and Ctrl+1 through Ctrl+9 select accounts directly in sorted order.

Keyboard-first, with Vim flavour

Every action in Parcel is bound to a key, and Ctrl+K opens a palette listing them all, including the Add account flow. Pressing r starts a reply on top of a quotation of the message being answered; the composer follows Vim's keybindings and adds a toolbar for emphasis, links, quotes and lists. Search starts with / and results update while you type. It accepts Gmail's search operators whichever account is active, and after an operator such as from: it suggests the people, labels or values that would fit.

A local index answers most searches

Parcel keeps its own index of your mail. According to the documentation, once it has worked through the whole mailbox it answers most searches locally, without asking the server.

Building and installing

Compiling Parcel requires Zig 0.17.1, the just command runner, a Wayland compositor, and development files for libcurl, Wayland, xkbcommon, Fontconfig and the Vulkan headers. The project provides package-install commands for Debian and Ubuntu, Fedora, and Arch. just run builds and launches the client; just install places the binary in ~/.local/bin and installs a desktop entry and icon in ~/.local/share so that app launchers list Parcel, with an optional prefix for installing elsewhere. For contributors, mise sets up the toolchain, including bs, the debug-mode compiler used for development builds that also lints; just ci builds the client and runs tests and lint, and AGENTS.md records the project's conventions.

Sign-in details

Gmail accounts are authenticated in the browser using Parcel's own Google client, which release builds carry; the refresh token is stored in the account's directory with permissions that keep it readable only by the user. Where a Google Workspace administrator blocks apps they have not approved, the documentation suggests asking them to trust Parcel's client ID, or using a client of your own, which source builds without a bundled Google client secret require anyway. While a Google project's app remains in testing mode, sign-ins expire after seven days, and parcel login gmail NAME re-authenticates. Fastmail needs no configuration because Parcel registers itself during sign-in, and other JMAP servers work where they expose OAuth for desktop apps; both paths also accept an API token instead of browser sign-in, stored per account alongside the OAuth credential.

Why it matters

For Linux users who prefer driving software from the keyboard, Parcel brings that workflow to a native desktop mail client rather than a terminal one, and its JMAP support means it is not tied to Gmail. The stacked-label model maps directly onto how Gmail organises mail, while the local index promises search responses that do not wait on the network. Just as notable is the implementation: a graphical, Wayland-native desktop application written in Zig is still an uncommon sight, and a front-page reception suggests real appetite for both the design approach and the toolchain behind it.

  • #linux
  • #email
  • #zig
  • #open-source
  • #jmap

Related posts