> For the complete documentation index, see [llms.txt](https://docs.warp.dev/llms.txt).
> Markdown versions of each page are available by appending .md to any URL.

# Triggers overview

Start cloud agents in Warp from Slack, Linear, Jira, GitHub, schedules, CI, or API calls, and find where each trigger reports its results.

A trigger starts a Warp cloud agent run from an event or a recurring schedule, without you typing a prompt. Pick a trigger based on where your work starts and where you want to read the results.

For triggers that route work through one factory’s named agents and workflow, use [factory automations](https://docs.warp.dev/factories/automations/) and [factory integrations](https://docs.warp.dev/factories/connect-your-factory/).

To set up your first recurring agent, follow the [Scheduled agents quickstart](https://docs.warp.dev/platform/triggers/scheduled-agents-quickstart/).

## Available trigger types

| Trigger | How you invoke it | Where to inspect results | Setup |
| --- | --- | --- | --- |
| Slack | Mention `@Warp` in a message or thread, or DM the bot. | Progress, summary, and PR links in the Slack thread. | [Slack integration](https://docs.warp.dev/platform/integrations/slack/) |
| Linear | Mention `@warp` in a comment or assign an issue to the agent. | Updates, summary, and PR links in the Linear issue. | [Linear integration](https://docs.warp.dev/platform/integrations/linear/) |
| Jira Cloud | Add the `warp-agent` label to an issue after connecting your Jira account. | Status and summary comments on the issue, including links to any PRs or branches created and the conversation. | [Jira integration](https://docs.warp.dev/platform/integrations/jira/) |
| GitHub | Mention `@warp-agent` in a new issue comment, pull request comment, review comment, or new pull request description. | Status, progress, and summary in the same thread, including any PRs opened. | [GitHub integration](https://docs.warp.dev/platform/integrations/github/) |
| GitHub Actions | Define repository events and an `oz-agent-action` step in workflow YAML. | Agent output in workflow steps; comments or branches depend on your prompt and permissions. | [GitHub Actions](https://docs.warp.dev/platform/integrations/github-actions/) |
| Schedules | Configure a recurring cron expression and prompt. | Each run’s task and session history, including logs and outputs. | [Scheduled agents](https://docs.warp.dev/platform/triggers/scheduled-agents/) |
| CLI | Start a cloud run from your terminal with the Oz CLI. | Run status and session links from the CLI or [Oz web app](https://docs.warp.dev/platform/oz-web-app/). | [Oz CLI](https://docs.warp.dev/agents/cli/oz-cli/) |
| API and SDK | Submit a prompt and configuration to the Agent and run endpoints. | Run details and session links fetched through the API. | [Agent and run endpoints](https://docs.warp.dev/factories/api-and-sdk/) |
| Custom webhooks | POST JSON to a factory webhook URL; a matching automation starts work. | Delivery log and factory runs; webhooks do not provide thread replies. | [Custom webhooks](https://docs.warp.dev/factories/webhooks/) |

After a trigger fires, track and review the resulting runs across your team from the [Agent Management Panel and Oz web app Runs page](https://docs.warp.dev/platform/managing-cloud-agents/), where you can filter by source, status, day, or creator.

## Related pages

-   [Integrations overview](https://docs.warp.dev/platform/integrations/) - Connect Slack, Linear, GitHub, [Jira](https://docs.warp.dev/platform/integrations/jira/), and other supported services.
-   [Run agents unattended with schedules and triggers](https://docs.warp.dev/guides/agent-workflows/how-to-run-unattended-agents/) - Choose a trigger for an unattended workflow.
