NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Go modules
Go modules, #596 by repository stars
Latest stable
v0.26.0
Last release 17 days ago
05 Nov 2026
Ships on a steady schedule
a new release about every 9 days
Nearly every release is documented
notes for 31 of 31 stable releases
Nothing withdrawn
no release was ever pulled
6 months old
105 releases · first in 2026
Drag across the ruler to compare, or tap a release to open it.
…and M4A audio arrive intact, and networking security fixes.
Highlights: fresh own replies mark chats read, broadcast sync avoids long stalls, business attachments and M4A audio arrive intact, and networking security fixes.
wacli send, preserving later arrivals; history imports, duplicate replies, reactions, edits, calls, and poll votes leave unread state intact. Thanks @nicolasbiondic (#533).sync --once. Thanks @ViaxCo (#550)..m4a files as audio/mp4 instead of the system MIME table's audio/mp4a-latm, which WhatsApp clients hide. Thanks @ViaxCo (#549).protocolMessage:APP_STATE_SYNC_KEY_SHARE instead of protocolMessage), so a (message) placeholder from an internal control can be told apart from a missed mutation. Thanks @3li7alaki (#547, #546).Your coding agent can read these notes before it upgrades. Set up the MCP server →
One column per month.
Nothing published for this version
Highlights: reliable slow file and voice uploads, plus complete decoding of wrapped history and video notes.
Highlights: reliable slow file and voice uploads, plus complete decoding of wrapped history and video notes.
Send: extend the send file and send voice attempt timeout by one second per 64 KiB, so uploads slower than 45 seconds no longer fail with send timed out after 45s. Thanks @ViaxCo (#535, #534).
Messages: read wrapped history payloads, grouped iPhone contact-card fields, and round video notes with their media and reply context. Thanks @emanuma03-alt (#529).
Dependencies: update the GraphQL parser after the 48-hour cooldown, preserving Go 1.27.0 and Node 24 minimums.
Highlights: opt-in file uploads up to 2048 MiB, durable poll vote retractions, and reliable uncached media downloads.
Highlights: opt-in file uploads up to 2048 MiB, durable poll vote retractions, and reliable uncached media downloads.
send file --max-size-mb to raise the 100 MiB upload cap per send, up to 2048 MiB, with bounded validation and forwarding to a running sync delegate. Thanks @aleixrodriala (#525).Send: quote file, voice, and sticker replies with stored text or media content, resolve phone/LID identities, and reject missing or unusable direct-ch
WACLI_LINKPREVIEW_SMALL=1 to restore inline-only thumbnails and the 300 KiB download cap. Thanks @samuba (#510).WACLI_LINKPREVIEW_ALLOW_CIDRS exceptions for trusted networks, preserving default SSRF denial and independent webhook permissions. Thanks @samuba (#509).--account-wide consent and separate default-off --phonebook permission; mirror applied contact edits in order and retain recovery debt for incomplete batches. Thanks @nicolasbiondic and @muriloprataviera (#505, #500).Security: build source, CI, Docker, and release artifacts with Go 1.27.3 to fix GO-2026-6809 while retaining the Go 1.27.0 source minimum.
Security: build source, CI, Docker, and release artifacts with Go 1.27.3 to fix GO-2026-6809 while retaining the Go 1.27.0 source minimum.
Windows: use a current-user-only named pipe for sync delegation, avoiding crashes and restart loops caused by inaccessible AF_UNIX socket files (#511).
Dependencies: refresh WhatsApp protocol handling, utility and parser modules, SQLite WASM tooling, and pnpm 12.14.0 after the 48-hour cooldown, retaining Go 1.27.0 and Node 24 minimums.
Dependencies: update x/exp after the 48-hour cooldown while retaining the Go 1.27.0 source minimum and Go 1.27.2 build toolchain.
Sync: unarchive chats on eligible incoming messages when Keep chats archived is off, recover missing preferences on upgrade, and preserve newer unarchives across stale archive replays. Thanks @Luizssauro (#466).
Known issues: back up your archive before upgrading; upgraded stores can repeat archive-state recovery on every sync start, and a failed full replay can discard saved app state (#501).
…sends and chat recovery, and five networking security fixes.
Highlights: bounded message search context and cursor reads, a content-free incremental journal, safer sends and chat recovery, and five networking security fixes.
mark-read --receipts clear local unread metadata when no eligible incoming message is stored, report the zero-receipt result as local-only, and preserve arrivals during the clear. Thanks @nicolasbiondic (#491).Nothing published for this version
Highlights: opt-in full-history pairing, live presence events, media retry filters, and Go standard-library security fixes.
Highlights: opt-in full-history pairing, live presence events, media retry filters, and Go standard-library security fixes.
media retry --type to recover one kind of media, including voice notes with --type audio, while applying chat/date filters and row limits to matching messages. Thanks @zarmat99 (#450).contacts check to a running sync --follow process so registration lookups no longer fail on the store lock. Thanks @ceifa (#453, #425).Nothing published for this version
Nothing published for this version
Highlights: offline phone/LID resolution, confined uploads, authenticated media retries, and chat-state commands alongside sync.
Highlights: offline phone/LID resolution, confined uploads, authenticated media retries, and chat-state commands alongside sync.
contacts resolve for verified phone/LID pairs, with explicit unresolved results and read-only access alongside sync. Thanks @tsavo-at-pieces (#458).WACLI_MEDIA_ROOTS upload confinement, including symlink-aware CLI validation and confined file reads in sync daemons. Thanks @tsavo-at-pieces (#459).Nothing published for this version
Highlights: opt-in read receipts without app-state recovery, accurate unread counts, and stable chat activity order.
Highlights: opt-in read receipts without app-state recovery, accurate unread counts, and stable chat activity order.
mark-read --receipts through an independent network path, with bounded batches, safe unread boundaries, sync delegation, and privacy-aware outcome reporting. Thanks @zarmat99 and @Adi-A (#432, #433).Highlights: webhooks omit media keys, backfill follows verified phone/LID identities, and sync recovery survives interruptions.
Highlights: webhooks omit media keys, backfill follows verified phone/LID identities, and sync recovery survives interruptions.
--events without exposing raw cryptographic payloads. (#418, #419 - thanks @shishiv)Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Dependencies: refresh whatsmeow, Go networking and database tooling, vulnerability and dead-code checkers, GoReleaser 2.18.1, and pnpm 12.4.0 while re…
Highlights: mark chats read or unread while continuous sync owns the store.
mark-read and mark-unread through the same-store follow process, preserving read-only checks and command output; restart older daemons after upgrading. (#361, #380 - thanks @shishiv)Nothing published for this version
Highlights: bounded memory use when generating waveforms for long voice notes.
Highlights: bounded memory use when generating waveforms for long voice notes.
be50611
This commit was created on GitHub.com and signed with GitHub’s verified signature .
GPG key ID: B5690EEEBB952194
Verified Learn about vigilant mode .
Highlights: bounded memory use when generating waveforms for long voice notes.
SebTardif
Nothing published for this version
Highlights: faster, interruptible upgrades, offline group rosters, and explicit opt-in self-chat sends.
Highlights: faster, interruptible upgrades, offline group rosters, and explicit opt-in self-chat sends.
groups participants list for offline roster snapshots with roles and timestamps, and refresh participant snapshots with sync --refresh-groups. (#359, #381 - thanks @shishiv)send text --allow-self for direct and delegated self-chat attempts, retaining the default rejection and documenting acknowledgement-only delivery and daemon restart requirements. (#396 - thanks @frdteknikelektro)Nothing published for this version
Nothing published for this version
Highlights: more complete searchable message history, bounded backfill retries, and clearer guidance for commands used alongside continuous sync.
Highlights: more complete searchable message history, bounded backfill retries, and clearer guidance for commands used alongside continuous sync.
Z form. (#386, #388 - thanks @hchittanuru3)media download --read-only --output PATH bypasses the store lock held by continuous sync. (#387 - thanks @hchittanuru3)[Audio] display fallback; re-ingestion can correct legacy captions without migrating untouched rows. (#378 - thanks @hchittanuru3)groups list truncates matching results, including JSON output, and keep --events warnings machine-readable. (#360 - thanks @hchittanuru3)Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Auth: stop with an actionable error when WhatsApp requires unsupported passkey pairing instead of silently rotating unusable QR codes. (#355 - thanks
Nothing published for this version
Highlight: group identities are finally stable — resolvable LIDs are normalized everywhere they appear, and existing stores are repaired on upgrade.
Highlight: group identities are finally stable — resolvable LIDs are normalized everywhere they appear, and existing stores are repaired on upgrade.
whatsmeow for current socket headers, LID history tokens, status queries, and group creation behavior.Nothing published for this version
Nothing published for this version
Locations: send native WhatsApp location pins and retain incoming static or live coordinates in local history with full purge, cleanup, and identity-m
chats list ordering is not replaced by refresh time. (#340 - thanks @goutamadwant)go-sqlite3, whatsmeow, database tooling, gRPC, WebAssembly, telemetry, and supporting Go modules.Nothing published for this version
Contacts: add contacts check [phone...] to query live whether numbers are registered on WhatsApp, with JSON output for scripting; per-number responded
contacts check <phone> [phone...] to query live whether numbers are registered on WhatsApp, with JSON output for scripting; per-number responded distinguishes a server non-answer from a confirmed "not registered". (#331)store_warning (stderr warning plus JSON field) instead of silently diverging local history, while keeping the delivered message id so scripts do not retry an already-sent message. (#328 - thanks @SebTardif)store_warning partial-success contract to every remaining send surface — text, sticker, reactions, polls, poll votes, button/list selections, and message forwarding — including sends delegated to a running sync --follow process.Nothing published for this version
Sync: add opt-in --send-spacing fixed or randomized pacing for sends delegated to a running follow process. (#318 - thanks @cohnen)
--send-spacing fixed or randomized pacing for sends delegated to a running follow process. (#318 - thanks @cohnen)whatsmeow, terminal support, GraphQL parsing, and supporting Go modules.sqlc code generator to Go 1.24+ go tool directive and bump project toolchain requirement to Go 1.26.5. (#313 - thanks @thedavidweng)Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Send files with an explicit WhatsApp media type, so an MP3 can be delivered as a downloadable document while retaining its audio MIME type. (thanks @D
send file --as auto|document|audio|image|video to choose the WhatsApp media type independently of MIME, including downloadable MP3 documents. (thanks @DiegoDAF)Nothing published for this version
Nothing published for this version
Nothing published for this version
Deleted messages now keep their original payload behind timestamped tombstones, with an explicit confirmation-gated purge command for irreversible era
sync --follow process instead of failing while the sync process owns the store lock. (#310 - thanks @Umair444)messages purge command that irreversibly erases one retained payload while keeping a durable suppression tombstone.whatsmeow for the latest protocol definitions and its required utility module.messages edit through a running sync --follow process like other send commands, so edits no longer always fail with store is locked while continuous sync owns the store. (#310 - thanks @Umair444)Nothing published for this version
Nothing published for this version
Nothing published for this version
Sync can now stay quiet during long-running mirror sessions so the primary phone keeps normal notification behavior. ( #298 - thanks @GodsBoy )
--presence-mode quiet to suppress available-presence updates during long-running sync sessions while retaining safe unavailable cleanup. (#298 - thanks @GodsBoy)whatsmeow for current protobufs, LID direct-message sends, pairing, and user lookup behavior. (#306)govulncheck so reachable GO-2026-5856 standard-library paths are excluded.go-sqlite3, the Go networking stack, and whatsmeow with its required transitive modules. (#305, #306)