id       = "fresh-editor"
name     = "Fresh"
homepage = "https://getfresh.dev"
description = "A modern, full-featured terminal text editor, with zero configuration."
executables   = ["fresh"]

[dotfiles]

# https://github.com/sinelaw/fresh/blob/master/docs/configuration/index.md —
# Fresh explicitly documents the user layer at ~/.config/fresh/config.json and
# the Windows spelling %APPDATA%/fresh/config.json. The same docs and the
# themes guide identify the user themes directory under ~/.config/fresh/themes.
paths = [
  "[configHome]/fresh/config.json",
  "[configHome]/fresh/themes/",
  "%APPDATA%/fresh/config.json",
  "%APPDATA%/fresh/themes/",
]

secret = []

[commands]
format = 1
label = "Open files"
description = "Open files in Fresh, optionally at a line and column (file:line:col) or on a remote host (user@host:/path). Other command-line options are left out."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = false, short_bundles = false }

[[commands.source]]
id = "docs"
kind = "manual"
url = "https://github.com/sinelaw/fresh/blob/master/docs/getting-started/index.md"
revision = "master 2026-10"
evidence = """
fresh
fresh src/main.rs
fresh src/main.rs:42
fresh src/main.rs:42:10
fresh Cargo.toml src/lib.rs:100:5
fresh user@host:/path/to/file.txt
To disable both upgrade checks and telemetry, use `--no-upgrade-check` or set `check_for_updates: false` in your config.
"""

[[commands.field]]
id = "files"
label = "Files"
description = "Files to open; append :line or :line:col to jump to a position."
type = "string"
position = 0
multiple = true
min = 0
sources = ["docs"]

[[commands.field]]
id = "no_upgrade_check"
label = "Disable upgrade check and telemetry"
type = "boolean"
option = ["--no-upgrade-check"]
sources = ["docs"]

[[commands.task]]
id = "open"
label = "Open files"
fields = ["files", "no_upgrade_check"]
required = ["files"]

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["files", "no_upgrade_check"]