Configuration

Letta Code uses a hierarchical configuration system with global and project-level settings.

Authentication

Letta Cloud (default)

On first run, Letta Code prompts you to authenticate via OAuth:

1. Run letta
2. Follow the browser prompt to log in at app.letta.com

API key

Alternatively, set an API key directly:

export LETTA_API_KEY=your-api-key

Self-hosted server

See Self-hosting to use Letta Code with your own Letta server.

Configuration files

Global settings (~/.letta/settings.json)

Applies to all projects:

{
  "tokenStreaming": true,
  "globalSharedBlockIds": {
    "persona": "block-id-...",
    "human": "block-id-..."
  }
}

Project settings (.letta/settings.local.json)

Personal, gitignored - your agent for this project:

{
  "lastAgent": "agent-id-..."
}

Shared project settings (.letta/settings.json)

Can be committed to share with your team:

{
  "permissions": {
    "allow": ["Bash(pnpm lint)", "Bash(pnpm test)"]
  }
}

Settings reference

Setting	Type	Description
tokenStreaming	boolean	Enable real-time token streaming
enableSleeptime	boolean	Enable sleeptime agents for passive memory updates (default: false)
lastAgent	string	ID of last used agent (for auto-resume)
globalSharedBlockIds	object	IDs of global memory blocks
permissions.allow	string[]	Patterns to auto-allow
permissions.deny	string[]	Patterns to always deny

Updates

Letta Code automatically keeps itself up to date to ensure you have the latest features and fixes.

• Update checks: Performed on startup and periodically while running
• Update process: Downloads and installs automatically in the background
• Applying updates: Updates take effect the next time you start Letta Code

Disable auto-updates

export DISABLE_AUTOUPDATER=1

Manual update

letta update

Recommended .gitignore

# Letta Code personal settings
.letta/settings.local.json

Keep .letta/settings.json tracked to share project context with your team.