id = "oterm"
name = "oterm"
homepage = "https://ggozad.github.io/oterm/"
description = "The terminal client for Ollama, OpenAI, Anthropic, and other LLM providers"
executables = ["oterm"]

[dotfiles]

# oterm's official app-config documentation places config.json in its data
# directory: ~/.local/share/oterm on Linux, ~/Library/Application Support/oterm
# on macOS, and %APPDATA%/oterm on Windows. Provider settings may reference
# credentials, so the config files are secret content.
# https://ggozad.github.io/oterm/app_config/
paths = [
  "[xdgData]/oterm/",
  "[appData]/oterm/",
]

secret = [
  "[xdgData]/oterm/config.json",
  "[appData]/oterm/config.json",
]

[commands]
format = 1
label = "Inspect oterm"
description = "Print oterm information instead of starting the chat interface. The interactive app itself takes no other options."
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://ggozad.github.io/oterm/app_config/"
revision = "2026-10-27"
evidence = """
If in doubt, run oterm --data-dir (or uvx oterm --data-dir) to print the resolved location.
Run oterm --db to print its path.
"""

[[commands.source]]
id = "src"
kind = "help"
url = "https://raw.githubusercontent.com/ggozad/oterm/HEAD/src/oterm/cli/oterm.py"
revision = "HEAD 2026-10-27"
evidence = """
version: bool = typer.Option(None, "--version", "-v", help="Print the version."),
None, "--upgrade", help="Apply pending database upgrades."
None, "--config", help="Print the environment settings."
None, "--db", help="Print the path of the chat database."
data_dir: bool = typer.Option(None, "--data-dir", help="Print the data directory."),
"""

[[commands.field]]
id = "version"
label = "Print version"
type = "boolean"
option = ["--version", "-v"]
sources = ["src"]

[[commands.field]]
id = "data_dir"
label = "Print data directory"
type = "boolean"
option = ["--data-dir"]
sources = ["docs", "src"]

[[commands.field]]
id = "db"
label = "Print chat database path"
type = "boolean"
option = ["--db"]
sources = ["docs", "src"]

[[commands.field]]
id = "config"
label = "Print environment settings"
type = "boolean"
option = ["--config"]
sources = ["src"]

[[commands.field]]
id = "upgrade"
label = "Apply database upgrades"
type = "boolean"
option = ["--upgrade"]
effect = "overwrite"
sources = ["src"]

[[commands.task]]
id = "data_dir"
label = "Show data directory"
fields = ["data_dir"]
required = ["data_dir"]
set = { data_dir = [true] }

[[commands.task]]
id = "version"
label = "Show version"
fields = ["version"]
required = ["version"]
set = { version = [true] }

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["version", "data_dir", "db", "config", "upgrade"]