Knip Migration
Developmentknip-migrationKnip Migration is an Agent Skill for development published in the LedgerHQ/ledger-live repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Dead-code / unused-dependency detection is migrating from the legacy `unimported` tool to `knip`, which requires each package to expose an explicit, minimal `package.json#exports` (no `./*` wildcard). Read this when adding a new package or migrating an existing one.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/LedgerHQ/ledger-live/blob/HEAD/.agents/skills/knip-migration/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/knip-migration, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Dead-code detection: explicit exports + knip (not unimported)
The repo is migrating dead-code / unused-dependency detection from the legacy unimported
tool to knip, one package at a time. knip is configured centrally in the root
knip.json (one workspaces entry per package).
Why this isn't just "swap the tool"
knip treats everything listed in a package's package.json#exports as an entry point.
Today every package exports a ./* wildcard mapped to ./src/*.ts (via the @ledgerhq/source
custom condition declared in tsconfig.base.json):
"./*": {
"@ledgerhq/source": "./src/*.ts",
"import": "./lib-es/*.js",
"require": "./lib/*.js",
"default": "./lib/*.js"
}
Because of this wildcard, knip considers every top-level src/*.ts file "used" and cannot
detect unused ("zombie") top-level source files — the exact thing unimported caught (it
ignored exports and diffed against a curated entry list). So real knip parity for a package
requires replacing the ./* wildcard with explicit, minimal subpath exports that enumerate
the package's true public API.
The few libs already pointed at knip (e.g.
libs/env,libs/promise) still keep the./*wildcard, so they are only partially migrated — do not copy them as the template.
New package = born migrated
A new package has no consumers, so it should start in the target state — no .unimportedrc.json:
- Explicit
exportsonly. Enumerate the real public API; do not add a./*wildcard. Mirror the.root entry per subpath, keeping the conditions:"exports": { ".": { "@ledgerhq/source": "./src/index.ts", "import": "./lib-es/index.js", "require": "./lib/index.js", "default": "./lib/index.js" }, "./logic": { "@ledgerhq/source": "./src/logic.ts", "import": "./lib-es/logic.js", "require": "./lib/logic.js", "default": "./lib/logic.js" }, "./lib-es/*": "./lib-es/*.js", "./lib/*": "./lib/*.js", "./package.json": "./package.json" } - Register in
knip.json— add aworkspacesentry (entry,ignore,ignoreDependencies). - Use knip, not unimported — add a script that runs knip scoped to the workspace:
pnpm knip --directory <relative-hop-to-root> -W <workspace-path>(--directoryis the hop back to the repo root —../..forlibs/<x>,../../..forlibs/coin-modules/<x>;-Wis the workspace path from root).
Migrating an existing package off unimported
- Audit the real consumers of the package's deep imports.
- Replace the
./*wildcard export with explicit subpath exports (the legit public API). - Refactor consumers that relied on now-removed arbitrary entry points.
- Switch the dead-code script
unimported→ knip, delete.unimportedrc.json, and verify a deliberately-unused top-levelsrcfile is now reported.
Start with leaf / low-dependency packages; ledger-live-common (largest surface) comes last.
Notes
unimportedstays until a package reaches knip parity — don't bulk-delete it.- Unifying the script / nx-target name (
unimported→knip-check) is tracked separately, so matching the surrounding package's existing script name is fine.
Reviewing
For a new package, flag either of these and point here:
- a
.unimportedrc.jsonor a script running the bareunimportedbinary ("unimported": "unimported") — it must use knip via a rootknip.jsonworkspacesentry; or - a
./*wildcard inpackage.json#exports— new packages must enumerate explicit exports so knip can detect zombie files.