Accounts and check

This page shows how to see the accounts that Tilde reads from config.toml, how to find a mistake in the file, and how to list the plugins that are loaded.

See the accounts

tcli accounts

The command prints one row for each mail account and each chat account. It connects to no server and never prints a password.

┌──────┬──────┬──────┬─────────────────┬──────────────────┬──────────────────┐
│ Kind │ Id   │ Name │ Address         │ Connection       │ Sending          │
├──────┼──────┼──────┼─────────────────┼──────────────────┼──────────────────┤
│ mail │ work │ Work │ ada@example.org │ maildir          │ smtp             │
│      │      │      │                 │                  │ smtp.example.org │
│ chat │ irc  │ IRC  │ -               │ irc              │ -                │
│      │      │      │                 │ irc.example.org  │                  │
└──────┴──────┴──────┴─────────────────┴──────────────────┴──────────────────┘

The Id is the value that other commands take as --account or as an argument, for example tcli cache rebuild work. With no account the command says No accounts are configured. and exits with 0.

Check the file

tcli check

tcli check reads the file and creates every part of every account: the mail store, the mail transport and the chat client. It connects to nothing, so run it after every change to config.toml.

┌─────────┬────────────────┬──────────┬────────┐
│ Account │ Part           │ Protocol │ Result │
├─────────┼────────────────┼──────────┼────────┤
│ work    │ mail store     │ maildir  │ ok     │
│ work    │ mail transport │ smtp     │ ok     │
│ irc     │ chat           │ irc      │ ok     │
└─────────┴────────────────┴──────────┴────────┘
3 of 3 parts are fine.

The exit code is 0 when the file has no problem and every part is fine, and 1 when not.

Read the problems

When the file has a mistake, tcli check lists it first, with the line, and then checks the accounts it could read:

┌──────────────────────┬───────────────────┬───────────────────────────────────┐
│ Where                │ Line              │ Problem                           │
├──────────────────────┼───────────────────┼───────────────────────────────────┤
│ [accounts] mail.nmae │ line 3, column 1  │ is not a key of this section.     │
│ [cache] enabled      │ line 37, column 1 │ has a value that is not valid.    │
└──────────────────────┴───────────────────┴───────────────────────────────────┘
2 problems in the configuration.

tcli check finds four kinds of mistake:

• a syntax error in the TOML, with its line and column;
• a section that no plugin reads ([acounts]) and a key that its section does not have (nmae). Tilde would ignore both without a word, so they are usually typos;
• a value of the wrong type. The message names the section and the key and never shows the value, because it can come from a #{command};
• a section that is not valid, such as an account without an address.

Every unknown key is listed, but each section reports only its first wrong value, so a second one in the same section shows up after you fix the first.

Check the servers

tcli check --connect

This also logs in to every server, with 15 seconds for each. A part that works shows connected in 0.03 s; a part that fails shows the reason, for example Name or service not known for a host that does not exist. A message never holds a password.

List the plugins

tcli plugins list

The command prints the active plugins in the order they were registered, with Id, Name, Version, Author and the ids of the plugins each one Needs (- when none). It starts nothing and connects to nothing. A plugin that misses a dependency stops the command with the error and no list.

The accounts and their keys are on Mail accounts and Chat accounts. The first config.toml is on First run.