Skip to content

v0.3.0 - Three-Tier Architecture

Choose a tag to compare

@dongzhenye dongzhenye released this 16 Aug 05:14
· 25 commits to main since this release

🏗️ Three-Tier Architecture Implementation

This release introduces a clear three-tier system to match different user needs.

New Architecture

Tier Complexity Setup Time Best For
Minimal ⭐ 5 seconds Users wanting simplest solution
Recommended ⭐ ⭐⭐ 30 seconds Most users (default)
Custom ⭐⭐⭐ 5+ minutes Power users with specific needs

Features Added

Directory Structure

  • recommended/ - Platform-specific configurations
    • recommended.macos.json
    • recommended.linux.json
    • recommended.windows.json
  • custom/ - Advanced examples
    • system-notify.macos.sh - macOS system notifications

Documentation

  • Restructured README with tier-based organization
  • Clear tier selection guide at the top
  • Platform-specific configurations

Key Decisions (ref #3)

  • Naming: Minimal / Recommended / Custom (no hierarchy implied)
  • Default: Recommended tier (balanced solution)
  • System notifications: Custom tier only (to avoid notification fatigue)

How to Use

Minimal (built-in):

claude config set --global preferredNotifChannel terminal_bell

Recommended (copy the appropriate file):

  • macOS: recommended/recommended.macos.json
  • Linux: recommended/recommended.linux.json
  • Windows: recommended/recommended.windows.json

Custom (see examples):

  • Check custom/ directory for examples

This architecture provides progressive enhancement while keeping things simple by default.