Configuration

// Settings load automatically on mount
useEffect(() => {
  loadAllSettings();
}, []);

// Settings reload on system resume from sleep
useEffect(() => {
  const cleanup = window.maestro.app.onSystemResume(() => {
    console.log('System resumed, reloading settings');
    loadAllSettings();
  });
  return cleanup;
}, []);

const { conductorProfile, setConductorProfile } = useSettings();

// Example profile
setConductorProfile(`
I'm a full-stack developer working on:
- React/TypeScript frontend
- Node.js/Express backend
- PostgreSQL database

Preferences:
- Use functional components with hooks
- Prefer explicit types over inference
- Write tests with Jest and React Testing Library
`);

interface LLMSettings {
  llmProvider: LLMProvider;  // 'anthropic' | 'openai' | 'custom'
  modelSlug: string;         // Model identifier
  apiKey: string;            // API key (encrypted)
}

const { llmProvider, modelSlug, apiKey } = useSettings();

const { ghPath, setGhPath } = useSettings();

// Custom gh path
setGhPath('/usr/local/bin/gh');

const { 
  fontFamily,      // Font name
  fontSize,        // Base font size in px
  setFontFamily,
  setFontSize
} = useSettings();

// Custom font
setFontFamily('JetBrains Mono');
setFontSize(14);

// Font size is applied to document root for rem-based scaling
// document.documentElement.style.fontSize = `${fontSize}px`;

const {
  leftSidebarWidth,     // Left panel width in px
  rightPanelWidth,      // Right panel width in px
  terminalWidth,        // Terminal width in characters
  setLeftSidebarWidth,
  setRightPanelWidth,
  setTerminalWidth
} = useSettings();

const {
  markdownEditMode,      // Edit mode vs preview in markdown
  chatRawTextMode,       // Show raw text vs formatted
  showHiddenFiles,       // Show hidden files in file explorer
  setMarkdownEditMode,
  setChatRawTextMode,
  setShowHiddenFiles
} = useSettings();

const {
  defaultSaveToHistory,        // Save to history by default
  defaultShowThinking,         // 'off' | 'on' | 'sticky'
  setDefaultSaveToHistory,
  setDefaultShowThinking
} = useSettings();

// Thinking mode options:
// 'off' - Never show thinking
// 'on' - Show thinking, can be toggled per session
// 'sticky' - Show thinking, persists across sessions

const { 
  osNotificationsEnabled,
  setOsNotificationsEnabled
} = useSettings();

// Enable desktop notifications
setOsNotificationsEnabled(true);

const {
  audioFeedbackEnabled,
  audioFeedbackCommand,   // Shell command for audio
  setAudioFeedbackEnabled,
  setAudioFeedbackCommand
} = useSettings();

// Custom audio command
setAudioFeedbackCommand('afplay /System/Library/Sounds/Glass.aiff');

const { toastDuration, setToastDuration } = useSettings();

// Toast duration in ms (default: 3000)
setToastDuration(5000);

const {
  logLevel,              // 'debug' | 'info' | 'warn' | 'error'
  maxLogBuffer,          // Max log entries in memory
  maxOutputLines,        // Max output lines per session
  setLogLevel,
  setMaxLogBuffer,
  setMaxOutputLines
} = useSettings();

// Debug logging
setLogLevel('debug');
setMaxLogBuffer(10000);
setMaxOutputLines(5000);

const { 
  logViewerSelectedLevels,   // Filter levels in log viewer
  setLogViewerSelectedLevels
} = useSettings();

// Show only warnings and errors
setLogViewerSelectedLevels(['warn', 'error']);

const {
  checkForUpdatesOnStartup,  // Auto-check for updates
  enableBetaUpdates,         // Include beta versions
  setCheckForUpdatesOnStartup,
  setEnableBetaUpdates
} = useSettings();

const { crashReportingEnabled, setCrashReportingEnabled } = useSettings();

// Disable crash reporting
setCrashReportingEnabled(false);

interface Shortcut {
  id: string;              // Unique identifier
  label: string;           // Display label
  keys: string[];          // Key combination
}

const { shortcuts, setShortcuts } = useSettings();

// Customize a shortcut
const newShortcuts = {
  ...shortcuts,
  toggleSidebar: {
    id: 'toggleSidebar',
    label: 'Toggle Left Panel',
    keys: ['Alt', 'Meta', 'b']  // Changed from ArrowLeft
  }
};

