ToShopToShop DocsBeta
ToShopToShop DocsBeta
HomepageWelcome to ToShop

Start Here

Using ToShop

Customize

Help

Tools

System Tools

Clipboard, screenshot, OCR, notifications, window control — the built-in tools that make ToShop a real desktop agent.

ToShop ships a set of system-level tools that are always available — no skill installation required. Paired with your agent's plan-act-observe cycle, they're enough to do most everyday desktop work.

All system tools follow the standard permission flow. Read-only ones (clipboard_read, list_windows, frontmost_app) run automatically; write ones (clipboard_write, screenshot, notify_user) ask the first time.

Clipboard

  • clipboard_read — Read whatever's on the clipboard (text or image) into the task.
  • clipboard_write — Replace the clipboard with your agent's output.

Common pattern: "summarize what's on my clipboard and put the summary back."

Screen capture & OCR

  • screenshot — Capture the full screen, a window, or a selection. macOS requires Screen Recording permission.
  • OCR — Extract text from any image (screenshot output or a file).

Common pattern: grabbing text out of PDFs, slides, or screenshots someone sent you.

Notifications

  • notify_user — Send a native OS notification. Used at the end of long routines or when your agent needs your attention.

Window & app state

  • frontmost_app — What app is in focus right now.
  • list_windows — Enumerate open windows so your agent can decide which to act on.

Common pattern: "summarize what I'm looking at" — your agent reads window state before deciding what tool to use.

Related

  • Files & Finder — open and reveal local files.
  • Browser & Web — fetch URLs, drive the browser.
  • Skills — bigger procedures built on top of these primitives.

Table of Contents

ClipboardScreen capture & OCRNotificationsWindow & app stateRelated