Skip to content

features.md

Latest commit

 

History

History
266 lines (215 loc) · 10.3 KB

features.md

File metadata and controls

266 lines (215 loc) · 10.3 KB

Features Overview

Table of Contents

Core Functionality

Window Management System

This tool manages browser-based AI application windows that run in web browsers.

Automatic Detection

  • Pattern-based Recognition: Identifies AI service windows using configurable keyword patterns
  • Process Validation: Verifies window authenticity through process inspection
  • Continuously tracks window states and availability
  • Works with Chrome, Edge, and other Chromium-based browsers

Window Arrangement

  • Grid Layout: Configurable NxM grid arrangements (default: 4x2 layout)
  • Side-by-Side Layout: Horizontal arrangement for comparative workflows
  • Span across multiple displays or target specific monitors
  • Custom sequence control for window positioning

State Management

  • Bulk Operations: Minimize, restore, or close all AI windows simultaneously
  • Target specific applications for focused operations
  • Hide/show AI applications in Windows taskbar
  • Focus Management: Bring specific services to foreground on demand

Configuration System

Hierarchical Configuration

Configuration Hierarchy:
├── Core Settings (settings.yml)
│   ├── Window Layout Parameters
│   ├── Display Preferences
│   ├── Timing Controls
│   └── UI Behavior Settings
│
├── AI Application Registry (ai_apps.yml)
│   ├── Service Definitions
│   ├── Detection Keywords
│   ├── Priority Rankings
│   └── User Profile Mappings
│
└── Runtime State (cached)
    ├── Active Window List
    ├── Current Arrangement
    └── User Preferences

Dynamic Updates

  • Hot Reloading: Configuration changes apply without restart
  • Validation Pipeline: Schema-based validation with detailed error reporting
  • Fallback Mechanisms: Graceful degradation with default values
  • Profile Management: Support for multiple user accounts per AI service

User Interface

Desktop Application

  • Electron-based UI: Native desktop integration with web technologies
  • Responsive Design: Adapts to different window sizes and screen resolutions
  • Theme Support: Dark and light mode with system integration
  • Real-time Updates: Live status monitoring and immediate feedback

Control Interface

Main Interface Components:
├── Application Grid
│   ├── Service Status Indicators
│   ├── Selection Controls
│   └── Individual Launch Buttons
│
├── Bulk Operation Toolbar
│   ├── Start All Applications
│   ├── Arrangement Controls
│   ├── Window State Management
│   └── Configuration Access
│
├── Prompt Distribution Panel
│   ├── Text Input Area
│   ├── Target Selection
│   ├── Character Counter
│   └── Send Controls
│
└── Status Information
    ├── Connection Status
    ├── Active Application Count
    └── Current Layout Mode

Extended Features

Multi-Display Configuration

Display Detection

  • Automatic Discovery: Detects all connected monitors and their properties
  • Work Area Calculation: Accounts for taskbars, docks, and system UI elements
  • Resolution Awareness: Adapts layouts to different screen resolutions
  • Orientation Support: Handles portrait and landscape monitor configurations

Arrangement Modes

  • Span Mode: Treats multiple displays as one large canvas
  • Primary Only: Restricts operations to the primary monitor
  • Display-Specific: Target arrangements to specific monitors
  • Custom Regions: Define specific areas for window placement

Profile System

User Account Management

Profile Structure:
├── Service Provider (e.g., AI-Service-A)
│   ├── Profile-User1
│   │   ├── Browser Configuration
│   │   ├── Shortcut Path
│   │   └── Launch Parameters
│   │
│   ├── Profile-User2
│   │   ├── Browser Configuration
│   │   ├── Shortcut Path
│   │   └── Launch Parameters
│   │
│   └── Profile-User3
│       ├── Browser Configuration
│       ├── Shortcut Path
│       └── Launch Parameters
│
└── Service Provider (e.g., AI-Service-B)
    └── [Similar structure]

