gezel Gezel Handboek

1.26231 — 19 August 2026

Five days since 1.26226, and a big five days.

If you read only one thing: gezel can now paint a picture of your whole workshop onto your desktop wallpaper, you can finally see what is using your disk and get it back, and the models running on your own machine can be used from VS Code, OpenCode and pi without leaving those apps.

Your desktop can show you the workshop

This is new, and it is easier to see than to describe.

Turn on Settings → Ambient dashboard and the meester — the gezel who acts as your guildmaster and front door — periodically composes a single-page summary of everything going on: your projects, what the crew has been doing, what is waiting on you. It renders to an image. On the desktop app, that image then becomes your wallpaper, and it keeps itself current.

It is off by default and stays off until you ask, because each render costs a model call and a page render. When you do turn it on, gezel captures your existing wallpaper first and puts it back if you ever turn the feature off.

It also takes the picture seriously. The image is built at your primary display's exact physical pixel size, so your desktop's Fill or Zoom setting cannot crop it, and the content is kept clear of menu bars, notches, docks and taskbars while the artwork still runs to the edges. There are eleven visual themes to pick from — the default is gezellig, a warm dark one — and you can choose the refresh interval, starting at every fifteen minutes.

Disk space you can see, clean up, and back up

Gezel keeps models, engines, caches, projects and conversations on your computer, which is the point, but until now the only way to find out what that cost you was to go looking in folders.

Settings → About now has a storage card that breaks the whole install down by category — downloaded models, native engines, engine caches, toolsets, projects, gezels, documents, git checkouts, derived caches, backups — with a size against each. From there:

  • Clean up walks you through what is safe to remove, category by category, with the space you would get back shown before you commit. Anything gezel can rebuild on its own is offered first; the things that are genuinely yours are the ones it asks hardest about.

  • Back up writes your crew, projects, documents and settings to a single file you choose.

  • Restore reads one of those files back, shows you exactly what it found and what it would change, and only then applies it.

If you use gezel from a terminal, the same three are there as gezel cleanup, gezel backup <file> and gezel restore <file>, each with a preview and a confirmation before anything is written or deleted.

And if you ever uninstall gezel, the prompts now point you at both of these first, rather than letting you find out afterwards.

The document library is a real project now

The shared document library — the folder where you keep the things that should be true for every project, like a mission statement or house style — used to be indexed by a separate, thinner mechanism than your projects were. That is gone. The library is now a project in its own right, and inherits everything projects get.

In practice that means library documents are searched the same way project files are: full content indexing, Office documents converted so their text is findable, meaning-based search alongside keyword search, a watcher that notices your edits, and idle-time enrichment. A Boekwachter — a librarian gezel — is recruited to the library once, and its presence is what opts the library into the parts that use a model.

Two deliberate limits. The library cannot be deleted or archived, and it does not appear in your list of projects, because it is not a job you work on. And nothing gezel generates is ever written into your documents folder — the search index and any converted copies are kept in gezel's own home. That matters if your documents folder is synced to a cloud drive, which is a normal thing to want and was previously a way to get a database file synced across your machines.

Alongside this, the file browsers throughout the app are now one thing rather than three. Documents, a project's workspace and a project's artifacts all use the same pane, so drag-and-drop import, resizing and collapsing, the list and grid views, previews for files that are not text, and editing with autosave work identically wherever you are. There is also a show hidden files toggle, and it remembers your choice.

Your local models, inside VS Code, OpenCode and pi

Gezel could already lend a model to Codex. Three more join it, each set up from Settings → Connected Apps with one button.

VS Code needs no extension — it uses VS Code's own support for custom model endpoints, so your crew simply appears in VS Code's native model picker while VS Code keeps its own tools, permissions and conversations. Gezel adds exactly one provider entry to the profile you choose and leaves every other entry alone. One tradeoff is worth knowing before you press it: without an extension, VS Code cannot offer gezel its encrypted secret store, so the credential is written in plain text. Gezel keeps that credential inference-only — it can ask for a completion and list models, and it cannot read your projects, files, terminals, chats or settings — and you can revoke it on its own at any time.

OpenCode and pi work the same way, and both offer a choice. By default gezel writes its own configuration file and hands you a command that points the tool at it for that run, touching nothing of yours. Or you can press Add to OpenCode / Add to pi, which installs one small gezel-owned file into that tool's own plugin folder so your crew is available in every session without a command. That file holds no password, does nothing when gezel is not running, and is removed when you remove the setup.

