| name | dispatch-dev |
| description | Dispatch a development task to a headless letta-code agent. The task runs in the background and results are posted back to the originating channel when complete. |
Dispatch Dev Task
Spawn a headless letta-code agent to work on a development task in a target repository. The agent runs in the background — your message queue stays unblocked.
Usage
dispatch-dev \
--prompt "Fix the authentication bug in src/auth/refresh.ts" \
--repo /path/to/target/repo \
--channel slack \
--chat C0123456789
Required Arguments
| Arg | Description |
|---|
--prompt | The task description for the dev agent |
--repo | Absolute path to the target repository |
--channel | Originating channel (slack, telegram, discord, signal, whatsapp) |
--chat | Chat/conversation ID for result delivery |
Optional Arguments
| Arg | Default | Description |
|---|
--max-turns | 30 | Maximum agentic turns before stopping |
Known Repositories
| Name | Path |
|---|
| lettabot | /Users/b.c.nims/dev/kastalien-research/letta/lettabot |
| letta-code | /Users/b.c.nims/dev/kastalien-research/letta/letta-code |
| thoughtbox | /Users/b.c.nims/dev/kastalien-research/letta/thoughtbox |
| letta-evals | /Users/b.c.nims/dev/kastalien-research/letta/letta-evals |
| claude-subconscious | /Users/b.c.nims/dev/kastalien-research/letta/claude-subconscious |
| letta-cowork | /Users/b.c.nims/dev/kastalien-research/letta/letta-cowork |
How It Works
- Validates arguments and verifies the repo directory exists
- Spawns
letta headless (--yolo --output-format json) as a detached background process
- Returns immediately with a task ID
- When the agent finishes, posts the result back to the originating channel via
lettabot-message
Important
- The dispatched agent runs with
--yolo (bypass permissions) — it can make changes without approval
- Results are delivered asynchronously via
lettabot-message --channel <channel> --chat <chat>
- Output logs are written to
/tmp/letta-task-<id>.json for debugging
- The agent works on a feature branch, not main
