Gronk 0.2.0

The first full release. Everything before this was a prerelease.

What you get

A right-click menu. Electron ships none, so right-clicking used to do nothing
at all: no cut, copy or paste, and the spelling suggestions Chromium was already
computing sat under the red underline with no way to reach them.

Focus mode. A topbar button, or the [ key, hides the sidebar and idle tray
so the conversation fills the frame.

Agent activity at a glance. A row of dots under the turn that spawned the
work: dim when finished, red when failed, pulsing while running. The tray keeps
the history until you dismiss it, and no longer opens itself while you are
reading.

Fixed

Scrolling stopped fighting you. Scrolling up a line or two while a reply
streamed was undone by the next token, and the end of a turn snapped you back to
the bottom. Both are gone; keyboard and scrollbar scrolling count as intent now
too.

Sign-in state is honest. A successful model list no longer counts as being
signed in, so a fresh install reads as signed out until something actually
indicates an account, and signing out no longer flips straight back.

Tool output stopped filling the screen with image previews. Only tools that
produce images get previews, and the row is capped.

macOS builds ship the Electron and Chromium licences again.

Verify your download

SHA256SUMS.txt is attached. These installers were built by GitHub Actions from
the commit this tag names; nothing was uploaded from a personal machine.

Known, and honest about it

No one has run this on macOS. The mac-specific parts of the sign-in fix are
unit-tested only, and the window controls may need padding. If you are on a Mac
and something looks wrong, that is useful information rather than a surprise.

Visual comparison does not run in CI. The four-platform test matrix does.

Nightly (bcbfaf3)

Rolling build from main. Not a release.

This is whatever is currently on main, built by CI. It has passed review, the
four-platform test matrix and the malware scan, and no human has used it. The
assets here are replaced every time a new nightly is cut, and this tag moves with
them. If you want something stable, take the latest release instead.

What is in this one, and not in 0.2.0

• The Build panel is now the session list. Flat, newest first, with a mode
  control to group by project instead. Reaching a conversation no longer means
  walking a hierarchy.
• The open session finally highlights in the sidebar.
• The README shows the app as it currently looks.

What has not been checked

Nobody has opened this build. The sidebar rework in particular is typechecked,
unit-tested and unseen. Visual baselines are deliberately not regenerated for it.

Nothing macOS-specific has ever been verified by a person on a Mac.

SHA256SUMS.txt is attached. It attests that a download matches what CI
uploaded; it says nothing about whether this build is any good.

Gronk 0.1.9

Tool activity release. Update from any earlier build.

Changed

• Tool activity is a single line you can expand, instead of several things pulsing at once. While Grok worked, the agent fleet indicator and the "Using SHELL" row animated independently, which read as two separate systems doing two separate things. They are now one summary bar showing whatever is actually running, with the detail behind a click.
• Long paths and commands in that bar are shortened to fit. A line that ran past the width of the bar is trimmed rather than pushing the layout around.

Which file do I want?

Platform	File
Windows	Gronk-0.1.9-windows-x64-setup.exe (installer) or -portable.exe
macOS	Gronk-0.1.9-macos-universal.dmg (Apple Silicon and Intel)
Linux	Gronk-0.1.9-linux-x86_64.AppImage or -amd64.deb

Node.js is not required. You do need the Grok CLI and your own Grok account.

These installers are unsigned

macOS will say the app is damaged. It is not. Right-click and choose Open, then confirm. Double-clicking will not work until you have done that once.
Windows SmartScreen: More info, then Run anyway.

SHA256SUMS.txt verifies the download arrived intact. That checks integrity, not authorship. Only signing does that.

Known limitations

• Developed and tested on Windows. The macOS and Linux builds come from CI and have not been run by the author.
• The macOS bundle is currently missing the upstream Electron and Chromium licence files. Attribution for the app's own dependencies ships correctly on every platform; this gap is the runtime's own licences on macOS only, and is being fixed.
• No automatic updates.
• Conversations are stored on your machine as readable text. Do not paste secrets into a chat.
• Grok cannot yet ask you a question mid-task. When it tries, you will see "Agent requested unsupported client method" and it will pick a default and carry on.

Full detail in CHANGELOG.md.

Gronk 0.1.8

UX and restore release. Update from any earlier build.

Added

• A single session tray above the composer for Plan, Agents, and Usage.
• Command palette (Ctrl/Cmd+K) to jump Home, Chat, Build, settings, and more.
• Pin and remove recent projects from the project menu (remove only forgets the list entry; it never deletes files on disk).
• Opening a project resumes the latest session for that folder. Use New session when you want a blank conversation.
• Chat skeleton while a project or session is opening.
• Allow this kind for session on permission prompts: batch-approve a tool kind for the rest of this agent process without full YOLO.
• OS notifications when the window is unfocused and a permission is needed or a turn finishes.
• First-run onboarding checklist on Home (CLI, sign-in, first project).
• Status menu in the top bar: connection, account, and model in one control.

Changed

• Light theme reworked as paper and ink. The Windows title-bar overlay follows light and dark.
• Wider message column and a tighter top bar.
• Agents tab only appears when something is live.
• Missing images fail more quietly so a bad catalogue cannot own the viewport.
• Session restore paints the local transcript in one shot, then connects the agent.

Which file do I want?

Platform	File
Windows	Gronk-0.1.8-windows-x64-setup.exe (installer) or -portable.exe
macOS	Gronk-0.1.8-macos-universal.dmg, Apple Silicon and Intel
Linux	Gronk-0.1.8-linux-x86_64.AppImage or -amd64.deb

Node.js is not required. You do need the Grok CLI and your own Grok account.

These installers are unsigned

macOS will say the app is damaged. It is not. Right-click and choose Open, then confirm. Double-clicking will not work until you have done that once.
Windows SmartScreen: More info, then Run anyway.

SHA256SUMS.txt verifies the download arrived intact. That checks integrity, not authorship. Only signing does that.

Known limitations

• Developed and tested on Windows. The macOS and Linux builds come from CI and have not been run by the author.
• No automatic updates.
• Conversations are stored on your machine as readable text. Do not paste secrets into a chat.
• Grok cannot yet ask you a question mid-task. When it tries, you will see "Agent requested unsupported client method" and it will pick a default and carry on.

Full detail in CHANGELOG.md.

Gronk 0.1.7

Update from any earlier build. A small fix release over 0.1.6.

Fixed

An image could be refused from a folder that was allowed. When the agent
referred to an image, Gronk checked it against a list of permitted folders. One
side of that comparison followed shortcuts on disk and the other did not, so a
folder reached through one never matched, and a file genuinely inside a
permitted folder was rejected with "Path outside allowed image roots".

macOS was most affected, because its temporary folder is reached that way by
default. The containment check itself is unchanged in strictness: both sides are
now resolved the same way, which is the comparison it was always meant to make.

Everything in 0.1.6 is still here: the resizable preview split, the pop-out
preview window, and remote images from the model shown as links rather than
fetched.

Which file do I want?

Platform	File
Windows	Gronk-0.1.7-windows-x64-setup.exe (installer) or -portable.exe
macOS	Gronk-0.1.7-macos-universal.dmg, Apple Silicon and Intel
Linux	Gronk-0.1.7-linux-x86_64.AppImage or -amd64.deb

Node.js is not required. You do need the Grok CLI and your own
Grok account.

These installers are unsigned

macOS will say the app is damaged. It is not. Right-click and choose Open,
then confirm. Double-clicking will not work until you have done that once.
Windows SmartScreen: More info, then Run anyway.

SHA256SUMS.txt verifies the download arrived intact. That checks integrity, not
authorship. Only signing does that.

Known limitations

• Developed and tested on Windows. The macOS and Linux builds come from CI and
  have not been run by the author.
• No automatic updates.
• Conversations are stored on your machine as readable text. Do not paste secrets
  into a chat.
• Grok cannot yet ask you a question mid-task. When it tries, you will see
  "Agent requested unsupported client method" and it will pick a default and
  carry on.

Full detail in CHANGELOG.md.

Gronk 0.1.6

Update from any earlier build.

New

The preview pane resizes. Drag the divider between the conversation and the
dev-server preview to give either side the room it needs.

Pop the preview into its own window. Handy on a second monitor. Closing that
window puts the preview back in the pane and leaves your dev server running.

The detached window keeps every restriction the docked pane has: sandboxed,
locked to localhost, no bridge to the agent or your files, and its own throwaway
session that writes nothing to disk. Detaching it does not loosen anything.

Changed

Images from the model are never fetched. A remote image in a reply now shows
as a link naming the host it points at, so you decide whether to open it.
Loading one automatically would tell that server you had read the message, and a
unique URL per reply turns an image tag into a tracking pixel that also hands
over your IP.

Images the model generates still appear inline, and images served by your own
dev server in the preview are untouched.

Fixed

• Stopping a popped-out preview flashed "running". Teardown destroyed the
  detached window in a way that instantly rebuilt the pane it was removing, so
  the dev server was reported alive for a moment after being stopped.
• The preview forgot itself after a window reload. The pane read its state
  only from live events, so it showed nothing running while the dev server was
  still up.

Which file do I want?

Platform	File
Windows	Gronk-0.1.6-windows-x64-setup.exe (installer) or -portable.exe
macOS	Gronk-0.1.6-macos-universal.dmg, Apple Silicon and Intel
Linux	Gronk-0.1.6-linux-x86_64.AppImage or -amd64.deb

Node.js is not required. You do need the Grok CLI and your own
Grok account.

These installers are unsigned

macOS will say the app is damaged. It is not. Right-click and choose Open,
then confirm. Double-clicking will not work until you have done that once.
Windows SmartScreen: More info, then Run anyway.

SHA256SUMS.txt verifies the download arrived intact. That checks integrity, not
authorship. Only signing does that.

Known limitations

• Developed and tested on Windows. The macOS and Linux builds come from CI and
  have not been run by the author.
• No automatic updates.
• Conversations are stored on your machine as readable text. Do not paste secrets
  into a chat.

Full detail in CHANGELOG.md.

Gronk v0.1.5

Update from any earlier build.

New

See your skills. A Skills tab lists every skill on your machine, the ones you
added and the 20-odd bundled with the Grok CLI, each with its own description. A
skill is a folder containing SKILL.md. Dropping it into ~/.grok/skills is the
entire install, and the tab says so.

Session actions where you actually are. Rename, Archive, Export and Delete
now sit behind a menu on each sidebar row, including search results.

Plugins & Skills has its own entry in the sidebar instead of being buried in
Settings.

Know who published a plugin. Cards now show the account it came from, like
github.com/xai-org. A marketplace name is a string anyone can set, including to
"xAI Official", so it is no longer styled as a credential. Nothing is marked
"verified", because Gronk has no way to know. You get the provenance and you
decide.

Fixed

• A failed plugin install showed no reason. The error was set, then wiped by
  the refresh right behind it, so every failed install, enable, disable and
  uninstall reported a message that never reached the screen.
• Search counted results it would not show. Archived sessions matched, got
  counted in the header, then vanished from the list underneath.
• Search re-read your whole history on every keystroke, once per session. It
  now reads once per query.
• Generated images were unreachable if you relocate the CLI with GROK_HOME.
  The app rebuilt the CLI's home by hand in two places and ignored the override,
  so it looked where the CLI was not writing.
• A new session only appeared in the sidebar after its first reply finished,
  so the list claimed there were none while you sat in one.
• Switching away mid-reply cut the turn off. The agent is now told to stop
  before its process closes.
• Skill descriptions written in the usual multi-line YAML style are read
  properly instead of showing as a single >.

Which file do I want?

Platform	File
Windows	Gronk-0.1.5-windows-x64-setup.exe (installer) or -portable.exe
macOS	Gronk-0.1.5-macos-universal.dmg, Apple Silicon and Intel
Linux	Gronk-0.1.5-linux-x86_64.AppImage or -amd64.deb

Node.js is not required. You do need the Grok CLI and your own
Grok account.

These installers are unsigned

macOS will say the app is damaged. It is not. Right-click and choose Open,
then confirm. Double-clicking will not work until you have done that once.
Windows SmartScreen: More info, then Run anyway.

SHA256SUMS.txt verifies the download arrived intact. That checks integrity, not
authorship. Only signing does that.

Known limitations

• Developed and tested on Windows. The macOS and Linux builds come from CI and
  have not been run by the author.
• No automatic updates.
• Conversations are stored on your machine as readable text. Do not paste secrets
  into a chat.

Full detail in CHANGELOG.md.

Gronk v0.1.3

Update from any earlier build. Every release before this one has at least one
feature that does not work.

Added

Search every session by title or message text, from the sidebar. It spans
Chat and Build together — you remember what was said, not which surface you said
it on — and each result says where it matched and which one it came from. Agent
reasoning is searched as well, since it often names the file the visible answer
only alludes to.

Fixed — the preview pane

Its security was hardened in 0.1.2. Its actual operation had never been
exercised. Six defects, each measured rather than reasoned about:

• It could fail to find your dev server at all. The URL scan ran on a
  redacted copy of the output, so a server printing its own address with a query
  string had that address mangled before it was matched. The capture also stopped
  only at whitespace, so App running at http://localhost:3000.,
  (http://localhost:3000) and markdown links all produced something unparseable
  — after which the pane waited forever with no error.
• Stopping it could leave your dev server running. A process-tree kill breaks
  when an intermediate exits, which is exactly what npm run dev does when it
  hands the server to a detached grandchild; the port stayed bound. A port sweep
  now follows, and on macOS and Linux it escalates to SIGKILL.
• A failed kill could crash the app. The guard could not catch the error it
  guarded, which arrives asynchronously and became an unhandled exception.
• A stopped pane could come back, and a failed start left it reporting
  "running" forever with nothing behind it.

Fixed — plugins

• The trust dialog said "Pinned commit" when nothing was pinned. The install
  never received that commit and never verified it afterwards. It now says what
  the value actually is and that the install is not pinned to it.
• A plugin source could specify any scheme. The https-only check covered
  catalog entries read from disk but not ones arriving from the CLI, so a
  marketplace listing could name a local file or an ssh target and have it
  installed. The check now sits at the install itself.
• A successful install could empty the Installed list when the follow-up read
  could not be parsed, making a working install look destructive.

Which file do I want?

Platform	File
Windows	Gronk-0.1.3-windows-x64-setup.exe (installer) or -portable.exe
macOS	Gronk-0.1.3-macos-universal.dmg — Apple Silicon and Intel
Linux	Gronk-0.1.3-linux-x86_64.AppImage or -amd64.deb

Node.js is not required. You do need the Grok CLI and your own
Grok account.

These installers are unsigned

macOS will say the app is damaged. It is not. Right-click and choose Open,
then confirm — double-clicking will not work until you have done that once.
Windows SmartScreen: More info → Run anyway.

SHA256SUMS.txt verifies the download arrived intact. That checks integrity, not
authorship — only signing does that.

Known limitations

• Developed and tested on Windows. The macOS and Linux builds come from CI and
  have not been run by the author.
• No automatic updates.
• Conversations are stored on your machine as readable text. Do not paste secrets
  into a chat.

Full detail in CHANGELOG.md.

Gronk v0.1.2

If you are on any earlier build, update. 0.1.0 and 0.1.1 both have an
unusable Light theme, and 0.1.0 also has an invisible activity heatmap.

Fixed

Light mode was unusable. Twenty-four elements were unreadable, several at a
contrast ratio of 1.03:1 — text the same colour as the surface behind it. The
cause was structural: 27 rules painted their own black background, so switching
theme flipped the palette and the text but left those surfaces dark. The accent
and the state colours were never overridden either. Now measured at zero
contrast failures across five views, with Dark verified unchanged.

The usage meter claimed you had spent money you had not. It read
"~$0.28 est." on every session. That figure is only a charge when you sign in
with an XAI_API_KEY, where it draws down prepaid credit. With a Grok account
nothing is billed per token — the same number is what those tokens would have
cost at API rates, against quota you already pay for. Dollars now appear only
when they are real; otherwise the panel labels it "At API rates". Token counts
are unchanged and shown either way.

Changed

The sidebar stays put. Choosing Build now lists your projects immediately,
instead of after you had already opened one. Switching projects no longer means
leaving the session you are in, so "Switch workspace" and "All" are gone.

One word for a project. "Folder" and "workspace" both meant the same thing as
"project" in different corners of the app. A project is a directory the agent
works in; a session is one conversation. "Open folder…" is now "＋ Add
project", since every project you have is already listed.

Which file do I want?

Platform	File
Windows	Gronk-0.1.2-windows-x64-setup.exe (installer) or -portable.exe (no install)
macOS	Gronk-0.1.2-macos-universal.dmg — works on Apple Silicon and Intel
Linux	Gronk-0.1.2-linux-x86_64.AppImage or Gronk-0.1.2-linux-amd64.deb

Node.js is not required — the installer bundles its own runtime. You do need the
Grok CLI and your own Grok account.

These installers are unsigned

macOS will say the app is damaged. It is not. Right-click the app and choose
Open, then confirm — double-clicking will not work until you have done that
once. Windows SmartScreen: More info → Run anyway.

SHA256SUMS.txt verifies the download arrived intact. That checks integrity,
not authorship — only signing does that.

Known limitations

• Developed and tested on Windows. The macOS and Linux builds come from CI and
  have not been run by the author. Reports welcome.
• No automatic updates. Code signing has to land first.
• Conversations are stored on your machine as readable text, which is what
  comparable tools do. Do not paste secrets into a chat.

Full detail in CHANGELOG.md.

Gronk v0.1.1

Patch release. If you installed v0.1.0, update.

Fixed

The activity heatmap on the Home screen was invisible. It had no stylesheet at
all, so every day cell rendered at zero height and the panel showed only its
month and weekday captions, bunched together as plain text. The component was
correct the whole time; the CSS for it had simply never been written, in v0.1.0
or in any build before it.

Nothing else changed. Same features, same known limitations as v0.1.0.

Which file do I want?

Platform	File
Windows	Gronk-0.1.1-windows-x64-setup.exe (installer) or -portable.exe (no install)
macOS	Gronk-0.1.1-macos-universal.dmg — one file, works on Apple Silicon and Intel
Linux	Gronk-0.1.1-linux-x86_64.AppImage or Gronk-0.1.1-linux-amd64.deb

Node.js is not required. The installer bundles its own runtime. You do need the
Grok CLI installed and your own Grok account.

These installers are unsigned

Both operating systems will warn you. That is expected for an unsigned app.

macOS will say the app is damaged or cannot be opened. It is not damaged.
Right-click the app and choose Open, then confirm. Double-clicking will not
work until you have done that once.

Windows SmartScreen will show a blue box. Click More info, then
Run anyway.

SHA256SUMS.txt verifies your download arrived intact. That checks integrity,
not authorship — only signing does that.

Known limitations

• Developed and tested on Windows. The macOS and Linux builds are produced by CI
  and have not been run by the author. Reports very welcome.
• No automatic updates. Code signing has to land first.
• Your conversations are stored on your machine as readable text, which is what
  comparable tools do. Do not paste secrets into a chat.

Full detail in CHANGELOG.md.