bpwd

A better pwd with clipboard support and targeting.

Installation

Homebrew (macOS/Linux)

brew install CodeTease/tap/bpwd

Cargo

cargo install bpwd

Installer Script

In Linux:

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/CodeTease/bpwd/releases/latest/download/bpwd-installer.sh | sh

In Windows (PowerShell)

powershell -ExecutionPolicy Bypass -c "irm https://github.com/CodeTease/bpwd/releases/latest/download/bpwd-installer.ps1 | iex"

Release

You can also download the binary from the Release page.

Usage

bwd [target] [-c] [-s] [-j] [-r]

• target: Optional path to resolve relative to current directory. Use -- to separate flags from arguments (e.g., bwd -- -my-dir).
• -c: Copy the result to clipboard.
• -s: Shorten path (replace home directory with $HOME or %USERPROFILE%).
• -j: Output path information as JSON.
• -r: Print path relative to project root (searches for .git or .bwd-root).

Examples

Standard Output (Absolute Path)

$ bwd
/home/codetease/projects/bpwd

Shortened Path (-s)

$ bwd -s
$HOME/projects/bpwd

JSON Output (-j)

$ bwd -j
{"path":"/home/codetease/projects/bpwd","short":"$HOME/projects/bpwd","root":"."}

Priority Logic

1. JSON (-j): Always outputs the JSON object.
2. Short (-s): If JSON is not requested, outputs the shortened path.
3. Default: Outputs the absolute path.