id          = "http-prompt"
name        = "HTTP Prompt"
homepage    = "https://http-prompt.com/"
description = "Interactive HTTP client"
executables      = ["http-prompt"]

[dotfiles]

# HTTP Prompt's official documentation says the user config is
# $XDG_CONFIG_HOME/http-prompt/config.py (normally ~/.config) and
# %LOCALAPPDATA%/http-prompt/config.py on Windows.
# https://docs.http-prompt.com/en/latest/user-guide.html
paths = [
  "[configHome]/http-prompt/config.py",
  "%LOCALAPPDATA%/http-prompt/config.py",
]
secret = []

[commands]
format = 1
label = "Start an HTTP Prompt session"
description = "Start with an optional URL, environment file or OpenAPI spec. Inline HTTPie options after the URL are left out."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = false, short_attached = false, short_bundles = false }

[[commands.source]]
id = "cli"
kind = "manual"
url = "https://github.com/httpie/http-prompt/blob/master/http_prompt/cli.py"
revision = "master 2026-10"
evidence = """
@click.option('--spec', help='OpenAPI/Swagger specification file.',
@click.option('--env', help='Environment file to preload.',
@click.argument('url', default='')
# Start with the given URL
$ http-prompt http://httpbin.org
"""

[[commands.field]]
id = "url"
label = "URL"
description = "Leave empty to resume the last session or use http://localhost:8000."
type = "string"
position = 0
sources = ["cli"]

[[commands.field]]
id = "env"
label = "Environment file"
type = "path"
path = { kind = "file", role = "input" }
option = ["--env"]
sources = ["cli"]

[[commands.field]]
id = "spec"
label = "OpenAPI spec"
description = "OpenAPI/Swagger specification file or URL."
type = "string"
option = ["--spec"]
sources = ["cli"]

[[commands.task]]
id = "start_url"
label = "Start at a URL"
fields = ["url"]
required = ["url"]

[[commands.task]]
id = "start_env"
label = "Preload an environment file"
fields = ["env", "url"]
required = ["env"]

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["url", "env", "spec"]