Settings

Glyph’s settings are organized into several categories, each accessible from the settings window (Cmd+, or Ctrl+,):

• AI Settings - Configure AI providers and models
• Appearance - Customize theme, colors, and fonts
• Space Settings - Manage current workspace
• Daily Notes - Configure daily note creation
• General - AI assistant defaults and licensing
• About - App version and updates

Opening Settings

Access settings in several ways:

• Keyboard: Cmd+, (macOS) or Ctrl+, (Windows/Linux)
• Command Palette: Cmd+K → “Settings”
• Menu: Application Menu → Settings

The settings window opens in a separate window, allowing you to keep it open while working.

AI Settings

Configure AI providers and models for the assistant panel.

AI Profiles

Glyph uses profiles to manage different AI configurations. Each profile contains:

• Provider (OpenAI, Anthropic, Google, etc.)
• Model selection
• Base URL for custom endpoints
• Custom headers for authentication
• Private host access permissions
• Reasoning effort (for o1-style models)

Supported Providers

• OpenAI: GPT-4, GPT-4 Turbo, GPT-3.5, o1 models
• Anthropic: Claude 3.5 Sonnet, Claude 3 Opus/Sonnet/Haiku
• Google: Gemini 1.5 Pro, Gemini 1.5 Flash
• Groq: Fast inference for Llama, Mixtral models
• Custom: Any OpenAI-compatible API endpoint

AI Availability

Toggle AI features on/off globally:

// From src/components/settings/AiSettingsPane.tsx
<select
  value={aiEnabled ? "enabled" : "disabled"}
  onChange={(event) => updateAiEnabled(event.target.value === "enabled")}
>
  <option value="enabled">On</option>
  <option value="disabled">Off</option>
</select>

When disabled, AI panels and commands are hidden throughout the app.

Appearance Settings

Customize Glyph’s visual appearance.

Theme Mode

Choose between:

• Light: Bright background, dark text
• Dark: Dark background, light text
• System: Follows your OS preference

The theme applies immediately without restart.

Accent Colors

Select an accent color that appears in:

• Selected items
• Buttons and interactive elements
• Active states
• Links and highlights

Available accents:

• Neutral (default gray)
• Cerulean (blue)
• Tropical Teal
• Light Yellow
• Soft Apricot
• Vibrant Coral

// From src/lib/settings.ts
export type UiAccent =
  | "neutral"
  | "cerulean"
  | "tropical-teal"
  | "light-yellow"
  | "soft-apricot"
  | "vibrant-coral";

Typography

Configure fonts and sizes:

Font Family

Choose the primary UI and content font. Glyph loads system fonts automatically, including:

• System defaults (Inter, SF Pro, Segoe UI)
• Custom installed fonts

Monospace Font

Select a monospace font for:

• Code blocks
• Inline code
• File paths
• Technical content

Common options: JetBrains Mono, Fira Code, Monaco, Consolas

Font Size

Adjust the base font size:

• Small: 13px
• Medium: 14px (default)
• Large: 15px
• Extra Large: 16px

All UI elements scale proportionally.

// From src/components/settings/appearanceOptions.ts
export async function loadAvailableFonts(): Promise<string[]> {
  const fonts = await invoke("system_fonts_list");
  return fonts.filter((font) => !isMonospaceFont(font));
}

export async function loadAvailableMonospaceFonts(): Promise<string[]> {
  const fonts = await invoke("system_fonts_list");
  return fonts.filter(isMonospaceFont);
}

Space Settings

Manage the current space and its metadata.

Current Space

Displays:

• Full path to the active space
• Status indicator (Active/Inactive)

Recent Spaces

View and manage recently opened spaces:

• List shows all recent space paths
• Click “Clear” to remove all entries
• Paths are stored in app settings, not in the space itself

Search Index

The search index powers fast full-text search across all notes.

Rebuild Index: Click this button to:

• Re-scan all markdown files in the space
• Clear stale entries
• Fix search issues
• Update after bulk file operations

Task Sources

Configure where Glyph looks for tasks (checkboxes in markdown):

• Enable/disable specific folders
• Set scan depth
• Filter by file patterns

Daily Notes Settings

Configure automatic daily note creation.

Daily Notes Folder

Choose where daily notes are created:

1. Click “Browse” to select a folder within your space
2. Must be inside the current space (not external)
3. Use relative paths (e.g., journal/daily)

Shortcuts:

• Cmd+Shift+D (macOS) or Ctrl+Shift+D (Windows/Linux) creates/opens today’s note

How It Works

// From src/components/settings/DailyNotesSettingsPane.tsx
const handleBrowseFolder = async () => {
  const selected = await open({ directory: true, multiple: false });
  if (selected && typeof selected === "string") {
    const currentSpacePath = await invoke("space_get_current");
    // Validates selection is within space
    // Converts to relative path
    await setDailyNotesFolder(relativePath || null);
  }
};

Daily notes are named using the format: YYYY-MM-DD.md (e.g., 2026-03-03.md).

General Settings

App-wide preferences and licensing.

Assistant Default View

Choose how the AI panel opens:

• Create View: Shows the note creation interface
• Chat View: Opens directly to chat mode

This preference applies when toggling the AI panel with Cmd+Shift+A.

License Management

Manage your Glyph license:

• View license status (trial, active, expired)
• Enter license key
• Purchase new license
• Check expiration dates

// From src/lib/license.ts
export interface LicenseStatus {
  status: "trial" | "active" | "expired" | "invalid";
  purchase_url: string;
  days_remaining?: number;
}

Settings Storage

Settings are stored in two locations:

App Settings

Stored in the system’s app data folder:

• Theme, accent, fonts
• AI profiles and providers
• Recent spaces list
• License information

Space Settings

Stored in .glyph/Glyph/ within each space:

• Daily notes folder
• Task sources configuration
• Space-specific preferences

Keyboard Shortcuts in Settings

Troubleshooting

Settings not saving

• Check file permissions in your home directory
• Ensure you have disk space available
• Try restarting Glyph

Fonts not appearing

• Font enumeration happens once at startup
• Restart Glyph after installing new fonts
• System fonts only (not web fonts)

AI profile errors

• Verify API keys are correct
• Check base URL format for custom endpoints
• Enable “Allow Private Hosts” for localhost APIs