How cmccomb/yo works
Main Components
a. Core Application Layer:
• Command Line Interface (Entry Point)
• Session Management
• Input Processing
• Response Generation
b. External Services Layer:
• LLM Service Integration
• Web Search Integration
• File Processing System
c. Utility Layer:
• Logging System
• Settings Management
• Token Management
• Status Checking
Component Relationships
• User input → Command Line Interface → Input Validation → Content Processing
• Content Processing → External Services (LLM/Web Search) → Response Generation → User Output
• Cross-cutting concerns like logging and settings affecting all components
Specific Implementation Details
┌─────────────────────────────────────────────────────────────┐
• Command Line Interface │
• (src/main.zsh) │
• ┬─────────────────────┬──────────────────┘
┌───────────────────▼─────┐ ┌─────────▼────────┐
• Input Processing │ │ Session Management│
• Input Validation │ │ (LLM) │
• Content Processing │ └──────────┬────────┘
• ┬────────┘ │
┌───────────────▼────────────────────────▼───────────┐
• External Services │
• ┌─────────────┐ ┌──────────┐ ┌──────────────┐ │
• LLM Service │ │ Web │ │ File │ │
• Integration │ │ Search │ │ Processing │ │
• ┘ └──────────┘ └──────────────┘ │
• ┬───────────────────────┘
┌──────────────────────────▼───────────────────────┐
• Utility Services │
• ┌─────────┐ ┌──────────┐ ┌────────────────┐ │
• Logging │ │ Settings │ │ Token Manager │ │
• ┘ └──────────┘ └────────────────┘ │
• ┘
Additional Notes
Annotations for:
• Installation workflow (scripts/install)
• Testing infrastructure (tests directory)
• GitHub Actions integration (.github/workflows)
• Configuration management (settings.zsh)