> ## Documentation Index
> Fetch the complete documentation index at: https://cellar.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# cellar

> Read WhatsApp Web's source code. Compare two releases to find features before they are announced.

WhatsApp Web is shipped to your browser as tens of thousands of scrambled JavaScript
files. Everything the app can do is in there, including parts that are built but not
switched on yet.

`cellar` downloads a version of that code, unpacks it into one readable file per
module, and lets you search it, compare two versions, and see which module uses
which. Nothing is uploaded anywhere. It reads the same files your browser already
downloads.

<Card title="Set up your AI assistant first" icon="sparkles" href="/agents" horizontal>
  The fastest way to use cellar is to let your coding assistant drive it. One command
  installs the tool, connects it, and teaches it what to do.
</Card>

## Install

You need a recent stable Rust toolchain and [`just`](https://github.com/casey/just),
which runs cellar's install recipes.

<Steps>
  <Step title="Install just">
    <CodeGroup>
      ```bash macOS theme={null}
      brew install just
      ```

      ```bash Any platform with Rust theme={null}
      cargo install just
      ```

      ```bash Debian / Ubuntu theme={null}
      apt install just
      ```

      ```bash Arch theme={null}
      pacman -S just
      ```
    </CodeGroup>

    More options, including Fedora, Nix, Scoop and a prebuilt binary, are in
    [`just`'s install guide](https://github.com/casey/just#installation).
  </Step>

  <Step title="Build cellar">
    ```bash theme={null}
    git clone https://github.com/polymorfa/cellar
    cd cellar
    just install
    ```

    This puts `cellar` at `~/.cargo/bin/cellar`. Make sure `~/.cargo/bin` is on your
    `PATH`.
  </Step>
</Steps>

Then download a version of WhatsApp Web. This pulls a few hundred megabytes and takes
a few minutes. Each version uses about 1.3 GB on disk.

```bash theme={null}
cellar bundle add --rev latest
```

Old versions stay available after WhatsApp moves on, so you can go back and pick up a
release you missed and compare against it.

```bash theme={null}
cellar bundle add --rev 1030882912
cellar bundle list
```

```
BUNDLE                     MODULES  INDEXED                     DIR
whatsapp-1030882912         172040  2026-08-09T23:27:13Z        /Users/you/.cellar/bundles/whatsapp-1030882912
whatsapp-1044822804         187892  2026-08-10T01:01:38Z        /Users/you/.cellar/bundles/whatsapp-1044822804
```

## What you can do

<Columns cols={2}>
  <Card title="Use it from an AI assistant" icon="sparkles" href="/agents">
    Sixteen tools over MCP, plus a skill that teaches the assistant when to use each.
  </Card>

  <Card title="Follow a real example" icon="compass" href="/walkthrough">
    Four commands that uncover passkey device linking before it was announced.
  </Card>

  <Card title="Manage versions" icon="package" href="/bundles">
    Download, import, inspect and remove versions of the client.
  </Card>

  <Card title="Search the code" icon="magnifying-glass" href="/search">
    Find modules by name, by the code inside them, or by what they export.
  </Card>

  <Card title="Compare releases" icon="git-compare">
    <a href="/diff">See what changed, as JSON, NDJSON, Markdown or text.</a>
  </Card>

  <Card title="Follow the wiring" icon="share-2">
    <a href="/graph">Dependency graphs as Mermaid, Graphviz or JSON.</a>
  </Card>
</Columns>

## Every command speaks JSON

Anything that produces data takes `--json`, so cellar composes with `jq`, scripts and
assistants. Comparisons additionally offer NDJSON and Markdown, and graphs offer
Mermaid and Graphviz. See [comparing releases](/diff) and [graphs](/graph).

## Legal

`cellar` is an independent tool. It is not affiliated with, endorsed by, or sponsored
by WhatsApp LLC or Meta. It reads publicly served client code for interoperability
research. "WhatsApp" is a trademark of its respective owner and is used here only to
identify the software this tool reads.