Use tcli

tcli is the command line tool of Tilde. It reads the same config.toml as tt and runs one command: it checks the file, sends a message, reads one, searches the cache, applies the mail rules or watches the events of your accounts. Every run starts with one dimmed line with the version, except tcli watch and tcli --version, which print no header so a script can read them. --config <path> goes with any command and names another root folder (tcli --config ~/work check). A command exits with 0 when it did its work, 1 when it failed, 2 when the command line is wrong and 130 when Ctrl-c stopped it before it was done. Every option and every exit code is in the reference of tcli, and the developer notes of the tool are in the README of tcli.

Page	What it answers
Accounts and check	Which accounts does Tilde see, is my config.toml right, and which plugins are loaded?
Send mail and chat	How do I send an email or a chat message from a script or a cron job?
The cache	How do I search the mail cache, fill it, update it or delete it?
Read a message	How do I show one message, check its OpenPGP signature or save an attachment?
Rules	How do I try my mail rules on the mail that is already in a folder?
Watch	How do I get one line for every new message, mention or rule that fired?
Scripts	How do I find an error in init.lua without opening tt?