x/eaSnippet
Watch
1
Code Issues Pull requests Releases 6 Activity Actions
6 releases 6 tags
  • v0.4.0 516d1cf7b9

    eaSnippet 0.4.0 Stable

    x released this 2026-10-22 00:54:22 +00:00 | 23 commits to main since this release

    eaSnippet 0.4.0

    Screenshots from the launcher and your own shortcuts, a welcome that fits on one screen, and AI agents
    that can drive the running app.

    Screenshots (Direct edition)

    • Capture Screen, Capture Window and Capture Area in the launcher (⌥Space), through macOS's own
      screenshot tool, saved where your Screenshot settings say.
    • Copy Text from Area: drag over text and it's read on this Mac, English and Chinese alike, then
      copied, so clipboard history keeps it too. When no text is found the clipboard stays as it was, and
      the picture is deleted at once.
    • Shortcuts for macOS's screenshot toolbar and for Copy Text from Area, off until you set them
      (Settings › Shortcuts › Screenshots). screenshot.startMode screen|window|area makes ⌘⇧5 open in
      that mode while eaSnippet runs.
    • From the command line: easnippet screenshot [screen|window|area] [--output file.png] [--clipboard] [--text].

    Getting started

    • One welcome screen instead of four steps: the six tools with your keys, the one permission
      eaSnippet needs, and opening at login. Getting Started… in the menu brings it back.
    • The menu reaches everything: Launcher…, Dictate (with its key) and Getting Started… are new.
    • Empty lists say why, with the fix: clipboard history off (Turn On) or blocked by macOS (Open
      Settings…), a filter with nothing in it (Show All), no snippets yet (New Snippet…).
    • Failures show: a microphone that isn't allowed says where to allow it, with a button; a pin,
      delete or plugin setting that doesn't save says so.
    • VoiceOver reads notices aloud, and the dictation buttons have names.

    Faster and smaller

    • Clipboard history searches without holding up your typing, and ↩ or ⌘1–9 pressed right after
      typing acts on what you typed.
    • The app is about half the size (20 MB instead of 38 MB): release builds leave out their debug
      symbols.

    Dictation

    • The first dictation after launch keeps its screen hints: the text models now load when
      eaSnippet starts.
    • Screen hints read Chinese as well as English.

    For AI agents

    • Agents and scripts can drive the running app (Direct edition): easnippet app status,
      app show (launcher, clipboard history, snippets, Library, Settings, welcome),
      app dictate start|stop|cancel|toggle, app insert (a snippet typed into the app in front, fields
      from --var, never the fill-in form) and app action (lock, sleep, captures). Each reply says what
      happened and where. Over MCP, app_status for every agent, and the rest with --allow-app. The app
      listens on a socket only you can open; restart, shut down and log out stay with you. New error code
      not_running.
    • With --allow-config, agents can change every setting, including the ones 0.3.1 refused: what
      clipboard history records and keeps, AI providers and when eaSnippet asks before sending text,
      excluded apps, what dictation reads off the screen, and launcher aliases and folders. Without the
      flag, agents still only read settings.
    • MCP screenshot (the main display, optionally with its text) with --allow-screen.
    • Errors agents can act on: a failed MCP tool call carries {"error": {"code", "message"}} with
      the same codes as the CLI, and busy when a tool that runs one call at a time is already running.
    • config set accepts what config get --json prints, for every setting, and
      easnippet config reset --all asks for --yes.

    Smaller fixes

    • A settings reset runs once even if eaSnippet quits partway through, and if it fails, eaSnippet says
      so after the next launch.

    Install

    brew upgrade --cask x/tap/easnippet      # or: brew install --cask x/tap/easnippet

    Or download the zip below and move eaSnippet to Applications. After updating, macOS may ask you to
    allow Accessibility, the microphone and Screen Recording again.

    Downloads