setShortcuts(newShortcuts);

const { tabShortcuts, setTabShortcuts } = useSettings();

// Separate shortcuts for tab operations
// newTab, closeTab, reopenClosedTab, etc.

interface ContextManagementSettings {
  autoGroomingEnabled: boolean;
  autoGroomingThreshold: number;       // Token count
  enableContextTransfer: boolean;
  transferFormat: 'full' | 'summary';
  maxStoredSessions: number;
  sessionRetentionDays: number;
}

const { 
  contextManagementSettings,
  updateContextManagementSettings
} = useSettings();

// Update specific settings
updateContextManagementSettings({
  autoGroomingEnabled: true,
  autoGroomingThreshold: 8000
});

const {
  statsCollectionEnabled,
  defaultStatsTimeRange,  // 'day' | 'week' | 'month' | 'year' | 'all'
  setStatsCollectionEnabled,
  setDefaultStatsTimeRange
} = useSettings();

interface AutoRunStats {
  totalRuns: number;
  totalDurationMs: number;
  completedRuns: number;
  failedRuns: number;
  peakConcurrentRuns: number;
  lastRunTimestamp: number;
}

const { 
  autoRunStats,
  recordAutoRunComplete,        // Record completion
  updateAutoRunProgress,        // Update progress
  acknowledgeBadge,             // Acknowledge achievement
  getUnacknowledgedBadgeLevel  // Get next badge
} = useSettings();

const {
  localIgnorePatterns,      // Glob patterns to ignore
  localHonorGitignore,      // Honor .gitignore
  setLocalIgnorePatterns,
  setLocalHonorGitignore
} = useSettings();

// Custom ignore patterns
setLocalIgnorePatterns([
  'node_modules/**',
  'dist/**',
  '*.log',
  '.env*'
]);

const {
  sshRemoteIgnorePatterns,
  sshRemoteHonorGitignore,
  setSshRemoteIgnorePatterns,
  setSshRemoteHonorGitignore
} = useSettings();

const { preventSleepEnabled, setPreventSleepEnabled } = useSettings();

// Prevent system sleep during agent operations
await setPreventSleepEnabled(true);

const {
  disableGpuAcceleration,  // Disable GPU rendering
  disableConfetti,         // Disable confetti animations
  setDisableGpuAcceleration,
  setDisableConfetti
} = useSettings();

const { colorBlindMode, setColorBlindMode } = useSettings();

// Enable colorblind-friendly palette
setColorBlindMode(true);

const {
  automaticTabNamingEnabled,   // Auto-name tabs based on content
  fileTabAutoRefreshEnabled,   // Auto-refresh file preview tabs
  setAutomaticTabNamingEnabled,
  setFileTabAutoRefreshEnabled
} = useSettings();

const { 
  suppressWindowsWarning,     // Suppress Windows compatibility warning
  setSuppressWindowsWarning
} = useSettings();

const {
  useNativeTitleBar,    // Use native OS title bar
  autoHideMenuBar,      // Auto-hide menu bar (Linux/Windows)
  setUseNativeTitleBar,
  setAutoHideMenuBar
} = useSettings();

interface EncoreFeatureFlags {
  [featureName: string]: boolean;
}

const { encoreFeatures, setEncoreFeatures } = useSettings();

// Enable experimental feature
setEncoreFeatures({
  ...encoreFeatures,
  'new-feature': true
});

const {
  webInterfaceUseCustomPort,
  webInterfaceCustomPort,
  setWebInterfaceUseCustomPort,
  setWebInterfaceCustomPort
} = useSettings();

// Custom web interface port
setWebInterfaceUseCustomPort(true);
setWebInterfaceCustomPort(3000);

const {
  wakatimeApiKey,
  wakatimeEnabled,
  wakatimeDetailedTracking,
  setWakatimeApiKey,
  setWakatimeEnabled,
  setWakatimeDetailedTracking
} = useSettings();

// Enable WakaTime tracking
setWakatimeApiKey('waka_...');
setWakatimeEnabled(true);
setWakatimeDetailedTracking(true);

{
  "conductorProfile": "...",
  "llmProvider": "anthropic",
  "activeThemeId": "dracula",
  "shortcuts": { ... },
  "customAICommands": [ ... ],
  // ... other settings
}