docs: add troubleshooting entry for runs not dequeuing in dev

[isshaddad]

No description provided.

[changeset-bot]

⚠️ No Changeset found

Latest commit: 8b6647e

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: dbd0d5ba-a1b8-45f9-833c-fa4e5d5b9b09

📥 Commits

Reviewing files that changed from the base of the PR and between 071a6a6 and bf81e19.

📒 Files selected for processing (1)

• docs/troubleshooting.mdx

✅ Files skipped from review due to trivial changes (1)

• docs/troubleshooting.mdx

📜 Recent review details

⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (1)

• GitHub Check: Analyze (javascript-typescript)

---

Walkthrough

A new troubleshooting subsection titled "Runs never dequeue in dev" is added to docs/troubleshooting.mdx under the Development section. It documents that having multiple trigger.dev dev sessions connected to the same account can prevent runs from dequeuing, and instructs users to stop any extra sessions so that only one dev session is active per account.

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Description check	⚠️ Warning	The pull request description is empty, missing all required sections from the template including Testing, Changelog, and issue closure reference.	Add a complete description following the repository template, including issue reference, testing steps, changelog entry, and checklist completion.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title accurately and specifically describes the main change: adding a troubleshooting entry for runs not dequeuing in dev environments.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/troubleshooting-dev-dequeue

Warning

There were issues while running some tools. Please review the errors and either fix the tool's configuration or disable the tool if it's a critical failure.

🔧 ESLint

If the error stems from missing dependencies, add them to the package.json file. For unrecoverable errors (e.g., due to private dependencies), disable the tool in the CodeRabbit configuration.

ESLint install timed out. The project may have too many dependencies for the sandbox.

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
trigger	🟢 Ready	View Preview	Jun 15, 2026, 4:04 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

[pkg-pr-new]

Open in StackBlitz

@trigger.dev/build

npm i https://pkg.pr.new/@trigger.dev/build@8b6647e

trigger.dev

npm i https://pkg.pr.new/trigger.dev@8b6647e

@trigger.dev/core

npm i https://pkg.pr.new/@trigger.dev/core@8b6647e

@trigger.dev/python

npm i https://pkg.pr.new/@trigger.dev/python@8b6647e

@trigger.dev/react-hooks

npm i https://pkg.pr.new/@trigger.dev/react-hooks@8b6647e

@trigger.dev/redis-worker

npm i https://pkg.pr.new/@trigger.dev/redis-worker@8b6647e

@trigger.dev/rsc

npm i https://pkg.pr.new/@trigger.dev/rsc@8b6647e

@trigger.dev/schema-to-json

npm i https://pkg.pr.new/@trigger.dev/schema-to-json@8b6647e

@trigger.dev/sdk

npm i https://pkg.pr.new/@trigger.dev/sdk@8b6647e

commit: 8b6647e

[devin-ai-integration]

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no bugs or issues to report.