id = "iamb"
name = "iamb"
homepage = "https://iamb.chat/"
description = "Matrix client for the terminal."
executables = ["iamb"]

[dotfiles]

# Iamb's official configuration guide says its TOML config is loaded from
# Rust's platform-native dirs::config_dir(), with config.toml as the default
# filename. These are the XDG and macOS/AppData spellings of that directory.
# https://iamb.chat/configure.html
# https://docs.rs/dirs/latest/dirs/fn.config_dir.html
paths = [
  "[configHome]/iamb/config.toml",
  "[appData]/iamb/config.toml",
]
secret = []

[commands]
format = 1
label = "Start iamb"
description = "Start the iamb Matrix client, optionally with a named profile or a different configuration directory. Other switches are not covered."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = false }

[[commands.source]]
id = "docs"
kind = "manual"
url = "https://iamb.chat/configure.html"
revision = "2026-10-27"
evidence = """
it at startup with the -C command-line flag.
user profile at startup. You can manually specify what you want via the -P
flag. For example:

$ iamb -P admin
"""

[[commands.field]]
id = "profile"
label = "Profile"
description = "Name of a profile defined in the configuration; overrides default_profile."
type = "string"
option = ["-P"]
sources = ["docs"]

[[commands.field]]
id = "config_dir"
label = "Configuration directory"
description = "Use this directory instead of the platform default."
type = "path"
option = ["-C"]
path = { kind = "directory", role = "input", must_exist = true }
sources = ["docs"]

[[commands.task]]
id = "start"
label = "Start with a profile"
fields = ["profile", "config_dir"]
required = []

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["profile", "config_dir"]