---
title: Letta Code CLI | Letta Docs
description: Run Letta Code from your terminal
---

## Install the Letta Code CLI

Requires Node.js 22.19+

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

![Letta Code CLI](/letta-code-demo.gif)

## Getting started

1. **Install Letta Code**

   Run the following command to install Letta Code via your terminal (requires [Node.js](https://nodejs.org/en/download) 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](/letta-agent/cli-reference/index.md) to see the full list of CLI commands.

5. **Optional: login to [Constellation](/letta-agent/constellation/index.md) (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](/letta-agent/headless/index.md) for automations.