config-map 1.0.0

A beautiful terminal map of your configuration files

config-map

A beautiful terminal map of your configuration files.

Scans ~/.config/ recursively and your top-level dotfiles, then displays each file with path, size, last-modified, format, line count, and a type-specific summary (extracted keys for structured formats, counts for .env / shell configs, etc.).

Install

pip install config-map

Usage

config-map                       # full report (~3s)
config-map --search herme        # only files with "herme" in the path
config-map --min-size 100k       # only files >= 100 KB
config-map --config              # only ~/.config/
config-map --dotfiles            # only top-level dotfiles
config-map --version             # show version

What it shows

Field	Description
File	Path (relative to ~)
Format	JSON / YAML / TOML / ENV / SHELL / PLIST / INI etc.
Size	Human-readable (B/KB/MB)
Lines	Line count (skips files >5 MB)
Modified	Last modified date/time
Purpose / Summary	Extracted keys, alias/export counts, git sections, etc.

Type-specific summaries

• JSON → top 6 keys
• YAML → top 6 top-level keys
• TOML → top 6 sections/keys
• .env → variable count
• Shell configs → alias / export / function counts
• .gitconfig → section list
• SSH config → Host entries
• plists → top-level key count

Performance

Large cache/model dirs (.hermes, .vscode, .lmstudio, .gemini, etc.) are scanned shallowly (top-level files only) to avoid walking gigabytes of models. Files over 5 MB are never read — they show size/format only.

Full scan runs in ~3 seconds on a typical macOS system.

Requirements

• Python 3.7+
• rich library (installed automatically)

License

MIT