id = "tgpt"
name = "tgpt"
homepage = "https://github.com/aandrew-me/tgpt"
description = "AI Chatbots in terminal for free"
executables = ["tgpt"]

[dotfiles]

# The upstream README and usage guide document config.conf and proxy.txt in
# ~/.config/tgpt on GNU/Linux, %USERPROFILE%/.config/tgpt on Windows, and the
# user's Library/Application Support/tgpt directory on macOS. These files can
# hold provider API keys and proxy credentials, so they are kept as secrets.
# https://github.com/aandrew-me/tgpt/blob/main/README.md
# https://github.com/aandrew-me/tgpt/blob/main/md/usage.md
paths = []
secret = [
  "[configHome]/tgpt/config.conf",
  "[configHome]/tgpt/proxy.txt",
  "%USERPROFILE%/.config/tgpt/config.conf",
  "%USERPROFILE%/.config/tgpt/proxy.txt",
  "[appData]/tgpt/config.conf",
  "[appData]/tgpt/proxy.txt",
]

[commands]
format = 1
label = "Ask an AI chatbot"
description = "Send a prompt to an AI provider from the terminal. Interactive modes, MCP and image generation sizing are left out; API keys are never put on the command line here."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = false }

[[commands.source]]
id = "usage"
kind = "help"
url = "https://github.com/aandrew-me/tgpt/blob/main/md/usage.md"
revision = "main 2026-10"
evidence = """
 Usage: tgpt [Flags] [Prompt]
 -s, --shell        Generate and Execute shell commands.
 -c, --code         Generate Code.
 -q, --quiet        Gives response back without loading animation and extra text
 -w, --whole        Gives response back as a whole text instead of streaming it
 -img, --image      Generate images from text
 --provider         Set Provider.
 -f, --find         Find information using web search
 --model            Set Model
 --url              Set API endpoint url. You need to provide the full URL.
 --preprompt        Set preprompt
 -y                 Execute shell command without confirmation
 Available providers to use: anyapi, deepseek, gemini, groq, isou, koboldai, minimax, ollama, ollamacloud, omniroute, openai, opencode, pollinations, powerbrain.
"""

[[commands.field]]
id = "prompt"
label = "Prompt"
type = "string"
position = 0
multiple = true
sources = ["usage"]

[[commands.field]]
id = "provider"
label = "Provider"
type = "enum"
option = ["--provider"]
choices = [{ value = "anyapi", label = "anyapi" }, { value = "deepseek", label = "deepseek" }, { value = "gemini", label = "gemini" }, { value = "groq", label = "groq" }, { value = "isou", label = "isou" }, { value = "koboldai", label = "koboldai" }, { value = "minimax", label = "minimax" }, { value = "ollama", label = "ollama" }, { value = "ollamacloud", label = "ollamacloud" }, { value = "omniroute", label = "omniroute" }, { value = "openai", label = "openai" }, { value = "opencode", label = "opencode (default)" }, { value = "pollinations", label = "pollinations" }, { value = "powerbrain", label = "powerbrain" }]
sources = ["usage"]

[[commands.field]]
id = "model"
label = "Model"
type = "string"
option = ["--model"]
sources = ["usage"]

[[commands.field]]
id = "url"
label = "API endpoint URL"
type = "url"
option = ["--url"]
sources = ["usage"]

[[commands.field]]
id = "preprompt"
label = "Preprompt"
type = "string"
option = ["--preprompt"]
sources = ["usage"]

[[commands.field]]
id = "shell"
label = "Generate shell commands"
type = "boolean"
option = ["--shell", "-s"]
sources = ["usage"]

[[commands.field]]
id = "yes"
label = "Run shell command without confirmation"
type = "boolean"
option = ["-y"]
effect = "exec"
sources = ["usage"]

[[commands.field]]
id = "code"
label = "Generate code"
type = "boolean"
option = ["--code", "-c"]
sources = ["usage"]

[[commands.field]]
id = "find"
label = "Web search"
type = "boolean"
option = ["--find", "-f"]
sources = ["usage"]

[[commands.field]]
id = "quiet"
label = "Quiet output"
type = "boolean"
option = ["--quiet", "-q"]
sources = ["usage"]

[[commands.field]]
id = "whole"
label = "Whole response, no streaming"
type = "boolean"
option = ["--whole", "-w"]
sources = ["usage"]

[[commands.field]]
id = "image"
label = "Generate an image"
type = "boolean"
option = ["--image", "-img"]
sources = ["usage"]

[[commands.task]]
id = "ask"
label = "Ask a question"
fields = ["prompt", "provider", "model", "quiet"]
required = ["prompt"]

[[commands.task]]
id = "shell"
label = "Generate a shell command"
fields = ["prompt", "shell"]
required = ["prompt", "shell"]
set = { shell = [true] }

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["prompt", "provider", "model", "shell", "code", "find"]

[[commands.group]]
id = "advanced"
label = "Advanced"
fields = ["url", "preprompt", "yes", "quiet", "whole", "image"]