Troubleshooting

Check The Installed Version

$npx linersh@latest --version

Expected current output:

>liner 0.5.7 (tui)  ·  0.5.7 (core)

If the platform core binary cannot be resolved, the version command prints only the TUI package version.

If compile says a page needs headless Chromium, run:

$liner setup-js

The terminal UI can also run this from the compile screen when it shows the JS rendering callout.

YouTube can block transcript fetching for age-restricted, region-locked, or rate-limited videos. Use a Netscape-format cookies file:

$liner compile mobile-design-foundations --cookies ~/cookies.txt

You can also set a default in ~/.liner/config.toml.

For local development, point the npm TUI at a specific Python core binary:

$LINER_BIN=/path/to/liner liner

The resolver tries LINER_BIN, the bundled platform package, the repo-local virtualenv, then liner on PATH.

$liner uninstall --yes

This removes Liner’s local state, Playwright Chromium cache, and npm’s npx execution cache. It is useful when testing a clean npx linersh install.