Skip to content

lichess-org/zulip-remind

Repository files navigation

Zulip Remind

Zulip bot that posts messages in a stream at a fixed date.

Also see: https://github.com/apkallum/zulip-reminder-bot.

I wanted a single service using redis, with support for fixed dates and public stream posting.

Usage

Use @remind to set a reminder for yourself, or for a stream. Some examples include:

  • @remind me on June 1st to wish Linda happy birthday
  • @remind me to stop procrastinating tomorrow
  • @remind here in 3 hours to update the project status
  • @remind stream to party hard on 2021-09-27 at 10pm

Use @remind list to see the list of all your reminders.

Use @remind delete id to delete a reminder by its ID

Setup

Manual

In Zulip, go to Settings -> Your bots, and add a new bot.

You may name it remind as I did, or anything else you like.

After it's created, download its zuliprc file and put it at the root of this project.

pnpm install
pnpm dev

And you're set, try using it from your Zulip instance.

Docker

You can easily start the docker container with:

docker compose up --build -d

Then a Redis database will start and the reminder automatically connects to it.

Please provide the zuliprc file and put it at the root of this project.

Redis configuration

To set a redis port, password, or database, use these environment variables:

REDIS_PORT
REDIS_PASSWORD
REDIS_DB
REDIS_HOST

Example:

REDIS_PORT=9379 REDIS_DB=5 REDIS_HOST=127.0.0.1 pnpm dev

Production

Build a prod release:

pnpm build

About

Zulip bot that posts messages in a stream at a fixed date.

Topics

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Contributors