Reference

`peekaboo set-value`

Home GitHub Edit page

peekaboo set-value

set-value writes an accessibility value directly to a settable element. It is the CLI equivalent of the MCP set_value tool and avoids keyboard synthesis, cursor movement, input-method timing, and autocomplete side effects when replacement semantics are intended.

#Options

OptionDescription
<value>String value to write.
--on <id-or-query>Element ID from peekaboo see, or a query used by the automation service. Required.
--snapshot <id>Snapshot ID from peekaboo see; uses the latest action context when omitted.

#Notes

  • The target element must expose a settable accessibility value.
  • Secure/password fields are rejected; use explicit typing flows for those contexts.
  • This is not a replacement for peekaboo type when the app needs observable keystrokes, IME handling, autocomplete, or undo grouping.
  • JSON output includes target, actionName, oldValue, newValue, and executionTime.

#Examples

peekaboo see --app TextEdit
peekaboo set-value "hello" --on T1 --snapshot <snapshot-id>

peekaboo set-value "42" --on "Search"