Documentation
Actions YAML reference
Schema, placeholders, action types, and the shell allowlist.
> Stub. Brief: `WISSPA_WEBSITE_PRD.md §6.7` and source schema from `Wisspa/WISSPA_PRD.md §5.2.1`.
## Where actions live
`~/Library/Application Support/com.techguider.wisspa/actions/`
Drop a `.yaml` file in this folder. Wisspa watches the directory and hot-reloads.
## Schema
```yaml
id: screenshot
name: "Interactive Screenshot to Clipboard"
description: "Triggers macOS interactive screenshot, copies result to clipboard"
triggers:
- "screenshot"
- "take a screenshot"
type: shell # shell | applescript | open_url | open_app | keystroke
command: "screencapture -i -c"
requires_permissions:
- screen_recording
destructive: false
success_feedback: "Screenshot captured to clipboard"
failure_feedback: "Screenshot failed"
enabled: true
```
## Placeholders
- `{query}` — transcript after the trigger phrase
- `{clipboard}` — current clipboard text
- `{selected_text}` — current selection
- `{active_app}` — frontmost app name
## Shell allowlist
Shell commands are validated on load. Rejected patterns: `sudo`, `rm -rf`, `dd`, piped `curl`/`wget`.