Skip to content
a little annoying bot that annoys me a little
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
bin Rototron: get a user directory, so we can get users Nov 14, 2019
eg Agendoizer: make and manage (and, later, share) lists Aug 15, 2019
lib/Synergy Weather: tweak output a bit Nov 20, 2019
t LiquidPlanner: client:~ Sep 4, 2019
.gitignore Add first-pass fortune reactor Nov 13, 2019
README.mkdn add a README from old-master, but it is a bit dated Apr 13, 2018
cpanfile InABox: bump cpanfile deps Jun 3, 2019
things-to-port things-to-port: remove many ported things! Jul 15, 2018



Synergy is a bot mostly for interacting with LiquidPlanner. Her primary purpose is to remind a user that they haven't got a timer running. During business hours, she will pester her user if a timer isn't running, escalating from one form of contact to another. She can be told to lay off. Synergy can respond to commands via SMS and other channels, too.


No warranty is expressed or implied.

Installation and Usage

Install all the prereqs. This is mostly easily done with Carton.

$ carton install

You need to set up a configuration file in YAML or JSON format. Look at the example file to see what config options are expected, because they're not documented yet. Run the program like this, more or less:

$ carton exec perl synergy -c /path/to/config/file.json

Commands for Everyone

(Warning: this section is probably out of date, especially after the v2 rewrite.)

page USER: This will send an SMS to the user, who must be the master user. Anyone can use this command.

page USER: MESSAGE: This will send the message as an SMS to the user, who must be the master user. Anyone can use this command.

task for USER: DESC: This will create a new task for the named user and report the URL. Anyone can use this command. Because of the LiquidPlanner auth system, one LP user is used to make every task, meaning that the "created by" field becomes less reliable. The user who asked for the command is noted in the task's initial description.

remind USER [ at TIME | in DURATION ] [with page]?: REMINDER: This command schedules a message to be send to the given user on the current channel. It doesn't check that the user is present now or later. It can be told to send a page, too.

alerts: This lists all active alerts in Circonus.

ack ALERTID for TIME: This acks the identified alert for a while.

oncall: This lists who is on call in Circonus.

oncall add USER [ USER... ]: Add users to the list of on call users.

oncall remove USER [ USER... ]: Remove users from the list of on call users.

oncall set USER [ USER... ]: Totally replace the contents of the on call group.

Commands for the Master User

Because LiquidPlanner doesn't for a token that can manipulate aspects of other users' timers, these commands only work for the user whose credentials are used for LiquidPlanner. In the future, this could be tweaked to allow many sets of credentials to be stored.

status: Synergy will tell you whether you've got a timer running.

commit: MESSAGE: Synergy will commit your current timer's time and add a comment given in your message. If it ends with "DONE", that will be removed and the task will be marked complete. Otherwise, time timer will start running again from zero.

stop timer: Synergy will stop your timer, leaving its time in place.

abort timer: Synergy will stop your timer and clear your timer.

chill [ for DURATION | until TIME ]: This tells Synergy not to nag you until later.

showtime: This tells Synergy to cancel any grace period. In the future, this will be used to start nagging outside of normal business hours.

show's over: This tells Synergy that you're done for the day, and not to nag you until the next business day.

You can’t perform that action at this time.