- One shot, right now — tap ⌘ twice, select a region, and Yetda pastes
it straight into the terminal or agent app you used last. No files to manage.
- Secrets stay yours — API keys, tokens and passwords in the shot are
blacked out on your Mac before the image goes anywhere: on-device OCR, plus
Apple's on-device LLM on Macs with Apple Intelligence. No cloud, no network.
- Several shots — every capture is also saved to
~/Yetda/; pick an
earlier one with ⌘⇧1, or (Claude Code) feed them all at once with /shots.
Works with
Yetda puts the image on the clipboard and presses the paste key in the last
terminal or agent desktop app you used, so it works with any agent that
accepts a pasted image:
| Agent | Paste key on macOS | Status |
|---|
| Claude Code | Ctrl+V (⌘V in iTerm2) | tested |
| Codex CLI | Ctrl+V | should work |
| Gemini CLI | Ctrl+V | should work |
| opencode | Ctrl+V | should work |
| Cursor CLI | ⌘V | set your terminal to ⌘V under Paste Into |
| Claude desktop app | ⌘V | tested |
| Codex / ChatGPT desktop app | ⌘V | should work |
Tried one of these? A PR to update this table is welcome.
The menu bar icon shows how many captures are waiting, and old ones are cleaned
up automatically — so the folder never fills up.
Install
macOS 13 or later.
brew install --cask woonmayer/tap/yetda
Or download Yetda.dmg,
open it and drag Yetda to Applications. Releases are signed with Developer ID
and notarized by Apple. (Maintainers: see docs/releasing.md.)
Build from source
Needs a Swift toolchain (Xcode or Command Line Tools).
./scripts/build-app.sh # produces Yetda.app (code-signed if an identity exists)
rm -rf /Applications/Yetda.app && mv Yetda.app /Applications/
open /Applications/Yetda.app
Move (don't copy) the bundle so only one Yetda.app exists — a second copy
can leave macOS showing a permission as granted while the running app still
gets the prompt. If that happens, reset with
tccutil reset ScreenCapture io.github.woonmayer.yetda (or Accessibility),
relaunch, and grant again.
build-app.sh signs with the first available code-signing identity (so macOS
permissions persist across rebuilds); it falls back to ad-hoc signing if none is
found. To pin a specific identity: YETDA_SIGN_ID="Developer ID Application: …" ./scripts/build-app.sh.
During development you can also run it straight from source: swift run Yetda.
Upgrading from ClipShot (the old name): delete /Applications/ClipShot.app,
install Yetda as above, and grant Screen Recording and Accessibility again —
macOS ties permissions to the bundle ID. Your settings and ~/ClipShot/
captures move over automatically on first launch.
First run: Screen Recording permission
macOS asks for Screen Recording permission the first time you capture
(required by screencapture). Grant it under
System Settings → Privacy & Security → Screen Recording, then relaunch the
app. If captures come out blank, the permission isn't granted yet.
여기까지가 README 앞부분입니다. 나머지는 원문에서 읽을 수 있습니다. README 전문 보기 ↗
