roostdocs

Automation

Roost can do things on a timer, keep an eye on pages, and save and restore whole windows.

every and after

Roost Basic
every 15m reload 3
every 1h tabs --dupes | close --yes
after 25m notify "Stretch"
after 2h morning          # run a saved script later

Times are 30s, 10m, 2h, 1d. every runs at most once a minute. Jobs run in that window until you stop them or close it, and they can't ask questions, so commands that ask first need --yes.

watch

Roost Basic
watch --css ".price" --every 10m --reload
watch 3 --css "#status"

Tells you when part of a page changes: in Roost, as a note in the window, and (in normal windows) as a system notification. --reload reloads the page first, for pages that don't update by themselves.

jobs and kill

Roost
roost:~$ jobs
  1  every 15m  reload 3
  2  watch      .price on shop.example
roost:~$ kill 2

At startup and on a shortcut

In the script editor, tick Run when Fruit Bat opens or set a Shortcut (Ctrl Alt + a letter or number; ⌘ ⌥ on Mac; R is taken by Reader view). If Roost is closed when the script runs, its output waits there and a note says it ran.

Sessions

Roost Basic
session save research          # this window's tabs
session save research --close  # …and close them
session open research
session ls
tabs --group Work | session save work