Guide / Command line and AI

Agent skill

Frayo ships a skill file so a coding agent knows when to look at your screen and which frayo command to run. It is plain text, one file.

First turn on Settings › Integrations › Allow scripts and agents to capture. See Command line and AI.

Install#

For Claude Code, no other tools needed:

mkdir -p ~/.claude/skills/frayo && curl -fsSL https://frayo.app/skills/frayo/SKILL.md -o ~/.claude/skills/frayo/SKILL.md

Download SKILL.md and put it in your agent's skills folder if you prefer.

Tools without skills#

Paste this into the agent's instructions:

To see or read my screen, use the frayo command (Mac). Prefer `frayo ocr` when only the text matters; it costs far fewer tokens than an image. `frayo capture window --json` captures a window (I pick it) and prints the PNG path. `frayo search "words" --json` finds earlier screenshots. Captures can be private: capture only what the task needs. Exit code 3 means permission was denied or I cancelled; ask me instead of retrying. If frayo is not found, ask me to turn on Settings > Integrations > Allow scripts and agents to capture in Frayo.