Letta Code CLI

Install the Letta Code CLI

Requires Node.js 22.19+

npm install -g @letta-ai/letta-code

Getting started

1. Install Letta Code

   Run the following command to install Letta Code via your terminal (requires Node.js version 22.19+):

   npm install -g @letta-ai/letta-code

   To launch Letta Code, run:

   letta

   If you’re running Letta Code for the first time, a new local agent will be auto-created for you. This default local mode stores agent state on your machine and does not require a Letta login.

   If you have an older version of Node.js installed, npm install -g may silently install an older version of Letta Code that is compatible with your Node version. To ensure you get the latest version, make sure your Node.js is 22.19 or newer. You can check with node --version.

2. Connect to LLM providers

   Use /connect to connect external API keys, coding plans, and local inference servers.

3. Navigate to your project

   cd your-project
   letta

4. Send your first message

   You’re ready to chat! Try asking your agent to explore your codebase or run /init to bootstrap its memory.

   Use /new to start a new conversation (or letta --new), /resume to swap conversations, /agent to swap agents, and /model to swap models. View the CLI reference to see the full list of CLI commands.

5. Optional: login to Constellation (agent cloud)

   Run /login if you want cloud-managed state to easily teleport your agents to any device: chat.letta.com, the desktop app, remote machines, and messaging integrations. You can store up to 3 agents for free on Constellation.

You can also run the CLI in headless mode for automations.