.env.example

# ============================================
# AI Maestro - Environment Configuration
# ============================================
#
# Copy this file to .env.local and customize for your setup:
#   cp .env.example .env.local
#
# .env.local is gitignored and will not be committed

# ============================================
# Network Configuration
# ============================================

# HOSTNAME - Controls which network interfaces accept connections
#
# Options:
#   localhost    - Local machine only (most secure)
#   127.0.0.1    - Local machine only (explicit IP)
#   0.0.0.0      - All network interfaces (allows LAN access)
#   192.168.x.x  - Specific network interface IP
#
# Security Recommendations:
#   - Use 'localhost' when on untrusted networks (public WiFi)
#   - Use '0.0.0.0' only on trusted home/office networks
#   - Never expose to the internet without authentication
#
# Default: 0.0.0.0 (allows local network access)
HOSTNAME=0.0.0.0

# PORT - Server port
# Default: 23000
PORT=23000

# ============================================
# Node.js Environment
# ============================================

# NODE_ENV - Application environment
# Options: development | production
# Default: development
NODE_ENV=development

# ============================================
# WebSocket Configuration (Optional)
# ============================================

# Reconnection delay in milliseconds
# Default: 3000
# WS_RECONNECT_DELAY=3000

# Maximum reconnection attempts before giving up
# Default: 5
# WS_MAX_RECONNECT_ATTEMPTS=5

# ============================================
# Terminal Configuration (Optional)
# ============================================

# Default font size for terminals
# Default: 14
# TERMINAL_FONT_SIZE=14

# Scrollback buffer size (lines)
# Default: 10000
# TERMINAL_SCROLLBACK=10000

# ============================================
# Session Logging Configuration
# ============================================

# ENABLE_LOGGING - Global master switch for session logging
#
# Controls whether AI Maestro creates log files for terminal sessions.
# When enabled, session content is saved to logs/{sessionName}.txt
#
# Features when logging is enabled:
#   - Automatic filtering of Claude Code status updates and thinking steps
#   - Per-session toggle available in terminal header (📝/🚫 button)
#   - Logs stored in ./logs/ directory (gitignored)
#   - Useful for reviewing agent conversations and debugging
#
# Options:
#   true  - Enable logging (creates log files)
#   false - Disable logging globally (default, no files created, saves disk space)
#
# Note: When set to false, per-session logging toggles have no effect
# Default: false (disabled)
# ENABLE_LOGGING=false

# ============================================
# Examples for Different Use Cases
# ============================================

# Example 1: Maximum Security (localhost only)
# HOSTNAME=localhost
# PORT=23000

# Example 2: Home Network Access (default)
# HOSTNAME=0.0.0.0
# PORT=23000

# Example 3: Custom Port
# HOSTNAME=localhost
# PORT=3000

# Example 4: Production Build
# NODE_ENV=production
# HOSTNAME=localhost
# PORT=23000