{
  "id": "letta-code",
  "name": "Letta Code",
  "homepage": "https://www.letta.com/agent",
  "description": "A stateful agent harness for creating agents that are more like people than tools.",
  "executables": [
    "letta"
  ],
  "dotfiles": {
    "paths": [
      "~/.letta/settings.json"
    ],
    "exclude": [],
    "secret": [],
    "side_effect": false
  },
  "commands": {
    "format": 1,
    "label": "Start Letta Code",
    "description": "Start Letta Code interactively, start a new agent with a personality, or send a one-off headless message to an agent. Subcommands (server, computers, skills, setup) and other flags are left out.",
    "quality": "ai-draft",
    "parser": {
      "end_of_options": "--",
      "interleave": "permute",
      "long_equals": true,
      "short_attached": false,
      "short_bundles": false
    },
    "source": [
      {
        "id": "readme",
        "kind": "help",
        "url": "https://github.com/letta-ai/letta-code/blob/main/README.md",
        "revision": "2026-10",
        "evidence": "letta --new-agent --personality tutorial\nUse `--backend cloud` or `--backend local` for a one-off override without changing the saved default.\nRoute a headless message through a specific computer:\nletta -p --agent <agent-id> --computer \"work-laptop\" \"hello from that machine\"\nUse `--computer cloud` to start or reuse the target agent's cloud sandbox.\n"
      }
    ],
    "field": [
      {
        "id": "message",
        "label": "Message",
        "description": "With the headless flag, the message to send and then exit.",
        "type": "string",
        "position": 0,
        "sources": [
          "readme"
        ]
      },
      {
        "id": "headless",
        "label": "Headless message",
        "description": "Send the message without opening the interactive UI.",
        "type": "boolean",
        "option": [
          "-p"
        ],
        "sources": [
          "readme"
        ]
      },
      {
        "id": "agent",
        "label": "Agent id",
        "type": "string",
        "option": [
          "--agent"
        ],
        "sources": [
          "readme"
        ]
      },
      {
        "id": "computer",
        "label": "Computer",
        "description": "Name of a connected computer, or cloud for the agent's cloud sandbox.",
        "type": "string",
        "option": [
          "--computer"
        ],
        "suggestions": [
          {
            "value": "cloud",
            "label": "Cloud sandbox"
          }
        ],
        "sources": [
          "readme"
        ]
      },
      {
        "id": "new_agent",
        "label": "Create a new agent",
        "type": "boolean",
        "option": [
          "--new-agent"
        ],
        "sources": [
          "readme"
        ]
      },
      {
        "id": "personality",
        "label": "Personality",
        "type": "string",
        "option": [
          "--personality"
        ],
        "suggestions": [
          {
            "value": "tutorial",
            "label": "Tutorial"
          }
        ],
        "sources": [
          "readme"
        ]
      },
      {
        "id": "backend",
        "label": "Backend (this run only)",
        "type": "enum",
        "option": [
          "--backend"
        ],
        "choices": [
          {
            "value": "cloud",
            "label": "Letta Cloud"
          },
          {
            "value": "local",
            "label": "Local"
          }
        ],
        "sources": [
          "readme"
        ]
      }
    ],
    "task": [
      {
        "id": "tutorial",
        "label": "Start the tutorial agent",
        "fields": [
          "new_agent",
          "personality"
        ],
        "required": [
          "new_agent",
          "personality"
        ],
        "set": {
          "new_agent": [
            true
          ],
          "personality": [
            "tutorial"
          ]
        }
      },
      {
        "id": "headless_message",
        "label": "Send a headless message",
        "fields": [
          "headless",
          "agent",
          "computer",
          "message"
        ],
        "required": [
          "headless",
          "agent",
          "message"
        ],
        "set": {
          "headless": [
            true
          ]
        }
      }
    ],
    "group": [
      {
        "id": "basic",
        "label": "Basic",
        "fields": [
          "headless",
          "agent",
          "message",
          "new_agent",
          "personality"
        ]
      },
      {
        "id": "advanced",
        "label": "Advanced",
        "fields": [
          "computer",
          "backend"
        ]
      }
    ]
  }
}