codescythe

Public Node package and CLI shim for Codescythe. This package loads the matching unscoped native N-API package for the current platform:

• codescythe-darwin-arm64
• codescythe-linux-amd64
• codescythe-linux-arm64

The package entrypoints are TypeScript files and require Node's --experimental-transform-types support. The package declares node >=22.18.0.

Documentation: https://perplexityai.github.io/codescythe/

The public JavaScript API exposes analyze(options), fix(options), and doctor(options). Options mirror the Rust CLI: pass cwd, config, verbose, force, or explainExport as needed. Results are parsed JavaScript objects returned from the native binding's JSON output.

Pass verbose: true to analyze or fix, or use --verbose with the package bin, to include the same analysis diagnostics exposed by the Rust CLI.

The package bin also exposes dependency-path queries:

npx codescythe query somepath src/main.ts src/module.ts
npx codescythe query somepath src/main.ts src/features/ --output mermaid
npx codescythe query allpaths src/main.ts src/runtime.ts:initRuntime --output svg > graph.svg

Query selectors can target files, directories, or exported symbols written as <file>:<symbol>. Query output supports text, JSON, Mermaid, and SVG.