linji.at / tg
A terminal client for Tangled, the git forge built on AT Protocol.
Star
Fork 0
Watch
tg docs configuration.md
1.4 kB
Markdown
at master

Configuration #

tg resolves configuration values from the following sources, in increasing precedence (later sources override earlier ones):

  1. Defaults — appview is https://bobbin.klbr.net
  2. Config file — $XDG_CONFIG_HOME/tg/config.toml (or ~/.config/tg/config.toml)
  3. Environment variables — prefixed TG_ (e.g. TG_APPVIEW)
  4. Command-line flags — e.g. --appview

The config file is optional; a missing file is not an error.

Config file #

# ~/.config/tg/config.toml
appview = "https://bobbin.klbr.net"

Override the config file location with --config /path/to/config.toml.

Environment variables #

Variable Config key Purpose
TG_APPVIEW appview Appview host URL
TG_ACCOUNT account Account handle or DID

Keys containing . or - map to TG_-prefixed underscore-separated names (e.g. foo.bar → TG_FOO_BAR).

Flags #

Flag Purpose
--config Path to config file
--appview Appview host URL (overrides config file and TG_APPVIEW)
--account Account handle or DID for this command