Skip to content

Commit 78af477

Browse files
authored
Updated readmes (#2408)
* readme wip * Added new commands * Simplified readme * Added docs links and improved about * Added nice header and updated links * Consistent headers * Copy update
1 parent e864973 commit 78af477

File tree

2 files changed

+55
-39
lines changed

2 files changed

+55
-39
lines changed

packages/cli-v3/README.md

Lines changed: 26 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,30 @@
1+
<div align="center">
2+
<picture>
3+
<source media="(prefers-color-scheme: dark)" srcset="https://imagedelivery.net/3TbraffuDZ4aEf8KWOmI_w/a45d1fa2-0ae8-4a39-4409-f4f934bfae00/public">
4+
<source media="(prefers-color-scheme: light)" srcset="https://imagedelivery.net/3TbraffuDZ4aEf8KWOmI_w/3f5ad4c1-c4c8-4277-b622-290e7f37bd00/public">
5+
<img alt="Trigger.dev logo" src="https://imagedelivery.net/3TbraffuDZ4aEf8KWOmI_w/a45d1fa2-0ae8-4a39-4409-f4f934bfae00/public">
6+
</picture>
7+
8+
[![npm version](https://img.shields.io/npm/v/trigger.dev.svg)](https://www.npmjs.com/package/trigger.dev)
9+
[![npm downloads](https://img.shields.io/npm/dm/trigger.dev.svg)](https://www.npmjs.com/package/trigger.dev)
10+
[![GitHub stars](https://img.shields.io/github/stars/triggerdotdev/trigger.dev?style=social)](https://github.com/triggerdotdev/trigger.dev)
11+
[![TypeScript](https://img.shields.io/badge/%3C%2F%3E-TypeScript-%230074c1.svg)](https://www.typescriptlang.org/)
12+
[![License: ](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
13+
[![Open Source](https://img.shields.io/badge/Open%20Source-%E2%9D%A4-red)](https://github.com/triggerdotdev/trigger.dev)
14+
15+
[Discord](https://trigger.dev/discord) | [Website](https://trigger.dev) | [Issues](https://github.com/triggerdotdev/trigger.dev/issues) | [Docs](https://trigger.dev/docs) | [Examples](https://trigger.dev/docs/examples)
16+
17+
</div>
18+
119
# Trigger.dev CLI
220

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

523
Note: this only works with Trigger.dev v3 projects and later. For older projects use the [@trigger.dev/cli](https://www.npmjs.com/package/@trigger.dev/cli) package.
624

7-
Trigger.dev is an open source platform that makes it easy to create event-driven background tasks directly in your existing project.
25+
## About Trigger.dev
26+
27+
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.
828

929
## Commands
1030

@@ -17,38 +37,14 @@ Trigger.dev is an open source platform that makes it easy to create event-driven
1737
| [whoami](https://trigger.dev/docs/cli-whoami-commands) | Display the current logged in user and project details. |
1838
| [logout](https://trigger.dev/docs/cli-logout-commands) | Logout of Trigger.dev. |
1939
| [list-profiles](https://trigger.dev/docs/cli-list-profiles-commands) | List all of your CLI profiles. |
40+
| [preview archive](https://trigger.dev/docs/cli-preview-archive) | Archive a preview branch. |
41+
| [promote](https://trigger.dev/docs/cli-promote-commands) | Promote a previously deployed version to the current version. |
42+
| [switch](https://trigger.dev/docs/cli-switch) | Switch between CLI profiles. |
2043
| [update](https://trigger.dev/docs/cli-update-commands) | Updates all `@trigger.dev/*` packages to match the CLI version. |
2144

22-
## MCP Server
23-
24-
The [Model Context Protocol (MCP)](https://modelcontextprotocol.io/introduction) is an open protocol that allows you to provide custom tools
25-
to agentic LLM clients, like [Claude for Desktop](https://docs.anthropic.com/en/docs/claude-for-desktop/overview), [Cursor](https://www.cursor.com/), [Windsurf](https://windsurf.com/), etc...
26-
27-
The Trigger.dev CLI can expose an MCP server and enable you interact with Trigger.dev in agentic LLM workflows. For example, you can use
28-
it to trigger tasks via natural language, view task runs, view logs, debug issues with task runs, etc...
29-
30-
### Starting the Trigger.dev MCP Server
31-
32-
To start the Trigger.dev MCP server, simply pass the `--mcp` flag to the `dev` command:
33-
34-
```bash
35-
trigger dev --mcp
36-
```
37-
38-
By default it runs on port `3333`. You can change this by passing the `--mcp-port` flag:
39-
40-
```bash
41-
trigger dev --mcp --mcp-port 3334
42-
```
43-
44-
### Configuring your MCP client
45-
46-
This depends on what tool you are using. For Cursor, the configuration is in the [.cursor/mcp.json](../../.cursor/mcp.json) file
47-
and should be good to go as long as you use the default MCP server port.
48-
49-
Check out [Cursor's docs](https://docs.cursor.com/context/model-context-protocol) for further details.
45+
## CLI documentation
5046

51-
Tip: try out [Cursor's YOLO mode](https://docs.cursor.com/context/model-context-protocol#yolo-mode) for a seamless experience :D
47+
For more information on the CLI, please refer to our [docs](https://trigger.dev/docs/cli-introduction).
5248

5349
## Support
5450

packages/trigger-sdk/README.md

Lines changed: 29 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -4,28 +4,48 @@
44
<source media="(prefers-color-scheme: light)" srcset="https://imagedelivery.net/3TbraffuDZ4aEf8KWOmI_w/3f5ad4c1-c4c8-4277-b622-290e7f37bd00/public">
55
<img alt="Trigger.dev logo" src="https://imagedelivery.net/3TbraffuDZ4aEf8KWOmI_w/a45d1fa2-0ae8-4a39-4409-f4f934bfae00/public">
66
</picture>
7-
8-
### Open source background jobs with no timeouts
97

10-
[Discord](https://trigger.dev/discord) | [Website](https://trigger.dev) | [Issues](https://github.com/triggerdotdev/trigger.dev/issues) | [Docs](https://trigger.dev/docs)
8+
[![npm version](https://img.shields.io/npm/v/@trigger.dev/sdk.svg)](https://www.npmjs.com/package/@trigger.dev/sdk)
9+
[![npm downloads](https://img.shields.io/npm/dm/@trigger.dev/sdk.svg)](https://www.npmjs.com/package/@trigger.dev/sdk)
10+
[![GitHub stars](https://img.shields.io/github/stars/triggerdotdev/trigger.dev?style=social)](https://github.com/triggerdotdev/trigger.dev)
11+
[![TypeScript](https://img.shields.io/badge/%3C%2F%3E-TypeScript-%230074c1.svg)](https://www.typescriptlang.org/)
12+
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
13+
[![Open Source](https://img.shields.io/badge/Open%20Source-%E2%9D%A4-red)](https://github.com/triggerdotdev/trigger.dev)
1114

12-
[![Twitter](https://img.shields.io/twitter/url/https/twitter.com/triggerdotdev.svg?style=social&label=Follow%20%40trigger.dev)](https://twitter.com/triggerdotdev)
15+
[Discord](https://trigger.dev/discord) | [Website](https://trigger.dev) | [Issues](https://github.com/triggerdotdev/trigger.dev/issues) | [Docs](https://trigger.dev/docs) | [Examples](https://trigger.dev/docs/examples)
1316

1417
</div>
1518

1619
# Official TypeScript SDK for Trigger.dev
1720

18-
The Trigger.dev SDK is a TypeScript/JavaScript library that allows you to define and trigger tasks in your project.
21+
The Trigger.dev SDK is a TypeScript/JavaScript library that allows you to define and trigger tasks in your projects.
1922

20-
## About
23+
## About Trigger.dev
2124

22-
Trigger.dev is an open source platform and SDK which allows you to create long-running background jobs. Write normal async code, deploy, and never hit a timeout.
25+
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.
26+
27+
## Core features
28+
29+
- Task creation and execution
30+
- CLI for development and deployment
31+
- Build system with extensions
32+
- Management API for runs, schedules, and environment variables
33+
34+
## Key Components:
35+
36+
- Tasks: Background jobs written in TypeScript/JavaScript
37+
- CLI: Commands for login, init, dev, deploy
38+
- Build Extensions: Customize builds (Prisma, Python, FFmpeg, etc.)
39+
- Management API: Programmatic control over runs and resources
2340

2441
## Getting started
2542

26-
The quickest way to get started is to create an account in our [web app](https://cloud.trigger.dev), create a new project and follow the instructions in the onboarding. Build and deploy your first task in minutes.
43+
There are two ways to get started:
44+
45+
1. Create an account in our [web app](https://cloud.trigger.dev), create a new project and follow the instructions in the onboarding. Build and deploy your first task in minutes.
46+
2. [Manual setup](https://trigger.dev/docs/manual-setup) in your existing project.
2747

28-
## SDK usage
48+
## SDK documentation
2949

3050
For more information on our SDK, refer to our [docs](https://trigger.dev/docs/introduction).
3151

0 commit comments

Comments
 (0)