climptree

Interactive import dependency tree visualizer for Solidity, TypeScript, and JavaScript files.

Install

npm install -g climptree

Usage

climptree <file> [--depth <n>]

Supported file types: .sol .ts .tsx .js .jsx .mjs .cjs

Examples

# Solidity contract
climptree contracts/FundMe.sol

# TypeScript file
climptree src/index.ts

# Limit tree depth
climptree src/index.ts --depth 3

Interactive Commands

Once the tree is displayed, you can navigate interactively:

| Command | Description | |---------|-------------| | cd <name> | Enter a child node | | cd a/b/c | Navigate multiple levels at once | | cd .. | Go back to parent | | ls | Refresh and redisplay the current tree | | q / exit | Quit |

Tab key autocompletes file names.

Tree Symbols

| Symbol | Meaning | |--------|---------| | ○ | File imported only once in the entire tree | | ● | File imported from multiple places (shown in full on first occurrence) | | ↑#N | Already expanded at position #N, skipped here to avoid repetition | | [ext] | External package (e.g. @openzeppelin/...) | | [not found] | Import path could not be resolved | | [cycle] | Circular dependency detected |

Requirements

Node.js >= 18.0.0

License

MIT