Agent Integration

Read the command contract

Treat the tracked SKILL.md and the fixed Clap source as the interface. The executable supplies local observation and input primitives; planning, confirmation policy, and task boundaries belong to the calling agent.

Use an observation loop

1. Call screenshot and decode its base64 PNG output.
2. Ground one concrete target in that observation.
3. Choose one of the seven input commands with explicit positional arguments.
4. Capture a new screenshot and compare the resulting state.

Do not infer success from a zero exit status alone. A fresh observation is the boundary between an attempted action and a verified result.

Pass arguments without a shell

Use an argv-style subprocess interface. Do not concatenate untrusted model text into a shell command. Keep command name and argument types on an allowlist, validate numeric coordinates, and preserve the distinction between observation and state-changing actions.

Keep permissions local

Screen Recording and Accessibility permissions attach to local macOS processes. The fixed revision does not add remote transport, autonomous planning, or an MCP server, so an integration must not imply those capabilities.