Repository navigation
Releases: Arthur031221/Blinkling
Release list
Blinkling v3.2.6
Blinkling 3.2.6
A Mac without Node.js gets a working install, an honest Windows requirement, first-start windows you can move, and several fixes to the card, the answers and the click away.
- Start Claude Code with
claude --dangerously-load-development-channels plugin:blinkling@blinkling, then type/blinkling:blinkling. The flag lets Blink's chat reach this session. Claude Code asks you to confirm it once. Without it Blink still works and answers from its own session. - A Mac without Node.js now gets a working install. Every plugin command starts through
bin/blinkling-run(a shell script, with a smallblinkling-run.exestub and a.cmdfile for the Windows MCP server), which finds Node.js 22 or newer (PATH, Homebrew, Volta, asdf, mise, nvm, fnm) or fetches a private, SHA-256 checked copy into~/.blinkling/runtime/node. Hooks exit quietly without Node.js and say so once. A test runs every hook command and the MCP handshake with a PATH that has no node. - The README no longer says Node.js is not required on Windows. Windows needs Node.js 22 or newer from nodejs.org, while macOS and Linux fetch a private copy. The Windows MCP server starts through
bin/blinkling-run.exe, a stub built in CI and checked by a test that spawns it without a shell. CI also installs the plugin into Claude Code 2.1.302 on Windows, whereclaude mcp listreports the server connected, and the same check passes on Linux with a PATH that has no Node.js. - Every README and the install doc list Node.js 22 or newer as a Windows prerequisite before step 1, and the open command tells a Windows user whose MCP server is down to install it and run
/mcp. - A card, its tail and a dropped Blink are measured from Blink's real window frame, so they stay together where the frame starts below the display's corner.
- One question has one answer: the first reply is final. A later reply is told it came late and changes nothing.
- On macOS a click away from Blinkling is heard before Input Monitoring is allowed, by a second helper mode that only reads the mouse buttons and stops once the key tap is up.
- A click inside Settings or the welcome no longer closes the card, and the next click on the background still ends it.
- The translate demo is recorded with the app pinned to English, its answer text is kept with the recording, and a test reads that the answer is in the language its caption names.
- Desktop tests pass on Node 22 as well as 24, because a request that waits keeps the event loop alive. The conversation spec expects Haiku 5.5.
- What is and is not isolated between chats: a card follows its own session's chat and its history, but an answer to a capture, Auto explain or a dropped question comes from Blink's own shared session, whose model, effort and context every chat uses.
- Welcome, Settings and the macOS permission guide can be moved from anywhere that is not a control: the whole header and any empty area drag, while buttons, links, fields and code stay clickable and selectable. The window stays inside the work area, a double click on an empty area puts it back, and the place is kept. Acceptance tests drag all three with the real pointer.
- The nine READMEs are rewritten. They tell you to close the terminal and open a new one after installing anything, give the one command that starts Claude Code with Blink's channel and say what its flag does, and keep Node.js 22 or newer for Windows and the private copy for macOS and Linux.
- A chat test no longer fails now and then because a delayed save recreated its folder during cleanup.
- Nothing else changes from 3.2.5.
Blinkling v3.2.5
Blinkling 3.2.5
A resizable card, live sessions only, answers drawn like a chat, and a costume scene for every model.
- Start Claude Code with
claude --dangerously-load-development-channels plugin:blinkling@blinkling, then type/blinkling:blinkling. The flag lets Blink's chat reach this session. Claude Code asks you to confirm it once. Without it Blink still works and answers from its own session. - The chat card can be resized by dragging its edges and corners, within limits, and it keeps its size. A card beside a low Blink reaches the bottom of the work area.
- The chat list shows live sessions only, with one chat per live session. Every live chat has the model and effort pickers and the quick chips. A capture goes to the newest session, and Auto explain and a dropped question are answered inside the session's own chat.
- Answers are drawn like a chat answer: headings, nested lists, tables with alignment, quotes, inline code and highlighted fenced code in monospace. The history stays at the newest message when the layout grows.
- Under every answer there are copy, ask again, read aloud and its time. Under every message there are its time, a delivered mark, copy and edit. Every copy goes through the system clipboard, so the code copy button works.
- The Guide ignores clicks on its own marks, labels, panel and buttons, and a click on the background ends it at every phase. Step 1 comes first with its place in the tour, and a closed guide can be shown again without a new run. On macOS and Windows the card and Blink are raised over the guide's marks, so no frame crosses the card.
- Auto explain stays inside Blink and is stopped there, and its answer opens the card. A draft that sits idle no longer holds it back, turning it on asks even with a draft in the card, and End tour frees Blink's session.
- Each model has its own transformation scene and leaves one signature piece on Blink, and each effort level has its own one-off show with props. A Settings switch turns the costume effects off, and the choice is kept across restarts. The piece stays on while Blink peeks at an edge, and it is mirrored at the right edge like the left.
- Models are labelled Opus 5.5, Sonnet 5.5, Haiku 5.5 and Fable 5.1 everywhere.
- The card opens when Blink's renderer reports that the swallow is done, with the timer only as an upper bound, and a failed flight still waits for the swallow before the card opens.
- The permission bubble closes with Esc, with its own close button and with a click on the background. A card that opened without focus closes with Esc.
- On X11 the screen is read after four settle frames instead of eight, so Blink is out of sight about 60 ms less.
- On Windows the window shape Blink is clipped to follows what a model leaves on Blink, including the props, the guide stick and the pose of a worn piece, and the hit check reads that shape. A long press on any part of the drawn Blink picks it up, and one outside falls through.
- When a question from Blink arrives while a typed prompt is still being answered, the terminal's own answer is no longer swallowed. It is read from the transcript and shown in the chat first, and Blink answers once after it if the terminal ignored the question.
- A very long page is cut at the tile limit and still gives a full page chip, so a paired browser no longer falls back to the visible part.
- Smaller: a picked paragraph or text file reaches the terminal as its text, an unset quit key says so in Settings, the first start notice never blocks, a press on a resize handle no longer snaps the card, and the docs no longer describe the small composer.
- Nothing else changes from 3.2.4.
Blinkling v3.2.4
Blinkling 3.2.4
A readability fix for the chat card.
- Start Claude Code with
claude --dangerously-load-development-channels plugin:blinkling@blinkling, then type/blinkling:blinkling. The flag lets Blink's chat reach this session. Claude Code asks you to confirm it once. Without it Blink still works and answers from its own session. - The card's paper is solid where the message list starts, so an answer's text never mixes with the page behind the card, and the four demos are recorded again with it.
- Nothing else changes from 3.2.3.
Blinkling v3.2.3
Blinkling 3.2.3
One card, a capture that lands in the mouth, the first Guide back, and a new session that starts fresh.
- Start Claude Code with
claude --dangerously-load-development-channels plugin:blinkling@blinkling, then type/blinkling:blinkling. The flag lets Blink's chat reach this session. Claude Code asks you to confirm it once. Without it Blink still works and answers from its own session. - A capture lands in Blink's mouth, and the card opens only after the swallow, on every edge and at every display scale. The picture is aimed from the same transform that draws Blink.
- A quick chip sends exactly the words on the button, with no added line about length or brevity, in Blink's own session and through the channel to the terminal session.
- There is one dialog box. The small quick window is gone, a capture goes into the big card's own box, and clicking Blink while the card is open never makes a second surface.
- The Guide is the first version again: the parts of the page are framed and named, the card has Back, Done, All steps and End tour, and Blink holds the guide stick and points at the framed part as the steps change.
- Auto explain takes the whole screen and asks what it is. The card shows only the picture and the answer, never the prompt, and it stays until you close it. It asks again only when the screen has changed enough.
- The full page button shows a progress bubble, the page flies into Blink's mouth like any capture, and then the card opens with one full page chip and its thumbnail.
- The idle grumble stays at the edge: Blink does not come out, and the bubble shows beside the peeking head.
- A Claude Code session that Blink has not met starts a brand new chat. The card follows it as soon as it links and starts empty, nothing of an earlier session is replayed into it, and the older chats stay in the switcher.
- A click on the desktop background closes the menu bubbles, the progress bubble, speech bubbles and the card in one go, and Blink goes back to its edge. A pinned card stays, and the idle grumble bubble is left alone.
- A quit key ends Blink within about a second from any state, even when a window is hung, and tells the linked terminal sessions that Blink was closed. It is Ctrl+Alt+Shift+B on Windows and Linux and Ctrl+Option+Command+B on macOS, and it can be changed in Settings.
- Changing the model or the effort dresses Blink for a few seconds: a crown and cape for Opus, glasses and a notebook for Sonnet, a scarf and a paper plane for Haiku, a storyteller's hat for Fable. The effort picks the move, from a small nod to a spin with sparkles. Nothing plays at start up or when the same value is picked again.
- The model list has Opus, Sonnet, Haiku and Fable, and every model is shown with its version, such as Opus 5.5 or Fable 5.1, in the list and on the selected value. A stored alias shows the version it stands for now.
- Pointing at a part of Blink triggers that part's reaction where the part is drawn. The hit zones and the drawing share one transform, with tests at scale 1 and 2, work area offsets and every edge. Setting BLINKLING_DEBUG_HIT=1 draws the zones.
- The capture progress bubble and the idle grumble bubble draw on Windows too. Blink is hidden from the capture itself on macOS and Windows, and on Linux it hides for as short a time as it can.
- Smaller: a new capture clears the old pointing marks, the card title sits on solid paper, and a terminal session started with the channel flag whose events are dropped is told about the quit through the notice hook like any other session. The open command says nothing about the start command when there is no Sync line.
- Pressing Esc to close the card no longer sends Blink to its edge as if you had clicked away: the blur that follows is only the hidden card giving up the keyboard. The guide stick is kept out of the screen watch like Blink itself, and a capture waits long enough for a hidden surface to be gone before the screen is read. The guide's screen watch skips a frame taken just after Blink's own windows moved, so moving the card to the next step cannot end the tour by itself.
- The four demos are recorded again from this build at twice the pixels and 30 frames a second. The READMEs show animated WebP files 1280 px wide, and the site plays H.264 MP4 and WebM video at 1920 px with a sharp poster, at its natural size.
Blinkling v3.2.2
Blinkling 3.2.2
Blink and its card follow each other frame by frame, the terminal chat is more honest, and the welcome shows how to link a session.
- Start Claude Code with
claude --dangerously-load-development-channels plugin:blinkling@blinkling, then type/blinkling:blinkling. The flag lets Blink's chat reach this session. Claude Code asks you to confirm it once. Without it Blink still works and answers from its own session. - The card follows Blink on every pointer event of a drag, so its tail stays on the mouth in every frame, also near the screen edges, instead of catching up when the drag stops.
- A slow capture shows its progress in a bubble beside Blink. The card opens only after the picture has been eaten, with no frame where both Blink and the card vanish.
- A click on the desktop closes the card on macOS and Windows too, through the global mouse hook, even when the card opened by itself without focus. On macOS this needs the Accessibility permission. Linux behaves as before.
- The Guide stick is longer and is aimed at the current step from every edge. The Step n of N header sits on solid paper outside the card's top fade, so it reads clearly.
- The welcome shows the start command and its one line of explanation on a connect page, and drops the permission page where nothing is asked. The plugin command no longer says that no launch flag is needed.
- Terminal chats no longer show the paste markers a terminal session adds, such as [Image #1] or [Pasted text #2]. A question that the linked terminal session never takes is answered by Blink after ten seconds, once, with one line that says so, and a late answer from the terminal is dropped.
- The provider prompt no longer limits the length of an answer, so a chip gets the answer to exactly its words. The Guide keeps its one sentence per step, because it is a tour.
- The tiles of a full page capture show as one page chip in the composer, and removing the chip removes every tile.
- The pointing instructions now tell the model to keep an element's name in the sentence and put the numbered mark right after it, and never a mark in place of a name. This is checked on the instructions, not on a live model answer.
- The Settings and welcome panels move off the chat card when either one opens, so the two never overlap, whichever opens first.
- The four README recordings are made again from this build.
Blinkling v3.2.1
Blinkling 3.2.1
Terminal and Blink now share one chat, and a round of fixes from testing 3.2.0 on a Mac.
- Start Claude Code with
claude --dangerously-load-development-channels plugin:blinkling@blinkling, then type/blinkling:blinkling. The flag lets Blink's chat reach this session. Claude Code asks you to confirm it once. Without it Blink still works and answers from its own session. Every README, the install guide, the site, the demo page, the installers and Settings say the same line. The plain--channelsflag was tried and Claude Code 2.1.301 refuses it for this plugin as "not on the approved channels allowlist", so the development flag stays. - One terminal session is one chat in Blink. What you type in the terminal appears in Blink on the right, Claude's answer on the left, and what you type in Blink is answered in the terminal by the same session through the channel and the reply tool, with no raw markup and no double answers. A session that goes away with a question open answers it as closed instead of leaving the card waiting.
- The card and Blink behave as one. The card follows Blink while it is carried and its tail stays on the mouth. A click on the background hides the card and sends Blink back at once, also while an answer streams, and the answer goes into the history. Leaving Blink with no card open sends it back after a short corridor grace. An empty card is short and grows from Blink's mouth, and it fades softly toward its top. The menu and the card never share the screen. Blink also stays out beside Settings and the welcome while they are open.
- Touching Blink reacts where it is drawn. Hover zones follow Blink's real shape in every pose and edge, and the peeking head answers where it is drawn even when the system keeps the window off the menu bar or the Dock. The idle grumble shows again after a failed action.
- The Guide is a short tour again: at most ten steps and only the regions they point at, a Step n of N header, an All steps list, and Blink points at the current step with a stick. The full page button always answers, with a line that it has begun, a retry on failure and a note when it is busy. Auto explain looks at the whole screen, asks at once when you turn it on, then asks again only when the screen changed enough.
- One composer. A capture goes into the card's own box, Enter on an empty box sends the highlighted chip, and the quick window is gone. The eat is faster and aims at the mouth on every edge, and the card opens only after it. No prompt Blink sends limits the length of the answer.
- The language changes in place: every window, the menu and the card take the new words at once with no reload and no restart. Dragging or double clicking a Settings or welcome header no longer selects its title. After the image viewer closes, the card is back on the newest answer, and it stays there when the composer grows.
- Starting is quicker: typing /blinkling starts Blink from the prompt hook straight away, without waiting for the model's turn before the open call, which took about 9 seconds.
- Picking text in a Linux browser now takes what you point at. A paragraph that holds links reads with the words of the links instead of blank marks, and pointing at a comma or a space between two links picks the paragraph instead of that one mark. A paragraph from an accessibility tree is read like other text: the sentence under the pointer first, then the paragraph.
- A Guide on a photo-heavy page is no longer closed a second after it appears. The picture the model saw and the live screen are now shrunk the same way before they are compared, so photos and fine text no longer read as the page having changed.
- The Guide shows its own controls. Start, Back and Next sit under the step text, and the card that opens while the screen is read is faded out of the picture like Blink and the menu, so the guide marks sit on the page and not on a half faded card.
- Privacy guard on every capture path. The one click Screenshot bubble, the largest visible area, the pick and the full screen all hide Blink's own windows before the picture is taken, including a window that appears during the first fade.
- The README shows three demos side by side, recorded again from this build: a paper (pick a paragraph, it flies into Blink's mouth, the answer streams), an Arabic Wikipedia article (the Translate chip), and a page that is hard to operate (the step by step Guide). Each is about 20 seconds and under 4 MB.
Blinkling v3.2.0
Blinkling 3.2.0
One chat card for every answer, a capture that visibly flies into Blink, and a round of fixes from testing 3.1.0 on a Mac.
- The chat card is the one place answers appear. It points at Blink's mouth, sits close to its body, follows it, and can be dragged a short way by its header, with the spot remembered for each edge. It shows the thinking dots with a changing word, keeps messages tight with your side tinted green, fades at the top, and opens at the newest message. An answer opens it by itself.
- Blink stays out while you read, scroll or type, and goes back to its edge only after a short quiet time. The old answer deck is gone, and every surface that could be left behind now closes by time, Esc, a click outside or leaving it.
- A picture in the card opens in a viewer with wheel and pinch zoom from fit to 800 percent, drag to pan, a double click between fit and 100 percent, and Esc or a click on the backdrop to close. Settings, welcome and the quick box can be moved a short way by their header.
- Capture is whole. The screenshot bubble and the full screen bubble take the picture, Blink eats it and the question opens with it. The picture flies into Blink's mouth above Blink the whole way and is cut at the mouth, so it visibly goes in. A whole page from the browser extension arrives as every tile. When the page cannot be scrolled, or no extension is connected, you get what is on the screen and one line says why.
- A picked rectangle gets an exact rounded frame in Blink green with a light and a dark hairline, and one calm light runs round it clockwise at a steady speed.
- Blink looks and moves better. The right edge matches the left, the bottom edge shows the eyes, cheeks and both hands, the legs stay whole when it turns upright, and its click area is its drawn shape plus a small margin. It now plays the missing motions: appear, leave, turn, walk, pick, catching a file, celebrate, shrug, whirl and dizzy.
- Guide and Auto explain run to the end without holding the app. Whole screen pictures are compressed on a worker thread, and a measured pass at 100 and 200 percent shows no frame over 50 ms and no long task.
- Starting is faster. An installed build is trusted by its fingerprint and Blink no longer waits for the archive check: 824 ms instead of 2168 ms.
- The terminal session and Blink's chat follow each other. A prompt and a finished answer typed in the session that opened Blink appear in Blink's chat, and Blink's chat reaches a session started with the development channel flag. Lines are never sent back to where they came from.
- Answers are no longer cut short by a length rule in the system prompt. All nine tools carry a title and the read only, destructive, idempotent and open world hints. Every README links the newest release notes.
- The release job commits the pinned builds as Arthur031221 with the private noreply address, so the history no longer shows github-actions[bot] for new releases.
Not tried on a real Mac here: the pick key helper from 3.1.0, and the feel of the motions on a physical display. They were checked by automated tests on Linux with a compositing window manager.
The four desktop builds keep the names used by 3.0.0, with the version changed to 3.2.0. The plugin pins each build by SHA-256 and size.
See the install guide for the manual route.
Blinkling v3.1.0
Blinkling 3.1.0
A new Blink, a smoother pick and a sturdier connection to the command line tool.
- Blink is new, and smaller. Held, it trembles and its legs dangle. Swung round in two full circles, it gets dizzy. Touching its head, cheeks, belly, hands or feet each gets a different reaction, and after a quiet minute it thinks out loud in one of eight short lines in your language. The logo, the app and browser helper icons, the permission page, the demo recordings, the store images and the social card all show the new Blink.
- The Ctrl pick keeps going while the key stays held: captures pile up, the auto box morphs into the dragged rectangle, text is marked with a highlighter stroke, and on release the captures are sucked into Blink's mouth. The quick box keeps every capture and a thumbnail opens the full image. The hint no longer runs off the right edge of the screen.
- The quick box and the chat card share one toolbar with a file button and lists for model, effort and permission, and both are anchored to Blink's mouth.
- Typed messages now get an answer or a visible reason. Command line tool builds 2.1.296 and later in the 2.1 line are accepted, the command is found even when the app was opened from the Dock, and a message typed in the linked web or phone session shows up in Blink too.
- macOS: the pick key no longer shares Blink's main thread, which froze Blink with input methods such as Zhuyin. Keys come from a small separate helper. This fix could not be tried on a real Mac here, only through the automated tests.
- Close joins the menu as a fifth bubble and always quits. Screenshot takes the largest area you can see in one click. Settings has a Language row with all nine languages, and so does the install page.
The four desktop builds keep the names used by 3.0.0, with the version changed to 3.1.0. The plugin pins each build by SHA-256 and size.
See the install guide for the manual route.
Blinkling v3.0.1
Blinkling 3.0.1
A small fix release for 3.0.0.
- macOS: the Ctrl pick key needs the Accessibility permission, which the first run never asked for, so on a Mac the pick could silently do nothing. Blinkling now raises the system prompt once and starts listening for the key as soon as you allow it, with no restart. The README, the install guide and
docs/INSTALL.mdsay so. - Guide mode failure and closing bubbles follow the system language in all nine languages. They were fixed Traditional Chinese for everyone.
- The Full page chip falls back to the visible part of the window when the page grab fails. The attachment is now named Visible part, so it is not mistaken for the whole page.
The four desktop builds keep the names used by 3.0.0, with the version changed to 3.0.1. The plugin pins each build by SHA-256 and size.
See the install guide for the manual route.
Blinkling v3.0.0
Blinkling 3.0.0
Blink now lives on your desktop, a small character in the corner of the screen. Hold Ctrl and click a thing, or hold Ctrl and drag an area, and Blink explains it with your own Claude Code session. Blink only looks and explains. It never clicks, types or controls your apps.
Install it from Claude Code with one pasted line, then run /blinkling:blinkling. On macOS, allow the screen permission once when it asks. The install guide picks your system and shows only its steps, with a short animation for each action.
The release carries four desktop builds, named by system: Blinkling-3.0.0-mac-arm64.zip, Blinkling-3.0.0-mac-x64.zip, Blinkling-3.0.0-win-x64.exe and Blinkling-3.0.0-linux-x64.AppImage. The plugin pins each build by SHA-256 and size and refuses anything else, so it never runs a download it did not expect. SHA256SUMS lists the same digests.
- On Ubuntu 24.04 and other systems that restrict unprivileged user namespaces, Blink now starts without manual steps. It uses the Chromium sandbox whenever the system allows one and falls back to running without it only when neither a user namespace nor a setuid helper is available.
- The plugin finds the build whether the repository is reached by its new address or by the old one, which GitHub redirects.
startWithClaudeCode=falseis honored: Blink stays closed when Claude Code starts.BLINKLING_REMOTE=0skips the Remote Control request for automated runs.- The plugin, the desktop app and the root package all report 3.0.0, and the two install scripts read the same default repository.
macOS builds are ad-hoc signed, not notarized, and Windows builds are unsigned. If macOS shows "cannot be opened" or Windows SmartScreen warns, the install guide shows the short steps to allow Blinkling.
See the install guide for the manual route.