Tooling

Yerd installs developer tools — Composer, Node.js (node/npm/npx), and Bun (bun/bunx) — as self-contained binaries on your PATH. Each is identified by a short id: composer, node, or bun. The Tooling guide covers the model in depth; this page is the command reference.

Latest only

Yerd installs the latest stable release of each tool (latest LTS for Node). There is no per-version selection — installing again updates to the current latest. Installing your first tool from the CLI automatically adds Yerd's bin directory to your PATH; you can also manage it yourself with yerd path install. If the bin directory isn't on your PATH, yerd doctor flags it with the one-line fix.

Listing

Command	Description
yerd tools	List every tool: install status, installed version, and the commands it provides.

yerd tools

TOOL      STATUS          COMMANDS       LOCATION
composer  2.10.1          composer       -
node      external        node,npm,npx   /opt/homebrew/bin/node
bun       not installed   bun,bunx       -

LOCATION is only populated for external tools - ones already on your PATH from somewhere other than Yerd (Homebrew, nvm/fnm, a global Composer, …). See the Tooling guide for what that means and why there's no install/update action for them.

Add --json for machine-readable output.

Installing & updating

Command	Description	Example
yerd install tool <ID>	Download, verify, and install the tool's latest release, then expose its commands on PATH. Idempotent — run again to update to the current latest.	yerd install tool node
yerd uninstall tool <ID>	Remove the tool's files and its PATH commands.	yerd uninstall tool bun

yerd install tool composer    # PHP dependency manager (needs a PHP version)
yerd install tool node        # latest Node LTS — node, npm, npx
yerd install tool bun         # bun + bunx
yerd install tool node        # run again to update to the newest LTS
yerd uninstall tool bun       # remove bun and prune its shims

<ID> is one of composer, node, or bun. An unknown id returns a not_found error.

Composer requires PHP

composer runs under Yerd's managed PHP, so install at least one PHP version first. Node and Bun are standalone.

PATH setup

The tool commands live in Yerd's {data}/bin directory. Manage your shell's PATH entry for it with yerd path:

Command	Description
yerd path install	Add {data}/bin to your shell startup file (idempotent; covers zsh, bash, and fish).
yerd path uninstall	Remove the Yerd PATH block from your shell startup file.
yerd path print	Print the shell snippet without modifying any file (for eval / manual use).

yerd path install     # then open a new terminal

Exit codes

These commands follow the standard CLI exit codes: 0 on success, 1 on a daemon error (e.g. an unknown tool id, a failed download, or a checksum mismatch), and 69 if the daemon is unreachable.

See also

• Tooling guide — the full model and where files live.
• PHP reference — the version model these tools follow.
• Services reference — the same install-on-demand approach.