@moo:monero.social

Matrix bot for Cuprate.

Contents

• Setup
• Commands
• Config
• Disk
• Forking

Setup

1. Build

sudo apt install build-essential libssl-dev pkg-config libsqlite3-dev

cargo build --release

2. Copy configuration file to appropriate location

mkdir -p ~/.config/moo/
cp moo.toml ~/.config/moo/
chmod -R 700 ~/.config/moo/ # user-only permissions

3. Add correct @moo:monero.social password to moo.toml

If you don't want to save a password unencrypted to disk, set this environment variable (leading with a space):

# There's a space leading this command so
# it isn't saved in your shell's history file.
 MOO_PASSWORD="$correct_password" ./moo

4. (optional) Add correct @moo900 GitHub API token to moo.toml

If you don't want to save this to disk, set this environment variable (leading with a space):

# There's a space leading this command so
# it isn't saved in your shell's history file.
 MOO_GITHUB_TOKEN="$moo900_github_token" ./moo

5. Start

./moo

Or run as a systemd service:

sudo cp moo.service /etc/systemd/system/

# >--- replace placeholders in moo.service

sudo systemctl daemon-reload
sudo systemctl start moo

moo will now:

• Join #cuprate:monero.social
• Read messages (ignoring ones before it started)
• Reply to commands (if you're in the allowed list of users)

Commands

moo is currently used as:

• Priority merge queue bot
• Cuprate meeting bot

The below commands read/write PR numbers to the queue.

• All commands start with !
• CAPITALIZED_WORDS are variables
• <> are required parameters
• [] are optional parameters

Command	Description
!queue	Report the queue as a markdown list. Sorted by priority, then add time.
!list	Report the queue as a simple list from high to low priority.
!json	Report the queue as JSON.
!add <PR_NUMBERS> [PRIORITY]	Add PR(s) to the queue. PRIORITY is low/medium/high/critical (default = medium).
!remove <PR_NUMBERS>	Remove PR(s) from the queue.
!sweep	Remove any PRs in the queue that can be removed (since they were merged).
!sweeper	Report how long before an automatic !sweep occurs.
!clear	Clear the entire queue.
!meeting	Begin/end Cuprate meetings. Issues/logs will be handled automatically after ending.
!cancel <COUNT> [REASON]	Cancel Cuprate meetings. The current issue will be closed and a new issue will be opened.
!agenda <ARRAY_OF_STRINGS>	Re-write the current Cuprate meeting's extra agenda items.
!status	Report moo status.
!help	Print all moo commands.
!shutdown	Shutdown moo.

Parameters are delimited by spaces, e.g.:

!add 3 123 52 low

!agenda expects a JSON array containing JSON strings:

!agenda ["New Agenda Item", "New Item 2"];

Config

For configuration, see moo.toml.

Disk

File	Location read/written to
Database	~/.local/share/moo/moo.json
Database (previous state)	~/.local/share/moo/moo.backup.json
Config	~/.config/moo/moo.toml