depwall/
/

    Home / Docs / Reference

    Troubleshooting

    Prebuilt binaries, missing platform packages, shims that are not intercepting, and how to report a miss.

    “no prebuilt binary for <platform>”#

    DepWall ships a compiled binary per platform. Supported: macOS (arm64, x64), Linux (x64, arm64), Windows (x64).

    “the platform package … is missing”#

    The install skipped optional dependencies. Reinstall with them:

    $ npm install -g depwall --include=optional

    Every install asks after I set an internal mirror#

    Add the mirror host to DEPWALL_REGISTRY_ALLOWLIST — see private registries.

    Shims are installed but nothing is intercepted#

    The shim directory is probably not first on PATH. Run depwall init again, or check that ~/.depwall/shims precedes your package manager in echo $PATH.

    git asks in my own repository#

    Some tools keep a program in a repository's own git config — Rails 7.1's credentials diff driver, nbstripout with a project .venv, a Watchman fsmonitor hook. DepWall cannot tell those from a repository built to run code on git status, because they are the same bytes. Check the setting it names, then record your review once:

    $ depwall trust-git

    If the value or the hook changes, git asks again.

    Report a missed detection#

    That is the most useful bug you can file: open an issue.