desktop

name	desktop
description	Window management, file operations, and clipboard
triggers	["window","file","folder","clipboard","copy","paste","minimize","maximize","snap","open file","delete","create"]

Desktop Control

What it does

Manages windows, files, and clipboard.

Security

• File operations are strictly limited to allowlisted directories defined in allowlist.json
• Never touch: Windows/, Program Files/, System32/, or any system directory
• Never delete without explicit voice confirmation — user will be asked "Are you sure?"
• Never read file contents and send them to any external API without user asking
• Clipboard history is in memory only — never written to disk or sent externally

Window operations

• Always call restore before activate for minimized windows (handled by primitives)

File operations

• Read, write, create files and folders
• Open file with default app
• Delete with voice confirmation (enforced by conductor)
• Search files by name within allowlisted paths

Clipboard

• Read/write clipboard text, history of last 10 items

Primitives used

• window_focus(title_contains) — focus window by title
• window_minimize(title_contains) — minimize window
• window_maximize(title_contains) — maximize window
• window_snap(title_contains, position) — snap: "left", "right", "top-left", "top-right", "bottom-left", "bottom-right"
• file_open(path) — open file/folder with default app
• file_read(path) — read file content or list directory
• file_write(path, content) — write content to file
• file_create(path, is_dir) — create file or folder (is_dir=true for folder)
• file_delete(path) — delete file (user will be asked to confirm)
• file_search(query, search_in) — search by filename
• clipboard_read() — get clipboard text
• clipboard_write(text) — set clipboard text
• clipboard_get_history() — last 10 items