aos watch

Follow what changes on this machine, one JSON line per event

3 commands. Run aos watch --help for the same list from the binary, or see every group.

Follow changes as a stream of JSON lines: the clipboard, the focused window, or a file or directory. The first sample is a baseline, so --max=1 means the next change. watch clipboard hides the text unless --content is passed. These run until interrupted and are not MCP tools.

Commands

aos watch clipboard

Print a JSON line whenever the clipboard text changes

needs a display

aos watch clipboard [--interval=<500ms>] [--max=<n>] [--content]

flag	values	meaning
--interval	<500ms>	Optional. default 500ms
--max	<n>	Optional
--content		Optional

aos watch clipboard
aos watch clipboard --max=1 --content

aos watch file

Print a JSON line whenever a file or directory entry changes

needs a display

aos watch file <path> [--interval=<500ms>] [--max=<n>] [--recursive]

flag	values	meaning
<path>		Required positional argument
--interval	<500ms>	Optional. default 500ms
--max	<n>	Optional
--recursive		Optional

aos watch file ~/Downloads
aos watch file ./notes.md --max=1
aos watch file ./src --recursive --interval=1s

aos watch window

Print a JSON line whenever the focused window changes

needs a display

aos watch window [--interval=<500ms>] [--max=<n>]

flag	values	meaning
--interval	<500ms>	Optional. default 500ms
--max	<n>	Optional

aos watch window
aos watch window --max=1