Burn after reading.
A sealed letter for your quick questions on macOS.
Write on the parchment, a quill writes the answer back, and the letter burns when you're done.
Press ⌥H anywhere. A letter settles at the top of the screen, already sealed in wax.
- Parchment, not a text box. The paper has deckled edges, fibers and a fold crease. The newest question and its answer sit just below the writing line, with earlier exchanges beneath them. The sheet grows downward up to an A4 page or the available screen height, then stays in place as the answer continues below the fold. Scroll down to read more; sending a question returns to the top.
- A quill that writes. Answers stream in at a hand's pace. Fresh ink glows gold before it settles to sepia, and the quill rests after the last word. While the model thinks, the quill hovers and counts the seconds.
- Wax seals. The crimson seal names the model writing to you. Paste a long text or a picture, or capture a region of the screen, and it is sealed into an amber seal cut with runes instead of filling your question.
- Burn after reading. Press Esc or click the flame in the bottom-right corner, and the letter catches fire at its bottom edge. Scorch, embers and sparks climb to the seal, and the conversation goes with them. Nothing is saved.
![]() |
![]() |
| Esc, and it burns | Candlelit paper in Dark Mode |
Reduce Motion turns off the falling paper, the stamping, the ink shimmer and the fire. The text simply appears.
With Homebrew:
brew install --cask hiarieszhou/tap/howlerOr install manually:
- Download Howler.dmg, open it, and drag Howler onto Applications. Older versions and
Howler.zip(the same app) are on Releases. - Open Howler. It is signed with a Developer ID and notarized by Apple, so it opens like any other app. Updates keep your Keychain and screen-recording permissions.
- A small quill appears in the menu bar. Howler has no Dock icon.
- From v0.1.7 on, Howler updates itself. Choose Check for Updates… in the menu, or let it check once a day (Settings › General). When a background check finds a new version, a small dot appears beside the menu bar quill and the version label in Settings becomes an Update button. Click it to download, install and restart Howler. Nothing installs until you choose to update. Sparkle handles progress, cancellation and errors, and verifies the download's EdDSA signature and Developer ID. Versions up to 0.1.6 need one manual download.
Releases before v0.1.4 were ad-hoc signed. If Gatekeeper stops one of those, right-click it and choose Open.
When Howler detects models in a running local Magpie app, Settings → General offers Subscription. Pick a model marked Images for screenshots. You can switch to API Key to use your own provider key. Howler remembers both setups. Burning clears the letter in Howler. Magpie and its model provider manage their own records.
Howler writes with one model service. The setup is short enough to hand to an AI assistant.
In Settings › General, select a provider, enter a model and paste your API key. Click Edit if you already have a saved configuration. Choose Custom to enter your own base URL and request format. Click Save & Check. The key goes directly into macOS Keychain.
For help configuring service or request parameters, use Copy Setup Prompt and paste it into an assistant that can run commands. Enter the key in Howler.
Save & Check sends one test request with a 30-second connection deadline. A saved key record does not prove the key is readable or the service works. Keychain access failures keep their diagnostic code and stop the flow; they never automatically delete and recreate the old key. For other failures, the setup prompt allows one diagnosed correction and retry before reporting the remaining problem.
You can run the same commands yourself. They live in the app binary:
H=/Applications/Howler.app/Contents/MacOS/Howler
$H config schema # every field, with examples
$H config set preset=deepseek 'body={"thinking":{"type":"disabled"}}'
pbpaste | $H config set api-key --stdin # or --env NAME, --file PATH
$H check # --verbose shows the request, key masked
$H config show| Field | Meaning |
|---|---|
format |
chat-completions (OpenAI and compatible, including local Ollama / LM Studio), anthropic-messages, gemini-generate-content |
base-url |
API base without the endpoint path; https:// only, except http://localhost |
model |
Model name as the service spells it |
body |
JSON merged into every request, e.g. to turn thinking off or cap the output |
headers |
Extra HTTP headers. Never the key. |
preset |
openai, anthropic, gemini, xai, deepseek or openrouter. Fills the three fields above. |
Changes take effect in the running app at once. Every request goes straight to the service you configured, never through a relay.
Changing the host, scheme, port or authentication format clears the saved key. Save a key for the new service before checking or sending. Changing only the model or API path on the same origin keeps the key. Editing the setup, key or system instructions invalidates the previous check.
Every conversation starts with a short system prompt, shown in full in Settings › Prompt:
- The date, in UTC, e.g.
Current date: 2026-10-29 (UTC).Without it a model takes its training cutoff for today. UTC says nothing about your time zone or location. Howler adds it; it can't be edited. - Instructions, editable. The suggested ones ask for short answers without tables (the letter can't show them), following the reply language requested for the current task. Reset brings them back.
Leave the instructions empty to turn the whole prompt off, date included, for models that reject a system prompt. A body that sets system (Anthropic) or systemInstruction / system_instruction (Gemini) replaces it.
The model can't search the web: it answers from what it was trained on, and the date only lets it say when something may be too recent for it.
| ⌥H | Show or focus the letter. Press again while focused to conceal it, keeping the conversation. Change or clear it in Settings › Shortcut. |
| ⌥⇧H | Capture a region, send it immediately and introduce it automatically. Change or clear this shortcut in Settings › Shortcut. |
| ⌥, | Open Settings from any app. Change or clear it in Settings › Shortcut |
| ↩ / ⌥↩ | Send / new line |
| ⌘C | Copy the latest answer (or click ❧ Copy). With text selected, it copies the selection. |
| + Attach | Paste from the clipboard, or capture a screen region |
| ⌘V | Short text goes into the question. Text of 280+ characters or 3+ lines, or a picture, is sealed as an attachment, including an image copied in a browser or an image file copied in Finder. |
| Esc / bottom-right flame | Burn and clear the letter. Esc first cancels composition, capture or an open preview. |
| Click outside | Return focus to the other app; keep the letter and replies. |
Capture and Explain sends your selected region to the configured model immediately and starts an introduction. Pasted text and pictures still wait for you to send. While the model thinks or writes, type follow-ups and press Return to queue them: the introduction appears first, then each answer in order. Use Edit on a waiting question when the input is empty to restore it; sending it again places it at the end. ⏹ stops the current reply and pauses the queue, keeping partial text. Retry reply replaces that attempt; Skip and continue keeps it as incomplete context. Network errors pause the queue too.
Further screenshots add introductions to the same queue. The input shows which screenshot a question refers to and lets you change it. A new capture does not silently change existing drafts or queued questions. Click the amber seal to preview the selected image.
Settings has three tabs: General, Prompt and Shortcut. All three shortcuts can be changed or cleared in Shortcut. Click the clear button, or press Delete while recording, to disable that global shortcut; an empty field stays empty after restart. Restore its default with the reset button. Recording and resetting check conflicts against other configured shortcuts. Menu actions and manual capture in Attach remain available, and existing replies continue. The menu bar menu uses complete, left-aligned text labels without icons.
The Shortcuts app can start the same capture without a keyboard shortcut. Add the Open URLs action with exactly howler://capture, then run that shortcut from the menu bar, Control Center or the Dock. Howler asks you to drag a region and does not read the screen until you do. A link with a question, image or any other parameter does nothing. If Howler is not running, the shortcut opens it and then starts the selection.
Settings › General › Reply language follows your macOS preferred language by default, regardless of the screenshot language, or lets you choose a language. An explicit language request in a question overrides the default for that turn. Custom system instructions may affect how well the model follows it.
Concealing the letter, clicking outside or opening Settings keeps the conversation in memory. Burning it or quitting clears it; restarting does not restore it. A model setup or key change pauses the queue until you explicitly continue. Leave out passwords and other secrets. Screen capture asks for Screen & System Audio Recording permission the first time. Howler only takes a still image of the region you drag and never records audio; macOS simply grants screen and audio access together.
- No chat history, ever. Messages and parsed-answer caches are cleared when the letter burns or the app quits. A concealed letter stays in memory. A screen capture uses a temporary PNG that Howler attempts to delete after reading it.
- Stored: the model setup, its last check, your system prompt instructions, three optional shortcuts and reply language preference (UserDefaults), plus the API key (Keychain).
- The system prompt carries the date in UTC; tasks add the necessary reply language instruction. They send no full system language list, name, region, time zone or location.
- The clipboard and the screen are read only when you paste or capture. Capture and Explain sends the selected region immediately. Burning local content does not delete data retained by your model service.
- No logs, no telemetry. Network requests use an ephemeral
URLSession. - Update checks fetch
appcast.xmlfrom Howler's latest GitHub Release, at most once a day, and only after you allow it. They send no system profile; GitHub sees only the request, with the app and Sparkle versions in its User-Agent. Turn them off in Settings › General. - The command line never prints the key.
- Send Feedback… (in the menu, or in Settings › General) opens a GitHub issue form in your browser. Opening it sends Howler's version, the macOS version and the chip to GitHub in the page URL to prefill the form. The issue is created only when you submit it.
Requires Xcode 15.3+ (Swift 5.10+) and macOS 14+. The one third-party dependency is Sparkle (pinned in Package.swift), which installs updates.
make test # fast core tests; no app, UI tests or Sparkle dependency
make test-app # native behavior/interaction tests (macOS)
make test-all # complete suite, including release-tool fixtures
make app # universal build → build/Howler.zip, app staged in build/stage.noindex (ad-hoc, or SIGN_IDENTITY)
make dmg # the same app in build/Howler.dmg, beside an Applications link
make run # build and open
make icon # re-render Resources/AppIcon.icns from Sources/Howler/AppIconArt.swiftDebug builds include a demo mode that needs no key and no network:
swift build
HOWLER_DEMO=1 .build/debug/Howler # also: long, multi, burn, image, setup, settings
HOWLER_DEMO_DARK=1 HOWLER_DEMO=1 .build/debug/HowlerTo rename the app or change its bundle ID, edit app.config and rebuild. To release, increment both VERSION (within 0.1.x) and BUILD_NUMBER, merge through a pull request, then push a matching annotated v tag. CI tests, builds, signs, notarizes and publishes the release (see release signing). Manual checks are listed in ACCEPTANCE.md.
Upgrading from Napkin or QuickAsk
The project was renamed QuickAsk → Napkin → Howler, and so was the GitHub repo. Update old clones with git remote set-url origin git@github.com:HiAriesZhou/Howler.git. The bundle ID com.hiarieszhou.howler shares nothing with com.hiarieszhou.napkin or io.github.hiarieszhou.quickask, so set up the model again. Delete the old app, because both would compete for ⌥Space. You can remove the old Keychain items in Keychain Access by searching for the old bundle IDs.
The icon and seals are drawn in code with the letter's own paper, wax and fire. Provider marks are monochrome letters and SF Symbols; no trademarked logos are bundled.
MIT License · © 2026 AriesZhou



