id       = "wd"
name     = "wd"
homepage = "https://github.com/mfaerevaag/wd"
description = "wd (warp directory) lets you jump to custom directories in zsh, without using cd."
executables   = ["wd"]
# A zsh function and completion, installed as a plugin or from the AUR.
platforms = ["macos", "linux"]

[dotfiles]

# README: "List all warp points (stored in ~/.warprc by default)" and, on
# WD_CONFIG, "Defines the path where warp points get stored. Defaults to
# $HOME/.warprc". wd.sh agrees and checks nothing else:
#   WD_CONFIG=${WD_CONFIG:-$HOME/.warprc}
#   typeset wd_config_file=${WD_CONFIG:-$HOME/.warprc}
# There is no XDG spelling. The file is the only thing wd writes; its sorting
# pass goes through a mktemp file it removes again.
paths = ["~/.warprc"]

exclude = []

# One `name:path` line per warp point. No credentials.
secret = []

# Sourced by the zsh function on every call, and rewritten in place by
# `wd add` / `wd rm`.
side_effect = false

# No machine_lines. wd stores each point home-relative:
#   printf "%q:%s\n" "${point}" "${PWD/#$HOME/~}" >> "$wd_config_file"
# so a point under the home directory is written as `~/…` and travels as-is.
# A point outside it keeps an absolute path, but that is the minority and there
# is no key to match it by — the whole file is one line per point.

[commands]
format = 1
label = "Warp to directory"
description = "Jump to a named directory, or add and remove warp points. wd is a shell function installed by its plugin."
quality = "ai-draft"
base = "fig:wd"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = true }

[[commands.source]]
id = "fig"
kind = "completion"
url = "https://github.com/withfig/autocomplete/blob/master/src/wd.ts"
license = "MIT"

[[commands.field]]
id = "point"
label = "Warp point"
description = "Name of the warp point; leave out only for subcommands."
type = "string"
position = 0
sources = ["fig"]

[[commands.field]]
id = "path"
label = "Subpath"
description = "Path appended to the warp point."
type = "string"
position = 1
sources = ["fig"]

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

[[commands.field]]
id = "config"
label = "Config file"
type = "path"
option = ["--config", "-c"]
path = { kind = "file", role = "input" }
sources = ["fig"]

[[commands.task]]
id = "warp"
label = "Warp to a point"
fields = ["point", "path"]
required = ["point"]

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["point", "path"]

[[commands.group]]
id = "advanced"
label = "Advanced"
fields = ["quiet", "config"]

[[commands.subcommand]]
path = ["add"]
label = "Add warp point"
description = "Save the current directory as a warp point."

[[commands.subcommand.source]]
id = "fig"
kind = "completion"
url = "https://github.com/withfig/autocomplete/blob/master/src/wd.ts"
license = "MIT"

[[commands.subcommand.field]]
id = "point"
label = "Warp point name"
description = "Defaults to the current directory name."
type = "string"
position = 0
sources = ["fig"]

[[commands.subcommand.task]]
id = "add"
label = "Add point"
fields = ["point"]

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["point"]

[[commands.subcommand]]
path = ["rm"]
label = "Remove warp point"
description = "Delete a saved warp point."

[[commands.subcommand.source]]
id = "fig"
kind = "completion"
url = "https://github.com/withfig/autocomplete/blob/master/src/wd.ts"
license = "MIT"

[[commands.subcommand.field]]
id = "point"
label = "Warp point name"
type = "string"
position = 0
effect = "delete"
sources = ["fig"]

[[commands.subcommand.task]]
id = "rm"
label = "Remove point"
fields = ["point"]

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["point"]