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]

# Letta's official platform docs list ~/.letta/settings.json as the global
# settings file. Authentication tokens are stored in the operating system
# keychain (or supplied through LETTA_API_KEY), so this settings file is not a
# credential store. Runtime/session state under ~/.letta is deliberately not
# included.
# https://github.com/letta-ai/letta-docs-md/blob/main/platform/computers/byom/index.md
# https://github.com/letta-ai/letta-acp#configuration
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 }

[[commands.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
Use `--backend cloud` or `--backend local` for a one-off override without changing the saved default.
Route a headless message through a specific computer:
letta -p --agent <agent-id> --computer "work-laptop" "hello from that machine"
Use `--computer cloud` to start or reuse the target agent's cloud sandbox.
"""

[[commands.field]]
id = "message"
label = "Message"
description = "With the headless flag, the message to send and then exit."
type = "string"
position = 0
sources = ["readme"]

[[commands.field]]
id = "headless"
label = "Headless message"
description = "Send the message without opening the interactive UI."
type = "boolean"
option = ["-p"]
sources = ["readme"]

[[commands.field]]
id = "agent"
label = "Agent id"
type = "string"
option = ["--agent"]
sources = ["readme"]

[[commands.field]]
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"]

[[commands.field]]
id = "new_agent"
label = "Create a new agent"
type = "boolean"
option = ["--new-agent"]
sources = ["readme"]

[[commands.field]]
id = "personality"
label = "Personality"
type = "string"
option = ["--personality"]
suggestions = [{ value = "tutorial", label = "Tutorial" }]
sources = ["readme"]

[[commands.field]]
id = "backend"
label = "Backend (this run only)"
type = "enum"
option = ["--backend"]
choices = [{ value = "cloud", label = "Letta Cloud" }, { value = "local", label = "Local" }]
sources = ["readme"]

[[commands.task]]
id = "tutorial"
label = "Start the tutorial agent"
fields = ["new_agent", "personality"]
required = ["new_agent", "personality"]
set = { new_agent = [true], personality = ["tutorial"] }

[[commands.task]]
id = "headless_message"
label = "Send a headless message"
fields = ["headless", "agent", "computer", "message"]
required = ["headless", "agent", "message"]
set = { headless = [true] }

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["headless", "agent", "message", "new_agent", "personality"]

[[commands.group]]
id = "advanced"
label = "Advanced"
fields = ["computer", "backend"]