Files
triggerdotdev--trigger.dev/packages/cli-v3
Saadi Myftija c4b5e27258 feat(cli): build deployment images on prebuilt base images (#4602)
The generated deploy Containerfile now starts from the prebuilt base
images published by base-images/ (`triggerdotdev/node` and
`triggerdotdev/bun` on DockerHub, pinned by digest) instead of
installing system packages during every project's build. Uncustomized
projects run no apt at all and their base layers are identical across
every project, so worker nodes cache one copy fleet-wide. The build
stage uses the -build toolchain variant for uncustomized and
package-only projects; projects with image instructions build FROM base
so instructions and their downloads run exactly once.

### Notes

- User packages install in their own sorted RUN with --allow-downgrades
(a pin of a preinstalled package is a downgrade against the prebuilt
base), preceded by a dpkg repair whenever instructions came first, since
apt-get install refuses to run on state a dpkg -i instruction left
broken.
- Deployed runtime images inherit newer package versions than today's
live-archive installs (the published bases upgrade everything to their
snapshot), plus the base images' OCI labels. Runtime env, user, workdir,
and entrypoint are unchanged.
2026-08-14 12:27:06 +02:00
..
2026-08-13 15:48:29 +01:00
2026-08-13 15:48:29 +01:00
2025-08-18 12:10:15 +01:00

Trigger.dev CLI

A CLI that allows you to create, run locally and deploy Trigger.dev background tasks.

Note: this only works with Trigger.dev v3 projects and later. For older projects use the @trigger.dev/cli package.

About Trigger.dev

Trigger.dev is an open source platform for building and deploying fully-managed AI agents and workflows. Write workflows in normal async TypeScript for everything from simple tasks to long-running AI agents, heavy media processing, complex real-time systems and more. Complete with full observability, managed queues, and elastic infrastructure which handles the horizontal scaling.

Commands

Command Description
login Login with Trigger.dev so you can perform authenticated actions.
init Initialize your existing project for development with Trigger.dev.
dev Run your Trigger.dev tasks locally.
deploy Deploy your Trigger.dev v3 project to the cloud.
whoami Display the current logged in user and project details.
logout Logout of Trigger.dev.
list-profiles List all of your CLI profiles.
preview archive Archive a preview branch.
promote Promote a previously deployed version to the current version.
switch Switch between CLI profiles.
update Updates all @trigger.dev/* packages to match the CLI version.

CLI documentation

For more information on the CLI, please refer to our docs.

Support

If you have any questions, please reach out to us on Discord and we'll be happy to help.