dirpic

A CLI tool to visualize your directory structure with optional file listing.

Features

• Interactive prompts - Choose between directories only or directories + files
• Colorful output - Beautiful, easy-to-read tree visualization
• Summary stats - See total directories and files at a glance
• Smart filtering - Automatically ignores common directories like node_modules, .git, etc.

Installation

npm install -g dirpic

Usage

Via npx (no installation required)

npx dirpic

After global installation

dirpic

Interactive Options

When you run dirpic, you'll be prompted with:

1. Display Mode:

   • Directories only
   • Directories and files

2. Path: Enter the path to map (defaults to current directory)

Example Output

  ╔══════════════════════════════════════╗
  ║              DIRPIC                  ║
  ║     Map your directory structure     ║
  ╚══════════════════════════════════════╝

  Mapping: /path/to/project
  --------------------------------------------------

my-project/
├── src/
│   ├── components/
│   │   ├── Button.tsx
│   │   └── Header.tsx
│   └── index.ts
├── public/
│   └── index.html
├── package.json
└── README.md

  --------------------------------------------------
  Summary: 3 directories | 6 files

Ignored Directories

The following are automatically filtered out:

• node_modules
• .git
• .DS_Store
• dist / build
• .next / .nuxt
• Hidden files (starting with .)

License

MIT