# Fleet Deployment

> Use when deploying agents from YAML configuration files

- Skill: `tomevault-io/fleet-deployment` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/fleet-deployment`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/fleet-deployment/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/fleet-deployment

---


## Entry Points
- `src/commands/apply.ts` - Deploy fleet from YAML
- `src/commands/validate.ts` - Validate config syntax
- `src/lib/fleet-parser.ts` - YAML parsing & content resolution
- `src/lib/diff-engine.ts` - Change detection
- `src/lib/diff-applier.ts` - Apply changes to Letta

## Commands

```bash
lettactl apply -f <file> [--dry-run] [--force] [-q] [-v]
lettactl apply-template -f <file> --template <pattern> [--dry-run]
lettactl validate -f <file>
```

## Key Types

```typescript
FleetConfig {
  root_path?: string
  shared_blocks?: SharedBlock[]
  mcp_servers?: McpServerConfig[]
  agents: AgentConfig[]
}

AgentConfig {
  name: string
  description: string
  system_prompt: { value?: string; from_file?: string; from_bucket?: BucketConfig }
  llm_config: { model: string; context_window: number }
  tools?: string[]
  shared_blocks?: string[]
  memory_blocks?: MemoryBlock[]
  folders?: FolderConfig[]
}

MemoryBlock {
  name: string
  description: string
  limit: number
  value?: string
  from_file?: string
  agent_owned?: boolean  // default: true
}
```

## Examples

```bash
# Deploy fleet
lettactl apply -f fleet.yaml

# Preview changes
lettactl apply -f fleet.yaml --dry-run

# Remove resources not in config
lettactl apply -f fleet.yaml --force

# Apply template to existing agents
lettactl apply-template -f template.yaml --template "^prod-.*"
```

## Environment
- `LETTA_BASE_URL` - Letta server URL (required)
- `LETTA_API_KEY` - API key (optional for self-hosted)
- `SUPABASE_URL`, `SUPABASE_ANON_KEY` - For cloud storage

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/nouamanecodes) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->