Contents

    [idea:inspiration]faq

    What inspired rookery?

    Rookery builds on thinking about associative archiving that dates back to 2019. Its name and metaphor system derive from thinking about software in the age of large language models.

    More generally as a knowledge management tool, rookery takes its cue from the Zettelkasten method, which was popularized in 2019 by Roam Research, and which has since influenced both Obsidian and Notion, two popular knowledge management platforms.

    Of these tools, rookery is closest in spirit to Obsidian in the sense that it allows you to create and manage a local-first knowledge base using plain-text files on disk. Unlike Obsidian, however, rookery is not an editor or IDE, which means you can author the Typst files in it however you like.

    Another way of thinking about rookery is that it is a Zettelkasten framework built on Typst that is more structured than Obsidian and Notion, but not so structured that you need to know anything in particular about Zettelkasten in order to use it. Rookery allows you to organize your thinking using ideas and tags in a way that is compatible with Zettelkasten and Zettelkasten-inspired systems like Roam, without enforcing or requiring strictly atomic notes.

    In addition to those mentioned above, three ways of thinking about note systems have concretely influenced rookery’s design:

    1. Andy Matuschak’s evergreen notes.
    2. Jon Sterling’s intellectual junkyards.
    3. Emacs’ Org-mode.
      [idea:genealogy]faq

      What is the genealogy of idea?

      An idea in a rookery can be conceptualized as an atomic note of sorts, which is why each idea is given its own standalone page. As with notes in other Zettelkasten-inspired systems, ideas that link to each other produce backlinks.

      In addition to the sense of an idea as a ‘Zettel’ or note, you can also think about them as slightly more general kinds of ‘todo’ item, as in Org-mode TODOs. Indeed, the notion of ideas comes from the IDEA variant in Doom Emacs, a preconfigured cluster of plugins for the Emacs editor.

      Rookery ideas are designed with structured extensions in mind. You can structure ideas into todos, meeting notes, or even application tracking pages.

        [idea:other-tools]faq

        What are other tools like rookery?

        Rookery was inspired by a range of existing knowledge management tools.

          [idea:forester-rookery]faq

          Forester | Rookery

          Forester is the open source system most similar to rookery, and also its chief inspiration. Forester is an OCaml engine that Jon Sterling develops to power his website. It is not wrong to think about rookery as forester reimplemented for and in Typst.

          Both rookery and forester have:

          • Atomic notes with unique and stable names (ideas and trees, respectively)
          • Bidirectional linking and transclusion, which is a fancy word meaning that you can embed one note in another as a window.
          • Compilation to a standalone static site.

          The core differences between forester and rookery:

          • Forester rolls its own enhanced markup language, whereas rookery uses Typst. This has consequences for how hyperlinks, mathematical markup, footnotes, citations, and inline code blocks are specified.
          • Forester requires an OPAM/OCaml toolchain and has a datalog-based query engine, whereas rookery is written in pure Typst.1 Both produce standalone static sites.
          • Rookery can be incrementally adopted in an existing Rheo project—a ‘normal’ writing project or website that isn’t organized as atomic notes—by sprinkling #idea blocks in as they are conceived, whereas forester must be adopted wholesale.
          • In addition to HTML and PDF, rookery can export to EPUB.
          • Rookery allows you to give ideas human-readable, semantic names if you prefer not to accept the names it derives automatically.
          • Forester was first released in 2023 and its latest major version, 5.0, was released in July 2025. Rookery is pre-release software (version 0.x) that was announced in September 2026.

          Footnotes

          1. ^ We recommend compiling rookeries with Rheo for a better experience, but it is not strictly required.
            [idea:kodama-rookery]faq

            Kodama | Rookery

            Kodama is another forester-inspired tool for authoring intellectual junkyards in Typst.

            • Rookery produces HTML, PDF, and/or EPUB, whereas Kodama renders only HTML.
            • Kodama does not explicitly support transclusion with windows, idea-scoped footnotes or citations, tags to organize ideas, mobile viewing, or standalone pages for each idea.
            • Kodama requires a separate binary to compile in addition to Typst, whereas rookery needs only the Typst toolchain (or Rheo as the preferred interface to it).
            • Kodama allows you to write your notes in either Markdown or Typst, whereas rookery is pure Typst.
              [idea:using-typst]faq

              Do I need to use Rheo to use rookery?

              Rheo is a typesetting engine based on Typst that is also maintained at the Free Computing Lab. In addition to providing an EPUB export option, Rheo can also register custom JavaScript and CSS from a package such as rookery.

              While we make a best effort to keep the rookery package Typst-native, we can guarantee a better experience if you compile your rookeries with Rheo. A large part of this is because rookery’s implementation depends heavily on Typst’s experimental bundle export, which means that one needs various flags and specific configuration to compile a rookery with the Typst CLI.

              Using pure Typst, your rookeries will certainly not get standalone minted idea pages, rookery-wide outlines, and the ability to compile to EPUB, and idea-href will always be none. Other aspects of the rookery may also not work. Using the latest release of Rheo, by contrast, rookery should work out of the box.

                [idea:maintenance]faq

                Who maintains rookery?

                Rookery is tooling maintained as part of the Free Computing Lab, an association of academics who have no strict affiliation with any company. The tool was originally built by Lachlan Kermode as a way to organize his research weeknotes. Rheo is also built and maintained by the Free Computing Lab.