repo-map

name	repo-map
description	Map a repository or directory with a compact file listing, extension summary, and total size. Use before modifying unfamiliar projects or when the user asks for a quick project overview.
version	1.0.0
author	Zijian Guo
license	MIT
platforms	["linux","macos"]
prerequisites	{"commands":["python3"]}
metadata	{"hermes":{"tags":["agent-tools","repository","files","inspection"]}}

repo-map - Repository overview

Generate a compact map of a project without third-party dependencies.

When to Use

• User asks what is in a repository or folder.
• You need orientation before making code changes.
• You need a machine-readable file inventory for downstream processing.

Script

~/.hermes/skills/repo-map/scripts/repo_map.py

Options

Option	Default	Description
path	.	Directory to inspect
--depth	3	Maximum directory depth
--max-files	200	Maximum files to print
--include-hidden	off	Include hidden files and directories
--json	off	Emit machine-readable JSON

Pitfalls

• Common dependency and build directories are skipped by default.
• Hidden files are skipped unless --include-hidden is passed.