Profile Features

  • Multiple Accounts: Support different user accounts per AI service
  • Quick Switching: Easy profile switching without application restart
  • Isolated Sessions: Separate browser profiles prevent cross-contamination
  • Batch Management: Apply operations across selected profiles

Performance Optimization

See Performance Optimization in architecture documentation for detailed performance features and optimization techniques.

Security Features

Path Validation

  • Extension Filtering: Restrict to safe file types (.lnk shortcuts)
  • Traversal Protection: Prevent directory traversal attacks
  • Sandbox Verification: Validate execution paths and permissions
  • Process Integrity: Verify launched processes match expectations

Configuration Security

  • Schema Validation: Strict type checking for all configuration values
  • Input Sanitization: Clean and validate all user inputs
  • Safe Defaults: Secure fallback values for missing configuration
  • Access Control: Appropriate file permissions for configuration files

Integration Capabilities

Browser Integration Architecture

See System Overview in architecture documentation for detailed browser integration diagrams and technical implementation.

Operating System Integration

Windows API Utilization

  • Window Enumeration: Efficient discovery of all top-level windows
  • Process Management: Creation, monitoring, and termination of processes
  • Display Information: Monitor configuration and capabilities
  • Focus Control: Foreground window management and activation

System Compatibility

  • Windows 10/11: Primary target platform with full feature support
  • 32/64-bit Support: Compatible with both system architectures
  • Low Resource Usage: Minimal system impact during operation

Workflow Features

Prompt Enhancer (Experimental)

Generates enhanced variations of input prompts using external AI API before distribution to chat services.

Enhancement Levels

  • Simple: Adds clarity and focus to basic prompts
  • Medium: Adds context, format preferences, tone guidance
  • In-Depth: Adds structure, examples, quality criteria

Variation Styles

Produces 5 variations per request:

  • Direct: Straightforward and efficient approach
  • Guided: Includes context and examples
  • Detailed: Comprehensive with thorough structure
  • Exploratory: Creative angle with unique perspective
  • Practical: Focused on actionable steps

Technical Requirements

  • API Provider: Groq Llama AI
  • Setup: API key required from console.groq.com
  • Configuration: Environment variable or config file
  • Processing Time: Approximately 5-10 seconds per enhancement

Prompt Distribution System

Target Selection

  • Individual Selection: Choose specific AI services for prompt delivery
  • Group Selection: Select predefined groups of AI services
  • All/None Shortcuts: Quick selection toggles for convenience
  • Default Settings: Remember last selection for faster workflows

Delivery Mechanisms

  • Clipboard Integration: Seamless text distribution via system clipboard
  • Window Focus: Automatic focus management during distribution
  • Batch Processing: Simultaneous delivery to multiple targets
  • Error Recovery: Graceful handling of unavailable services

Automation Features

Startup Automation

  • Auto-launch: Automatically start configured AI applications
  • Arrangement on Startup: Apply preferred layout immediately
  • Profile Loading: Load specific user profiles automatically
  • Background Operation: Silent startup without user intervention

Workflow Optimization

  • Keyboard Shortcuts: System-wide hotkeys for common operations
  • Tray Integration: Minimize to system tray for background operation
  • State Persistence: Remember window arrangements between sessions
  • Quick Actions: One-click operations for frequent tasks

Extensibility

Plugin Architecture Readiness

The system is designed with extensibility in mind:

  • Modular Components: Clear separation of concerns for easy extension
  • Event System: Hook points for external functionality integration
  • Configuration Schema: Extensible configuration format
  • API Design: Clean interfaces for future plugin development

Future Enhancement Support

  • Browser Extension Integration: Architecture ready for browser extension connectivity
  • Cloud Synchronization: Framework for configuration sync across devices
  • Custom Scripting: Support for automation scripts
  • Third-party Integrations: APIs for external tool connectivity

This feature set provides a solution for managing multiple AI chat interfaces while maintaining flexibility for different user workflows and requirements.