Repository navigation
Releases
kk v0.9.3b
- Fixes the v0.9.3 launch crash where macOS could not locate the bundled Sparkle framework. The app now includes the bundled-framework search path in Debug and Release builds.
- Packaging now rejects apps missing that search path or the Sparkle framework, preventing this broken package from being released again.
- About settings now uses two columns so version, update controls, launch at login, onboarding, and Quit fit in one view without scrolling.
- Version 0.9.3b, build 931. Keeps the existing Sparkle signing key and public update-feed URL.
If v0.9.3 crashes on launch, download and replace it manually once. That build cannot run its updater. After installing this fixed build, update checks are available in Settings → About; automatic download and installation can be enabled there.
Validation: 198 regression tests passed, plus the arm64 Release build, packaged ZIP/DMG signatures, runpaths, versions, architecture, matching binaries, checksums, and update-archive signature. The corrected app was launched directly from the extracted release ZIP, and its menu was confirmed working. Four settings tests passed after the layout change, including light and dark About renders.
Requires macOS 15 or later and Apple Silicon (arm64). Includes an app ZIP, DMG, SHA-256 checksums, and the signed-update appcast.
This app is ad-hoc signed and not notarized.
After moving kk.app to Applications, if macOS blocks opening it, run this in Terminal:
xattr -rd com.apple.quarantine /Applications/kk.appkk v0.9.3
- Settings → About now shows the version and build number, with manual update checks and optional automatic installation of signed updates.
- Retry completed answers or edit an earlier prompt in place. Escape cancels, Return sends, and Shift+Return adds a newline; the follow-up draft is preserved while editing.
- Revising an earlier turn checks later prompts and answers with your model, preserves independent turns, and revises dependent ones when needed. Inferred prompts have dashed bubbles; hover to browse original and revised versions. Copies and follow-ups use the newest versions. Failed or cancelled revisions keep the original conversation.
- Optional capture flash in Settings → General: Off, Low, or Full. Only successful desktop captures flash, with reduced intensity when Reduce Motion is enabled.
- Optional LaTeX line wrapping in Settings → Advanced. Long display equations wrap at safe operators without shrinking the text; unsplittable expressions still scroll.
- Quiet-space placement prefers taller usable regions across subtle borders and background-color changes. Popup height now grows with the streamed content in both placement modes instead of filling unused space immediately.
- Scroll to latest: a button appears when you scroll up in a chat and returns to the newest message.
Validation: 198 regression tests passed, plus the arm64 Release build and ZIP/DMG signature, version, architecture, and checksum checks. The update feed and archive signature were verified. Revision tests use a stubbed endpoint and capture/placement tests use fixtures; live-model revision quality and physical multi-display capture remain unverified.
Requires macOS 15 or later and Apple Silicon (arm64). Includes an app ZIP, DMG, SHA-256 checksums, and the signed-update appcast.
This app is ad-hoc signed and not notarized.
After moving kk.app to Applications, if macOS blocks opening it, run this in Terminal:
xattr -rd com.apple.quarantine /Applications/kk.appkk v0.9.2
- Mermaid diagrams: answers can include flowcharts, sequence, class, state, and ER diagrams, Gantt charts, and more, drawn on your Mac with a bundled copy of Mermaid 11.17.2 (no network access).
- Native styling: system font, your accent color, rounded shapes, and light and dark variants. Diagram labels scale with the chat text size; very wide diagrams scroll sideways, with a scroll bar shown until you scroll.
- Automatic repair: if a diagram doesn't parse, kk asks the model once for a corrected version and replaces it in the answer, so copies and follow-ups use the fix.
- Math in diagram labels with
$$…$$(flowcharts and sequence diagrams). - Hover a diagram to enlarge it, copy it as an image, or show its source. Diagram drawing and automatic repair can be turned off in Settings → Advanced.
- Blank-space placement now keeps chat beside the window you're working in, opens at full width in the quietest spot, and grows through mostly blank rows after you send.
- Manual resizing stops at a usable minimum size, and the header and question field no longer get clipped in narrow windows.
- The annotation toolbar's "Ask kk" button becomes an icon at narrow widths instead of wrapping.
Validation: 177 regression tests passed, plus the arm64 Release build and ZIP/DMG signature, version, and checksum checks. Diagram tests cover the bundled renderer, styling, math, and the repair flow against a stubbed endpoint; placement tests use synthetic screen images. Live models, real desktops, and manual edge-dragging remain unverified.
Requires macOS 15 or later and Apple Silicon (arm64). Includes an app ZIP, DMG, and SHA-256 checksums.
This app is ad-hoc signed and not notarized.
After moving kk.app to Applications, if macOS blocks opening it, run this in Terminal:
xattr -rd com.apple.quarantine /Applications/kk.appkk v0.9.1
- File attachments: paste (⌘V), drag and drop anywhere on kk, or pick files. Works in the launcher and in follow-ups.
- Images, including HEIC/HEIF, WebP, AVIF, PNG, and JPEG. Photos are rotated upright and resized before sending.
- PDFs send the text of every page. Scanned pages are read with on-device OCR, and the first 8 pages are also sent as images for vision models (adjustable or off in Settings).
- Text and source files (
.txt,.md,.py,.json, and more) in UTF-8, UTF-16, UTF-32, or Windows-1252. - Attachment chips with previews, loading progress, and clear errors. Attachments stay with their question for follow-ups and retry.
- Drop feedback: the question field blurs behind a "Drop to attach" target while you drag.
- New Advanced settings tab: send attachments without a question (on by default), PDF page images, an optional attach button (hidden by default), and the window, button, and conversation options moved from General.
Validation: 157 regression tests passed, plus the arm64 Release build and ZIP/DMG signature, version, and checksum checks. Attachment tests cover encodings, HEIC/WebP decoding, EXIF orientation, OCR, locked PDFs, and pasteboard priority; live drags from Finder and Photos remain unverified. The first scanned PDF after installing or updating macOS can take about a minute while macOS prepares its text-recognition model.
Requires macOS 15 or later and Apple Silicon (arm64). Includes an app ZIP, DMG, and SHA-256 checksums.
This app is ad-hoc signed and not notarized.
After moving kk.app to Applications, if macOS blocks opening it, run this in Terminal:
xattr -rd com.apple.quarantine /Applications/kk.appkk v0.9.0.7b
- Fix blank-space chat height: after finding the largest blank square, kk extends into the available blank space above and below it at the fitted width.
- After sending a message, chat fills that available height, including beyond the usual 620-point cap. The composer remains at the bottom, and manual dragging preserves the taller window.
Validation: 119 regression tests passed, plus the arm64 Release build and ZIP/DMG signature, version, matching-binary, and checksum checks. Placement tests use synthetic images and native windows; live desktop and physical multi-display behavior remain unverified.
Requires macOS 15 or later and Apple Silicon (arm64). Includes an app ZIP, DMG, and SHA-256 checksums.
This app is ad-hoc signed and not notarized.
After moving kk.app to Applications, if macOS blocks opening it, run this in Terminal:
xattr -rd com.apple.quarantine /Applications/kk.appkk v0.9.0.7
- Optional Move chat to largest blank space setting: kk finds the largest visually quiet square on the chat’s display when it opens and whenever a message is sent.
- Ignores faint, thin dividers and adjusts chat width and height to fit, with a readable minimum when space is tight. Manual dragging and resizing take control until the next send.
- Placement scans run locally, exclude kk’s own windows, and never become message attachments. Requires existing Screen Recording access; normal placement remains available when scanning cannot find a useful area. Off by default in Settings → General.
Validation: 118 tests passed, plus the arm64 Release build and ZIP/DMG signature, version, binary, and checksum checks. Placement tests use synthetic images and native windows; live desktop placement and physical multi-display behavior have not been verified.
Requires macOS 15 or later and Apple Silicon (arm64). Includes an app ZIP, DMG, and SHA-256 checksums.
This app is ad-hoc signed and not notarized.
After moving kk.app to Applications, if macOS blocks opening it, run this in Terminal:
xattr -rd com.apple.quarantine /Applications/kk.appkk v0.9.0.6
- Adjustable chat text size in Settings, with a slider and reset to default.
- Refreshed README, demos, and GPLv3 license.
This app is ad-hoc signed and not notarized.
After moving kk.app to Applications, if macOS blocks opening it, run this in Terminal:
xattr -rd com.apple.quarantine /Applications/kk.appkk v0.9.0.5
- kk shortcut focuses an open chat’s follow-up field.
- Eraser (X) deletes a clicked stroke, with Undo.
- Hover + Delete removes marks while the canvas has focus. Toggle it in Settings → Annotations.
This app is ad-hoc signed and not notarized.
After moving kk.app to Applications, if macOS blocks opening it, run this in Terminal:
xattr -rd com.apple.quarantine /Applications/kk.appkk v0.9.0
kk v0.9.0 preview
Updated build 902: adds Pointer to Settings → Annotations → Default tool. Selecting it starts annotation sessions on the live desktop with clicks passing through. Drawing tools and Return to drawing remain available. Includes the build 901 onboarding focus fixes.
A native macOS assistant for questions about your screen.
- Configurable global shortcut, compact launcher, content-fitting conversations, Markdown and LaTeX.
- Screen annotations with pointer, freehand, ellipse, rectangle, arrow, movable/resizable marks, and customizable tool keys.
- Frozen or live screen context and active/cursor/all-display capture selection for each chat turn.
- Editable follow-up drafts during streaming, Stop, copy feedback, and optional multi-turn dismissal/copy controls.
- General-first settings, appearance/material/accent controls, onboarding, permission guidance, and Launch at login.
Downloads
Requires Apple Silicon (arm64) and macOS 15 or later. Liquid Glass requires macOS 26; earlier systems use translucency.
- DMG: open it and drag
kk.apponto the Applications shortcut. - App ZIP: extract it to obtain
kk.app. - SHA256SUMS.txt: checksums for both downloads.
This prerelease is ad-hoc signed and not notarized. It does not include a Developer ID distribution signature. macOS may block the first launch; review the app in Privacy & Security before allowing it.
Screen Recording access is optional for text-only use. Configure an OpenAI-compatible endpoint/model and your own API key in Connection settings. API keys are stored in Keychain; screenshots and chat history stay in memory.
README screenshots use sample content. Build 902 was verified with a Release build and package/signature checks; tests were skipped as requested. Physical multi-monitor capture and complete macOS permission/relaunch interactions remain manually unverified.