For all four, gezel will not silently overwrite something it did not write. If a file was hand-edited or came from a different gezel installation, the card says Needs attention and does nothing until you pick Repair, which keeps the original beside it as a .backup.

The full detail is in Connected apps.

Qwen 3.8 27B is measured, and it leads

The model scorecard has a tenth entry, and it is the new best on the board: qwen3.8-27b-q4 scores 8.2 on the general set and 7.1 on the office-and-knowledge set, ahead of every other model measured on both. That is the follow-up promised in the last release, run the same way as the rest — every job three times on a real machine, checked by a program and read by a separate judge.

Its speed is ordinary for its size, so the choice against something like gemma4-26b is still the usual one: gemma4-26b answers roughly four times faster, qwen3.8-27b answers considerably better. How we test models explains what these numbers do and do not tell you.

Two accuracy fixes land with it. Gezel's estimate of how much memory a model will actually need is now measured rather than assumed on Apple Silicon, and on the other engines it accounts for the extra memory an image-capable model needs — so a model that fits now reliably fits, and one that does not is refused before it wastes your time. And on Apple Silicon, a model's private "thinking" no longer leaks into the answer you read, and no longer runs several times longer than it should have; on one measured model that was seven times more thinking than the same model on the other engine, for no benefit.

Smaller things

  • Projects have icons. A small maker's mark by project type, inherited automatically and overridable per project, in the sidebar and everywhere a project is named.

  • Messages gezel wrote to itself are labeled "System", not "You" — handoffs and dispatched work no longer look like something you typed.

  • Search from the title bar opens instantly with a loading state, finds names before it finishes searching content, tells you when a lookup failed rather than showing an empty result, matches on a gezel's role as well as its name, and stops repeating the same memory snippet back at you.

  • The History detail pane is readable. Labeled sections for context, details, changes and timing, with real dates and durations, instead of a block of raw data.

  • Night Shift shows a tally of what the crew actually got through, both so far tonight and last night, in the moon menu.

  • Task descriptions save as you type, like every other long-form editor in the app. No more losing a description to a missed Save button.

  • File mentions in chat now cover workspace files, not only artifacts — gezel links what it names, and you can open it from the message.

  • Live speed readings are exact, per model and per engine, rather than estimated.

  • Changing a setting no longer kills a running model. Idle engines are released; work in progress is left alone. Only emergency stop and shutdown still stop everything, and if an engine does go away mid-answer the message now says whether gezel stopped it or it crashed.

  • Models installed for the whole machine are shown as read-only rather than offering you a Delete that could not work.

  • Preview panes follow your theme, including when it is set to follow the system.

  • Voice output no longer hangs on a stalled load or stream; it gives up and says so.

  • Folder moves keep a snapshot, listed in Settings with the details openable.

  • A stale meester pointer now prefers an existing gezel who has the Meester role, instead of picking whoever came first.

  • Refreshed editor and catalog content packages (squisq 2.8.0, gilde 0.1.36).

For developers

  • Multi-turn file edits. MCP file-edit tools take partial: true to open a path as a draft: intermediate states are not validated, so a model can build a file larger than one turn's output — and advance_task_step / verify_outcome stay blocked until the file parses again.

  • Task gates got much stricter. Launch parameters interpolate through every gate field, an unresolved {{param}} is now an infrastructure error rather than a silent miss, gate attempt budgets survive self-loop reactivation, and a tool failure that never recovered is surfaced in the thread instead of being inferred from a stalled step.

  • Deterministic fan-out work moved out of prompts. publishCorpusBatches in the script standard library replaces asking a model to retype a batch manifest, and the fan-out input is checked against its source.

  • Catalog schemas have one export source plus a freshness test, so a core schema change can no longer drift from committed gilde schemas without failing.

  • Packaged POSIX launches reuse the installer's service tree when it matches the shipped bundle and is not writable by the calling account, instead of unpacking a byte-identical copy per account.

  • New endpoints: /api/ambient-dashboard, /api/storage/*, /api/vscode-setup, /api/opencode-setup, /api/pi-setup, all with client methods.

  • Linux .deb packages are verified to be zstd-compressed at release time, and release manifests are formatted by a script rather than by hand.

Anything to do?

No. Update when you are offered it.

Three things are worth a visit. Settings → About now tells you what gezel is using on disk, and it is worth a look if you have been downloading models. Settings → Ambient dashboard is the new wallpaper feature, and it is off until you turn it on. And if you use VS Code, OpenCode or pi, Settings → Connected Apps will put your own models in them in about one click.

Watch this article as a slideshow