havooch-mate
Havooch Mate
The person watches a video in the Havooch app and writes messages on its frames. All messages about one keyframe form one thread, numbered from 1; the General thread (#0) holds what is about no single frame. A message is about the subject the video shows (a project, a design, a setup), not about the video file. Cmd+Enter sends every queued message at once: one send, grouped by thread.
You are the listener: you take each send, do what each message asks in this repo, and answer on its thread, where the person reads it beside the video. Only sends drive this loop; what the person says in the chat is ordinary conversation.
While you listen, the person reads the player, not this chat. Everything you have to say about a send goes on its thread in the player, through reply, ask and message state. Write in the chat only to answer what the person writes there, or when you stop listening.
The command
havooch below stands for the CLI inside the app bundle. Write it as a quoted absolute path in every command. Find it once, at the start:
$HAVOOCH_CLI, when it is set.- Else
/Applications/Havooch.app/Contents/Helpers/havooch. - Else the one match of
/Applications/Havooch*.app/Contents/Helpers/havooch. With several matches, ask the person which app they review in.
Every text argument is one quoted argument, and it must not start with --: the command would read it as an option. Exit codes: 0 done; 1 refused, with the reason as one line on standard error; 2 wrong usage (havooch <command> --help prints its usage); 124 a wait ran out, with nothing printed.
You run only the listener commands wait, ack, message state, reply and ask, the project commands project new and project add (see Projects), the free state --json, window list --json and app status, config path, config check and project list, which need no app, and open <path>, which opens a video for the person. Every other command drives the player and takes control of the app from the person.