Configuration

Customize Laradebug to fit your workflow.

Opening Settings

Access settings via:

• Menu: Laradebug → Settings
• Keyboard: Cmd + ,
• UI: Click the gear icon in the toolbar

General Settings

Default Timeout

Maximum time allowed for code execution.

Setting	Default	Range
Timeout	30 seconds	5-300 seconds

Settings → General → Default Timeout

Increase this for long-running operations like database migrations or large data imports.

Debugger Grace Period

Time to wait for Ray events after code execution completes.

Setting	Default	Range
Grace Period	5 seconds	0-30 seconds

This ensures all async debug events are captured before moving on.

Ray/Debugger Settings

Auto-Start

Automatically start the Ray server when Laradebug launches.

Setting	Default
Auto-start	Enabled

Port

The port the Ray server listens on.

Setting	Default
Port	23517

Port Conflicts

If port 23517 is in use, change it here and update your Laravel project's Ray config:

// config/ray.php
'port' => 23518,

AI Assistant Settings

Provider

Choose your AI provider:

Provider	Description
Anthropic	Claude models (recommended)
OpenAI	GPT models
Ollama	Local models

API Key

Enter your API key for the selected provider:

Settings → AI → API Key

Ollama (Local)

For Ollama, no API key is needed. Just ensure Ollama is running locally:

ollama serve

Editor Settings

Font Size

Code editor font size.

Setting	Default	Range
Font Size	12px	10-24px

Font Family

Monospace font for the code editor.

Setting	Default
Font Family	Menlo

Popular alternatives: Monaco, Fira Code, JetBrains Mono

Line Height

Space between lines in the editor.

Setting	Default
Line Height	22px

Theme

Appearance

Theme	Description
Dark	Dark background (default)
Light	Light background

The theme affects both the app UI and the code editor.

Autocomplete Settings

Enable Autocomplete

Toggle AI-powered code suggestions.

Setting	Default
Enabled	On

Trigger Delay

Delay before showing autocomplete suggestions.

Setting	Default
Delay	300ms

Lower values = faster suggestions, but more API calls.

Context Lines

Number of surrounding lines sent to the AI for context.

Setting	Default
Context Lines	50

More lines = better suggestions, but higher token usage.

Resetting Settings

To reset all settings to defaults:

Settings → Reset to Defaults

Or manually delete the settings file:

rm ~/Library/Application\ Support/Laradebug/settings.json

Environment Variables

Laradebug respects these environment variables:

Variable	Description
PHP_PATH	Custom PHP binary path
COMPOSER_PATH	Custom Composer path

Next Steps

• Keyboard Shortcuts — Learn all shortcuts
• Features — Explore all features