Skip to content
Letta Code Letta Code Letta Docs
Sign up
Using Letta Code

Letta Code CLI

Run Letta Code from your terminal

Letta Code is a memory-first agent that can run from your terminal. The CLI supports both Letta Cloud agents and Local mode.

Install the Letta Code CLI

Requires Node.js 18+

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

Letta Code CLI

  1. Install Letta Code

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

    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.

  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

    Run /login if you want Constellation-managed state and access from chat.letta.com, the desktop app, other machines, and messaging integrations.

    Read more about Constellation here.