creating-letta-code-channels

Original：🇺🇸 English

Translated

1 scriptsChecked / no sensitive code detected

Builds and debugs Letta Code channels, including first-party channel adapters and dynamic user channel plugins under ~/.letta/channels. Use when adding Telegram, WhatsApp, Bluesky, Slack, Discord, or custom channel support; testing channel routing, pairing, MessageChannel, runtime dependencies, or channel plugin manifests.

11installs

Sourceletta-ai/skills

Added on2026-05-26

NPX Install

npx skill4agent add letta-ai/skills creating-letta-code-channels

SKILL.md Content

View Translation Comparison →

Creating Letta Code channels

Use this when adding or debugging Letta Code channel support.

First choice

User plugin (
```
~/.letta/channels/<id>/
```
) for headless experiments, community plugins, and fast workflow tests.
First-party channel (
```
src/channels/<id>/
```
) when the channel needs bespoke Desktop UI, custom account snapshots, Slack/Discord-style auto-routing, rich protocol fields, or migration/compatibility shims.

User plugins cannot shadow first-party ids:

telegram

,

slack

, and

discord

are ignored under

~/.letta/channels/

. Use ids like

telegram-test

,

whatsapp-community

, or

custom-chat

.

Core workflow

Work in
```
~/letta/letta-code
```
or a worktree.
Read
```
src/channels/README.md
```
on branches with dynamic plugins.

For a user plugin, create:

```
~/.letta/channels/<id>/channel.json
```
```
~/.letta/channels/<id>/plugin.mjs
```
```
~/.letta/channels/<id>/accounts.json
```

Always implement
```
messageActions
```
if agents should reply via
```
MessageChannel
```
.
Start with
```
dmPolicy: "pairing"
```
for testing, or
```
allowlist
```
/
```
open
```
for known headless deployments.
Test all four legs:
- plugin discovery/import
- inbound
```
adapter.onMessage(msg)
```
  to route/pairing
- routed channel notification reaches the agent
- outbound
```
MessageChannel
```
  calls
```
messageActions.handleAction
```
  →
```
adapter.sendMessage
```

Run targeted tests, then

bun run typecheck

,

bun run lint

,

bun run build

.

References

Read only what is needed:

```
references/user-plugins.md
```
— dynamic plugin manifest/account/runtime/headless flow and gotchas.
```
references/first-party-channels.md
```
— first-party channel file cascade and safety checks.
```
references/testing.md
```
— smoke-test checklist and commands.

Scaffold helper

Use the bundled scaffold for a minimal user plugin skeleton. Replace

<path-to-this-skill>

with this skill directory path:

bash

npx tsx <path-to-this-skill>/scripts/scaffold-user-channel-plugin.ts \
  my-channel "My Channel" \
  --runtime-package some-sdk@1.0.0 \
  --runtime-module some-sdk

It creates

channel.json

,

plugin.mjs