lettactl

Note

lettactl is a community-maintained tool, not an official Letta product. Review the source code and repository before using it in production.

lettactl is a CLI that brings kubectl-style declarative management to Letta agents. You define agents in YAML, keep those files in git, and apply changes to your Letta project from the command line.

Installation

npm install -g lettactl

Quick start

1. Create a configuration file named letta.yaml:

agents:
  - name: support-agent
    model: gpt-4o
    memory_blocks:
      - label: persona
        file: ./blocks/support-persona.md
      - label: guidelines
        file: ./blocks/support-guidelines.md
    tools:
      - web_search
      - send_email

2. Apply the configuration to your Letta project:

lettactl apply -f letta.yaml

lettactl will create or update the support-agent definition in Letta based on the contents of the YAML file and any referenced memory block files.

Key features

• Declarative configuration in YAML files
• Automatic diffing of memory block files and agent definitions
• Shared memory blocks by pointing multiple agents at the same source file
• Git-friendly agent definitions for code review and history

Common use cases

• CI/CD pipelines for agent deployment
• Managing agent fleets across environments (dev, staging, prod)
• Team collaboration on agent personas and memory block content

Resources

• GitHub repository: https://github.com/nouamanecodes/lettactl
• Author: powerful_dolphin_87375 on Discord