# Release notes

> What changed in every GUIJam release since the first build. New features, fixes, frameworks and AI tools, and how to upgrade.

GUIJam is in release candidates for 0.1.0. Each one is published on npm with prebuilt `gjd` binaries for every supported platform. Releases are listed newest first. The full notes for each release are on [GitHub](https://github.com/francistinao/gui-jam/releases), and [Releasing](https://guijam.francistinao.com/docs/releasing) shows how a release is cut.

## Upgrading

Your lockfile keeps the version you installed until you update it:

```bash
npm install --save-dev guijam@latest
```

Then restart your dev server. Since 0.1.0-rc.5, the restart also replaces a GUIJam daemon still running from the old version. To check that your AI tool answers, run [`npx guijam doctor --probe`](https://guijam.francistinao.com/docs/reference/cli#doctor).

## 0.1.0-rc.7

November 19, 2026 · [GitHub release](https://github.com/francistinao/gui-jam/releases/tag/v0.1.0-rc.7) · [npm](https://www.npmjs.com/package/guijam/v/0.1.0-rc.7)

Move, remove and comment out what you select, even when the change belongs in another file.

### What's new

- **Move, remove and comment out components.** Select a component and ask "remove this", "comment this out" or "move this to the employee dashboard, under the onboarding tasks". GUIJam now shows your AI tool the file that renders the component, so it removes or comments out the tag and its unused import there, or moves it with its props and its import. The component's own file stays as it is. Before, these requests were refused because the AI could only edit the selected element's own file. See [Move, remove or comment out](https://guijam.francistinao.com/docs/guides/draw#move-remove-or-comment-out).
- **Files you name are editable.** Name a file or a component in your prompt, even in plain words ("employee dashboard" finds `EmployeeDashboard.tsx`), and the AI can edit it in the same variant.
- **One variant, several files.** A variant that changes several files previews them together, **Use** writes them together and **Undo** restores them together.
- **Sketches in a layout land in the page.** A sketch drawn in the empty part of a layout that renders your routed page (`<Outlet />`, `{children}`) now goes in that page's file, not the layout's. See [Where new code goes](https://guijam.francistinao.com/docs/guides/sketch#where-new-code-goes).
- **The panel keeps up.** It lists every file a variant edits under **Edits**, the outline follows an element that moves, a variant that removes it says "Not on the page in this variant.", and after **Use** the Undo toast stays.

### Fixes

- Long answers wrap inside the panel. File paths used to run past its right edge.
- Answers are plain text, without Markdown asterisks and backticks.

### Measured

Claude Code on a small React app, one variant each:

| Request                                         | Sonnet | Opus   |
| ----------------------------------------------- | ------ | ------ |
| remove this                                     | 3.4 s  | 4.8 s  |
| move this into the menu card, next to the price | 9.6 s  | 10.4 s |
| comment this out                                | 3.5 s  | 5.2 s  |

Each edited only the file that renders the component (and the menu card for the move), and removed or commented out the unused import.

## 0.1.0-rc.6

November 19, 2026 · [GitHub release](https://github.com/francistinao/gui-jam/releases/tag/v0.1.0-rc.6) · [npm](https://www.npmjs.com/package/guijam/v/0.1.0-rc.6)

Sketch what you want over a component you selected.

### What's new

- **Sketch over a component.** Pick **Select object**, click a component, then **Sketch what you want for this component**. Sketch anywhere on the page (a new shape, an icon, an arrow at the part to change) and describe it. GUIJam sends your prompt with a screenshot of the page, your strokes and a close-up of the component, and the AI changes that component to match instead of adding a new one. See [Sketch over a component](https://guijam.francistinao.com/docs/guides/sketch#sketch-over-a-component).
- **From Ask AI too.** After Select object and Ask AI, the pencil next to Add image turns the same prompt into a sketch.
- **Your sketch stays with the drawing.** It survives Cancel, Edit prompt and a page reload. Clear sketch removes the strokes and keeps what you typed. `Esc` throws the draft away, and Select picks elements again.

### Fixes

- A sketch takes half the space it used to in the page's session storage, and a save that doesn't fit no longer brings an older one back after a reload.
- A sketch restored after a reload sits where you drew it.

### Measured

A pill outline and a star sketched over a button, with the prompt "Make it look like my sketch: a pill shape with a star before the label":

| AI tool and model   | First variant | All three |
| ------------------- | ------------- | --------- |
| Claude Code, Sonnet | 5.9 s         | 8.2 s     |
| Codex               | 11.4 s        | 13.7 s    |

Both made the button `rounded-full` with a star before the label, and changed only that button's file. Capturing a sketch took 41 to 70 ms, including one with 120 strokes.

## 0.1.0-rc.5

November 18, 2026 · [GitHub release](https://github.com/francistinao/gui-jam/releases/tag/v0.1.0-rc.5) · [npm](https://www.npmjs.com/package/guijam/v/0.1.0-rc.5)

Upgrades take effect right away, and AI tool runs that nothing is waiting for stop.

### Fixes

- **An upgrade takes effect on the next dev server start.** GUIJam's daemon keeps running between dev server restarts. After an upgrade, the plugin used to keep talking to the old daemon until it stopped on its own after 30 minutes idle, so the new version seemed not to work. The plugin now compares the running daemon's version with the one it ships and replaces it when they differ.
- **A stopped daemon no longer leaves your AI tool running.** When the daemon stopped, by `gjd daemon stop` or after 30 minutes idle, a generation still in progress kept running on its own and kept using your plan. The daemon now ends those runs and their child processes on macOS and Linux, as it already did on Windows.

## 0.1.0-rc.4

November 18, 2026 · [GitHub release](https://github.com/francistinao/gui-jam/releases/tag/v0.1.0-rc.4) · [npm](https://www.npmjs.com/package/guijam/v/0.1.0-rc.4)

Generation is much faster on every AI tool, and each variant shows as soon as it is ready.

### What's new

- **Variants arrive as they finish.** GUIJam asks your AI tool for the three variants at once, one per run, and shows each one the moment it is ready. The first one previews on your page right away. You can switch between them, Use one or Discard before the others land, and the runs still writing stop when you do. See [Draw](https://guijam.francistinao.com/docs/guides/draw).
- **GUIJam sets how hard the model thinks.** Small edits and questions run at low effort, sketches and open-ended changes at medium. Before, Claude Code inherited your own `effortLevel` (often `xhigh`), which made a sketch on Opus run past the 3-minute limit. [Choose your own](https://guijam.francistinao.com/docs/ai-tools#choose-an-effort) with `npx guijam provider use <id> --effort low|medium|high`. Claude Code and Codex use it.
- **Leaner AI tool startup.**
  - Claude Code runs in safe mode, without your CLAUDE.md, plugins, hooks or git instructions. It still uses your login.
  - Codex skips project docs and environment context.
  - Gemini CLI no longer relaunches itself.
  - Login checks and OpenCode's model list are cached.
- **Smaller new components.** A self-contained piece from a [sketch](https://guijam.francistinao.com/docs/guides/sketch) (an effect, a widget, a card) is one component file, split into atoms and molecules only when its parts are reused.
- **An honest wait.** After three runs, the widget quotes how long the first variant usually takes with your tool and model, measured in your project, instead of a fixed "20 to 60 s". Every run logs its timings to [`.guijam/logs/gjd.log`](https://guijam.francistinao.com/docs/reference/guijam-directory#logs).
- **Fewer dropped variants.** Two variants may now add the same new file, a miscopied file hash no longer drops a working variant, and each dropped variant is logged with its reason.

### Measured

Sketching a new animated component ("a falling 8-bit pattern that ripples around the cursor") in empty space:

| AI tool and model   | First variant                            | All three  |
| ------------------- | ---------------------------------------- | ---------- |
| Claude Code, Opus   | 30 to 37 s (was: no answer within 180 s) | 44 to 49 s |
| Claude Code, Sonnet | 19 to 22 s                               | 25 to 28 s |
| Codex               | 23 to 32 s                               | 34 to 37 s |

Gemini CLI answered a text Draw with its first variant in 16 s.

Three runs send your prompt and its images three times, so each Draw uses more input tokens than before. Up to six AI tool processes run at once, so a third drawing waits for a free slot.

## 0.1.0-rc.3

November 18, 2026 · [GitHub release](https://github.com/francistinao/gui-jam/releases/tag/v0.1.0-rc.3) · [npm](https://www.npmjs.com/package/guijam/v/0.1.0-rc.3)

Every AI tool now says why it can't answer, and this release fixes what live tests against the real CLIs found.

### What's new

- **The AI tool's own reason, not a guess.** When a tool refuses or fails, the widget shows what it said and what to do next. OpenCode used to report "isn't logged in" for every refusal. OpenCode Zen actually answers "Model access is disabled" when a model is switched off in the Zen console, and "Insufficient balance" without credit. Every failed run is also written to `.guijam/logs/gjd.log`. See [The AI tool refused the request](https://guijam.francistinao.com/docs/troubleshooting#the-ai-tool-refused-the-request).
- **[`npx guijam doctor --probe`](https://guijam.francistinao.com/docs/reference/cli#doctor)** sends one short real request to your AI tool and shows whether it answers. `init` offers it for OpenCode, Gemini CLI and Qwen Code.
- **Codex edits apply again.** Codex sometimes changes an element's attributes, which only worked in Vue, Svelte and Astro files, so every variant was dropped in React. Plain text attributes such as `title`, `aria-label`, `alt` and `type` now work in `.jsx` and `.tsx` too.

### AI tools

- **[OpenCode](https://guijam.francistinao.com/docs/ai-tools/opencode):**
  - Uses the providers from your own OpenCode config (custom providers, base URLs, `{env:…}` keys). Your MCP servers, plugins and permissions still stay off.
  - Before a Draw, GUIJam checks that OpenCode can reach your chosen model.
  - OpenCode's free `opencode/*` models only answer OpenCode itself, so `init` no longer offers them.
- **[Gemini CLI](https://guijam.francistinao.com/docs/ai-tools/gemini-cli):**
  - Google no longer serves Gemini CLI to a personal Google login. Set `GEMINI_API_KEY` and choose it with `gemini`, then `/auth`, then "Use Gemini API Key".
  - GUIJam now uses `gemini-3-flash-preview` by default, because Gemini CLI's automatic choice can wait on overloaded models.
- **[Qwen Code](https://guijam.francistinao.com/docs/ai-tools/qwen-code):** Qwen's free OAuth tier ended on 2026-04-15, so Qwen Code needs a Qwen plan or another provider's key, set with `qwen`, then `/auth`. Its refusals, such as "membership required", now reach the widget in full.

In GUIJam's live test suite, Claude Code, Codex and Gemini CLI answered a real Draw and a question through the widget, edited only the selected file, changed nothing in read-only runs, and stopped within 3 seconds when cancelled. OpenCode and Qwen Code need an account their provider accepts, as described above.

## 0.1.0-rc.2

November 17, 2026 · [GitHub release](https://github.com/francistinao/gui-jam/releases/tag/v0.1.0-rc.2) · [npm](https://www.npmjs.com/package/guijam/v/0.1.0-rc.2)

GUIJam runs on Windows.

### What's new

- **Windows x64.** GUIJam runs natively on Windows, no WSL needed. `npx guijam init` no longer fails with `spawn npm ENOENT`, and `@guijam/gjd-win32-x64` ships `gjd.exe`.
  - AI tools installed with npm or pnpm get their prompt straight from GUIJam, so long prompts aren't cut short by Windows' command-line limits.
  - Stopping a generation stops every process the AI tool started, and no console windows open.
  - The AI tool you choose is saved in `%APPDATA%\guijam\config.toml`.
  - Projects on any drive, paths in any letter case, and files with Windows line endings work. `init` keeps your config file's line endings.
  - Link screenshots find Chrome, Edge, Brave or Chromium where Windows installs them.
- New files GUIJam creates always have names that also work on Windows, so a project stays usable by Windows teammates.
- OpenCode receives the prompt on standard input instead of the command line.
- `gjd daemon status` and `gjd daemon stop` ask the daemon directly instead of sending signals.
- If Next.js can't start GUIJam's connection, `next dev` keeps running without GUIJam instead of hanging.

### Requirements

Node `^20.19.0` or `>=22.12.0` on macOS (Apple silicon or Intel), Linux (x64 or arm64) or Windows (x64). Windows on Arm isn't supported yet.

## 0.1.0-rc.1

November 17, 2026 · [GitHub release](https://github.com/francistinao/gui-jam/releases/tag/v0.1.0-rc.1) · [npm](https://www.npmjs.com/package/guijam/v/0.1.0-rc.1)

The first release candidate: draw on your running app, get live UI variants from the AI coding CLI you already use, and keep the one you like as a minimal source edit. Prebuilt `gjd` binaries shipped for macOS (arm64, x64) and Linux (x64, arm64).

### What it does

- **[Select](https://guijam.francistinao.com/docs/guides/fine-tune)** any element and fine-tune its fill and corner radius in a Figma-style panel, previewed live, written as a one-line change.
- **[Draw](https://guijam.francistinao.com/docs/guides/draw)** around an element, describe the change, and pick one of three live variants. Up to three drawings generate at once.
- **[Sketch](https://guijam.francistinao.com/docs/guides/sketch)** a card, a section or an icon where you want it. New UI is split into atoms, molecules and organisms when your project has components.
- **[Ask](https://guijam.francistinao.com/docs/guides/ask)** a question about what you see and get an answer that points at the files involved.
- Add [inspiration images or links](https://guijam.francistinao.com/docs/guides/images-and-links) to a prompt. Requests that need three.js, Motion or GSAP can use them after you approve the install.
- Every applied change can be [undone](https://guijam.francistinao.com/docs/guides/undo), and undo restores files exactly.

### Supported frameworks

- [Vite](https://guijam.francistinao.com/docs/frameworks/vite) 6, 7 and 8 with React, Preact, Solid, Vue or Svelte, including [Laravel](https://guijam.francistinao.com/docs/frameworks/laravel) and Inertia
- [SvelteKit](https://guijam.francistinao.com/docs/frameworks/sveltekit), [Nuxt](https://guijam.francistinao.com/docs/frameworks/nuxt) 4, [React Router](https://guijam.francistinao.com/docs/frameworks/react-router) 7 and 8 (framework mode), [SolidStart](https://guijam.francistinao.com/docs/frameworks/solidstart) 2
- [Astro](https://guijam.francistinao.com/docs/frameworks/astro) 7 (fine-tune in place, AI variants through a page reload)
- [Next.js](https://guijam.francistinao.com/docs/frameworks/nextjs) 16.3 or later, App Router, on Turbopack and webpack

Fine-tune writes Tailwind classes, Vuetify props, or inline styles, whichever your project uses.

### Requirements

- Node `^20.19.0` or `>=22.12.0` on macOS or Linux
- Claude Code, Codex or OpenCode, installed and logged in. Qwen Code and Gemini CLI were supported but not verified live yet.

GUIJam never reads your credentials and gives the CLI no tools that can change files. It runs only in development.

### Not supported yet

Windows, Angular, SolidStart 1 (vinxi) and the Next.js Pages Router. In Next.js, a sketch that would create new component files can't be previewed yet.

## Before 0.1.0-rc.1

November 17, 2026. GUIJam was built in the open in the [gui-jam repository](https://github.com/francistinao/gui-jam) before its first release. Nothing was published to npm until 0.1.0-rc.1. In the order it landed:

### The core loop

- The Vite plugin maps DOM elements to their JSX source locations.
- The `gjd` daemon, written in Rust, inspects elements, turns fine-tunes into codemods and applies edits safely. It serves previews, commits and undo to the plugin.
- The widget selects an element and fine-tunes its fill and radius.
- Draw around an element, describe a change and preview an AI variant. One variant became three, with live progress and switching between them.

### Prompts

- Prompts are routed to exact edits, answers, or a fast or standard tier.
- Prompts can refer to other parts of the page and to project files.
- Sketch to UI sends your drawing and the page to the model.
- Generated icons are saved as SVG or WEBP files.
- Up to three drawings generate at once, and drawings survive page reloads.
- Inspiration images sit next to the prompt, and links in the prompt are read for context.
- New UI is split into atoms, molecules and organisms. three.js, Motion and GSAP are installed only on approval.

### AI tools and setup

- Claude Code first, then adapters for Codex, OpenCode, Qwen Code and Gemini CLI.
- `npx guijam init` sets up a project and saves the AI tool you choose. `gjd` ships as per-platform npm packages.
- The toolbar gained Lucide icons, tooltips and `Esc` to leave the active tool, and progress reports what the AI tool is actually doing.

### Frameworks

- Fine-tune for elements styled with inline style objects.
- Class and inline CSS edits in `.vue`, `.svelte`, `.astro` and `.html` templates.
- Vue and Nuxt, including Vuetify components through their `color` and `rounded` props.
- Svelte and SvelteKit, Solid, React Router framework mode and SolidStart 2.
- Astro, with in-page fine-tune previews.
- Next.js 16.3 and later, with live previews on Turbopack and webpack.
- End-to-end tests on official starters set up by a real `guijam init`.

> **Found a problem?**
>
> Report it on [GitHub](https://github.com/francistinao/gui-jam/issues) before 0.1.0, and include `.guijam/logs/gjd.log` when something fails.
