Skip to content
Letta Platform Letta Platform Letta Docs
Sign up
Development tools
Community tools
lettactl

lettactl

Use a community-built CLI and SDK to manage Letta fleets with declarative YAML, canaries, and multi-tenant workflows.

lettactl is a kubectl-style CLI and TypeScript SDK for declarative Letta fleet management. It is designed for deploying and operating many agents with version-controlled configs, safer rollouts, and repeatable workflows.

The canonical documentation now lives at lettactl.dev.

Installation

Section titled “Installation”
Terminal window
npm install -g lettactl

Quick Start

Section titled “Quick Start”

1. Configure your environment

Section titled “1. Configure your environment”
Terminal window
export LETTA_BASE_URL=http://localhost:8283
# Optional for Letta Cloud
export LETTA_API_KEY=your-key-here

2. Create a fleet config

Section titled “2. Create a fleet config”

Create fleet.yaml:

agents:
  - name: my-first-agent
    description: "A simple AI assistant"
    llm_config:
      model: "openai/gpt-4o"
      context_window: 128000
    system_prompt:
      value: "You are a helpful assistant."
    memory_blocks:
      - name: user_preferences
        description: "What I know about the user"
        agent_owned: true
        limit: 5000
        value: "No preferences yet."


  - name: support-agent
    description: "Customer support assistant"
    llm_config:
      model: "google_ai/gemini-2.5-pro"
      context_window: 32000
    system_prompt:
      from_file: "prompts/support.md"
    tags:
      - "tenant:acme"
      - "role:support"
    tools:
      - archival_memory_search
      - archival_memory_insert

3. Preview and deploy

Section titled “3. Preview and deploy”
Terminal window
# Preview changes
lettactl apply -f fleet.yaml --dry-run


# Deploy
lettactl apply -f fleet.yaml

Key capabilities

Section titled “Key capabilities”
CapabilityWhat it gives you
Declarative YAML + smart diffApply only the changes needed between local config and server state
Canary deploymentsDeploy CANARY- copies, test, then promote and cleanup safely
Multi-tenancy tagsScope operations by tags (for example tenant:acme,role:support)
Import/export workflowsExport existing agents to YAML and bring them under git-based management
Rich command groupsDeployment, inspection, lifecycle, messaging, async runs, reporting, utilities
TypeScript SDKProgrammatic fleet provisioning and runtime orchestration

Common workflows

Section titled “Common workflows”
  • Validate config before deploy: lettactl validate -f fleet.yaml
  • Inspect fleet state: lettactl get agents, lettactl describe agent <name>
  • Canary rollout: lettactl apply -f fleet.yaml --canary, then --promote --cleanup
  • Tenant-scoped operations: lettactl get agents --tags "tenant:acme"
  • Export existing agents: lettactl export agents --all -f yaml -o fleet.yaml

Where to read full docs

Section titled “Where to read full docs”

Resources

Section titled “Resources”