id       = "intelli-shell"
name     = "IntelliShell"
homepage = "https://github.com/lasantosr/intelli-shell"
description = "A smart command template and snippet manager for shells."
executables   = ["intelli-shell"]

[dotfiles]

# The official default_config.toml documents these exact Linux, macOS and
# Windows paths (and the XDG_CONFIG_HOME override on Unix).
# https://github.com/lasantosr/intelli-shell/blob/main/default_config.toml
paths = [
  "[configHome]/intelli-shell/config.toml",
  "[appData]/org.IntelliShell.Intelli-Shell/config.toml",
  "%APPDATA%/IntelliShell/Intelli-Shell/config/config.toml",
]
exclude = []
secret  = []

# The same official default config has [gist].token, a GitHub Personal Access
# Token used for Gist export. Keep other user preferences while excluding only
# that field.
[[dotfiles.secret_paths]]
file  = ["[configHome]/intelli-shell/config.toml", "[appData]/org.IntelliShell.Intelli-Shell/config.toml", "%APPDATA%/IntelliShell/Intelli-Shell/config/config.toml"]
match = { key_path = ["gist.token"] }

# data_dir points at the local command database when explicitly configured;
# it is a machine-specific location, not a portable preference.
[[dotfiles.machine_lines]]
file  = ["[configHome]/intelli-shell/config.toml", "[appData]/org.IntelliShell.Intelli-Shell/config.toml", "%APPDATA%/IntelliShell/Intelli-Shell/config/config.toml"]
match = { key_path = ["data_dir"] }
scope = "backup"

[commands]
format = 1
label = "IntelliShell"
description = "Search the command library and bookmark new commands. Import, export, replace, fix, config and logs are outside this form."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = false }

[[commands.subcommand]]
path = ["search"]
label = "Search commands"
description = "Print matching stored commands, or open the interactive picker."

[[commands.subcommand.source]]
id = "docs"
kind = "manual"
url = "https://github.com/lasantosr/intelli-shell/blob/main/docs/src/reference/search.md"
revision = "2026-10-27"
evidence = """
intelli-shell search [OPTIONS] [QUERY]
- `-m, --mode <MODE>`
  - `auto`: Uses an internal algorithm to best match common search patterns
  - `fuzzy`: Finds commands that are similar to the query using special syntax
  - `regex`: Treats the query as a regular expression for complex pattern matching
  - `exact`: Returns only commands that precisely match the entire query
  - `relaxed`: Broadens the search to find the maximum number of potentially relevant commands
- `-u, --user-only`  Excludes commands imported from `tldr` pages from the search results.
- `--ai`  Uses AI to generate commands based on the `QUERY` prompt
- `-i, --interactive`  Opens the interactive TUI to search and select a command.
"""

[[commands.subcommand.field]]
id = "query"
label = "Query"
type = "string"
position = 0
sources = ["docs"]

[[commands.subcommand.field]]
id = "mode"
label = "Search mode"
type = "enum"
choices = [{ value = "auto", label = "Auto" }, { value = "fuzzy", label = "Fuzzy" }, { value = "regex", label = "Regex" }, { value = "exact", label = "Exact" }, { value = "relaxed", label = "Relaxed" }]
option = ["--mode", "-m"]
sources = ["docs"]

[[commands.subcommand.field]]
id = "user_only"
label = "Exclude tldr commands"
type = "boolean"
option = ["--user-only", "-u"]
sources = ["docs"]

[[commands.subcommand.field]]
id = "interactive"
label = "Interactive picker"
type = "boolean"
option = ["--interactive", "-i"]
sources = ["docs"]

[[commands.subcommand.field]]
id = "ai"
label = "Generate with AI"
description = "Treat the query as a natural-language prompt."
type = "boolean"
option = ["--ai"]
sources = ["docs"]

[[commands.subcommand.task]]
id = "find"
label = "Find commands"
fields = ["query", "mode", "user_only"]
required = ["query"]

[[commands.subcommand.task]]
id = "pick"
label = "Pick interactively"
fields = ["query", "interactive"]
required = []
set = { interactive = [true] }

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["query", "mode", "user_only", "interactive", "ai"]

[[commands.subcommand]]
path = ["new"]
label = "Bookmark a command"
description = "Store a new command in the library without opening the TUI."

[[commands.subcommand.source]]
id = "docs"
kind = "manual"
url = "https://github.com/lasantosr/intelli-shell/blob/main/docs/src/reference/new.md"
revision = "2026-10-27"
evidence = """
intelli-shell new [OPTIONS] [COMMAND_STRING]
- `-a, --alias <ALIAS>`  Sets an alias (a short, memorable name) for the command.
- `-d, --description <DESCRIPTION>`  Provides a detailed description for the command.
- `--ai`  Uses AI to generate a command and its description from the `COMMAND_STRING` prompt.
- `-i, --interactive`  Opens the interactive TUI to bookmark the command
"""

[[commands.subcommand.field]]
id = "command_string"
label = "Command"
type = "string"
position = 0
sources = ["docs"]

[[commands.subcommand.field]]
id = "alias"
label = "Alias"
type = "string"
option = ["--alias", "-a"]
sources = ["docs"]

[[commands.subcommand.field]]
id = "description"
label = "Description"
description = "May include #tags."
type = "string"
option = ["--description", "-d"]
sources = ["docs"]

[[commands.subcommand.field]]
id = "interactive"
label = "Review in interactive picker"
type = "boolean"
option = ["--interactive", "-i"]
sources = ["docs"]

[[commands.subcommand.field]]
id = "ai"
label = "Generate with AI"
type = "boolean"
option = ["--ai"]
sources = ["docs"]

[[commands.subcommand.task]]
id = "bookmark"
label = "Bookmark a command"
fields = ["command_string", "alias", "description"]
required = ["command_string"]

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["command_string", "alias", "description", "interactive", "ai"]