For an overview of all available workflows, see the main README.

Visualize your repository's file structure and size distribution with a weekly ASCII tree map

The Weekly Repository Map workflow analyzes your repository's structure every week using standard bash tools, then creates a GitHub issue containing an ASCII tree map visualization showing directory hierarchy, file sizes, and key statistics.

Add the workflow to your repository:

gh aw add https://github.com/githubnext/agentics/blob/main/workflows/weekly-repo-map.md

Then compile:

gh aw compile

Note: This workflow creates GitHub Issues with the documentation label.

The Weekly Repository Map runs every Monday and:

1. Collects Repository Statistics — Counts files, measures sizes, and maps the directory structure using standard bash tools
2. Generates ASCII Tree Map — Creates a visual representation of the repository hierarchy with proportional size bars
3. Summarizes Key Metrics — Reports file type distribution, largest files, and directory sizes
4. Creates an Issue — Posts the complete visualization as a GitHub issue, closing the previous week's issue

graph LR
    A[Collect File Statistics] --> B[Compute Sizes & Counts]
    B --> C[Generate ASCII Tree Map]
    C --> D[Compute Key Statistics]
    D --> E[Create Issue Report]

Each run produces one issue containing:

• Repository Overview — Brief summary of the repository's structure and size
• ASCII Tree Map — Visual directory hierarchy with size bars using box-drawing characters
• File Type Breakdown — Count of files by extension
• Largest Files — Top 10 files by size
• Directory Sizes — Top directories ranked by total size

Example excerpt from an issue:

Repository Tree Map
===================

/ [1234 files, 45.2 MB]
│
├─ src/ [456 files, 28.5 MB] ██████████████████░░
│  ├─ core/ [78 files, 5.2 MB] ████░░
│  └─ utils/ [34 files, 3.1 MB] ███░░
│
├─ docs/ [234 files, 8.7 MB] ██████░░
│
└─ tests/ [78 files, 3.5 MB] ███░░

The workflow uses these default settings:

gh aw edit weekly-repo-map

Common customizations:

• Change issue labels — Set the labels field in safe-outputs.create-issue to labels that exist in your repository
• Adjust the schedule — Change to run more or less frequently (e.g., daily or monthly)
• Customize exclusions — Update the bash commands to exclude additional directories (e.g., vendor/, dist/)
• Adjust tree depth — Edit the prompt to change how deep the tree visualization goes (default max is 3–4 levels)

• Repository Quality Improver — Daily analysis of quality dimensions across your repository
• Daily File Diet — Monitor for oversized source files and create targeted refactoring issues
• Weekly Issue Summary — Weekly issue activity report with trend charts