otty / apps

All apps/wd

wd

wd (warp directory) lets you jump to custom directories in zsh, without using cd.

Runs as wd|macOS, Linux|github.com

Open form in Otty otty.toml

Sync rules

What travels, what stays, what never leaves

wd in your home directory Every rule on this page, by file

· ~/.warprc Sync

Only what the catalog names. A directory that syncs brings everything inside it except what is listed as excluded here.

apps/wd/otty.tomlThe file this page is generated from

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"]

Use it with your dotfile manager

Same data, in the shape your tool already reads

Opens Otty and adds this tool to what it syncs

Opens otty://sync/add/wd. Otty ships with this catalog, so the link only has to name the tool — nothing is downloaded.

Every one of these is generated from the same rules as this page.