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

To use Letta Code with a self-hosted Letta server:

export LETTA_BASE_URL="http://localhost:8283"

See the self-hosting guide for more information.

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
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 checks for updates on startup and installs them in the background. 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.