How to install wd without oh-my-zsh?

You can install wd manually by cloning the repository and adding the wd function to your .zshrc, or use other package managers like Antigen or zplug as detailed in the README. The automatic installer is available but not recommended for security reasons.

wd vs autojump: which is better for zsh?

wd uses manually created named warp points for precise control, while autojump learns from your cd history and works across shells. Choose wd if you prefer explicit shortcuts in zsh; autojump is better for automated, history-based navigation.

Can I use wd with bash?

No, wd is specifically designed for zsh and relies on zsh features, so it won't work with bash. For similar functionality in bash, consider alternatives like autojump or custom shell scripts.

How to delete all warp points in wd?

There's no single command to delete all warp points; you can manually remove the config file `~/.warprc` or use `wd clean` to remove points to non-existent directories. For bulk removal, you might need to script it or edit the file directly.

Does wd work with nested directories within warp points?

Yes, wd supports navigating to subdirectories within warp points using autocompletion, as shown in the usage with commands like `wd foo some/inner/path` for accessing inner paths.

How to set up the fzf browse feature in wd?

Install fzf separately, then enable the browse feature by adding a keybind in your .zshrc, such as `bindkey '^B' wd_browse_widget`, as described in the README's browse section for interactive search.

Is wd good for Docker or temporary environments?

wd can be used in Docker containers if zsh is installed, but since warp points are stored locally and containers are often ephemeral, the benefits are limited unless you persist the config file across sessions.

Open-Awesome

wd

MITShellv0.10.1

A zsh plugin that lets you jump to custom directories without using cd, using named warp points.

GitHub

736 stars49 forks0 contributors

What is wd?

wd (warp directory) is a zsh plugin that enables fast directory navigation by creating named shortcuts called warp points. It solves the inefficiency of repeatedly using cd for frequently visited or deeply nested directories, allowing instant jumps to any saved location.

Target Audience

Developers and power users who work extensively in the terminal with zsh and want to optimize their directory navigation workflow.

Value Proposition

It offers a lightweight, intuitive alternative to cd with features like fuzzy search, subdirectory access, and seamless integration into existing zsh setups, making terminal navigation significantly faster.

Overview

:rocket: Jump to custom directories in zsh

Use Cases

Best For

Quickly jumping between frequently accessed project directories
Navigating deep directory structures without typing long paths
Enhancing terminal productivity in zsh-based development environments
Managing multiple warp points for different workflows
Integrating fuzzy search into directory navigation
Reducing reliance on cd commands in daily shell usage

Not Ideal For

Developers using shells other than zsh, such as bash or fish
Environments with ephemeral or containerized setups where persistent warp points offer little value
Teams preferring minimal shell configurations without third-party plugins for security or simplicity
Users who rely on automated directory navigation tools like autojump that learn from history rather than manual shortcuts

Pros & Cons

Pros

Instant Directory Jumps

Commands like `wd foo` allow jumping to saved directories instantly, replacing repetitive cd usage, as demonstrated in the demo GIF and usage examples for fast navigation.

Fuzzy Search Integration

Integrates with fzf via `wd browse` for interactive, fuzzy search of all warp points, with configurable keybinds like Ctrl-B, enhancing navigation efficiency.

Seamless zsh Integration

Comes bundled with oh-my-zsh and supports other managers like Antigen, making setup straightforward for existing zsh users without complex configuration.

Comprehensive Warp Point Management

Offers commands like `wd list`, `wd rm`, and `wd clean` to manage warp points stored in `~/.warprc`, including cleaning non-existent directories for maintenance.

Cons

Zsh-Only Limitation

Designed exclusively for zsh, so it cannot be used with other popular shells like bash or fish without significant workarounds, limiting cross-shell compatibility.

Security Risk in Installation

The README warns that the automatic install script runs remote code without review, which is poor security practice, pushing users towards manual methods for safety.

External Dependency for Features

Advanced features like fuzzy browsing require fzf to be installed separately, adding an extra step and potential complexity for full functionality.

Limited Sharing and Persistence

Warp points are stored locally in `~/.warprc` by default, with no built-in mechanism for syncing or sharing across multiple machines or team members.

Frequently Asked Questions

Related Projects

zoxide

A smarter cd command. Supports all major shells.

Stars36,674

Forks822

Last commit5 days ago

zsh-autosuggestions

Fish-like autosuggestions for zsh

Stars35,506

Forks1,930

Last commit10 months ago

zsh-syntax-highlighting

Fish shell like syntax highlighting for Zsh.

Stars22,623

Forks1,371

Last commit3 months ago

autojump

A cd command that learns - easily navigate directories from the command line

Stars16,908

Forks710

Last commit1 year ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub

wd