[[!meta title="BONE and gnaw.el: tracking what matters"]]
[[!meta copyright="Copyright © 2026 Bastien Guerry"]]
[[!inline pages="internal(2026/info/bone-nav)" raw="yes"]]

<!-- Initially generated with emacsconf-publish-talk-page and then left alone for manual editing -->
<!-- You can manually edit this file to update the abstract, add links, etc. --->


# BONE and gnaw.el: tracking what matters
Bastien Guerry (he) - IRC: bzg, <https://bzg.fr>, <mailto:bzg@bzg.fr>

[[!inline pages="internal(2026/info/bone-before)" raw="yes"]]

Most free software projects use three communication channels: one for
general feedback, one for bug reports, and one for contributions.
Projects that use patches instead of pull/merge requests (e.g. Emacs)
can reduce this to two channels: a discussion list and a bug tracker.
Some opinionated projects (e.g. Org mode) use only one channel: a
mailing list for general discussions, bug reports and patches. This
makes it easy for everyone to track everything. However, this requires
a tool to help filter all the input. The Org mode tracker uses BONE
for this filtering, and Org mode contributors can use gnaw.el as a
BONE client.

BONE (Backlog Of Notable Emails) is a bug tracker written in Clojure
that watches a project's mailing list. An email whose subject starts
with [BUG], [PATCH] or [FR] becomes a report. Replies update it with a
small, fixed vocabulary: "Confirmed.", "Acked.", "Owned.", "Closed.",
plus the usual review trailers like Reviewed-by:. Nobody creates an
account, nobody fills a form, nobody leaves their mail client. The
mailbox stays the single source of truth: the tracker database can be
rebuilt from the archive at any time. BONE then exports the reports as
static HTML, RSS, Org and, most importantly, plain reports.json files
that anyone can fetch and reuse.

gnaw.el is the Emacs client for BONE. M-x gnaw opens a report browser
listing the bugs, patches and feature requests of the sources you
follow, across projects. From that buffer you can search reports, read
the underlying emails in Gnus, notmuch or mu4e, view and apply patches
directly into a local git repository, open attachments, and organize
your own work with local sticky and dismiss marks.

The talk will:

-   show BONE in action on a real mailing list, from the tagged email to
    the exported reports;
-   demo gnaw.el: browsing, searching, reading, applying a patch, all
    from Emacs;
-   discuss the pros and cons of using this tool for Org mode.

The audience is anyone who maintains or contributes to a project
through a mailing list, anyone who is tired of forge accounts, and
anyone curious about what a tracker looks like when it is derived from
the conversation instead of replacing it.

Links:

-   [BONE - Reports - Org mode ML](https://tracker.orgmode.org)
-   BONE: <https://codeberg.org/bzg/bone>
-   gnaw.el: <https://codeberg.org/bzg/gnaw.el>
-   The essay behind the idea:
    <https://bzg.fr/en/notes/the-issue-with-issue-trackers/>

About the speaker:

Bastien Guerry has been maintaining Org mode from 2011 until 2025.



[[!inline pages="internal(2026/info/bone-after)" raw="yes"]]

[[!inline pages="internal(2026/info/bone-nav)" raw="yes"]]