Configuration

Customize MyDeskBot Desktop to fit your workflow and preferences.

Accessing Settings

Open Settings in one of these ways:

1. Click the gear icon ⚙️ in the sidebar
2. Press Cmd/Ctrl + ,
3. Go to Settings in the menu bar

General Settings

Appearance

Theme:

• Light
• Dark
• System (follows OS setting)
• High Contrast

Font Size:

• Small (12px)
• Medium (14px) - Default
• Large (16px)
• Extra Large (18px)

Language:

• English
• 中文 (简体)
• 中文 (繁體)
• 日本語
• Español
• Français
• Deutsch

Startup

Launch on Startup: Automatically start MyDeskBot when you log in

Restore Previous Session: Reopen previous conversations and files

Open in Tray: Start minimized to system tray

Updates

Check for Updates: Automatically (Daily/Weekly/Monthly) or Manual

Auto-Install Updates: Automatically install updates when available

AI Settings

Model Configuration

Primary Model: Select your default AI model

• GPT-4o
• GPT-4 Turbo
• Claude 3.5 Sonnet
• Claude 3 Opus
• Gemini Pro
• Custom model

Temperature: Control creativity (0.0 - 2.0)

• 0.0: More focused and deterministic
• 1.0: Balanced (default)
• 2.0: More creative and varied

Max Tokens: Maximum response length

• Default: 4096
• Short: 2048
• Long: 8192
• Extended: 16384

API Providers

Add and manage multiple API providers:

{
  "providers": {
    "openai": {
      "apiKey": "sk-...",
      "organization": "org-...",
      "baseURL": "https://api.openai.com/v1"
    },
    "anthropic": {
      "apiKey": "sk-ant-...",
      "baseURL": "https://api.anthropic.com"
    }
  }
}

Response Behavior

Stream Responses: Show responses as they're being generated

Auto-Continue: Automatically continue long responses

Timeout: Maximum time to wait for response (30s - 5min)

Editor Settings

Code Editor

Editor Theme:

• Monokai
• Solarized Dark
• One Dark Pro
• GitHub Dark Dimmed
• Custom

Tab Size: 2 or 4 spaces

Line Numbers: Show/hide line numbers

Word Wrap: Enable word wrapping

Autocomplete: Enable code suggestions

Formatting

Auto-format on Save: Automatically format code when saving

Format on Paste: Format code when pasting

Default Formatter: Select your preferred formatter (Prettier, ESLint, etc.)

Database Settings

Connections

Configure database connections:

{
  "databases": [
    {
      "name": "Development",
      "type": "postgresql",
      "host": "localhost",
      "port": 5432,
      "database": "myapp_dev",
      "username": "developer",
      "useSSL": true
    }
  ]
}

Security

Require Confirmation for Writes: Ask before executing INSERT/UPDATE/DELETE

Block Destructive Operations: Prevent DROP, TRUNCATE commands

Max Result Limit: Maximum number of rows to return (default: 1000)

SSH/SFTP Settings

Saved Servers

{
  "servers": [
    {
      "name": "Production",
      "host": "production.example.com",
      "port": 22,
      "username": "deploy",
      "authentication": "ssh-key",
      "keyPath": "~/.ssh/id_rsa"
    }
  ]
}

Connection

Keep Alive Interval: Send keep-alive packets every N seconds (default: 60)

Connection Timeout: Maximum time to connect (default: 30s)

Automatic Reconnection: Reconnect if connection drops

Security

Confirm Destructive Commands: Ask before running rm, sudo, etc.

Block Commands: Comma-separated list of forbidden commands

Keyboard Shortcuts

Customize keyboard shortcuts or create new ones:

{
  "shortcuts": {
    "newConversation": "Cmd/Ctrl+N",
    "openSettings": "Cmd/Ctrl+,",
    "focusChatInput": "Cmd/Ctrl+/",
    "toggleSidebar": "Cmd/Ctrl+B",
    "quickCommand": "Cmd/Ctrl+K"
  }
}

View all shortcuts

Privacy & Security

Data Storage

Local Storage Only: Keep all data on your computer

Cloud Sync: Sync data to your account (optional)

Clear Chat History: Delete all conversation history

Encryption

Encrypt Local Data: Encrypt stored conversations and settings

Password Protection: Require password to launch

Biometric Unlock: Use Touch ID/Face ID (macOS/Windows)

Data Sharing

Telemetry: Share anonymous usage data to improve MyDeskBot

Crash Reports: Automatically send crash reports

Analytics: Track feature usage for improvement

Advanced Settings

Performance

Memory Allocation: Maximum RAM usage (1GB - 8GB)

Model Preloading: Preload models for faster first response

Cache Responses: Cache AI responses for similar queries

Developer Options

Debug Mode: Enable debug logs

Experimental Features: Try new features before they're released

API Server: Run local API server (for integration with other tools)

Custom Models: Add custom model endpoints

Logs

Log Level: Error, Warning, Info, Debug

Log Location: View application logs

Export Logs: Download logs for troubleshooting

Import/Export Settings

Export Settings

1. Go to Settings → Advanced → Export
2. Choose what to export:
   • All settings
   • API keys
   • Connections
   • Keyboard shortcuts
3. Click "Export" to save a .json file

Import Settings

1. Go to Settings → Advanced → Import
2. Select your exported .json file
3. Review what will be imported
4. Click "Import"

Reset

Reset to Defaults

Reset specific settings to their default values:

1. Go to Settings → Advanced → Reset
2. Select what to reset:
   • All settings
   • AI settings
   • Editor settings
   • Keyboard shortcuts
3. Click "Reset"

Factory Reset

Completely reset MyDeskBot (requires confirmation):

1. Go to Settings → Advanced → Factory Reset
2. Enter "RESET" to confirm
3. Click "Factory Reset"

Warning: This will delete all settings, conversations, and connections.

Configuration Files

Location

• macOS: ~/Library/Application Support/MyDeskBot/settings.json
• Windows: %APPDATA%\MyDeskBot\settings.json
• Linux: ~/.config/mydeskbot/settings.json

Manual Editing

You can edit the configuration file directly:

{
  "version": "1.0.0",
  "general": {
    "theme": "dark",
    "language": "en"
  },
  "ai": {
    "model": "gpt-4o",
    "temperature": 1.0,
    "maxTokens": 4096
  }
}

Environment Variables

Configure MyDeskBot using environment variables:

# API Keys
export OPENAI_API_KEY="sk-..."
export ANTHROPIC_API_KEY="sk-ant-..."

# Model Configuration
export DEFAULT_MODEL="gpt-4o"
export TEMPERATURE="1.0"

# Database
export DB_HOST="localhost"
export DB_PORT="5432"

# SSH
export SSH_KEY_PATH="~/.ssh/id_rsa"

Best Practices

1. Use Environment Variables: Store API keys in environment variables for security
2. Back Up Settings: Regularly export your settings
3. Use Strong Passwords: Enable password protection
4. Keep Updated: Enable automatic updates
5. Customize Your Workflow: Tailor settings to your preferences

See Also

• Installation Guide
• Workflows
• Features
• Keyboard Shortcuts