CLAUDE.md

1# CLI Package
2 
3The `trigger.dev` CLI package, published as `trigger.dev` on npm. Executable: `trigger`.
4 
5## Dev vs Deploy
6 
7### Dev Mode (`src/dev/`)
8Runs tasks locally in the user's Node.js process. No containers involved. Uses `src/dev/` for the dev command, connects to the local webapp for coordination.
9 
10### Deploy Mode (`src/deploy/`)
11Bundles task code and builds Docker images for production:
121. **Bundle**: `src/build/` bundles worker code using the build system
132. **Archive**: `src/deploy/archiveContext.ts` packages files for deployment
143. **Build image**: `src/deploy/buildImage.ts` creates Docker images (local Docker/Depot or remote builds)
154. **Push**: Pushes image to registry, registers with webapp API
16 
17## Customer Task Images
18 
19Code in `src/entryPoints/` runs **inside customer containers** - this is a different runtime environment from the CLI itself. Changes here affect deployed task execution directly.
20 
21The build system (`src/build/`) uses the config from `trigger.config.ts` in user projects to determine what to bundle, which build extensions to apply, and how to structure the output.
22 
23## Commands
24 
25CLI command definitions live in `src/commands/`. Key commands:
26- `dev.ts` - Local development mode
27- `deploy.ts` - Production deployment
28- `init.ts` - Project initialization
29- `login.ts` - Authentication
30- `promote.ts` - Deployment promotion
31 
32## MCP Server
33 
34`src/mcp/` provides an MCP server for AI-assisted task development.
35 
36## SDK Documentation Rules
37 
38The `rules/` directory at the repo root contains versioned SDK documentation that gets installed alongside customer projects. Update both `rules/` and `.claude/skills/trigger-dev-tasks/` when SDK features change.
39