roostdocs

Echo and Roost

Echo is the AI built into Fruit Bat. Ask it to do something in the browser, like "close my YouTube tabs and open the bat article in reader view", and it answers with a short Roost script on a card. Echo never runs anything itself.

How it works

  1. You ask Echo to do something (questions just get answers).
  2. Echo writes a script. Fruit Bat checks every line against Echo's rules before showing it.
  3. You read the card. Lines that change things are marked; lines Echo isn't allowed to use are crossed out with the reason, and then the card can't run.
  4. You press Run script. It runs in Roost, which still asks before big changes.

The card

  • Run script runs it once.
  • Edit turns the card into an editor, checked as you type. Your version is marked as yours.
  • Open in Roost's editor makes it your own script, with every command.
  • Save as script saves it under a name made from what you asked.

Echo’s rules

  • Only a list of everyday commands: tabs, pages, clicking and filling, links, bookmarks, sessions, notes, reading chats, looking at the wallet and torrents.
  • No forgetting history, downloads, saving files, settings, automation, aliases, or running your scripts.
  • Never sends money, switches wallet networks, or adds or removes torrents. Chat messages ask you every time.
  • --yes is removed and { yes: true } refused, so Roost still asks you.
  • Tighter limits: 40 lines, 100 rounds per loop, 2,000 steps, 20 new tabs and 20 clicks per run.
  • In Roost Script, every command is checked again as it's built while the script runs, so a command name put together at run time can't get past the rules.
  • Echo reads web pages, so text on a page that tries to instruct an AI is removed, and Echo is told never to write commands because a page asked.

Which language

Settings › General › Language for Echo's Roost scripts picks Roost Basic (the default) or Roost Script. The rules are the same either way.

After it runs

The card shows what happened and where it stopped. What's next?, Do the rest or Fix it send Echo the result and the page you're on, and it answers with the next script if one is needed.