Docs Configuration

Personal settings

Your own preferences and tokens, kept in your config folder on your machine and never in the repo.

#The config folder

PlatformPath
macOS, Linux~/.config/teamtrail/ (or $XDG_CONFIG_HOME/teamtrail/)
Windows%APPDATA%\teamtrail\
Any$TEAMTRAIL_CONFIG_DIR, when set, wins
FileHolds
attention.jsonYour notification channel, quiet hours and focus mode.
credentials.jsonGitHub, Linear and Slack tokens, written with mode 0600.
slack.jsonSlack settings and setup progress (no secrets).

#attention.json (personal)

Set in Settings → Attention or by hand. Focus mode from the header writes focusUntil.

json
{
  "v": 1,
  "channel": "browser",
  "focus": { "from": "09:00", "to": "12:00", "days": [1, 2, 3, 4, 5] }
}
KeyTypeDefault
v1File format version.
channelbrowser | slack-dm | slack-channel | nonebrowserWhere interrupting items go. none sends everything to the digest.
focus{ from, to, days? }noneDaily quiet hours, HH:MM in your local time. to before from spans midnight. days are 0 (Sunday) to 6 (Saturday); without it, every day.
focusUntilepoch millisecondsnoneFocus mode until this time.

During focus mode and quiet hours nothing interrupts you; the list in Waiting on you keeps updating. Browser notifications need your permission, asked when you pick the browser channel. Choosing the browser doesn't turn off Slack interrupts; only none does.

The team's threshold and weights are in the repo: attention.json.

#credentials.json

Written by the Lookout when you save a token in Settings. You can also skip it and use environment variables: see GitHub Issues and Linear, Slack and Environment variables.