editing-letta-code-desktop-preferences

Edits Letta Code Desktop preferences by merging updates into the desktop_preferences.json file.

3.2k|385|Updated Oct 25, 2025
One-click install
npx skills add https://github.com/letta-ai/letta-code --skill editing-letta-code-desktop-preferences
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: editing-letta-code-desktop-preferences
Source: https://github.com/letta-ai/letta-code/tree/main/src/skills/builtin/editing-letta-code-desktop-preferences
Command: npx skills add https://github.com/letta-ai/letta-code --skill editing-letta-code-desktop-preferences

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Changing Letta Code Desktop settings like theme, default working directory, or remote access requires safely editing the ~/.letta/desktop_preferences.json file without corrupting it or losing unrelated settings.

Core Features & Use Cases

  • Safe JSON Merging: Reads the existing preferences file, preserves unknown keys, and merges only the requested changes.
  • Guided Key Reference: Documents user-editable keys (theme, defaultWorkingDirectory, allowRemoteAccess, runInBackground, startAtLogin, remoteEnvName) and system-managed keys that must not be touched.
  • Validation Step: Includes a command to re-parse the file after editing to confirm it remains valid JSON.
  • Use Case: A user asks to switch the Desktop app to dark theme; the skill updates only the theme key in desktop_preferences.json, and the change applies live within ~100ms via the file watcher.

Quick Start

Ask the agent to change a Desktop setting, for example: set my Letta Code Desktop theme to dark using the preferences file.

Frequently Asked Questions about editing-letta-code-desktop-preferences

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I change the Letta Code Desktop theme?

Edit the theme key in ~/.letta/desktop_preferences.json, setting it to auto, light, or dark. Read the existing file first, merge only the theme change, and write back pretty-printed JSON; the change applies live within about 100ms.

Where are Letta Code Desktop preferences stored?

Desktop preferences are stored in ~/.letta/desktop_preferences.json. It contains user-editable keys like defaultWorkingDirectory, theme, allowRemoteAccess, runInBackground, startAtLogin, and remoteEnvName.

Which Desktop preferences keys should not be edited directly?

System-managed keys such as artifactsByAgent, debugPanelEnabled, remoteAppServerEnabled, and remoteAppServerUrl should not be edited directly. They are controlled by the Desktop UI, app menus, or startup configuration.

Do Desktop preference changes require restarting the app?

No restart is needed when Desktop is running, because a file watcher applies changes within about 100ms. If Desktop is not running, the changes take effect on the next startup.

When should I not use this preferences editing skill?

Do not use it for Desktop product-code changes, Electron IPC work, UI changes, or general Letta Cloud Desktop implementation tasks. It is only for editing the active preferences JSON file.