Mirador 0.4.2

[sodre90]

Mirador 0.4.2 gives the agent a checklist beside the canvas that it ticks as it works, and lets you take a page the agent drew with you: as an image, as HTML, or as a file of its own. Mirador is also open source now, under the MIT license, with a website at sodre90.github.io/mirador.

▶ Watch the trailer (1:37)

What's new

• A checklist beside the canvas. For work with several steps, such as a feature, a release or a migration, the agent publishes its steps as a checklist in a tab beside the canvas and ticks each one as it finishes. Each item says whose it is: the agent's, yours, or both of yours. You can tick items too, and the agent hears of your ticks with your next message. An item the agent ticks flashes, and the agent's own to-do list is pinned underneath. The × next to the checklist's title takes you back to the page under it.
• Take a canvas page with you. The Export menu on a page the agent drew copies it as an image or as HTML, downloads it, or saves it into the project as a file of its own. The file draws outside Mirador, loading D3, Mermaid and three.js from a public CDN; choose so in Settings → Canvas and D3 and Mermaid go inside the file instead, so it draws offline. The desktop app leaves out Download, as its downloads land in your Downloads folder without a word; save the page into the project instead.
• A canvas bar that fits a narrow pane. As the canvas pane narrows, the bar folds its less used buttons into a ⋯ menu: first History, Clear and Export, then the arrows and Changes, then the checklist. Every button stays in reach at any width.
• Hook messages that stay out of the way. What a hook prints, such as the context a SessionStart hook adds after compaction, shows as one line naming the hook, which opens to the hook's lines. The "says:" Claude Code puts before every line is gone, and the line breaks stay. A hook's warning still says it is one.

Install

The app carries Mirador and the Bun it runs on. It runs the Claude Code and opencode you have installed.

curl -fsSL https://github.com/sodre90/mirador/releases/latest/download/install.sh | sh

On macOS (Apple Silicon) and Linux (x64, arm64) the script downloads this release, installs it and starts it. Already on 0.4.1? The app updates itself: a banner offers to restart into 0.4.2. Coming from 0.4.0, run the script once more (quit Mirador first).

With Homebrew: brew install --cask sodre90/tap/mirador. On Linux, Homebrew prints the apt and dnf commands for the libraries the app needs.

By hand:

macOS (Apple Silicon): Mirador-macos-arm64.zip.

unzip Mirador-macos-arm64.zip -d /Applications
open /Applications/Mirador.app

Linux: Mirador-linux-x64-Setup.tar.gz or Mirador-linux-arm64-Setup.tar.gz (uname -m says which). It needs glibc 2.36 or newer (Ubuntu 24.04, Debian 12, Fedora 37 or later), GTK 3, WebKitGTK 4.1 and the Ayatana AppIndicator library:

sudo apt install libgtk-3-0 libwebkit2gtk-4.1-0 libayatana-appindicator3-1 librsvg2-2   # Debian, Ubuntu
sudo dnf install gtk3 webkit2gtk4.1 libayatana-appindicator-gtk3 librsvg2              # Fedora
mkdir mirador-setup && tar -xzf Mirador-linux-*-Setup.tar.gz -C mirador-setup && mirador-setup/installer

Then start Mirador from your applications menu. The stable-* files are what the app fetches to update itself; you don't need them.

The README covers signing in and running from a checkout.

Checksums (SHA-256)

2301395e23743e37e425cc46e8876c6450fc421f2ecebf862c18783886a2b138  Mirador-linux-arm64-Setup.tar.gz
e7e96ee8ff0fe4af5b43477d476474a346d3701416d3a9c541b356ccad853926  Mirador-linux-x64-Setup.tar.gz
bdfd6fd9d598a5394aa73eaf72faf6b4c2cdeaacf897e863ff87e02b3dd47d83  Mirador-macos-arm64.zip
7106b1b5ea275d19732fc21aeab486d840916fb572ec35d39d63d12043fd3ee9  stable-linux-arm64-31st2g9dnzywz.patch
735ba489a3fca581f965bdc8c34a5f86ae2a7d12bd08b2249b7f5f383d82bbea  stable-linux-arm64-Mirador.tar.zst
795ac0bff9daf0511985600da686a762dfbbc6f0b797321f71969ea32e14a631  stable-linux-arm64-update.json
5da27408426ab0349686384bc80042cbf6a4220af8508d5918e65c357bef8b11  stable-linux-x64-3hsdrhe02j2j5.patch
86fc84ef81f57b0ff4ff4565cb0f01caeb49ea56833e312091ea36cf0ae8bedd  stable-linux-x64-Mirador.tar.zst
4f89f3dcf58f799e2d7e969cb165ee7ff939f90df7a979c348c2f5bc6d23c865  stable-linux-x64-update.json
00356c2af9d130cccb8d17634245c717151d05c6a171927569b40e1146f49957  stable-macos-arm64-3dggi45r45mrk.patch
01f5a3352e4b16e8a5c8c9313c475504b3cc386d4a84387004c7f254fa1d7615  stable-macos-arm64-Mirador.app.tar.zst
baffc3612d1b5171417b192ce220780a2779957bfcdb2e04e961754302339c63  stable-macos-arm64-update.json
62d7b79d3f548d3c1c8700052d81cc975ed0450f443aafd2f8e30f5e0b2f1d30  install.sh

---

This discussion was created from the release Mirador 0.4.2.