CLI and agent skill
Command line
Install the Python package to get the jax-diagnose command. It accepts a string or reads a traceback from standard input.
jax-diagnose TracerBoolConversionError
jax-diagnose --json < traceback.txt
A route returns status 0. An unmatched input returns 1 and produces {"match": null} in JSON mode. The checkout command python3 scripts/diagnose.py also runs on Python 3.10.
Agent skill
Install in your project with Node.js 22.20 or newer.
npx skills add mlnomadpy/jax-diagnostics
To select Codex without prompts, add --agent codex --yes. In Codex, invoke $jax-diagnostics and provide the original error, failing transform or operation, backend, versions, and relevant input shapes. Use the guide's verification step on the failing case. Skills.sh listing
The skill entry point can also be read directly. Its reference guides work as documentation without running Python.