Isaac's documentation

Isaac is your friendly neighbourhood bot and hangs out in several channels on Slashnet. This is his full user documentation.

Isaac's canonical pronouns are he, they or it. He's fine with all of them. :)

Bot admins

The bot administrators have access to some special maintenance commands for Isaac. If you have any questions about the bot, please ask them.

The bot admin for Isaac on Slashnet is CO2.

Title resolver

Isaac resolves titles of webpages. It's simple: Just use a link starting with http:// or https:// in any channel message and Isaac will do his best to find the title of that webpage and print it in channel.

This functionality does not work in private messages.

Pronouns

Isaac can keep track of the preferred (gender) pronouns of users, and you can look them up at any time.

Note: Isaac makes use of NickServ login data found through the /whois command for this functionality. The reason for this is twofold:

This prevents a hard-to-solve problem of keeping track of users through nick changes and reconnects.
This prevents the possibility of people messing with other people's pronouns by changing into their nickname.

The pronoun function uses these commands, that should be used on a line by themself. All of these commands are available both in channel and in private messages to Isaac.
Isaac uses a global list for this, so there's no need to set this per channel.

It is possible to set multiple preferred pronouns for yourself, but this needs to be done one by one.

!pronouns <nickname> Look up the pronouns for this user. Example use: !pronouns Isaac
!pronouns-add <pronoun> Add a preferred pronoun for yourself. Example use !pronouns-add he
!pronouns-remove <pronoun> Remove one of your preferred pronouns.
!pronouns-forget Make Isaac forget ALL of your pronoun data.

The following pronoun options are available: he, she, they, it, other

If you lost access to your NickServ account and want anything changed or removed, please ask a bot admin for assistance.

Botsnack

Can a bot who doesn't enjoy the occassional botsnack even be called a bot? Just type 'botsnack' on its own line in any channel Isaac is in and see what happens.

Other

The command !help will bring you back to this page. :)

Admin-only commands

These commands work both in channel and in private messages, but can only be used by bot admins.

!quit Hard shutdown of the bot. Only to be used if Isaac shows signs of becoming Skynet. After a shutdown CO2 needs to do a manual restart to bring him online again.
!pronouns-admin-add <pronoun> <nickname> Adds a preferred pronoun to ANY nickname.
!pronouns-admin-remove <pronoun> <nickname> Removes a preferred pronoun from ANY nickname.
!pronouns-admin-forget <nickname> Make Isaac forget ALL pronoun data for this nickname.

Puppet master commands

In the deep lore, there exist rumors of some secret role even more powerful than bot admins, namely the so-called puppet masters. Who are they? No-one really knows...

Puppet masters have access to the following commands, that only work from private messages sent to Isaac.

!say <#channel> <text> or !say <nickname> <text> Sends <text> to <#channel> or in a private message to <nickname>.
!act <#channel> <action> or !act <nickname> <action> Sends <action> as a /me action to <#channel> or in a private message to <nickname>.

Source code

If you're interested in the nitty-gritty details or want to run your own copy of Isaac, his source code is here: https://github.com/CO2-Codes/Scala-IRC-bot. It is maintained by CO2.