Merge branch 'feat/flat-lists'

Author: hesreallyhim

HOW_IT_WORKS.md

@@ -236,6 +236,185 @@ Description of the resource
 </details>
 ```
 
+## Alternative README Views
+
+The repository offers multiple README styles to suit different preferences, all generated from the same CSV source of truth.
+
+### Style Options
+
+Users can switch between three presentation styles via navigation badges at the top of each page:
+
+| Style | Description | Location |
+|-------|-------------|----------|
+| **Extra** | Visual/themed with SVG assets, collapsible sections, GitHub stats | `README.md` (root) |
+| **Classic** | Clean markdown, minimal styling, traditional awesome-list format | `README_ALTERNATIVES/README_CLASSIC.md` |
+| **Flat** | Sortable/filterable table view with category filters | `README_ALTERNATIVES/README_FLAT_*.md` |
+
+### File Structure
+
+Alternative views are in the `README_ALTERNATIVES/` folder to keep the root clean:
+
+```
+README.md                                      # Main "Extra" view (root)
+README_ALTERNATIVES/
+├── README_CLASSIC.md                          # Classic markdown view
+├── README_FLAT_ALL_AZ.md                      # Flat: All resources, A-Z
+├── README_FLAT_ALL_UPDATED.md                 # Flat: All resources, by updated
+├── README_FLAT_ALL_CREATED.md                 # Flat: All resources, by created
+├── README_FLAT_ALL_RELEASES.md                # Flat: All resources, recent releases
+├── README_FLAT_TOOLING_AZ.md                  # Flat: Tooling only, A-Z
+├── README_FLAT_HOOKS_UPDATED.md               # Flat: Hooks only, by updated
+└── ... (44 flat views total: 11 categories × 4 sort types)
+```
+
+### Flat List System
+
+The flat view provides a searchable table with dual navigation:
+
+#### Sort Options
+- **A-Z** - Alphabetical by resource name
+- **Updated** - By last modified date (most recent first)
+- **Created** - By repository creation date (newest first)
+- **Releases** - Resources with releases in past 30 days
+
+#### Category Filters
+- **All** - All 164+ resources
+- **Tooling**, **Commands**, **CLAUDE.md**, **Workflows**, **Hooks**, **Skills**, **Styles**, **Status**, **Docs**, **Clients**
+
+#### Table Format
+Resources are displayed with stacked name/author format to maximize description space:
+
+```markdown
+| Resource | Category | Sub-Category | Description |
+|----------|----------|--------------|-------------|
+| [**Resource Name**](link)<br>by [Author](link) | Category | Sub-Cat | Full description... |
+```
+
+### Release Detection
+
+The "Releases" sort option shows resources with published releases in the past 30 days. Release information is fetched from multiple sources in priority order:
+
+1. **GitHub Releases** - Official release tags
+2. **GitHub Tags** - Fallback if no releases
+3. **npm Registry** - For JavaScript packages
+4. **PyPI** - For Python packages
+5. **crates.io** - For Rust packages
+6. **Homebrew** - For Homebrew formulas
+7. **README parsing** - Last resort version extraction
+
+Release data is stored in the CSV with columns:
+- `Latest Release` - Timestamp of the release
+- `Release Version` - Version string
+- `Release Source` - Which registry/method detected it
+
+A disclaimer appears on all release views noting the best-effort nature of detection.
+
+### Generator Architecture
+
+The `generate_readme.py` script uses a class hierarchy for different README styles:
+
+```python
+ReadmeGenerator (ABC)
+├── VisualReadmeGenerator        # README.md (Extra)
+├── MinimalReadmeGenerator       # README_CLASSIC
+└── ParameterizedFlatListGenerator  # All flat views (parameterized by category + sort)
+```
+
+The `ParameterizedFlatListGenerator` takes `category_slug` and `sort_type` parameters, enabling generation of all 44 combinations from a single class.
+
+### Navigation Badges
+
+SVG badges are generated dynamically in `assets/`:
+- `badge-style-*.svg` - Style selector (Extra, Classic, Flat)
+- `badge-sort-*.svg` - Sort options (A-Z, Updated, Created, Releases)
+- `badge-cat-*.svg` - Category filters (All, Tooling, Hooks, etc.)
+
+Current selections are highlighted with colored borders matching each badge's theme color.
+
+### Adding/Removing Flat List Categories
+
+To add a new category filter to flat list views:
+
+1. **Update `FLAT_CATEGORIES`** in `scripts/generate_readme.py`:
+   ```python
+   FLAT_CATEGORIES = {
+       # ... existing categories ...
+       "new-category": ("CSV Category Value", "Display Name", "#hexcolor"),
+   }
+   ```
+   - First value: Exact match for the `Category` column in CSV (or `None` for "all")
+   - Second value: Display name shown on badge
+   - Third value: Hex color for badge accent and selection border
+
+2. **Regenerate READMEs**: Run `python scripts/generate_readme.py`
+   - Creates new files: `README_ALTERNATIVES/README_FLAT_NEWCATEGORY_*.md`
+   - Generates badge: `assets/badge-cat-new-category.svg`
+   - Updates navigation in all 44+ flat views
+
+To remove a category: Delete its entry from `FLAT_CATEGORIES` and run the generator. Manually delete the orphaned `.md` files from `README_ALTERNATIVES/`.
+
+### Adding/Removing Sort Types
+
+To add a new sort option:
+
+1. **Update `FLAT_SORT_TYPES`** in `scripts/generate_readme.py`:
+   ```python
+   FLAT_SORT_TYPES = {
+       # ... existing sorts ...
+       "newsort": ("DISPLAY", "#hexcolor", "description for status text"),
+   }
+   ```
+
+2. **Implement sorting logic** in `ParameterizedFlatListGenerator.sort_resources()`:
+   ```python
+   elif self.sort_type == "newsort":
+       # Custom sorting logic
+       return sorted(resources, key=lambda x: ...)
+   ```
+
+3. **Regenerate READMEs**: Creates new views for all categories × new sort type.
+
+### Adding/Removing README Styles
+
+The main README styles are defined as generator classes:
+
+| Style | Generator Class | Template | Output |
+|-------|----------------|----------|--------|
+| Extra | `VisualReadmeGenerator` | `README.template.md` | `README.md` |
+| Classic | `MinimalReadmeGenerator` | `README_CLASSIC.template.md` | `README_ALTERNATIVES/README_CLASSIC.md` |
+| Flat | `ParameterizedFlatListGenerator` | (built-in) | `README_ALTERNATIVES/README_FLAT_*.md` |
+
+**To add a new README style:**
+
+1. **Create a generator class** extending `ReadmeGenerator`:
+   ```python
+   class NewStyleReadmeGenerator(ReadmeGenerator):
+       @property
+       def template_filename(self) -> str:
+           return "README_NEWSTYLE.template.md"
+
+       @property
+       def output_filename(self) -> str:
+           return "README_ALTERNATIVES/README_NEWSTYLE.md"
+
+       # Implement abstract methods...
+   ```
+
+2. **Create template** in `templates/README_NEWSTYLE.template.md`
+
+3. **Add to `main()`** in `generate_readme.py`:
+   ```python
+   # Generate new style
+   generator = NewStyleReadmeGenerator(csv_path, template_dir, assets_dir, repo_root)
+   resource_count, backup = generator.generate()
+   ```
+
+4. **Create style badge** `assets/badge-style-newstyle.svg`
+
+5. **Update navigation** in all templates to include the new style option
+
+**To remove a style:** Delete the generator class, template, and `main()` call. Update navigation in remaining templates.
+
 ### Announcements System
 
 Announcements are stored in `templates/announcements.yaml`:

README.md

@@ -1,11 +1,16 @@
 <!--lint disable remark-lint:awesome-badge-->
 
+<h3 align="center">Pick Your Style:</h3>
+<p align="center">
+<a href="./"><img src="assets/badge-style-extra.svg" alt="Extra" height="28" style="border: 2px solid #6a6a8a; border-radius: 6px;"></a>
+<a href="README_ALTERNATIVES/README_CLASSIC.md"><img src="assets/badge-style-classic.svg" alt="Classic" height="28"></a>
+<a href="README_ALTERNATIVES/README_FLAT_ALL_AZ.md"><img src="assets/badge-style-flat.svg" alt="Flat" height="28"></a>
+</p>
+
 <div align="center" id="awesome-claude-code">
 
 [![Awesome](https://awesome.re/badge-flat2.svg)](https://awesome.re)
 
-<a href="README_CLASSIC.md"><img src="assets/classic-banner.svg" alt="View README_CLASSIC.md" width="400"></a>
-
 </div>
 
 <!-- Terminal Header - Theme Adaptive -->
@@ -192,22 +197,6 @@ _A well-balanced, "down-to-Earth" set of sub agents, skills, and commands,  that
 _Professional development environment for Claude Code with spec-driven workflow, TDD enforcement, cross-session memory, semantic search, quality hooks, and modular rules integration. A bit "heavyweight" but feature-packed and has wide coverage._  
 ![GitHub Stats for claude-codepro](https://github-readme-stats-plus-theta.vercel.app/api/pin/?repo=claude-codepro&username=maxritter&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
 
-<a href="https://github.com/aannoo/claude-hook-comms"><img src="assets/badge-claude-code-hook-comms-hcom.svg" alt="Claude Code Hook Comms (HCOM)"></a>  
-_Lightweight CLI tool for real-time communication between Claude Code sub agents using hooks. Enables multi-agent collaboration with @-mention targeting, live dashboard monitoring, and zero-dependency implementation. [NOTE: At the time of posting, this resource is a little unstable - I'm sharing it anyway, because I think it's incredibly promising and creative. I hope by the time you read this, it is production-ready.]_  
-![GitHub Stats for claude-hook-comms](https://github-readme-stats-plus-theta.vercel.app/api/pin/?repo=claude-hook-comms&username=aannoo&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
-
-<a href="https://github.com/dreamiurg/claude-mountaineering-skills"><img src="assets/badge-claude-mountaineering-skills.svg" alt="Claude Mountaineering Skills"></a>  
-_Claude Code skill that automates mountain route research for North American peaks. Aggregates data from 10+ mountaineering sources like Mountaineers.org, PeakBagger.com and SummitPost.com to generate detailed route beta reports with weather, avalanche conditions, and trip reports._  
-![GitHub Stats for claude-mountaineering-skills](https://github-readme-stats-plus-theta.vercel.app/api/pin/?repo=claude-mountaineering-skills&username=dreamiurg&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
-
-<a href="https://github.com/Piebald-AI/claude-code-system-prompts"><img src="assets/badge-claude-code-system-prompts.svg" alt="Claude Code System Prompts"></a>  
-_All parts of Claude Code's system prompt, including builtin tool descriptions, sub agent prompts (Plan/Explore/Task), utility prompts (CLAUDE.md, compact, Bash cmd, security review, agent creation, etc.). Updated for each Claude Code version._  
-![GitHub Stats for claude-code-system-prompts](https://github-readme-stats-plus-theta.vercel.app/api/pin/?repo=claude-code-system-prompts&username=Piebald-AI&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
-
-<a href="https://github.com/fcakyon/claude-codex-settings"><img src="assets/badge-claude-codex-settings.svg" alt="Claude Codex Settings"></a>  
-_A well-organized, well-written set of plugins covering core developer activities, such as working with common cloud platforms like GitHub, Azure, MongoDB, and popular services such as Tavily, Playwright, and more. Clear, not overly-opinionated, and compatible with a few other providers._  
-![GitHub Stats for claude-codex-settings](https://github-readme-stats-plus-theta.vercel.app/api/pin/?repo=claude-codex-settings&username=fcakyon&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
-
 
 <br>
 
@@ -1187,6 +1176,13 @@ _A highly customizable status line formatter for Claude Code CLI that displays m
 <div align="center"><img src="assets/entry-separator-light-animated.svg" alt=""></div>
 
 
+<a href="https://github.com/rz1989s/claude-code-statusline"><img src="assets/badge-claude-code-statusline.svg" alt="claude-code-statusline"></a>  
+_Enhanced 4-line statusline for Claude Code with themes, cost tracking, and MCP server monitoring_  
+![GitHub Stats for claude-code-statusline](https://github-readme-stats-plus-theta.vercel.app/api/pin/?repo=claude-code-statusline&username=rz1989s&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
+
+<div align="center"><img src="assets/entry-separator-light-animated.svg" alt=""></div>
+
+
 <a href="https://github.com/Owloops/claude-powerline"><img src="assets/badge-claude-powerline.svg" alt="claude-powerline"></a>  
 _A vim-style powerline statusline for Claude Code with real-time usage tracking, git integration, custom themes, and more_  
 ![GitHub Stats for claude-powerline](https://github-readme-stats-plus-theta.vercel.app/api/pin/?repo=claude-powerline&username=Owloops&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
@@ -1914,13 +1910,6 @@ _Provides detailed and emphatic instructions for Claude to follow as a coding ag
 <div align="center"><img src="assets/entry-separator-light-animated.svg" alt=""></div>
 
 
-<a href="https://github.com/Family-IT-Guy/perplexity-mcp/blob/main/CLAUDE.md"><img src="assets/badge-perplexity-mcp.svg" alt="Perplexity MCP"></a>  
-_Offers clear step-by-step installation instructions with multiple configuration options, detailed troubleshooting guidance, and concise architecture overview of the MCP protocol._  
-![GitHub Stats for perplexity-mcp](https://github-readme-stats-plus-theta.vercel.app/api/pin/?repo=perplexity-mcp&username=Family-IT-Guy&all_stats=true&stats_only=true&hide_border=true&bg_color=00000000&icon_color=FF0000&text_color=FF0000)
-
-<div align="center"><img src="assets/entry-separator-light-animated.svg" alt=""></div>
-
-
 </details>
 
 <br>

README_CLASSIC.md README_ALTERNATIVES/README_CLASSIC.mdREADME_CLASSIC.md renamed to README_ALTERNATIVES/README_CLASSIC.md

@@ -1,12 +1,19 @@
 <!--lint disable remark-lint:awesome-badge-->
 
+<h3 align="center">Pick Your Style:</h3>
+<p align="center">
+<a href="../"><img src="../assets/badge-style-extra.svg" alt="Extra" height="28"></a>
+<a href="README_CLASSIC.md"><img src="../assets/badge-style-classic.svg" alt="Classic" height="28" style="border: 2px solid #c9a227; border-radius: 4px;"></a>
+<a href="README_FLAT_ALL_AZ.md"><img src="../assets/badge-style-flat.svg" alt="Flat" height="28"></a>
+</p>
+
 <!-- Responsive Logo with Theme Support -->
 <div align="center">
 
   <!-- Same ASCII art for all screen sizes, just scales down on mobile -->
   <picture>
-    <source media="(prefers-color-scheme: dark)" srcset="assets/logo-dark.svg">
-    <img src="assets/logo-light.svg" alt="Awesome Claude Code" width="100%" style="max-width: 900px;">
+    <source media="(prefers-color-scheme: dark)" srcset="../assets/logo-dark.svg">
+    <img src="../assets/logo-light.svg" alt="Awesome Claude Code" width="100%" style="max-width: 900px;">
   </picture>
 
 </div>
@@ -18,8 +25,7 @@
 
 <!--lint enable remark-lint:awesome-badge-->
 
-[![Awesome](https://awesome.re/badge-flat2.svg)](https://awesome.re) [![FREEDOM FUNDER](/assets/freedom-funder-badge.svg)](https://bailproject.org)
-
+[![Awesome](https://awesome.re/badge-flat2.svg)](https://awesome.re) [![FREEDOM FUNDER](../assets/freedom-funder-badge.svg)](https://bailproject.org)
 
 # Awesome Claude Code
 
@@ -71,50 +77,6 @@ Professional development environment for Claude Code with spec-driven workflow,
 </details>
 <br>
 
-[`Claude Code Hook Comms (HCOM)`](https://github.com/aannoo/claude-hook-comms) &nbsp; by &nbsp; [aannoo](https://github.com/aannoo)  &nbsp;&nbsp;⚖️&nbsp;&nbsp;MIT  
-Lightweight CLI tool for real-time communication between Claude Code sub agents using hooks. Enables multi-agent collaboration with @-mention targeting, live dashboard monitoring, and zero-dependency implementation. [NOTE: At the time of posting, this resource is a little unstable - I'm sharing it anyway, because I think it's incredibly promising and creative. I hope by the time you read this, it is production-ready.]
-
-<details>
-<summary>📊 GitHub Stats</summary>
-
-![GitHub Stats for claude-hook-comms](https://github-readme-stats-plus-theta.vercel.app/api/pin/?repo=claude-hook-comms&username=aannoo&all_stats=true&stats_only=true)
-
-</details>
-<br>
-
-[`Claude Mountaineering Skills`](https://github.com/dreamiurg/claude-mountaineering-skills) &nbsp; by &nbsp; [Dmytro Gaivoronsky](https://github.com/dreamiurg)  &nbsp;&nbsp;⚖️&nbsp;&nbsp;MIT  
-Claude Code skill that automates mountain route research for North American peaks. Aggregates data from 10+ mountaineering sources like Mountaineers.org, PeakBagger.com and SummitPost.com to generate detailed route beta reports with weather, avalanche conditions, and trip reports.
-
-<details>
-<summary>📊 GitHub Stats</summary>
-
-![GitHub Stats for claude-mountaineering-skills](https://github-readme-stats-plus-theta.vercel.app/api/pin/?repo=claude-mountaineering-skills&username=dreamiurg&all_stats=true&stats_only=true)
-
-</details>
-<br>
-
-[`Claude Code System Prompts`](https://github.com/Piebald-AI/claude-code-system-prompts) &nbsp; by &nbsp; [Piebald AI](https://github.com/Piebald-AI)  &nbsp;&nbsp;⚖️&nbsp;&nbsp;MIT  
-All parts of Claude Code's system prompt, including builtin tool descriptions, sub agent prompts (Plan/Explore/Task), utility prompts (CLAUDE.md, compact, Bash cmd, security review, agent creation, etc.). Updated for each Claude Code version.
-
-<details>
-<summary>📊 GitHub Stats</summary>
-
-![GitHub Stats for claude-code-system-prompts](https://github-readme-stats-plus-theta.vercel.app/api/pin/?repo=claude-code-system-prompts&username=Piebald-AI&all_stats=true&stats_only=true)
-
-</details>
-<br>
-
-[`Claude Codex Settings`](https://github.com/fcakyon/claude-codex-settings) &nbsp; by &nbsp; [fatih akyon](https://github.com/fcakyon)  &nbsp;&nbsp;⚖️&nbsp;&nbsp;Apache-2.0  
-A well-organized, well-written set of plugins covering core developer activities, such as working with common cloud platforms like GitHub, Azure, MongoDB, and popular services such as Tavily, Playwright, and more. Clear, not overly-opinionated, and compatible with a few other providers.
-
-<details>
-<summary>📊 GitHub Stats</summary>
-
-![GitHub Stats for claude-codex-settings](https://github-readme-stats-plus-theta.vercel.app/api/pin/?repo=claude-codex-settings&username=fcakyon&all_stats=true&stats_only=true)
-
-</details>
-<br>
-
 
 ## Contents [🔝](#awesome-claude-code)
 
@@ -1038,6 +1000,17 @@ A highly customizable status line formatter for Claude Code CLI that displays mo
 </details>
 <br>
 
+[`claude-code-statusline`](https://github.com/rz1989s/claude-code-statusline) &nbsp; by &nbsp; [rz1989s](https://github.com/rz1989s)  &nbsp;&nbsp;⚖️&nbsp;&nbsp;MIT  
+Enhanced 4-line statusline for Claude Code with themes, cost tracking, and MCP server monitoring
+
+<details>
+<summary>📊 GitHub Stats</summary>
+
+![GitHub Stats for claude-code-statusline](https://github-readme-stats-plus-theta.vercel.app/api/pin/?repo=claude-code-statusline&username=rz1989s&all_stats=true&stats_only=true)
+
+</details>
+<br>
+
 [`claude-powerline`](https://github.com/Owloops/claude-powerline) &nbsp; by &nbsp; [Owloops](https://github.com/Owloops)  &nbsp;&nbsp;⚖️&nbsp;&nbsp;MIT  
 A vim-style powerline statusline for Claude Code with real-time usage tracking, git integration, custom themes, and more
 
@@ -1984,17 +1957,6 @@ Provides detailed and emphatic instructions for Claude to follow as a coding age
 </details>
 <br>
 
-[`Perplexity MCP`](https://github.com/Family-IT-Guy/perplexity-mcp/blob/main/CLAUDE.md) &nbsp; by &nbsp; [Family-IT-Guy](https://github.com/Family-IT-Guy)  &nbsp;&nbsp;⚖️&nbsp;&nbsp;ISC  
-Offers clear step-by-step installation instructions with multiple configuration options, detailed troubleshooting guidance, and concise architecture overview of the MCP protocol.
-
-<details>
-<summary>📊 GitHub Stats</summary>
-
-![GitHub Stats for perplexity-mcp](https://github-readme-stats-plus-theta.vercel.app/api/pin/?repo=perplexity-mcp&username=Family-IT-Guy&all_stats=true&stats_only=true)
-
-</details>
-<br>
-
 </details>
 
 <br>