novuhq

novuhq/novu

Cursor rule Cursor

NEVER run apps/api mocha tests without NODEENV=test — drops dev MongoDB.

novuhq/novu

Cursor rule Cursor

Rules for writing and running tests.

novuhq/novu

Cursor rule Cursor

Rules for working in the Worker service (background job processing).

novuhq/novu

Cursor rule Cursor

Rules for working in the WebSocket service (real-time delivery).

novuhq/novu

Skill Claude CodeCodexCursor

Build a new channel Connect button (e.g. WhatsApp, Discord, LINE) in @novu/js and @novu/react following the existing SlackConnectButton, MsTeamsConnectButton, and TelegramConnectButton pattern. Use when adding connect/disconnect UI for a new chat channel/provider to the SDK — covering the SolidJS core component, the…

novuhq/novu

Skill Claude CodeCodexCursor

Add a new chat channel's layer-1 setup guide — the in-dashboard SetupGuide that walks a developer through connecting the channel itself (create app/bot → save credentials → install/verify → send first message) with live connection detection — in apps/dashboard, following the existing Slack, MS Teams, and Telegram…

novuhq/novu

Skill Claude CodeCodexCursor

Add a new chat channel's layer-2 dashboard onboarding — the connected-state "What's next" / "FOR YOUR USERS" developer-rollout guide plus its connected details page — in apps/dashboard, following the existing Slack, MS Teams, and Telegram pattern. Use when a connected agent integration needs a per-provider "what's…

novuhq/novu

Skill Claude CodeCodexCursor

Critically triage pull request review comments against PR requirements and codebase reality, implement only valid fixes, and reply only when declining a suggestion. Use when the user asks to address PR comments, review feedback, CodeRabbit/Bugbot threads, or /address-pr-review.

novuhq/novu

Skill Claude CodeCodexCursor

Use this skill when making changes to the enterprise submodule (.source/) or enterprise packages (enterprise/packages/), or when the enterprise submodule needs to be initialized/updated.

novuhq/novu

Skill Claude CodeCodexCursor

Build terminal user interfaces (TUIs) using Ink (React for CLIs) and @inkjs/ui with a reactive, session-driven wizard pattern. Use when creating interactive CLI installation wizards, setup flows, or multi-step terminal applications in Node.js/TypeScript. Covers reactive screen resolution, declarative flow pipelines…

novuhq/novu

Skill Claude CodeCodexCursor

Post-implementation PR prep for Novu feature branches — quality passes, commit/PR hygiene, CI triage, and review feedback. Use after feature work is done, when the user asks to prepare a PR, ship a branch, fix CI, address review comments, or babysit a pull request before merge.

novuhq/novu

Skill Claude CodeCodexCursor

Build or refactor a Tool-channel provider (PagerDuty, Opsgenie, future incident/alerting tools) to be endpoint-routed: per-subscriber secrets encrypted on the channel endpoint resource, a stateless provider that resolves routing from channelData at send time, SKIPPED steps when no endpoint exists, and the full…

novuhq/novu

Skill Claude CodeCodexCursor

Implement planned work by fanning out parallel subagents on isolated worktrees — TDD at pre-agreed seams, per-slice nv-park-and-review, merge back, full suite once at the end.

novuhq/novu

Skill Claude CodeCodexCursor

Onboard a new DCR OAuth MCP catalog entry with provider-doc vetting and curl probes. Use when adding or changing mode: dcr entries in MCPSERVERS. Abort if the provider requires whitelist or manual approval.

novuhq/novu

Skill Claude CodeCodexCursor

Commit local changes as a baseline, hop into a lightweight review worktree, run a thermo-nuclear code quality review scoped to ONLY that commit, commit the resulting refactor as a separate follow-up commit, then land it back and tear the worktree down. Use when the user asks to review their local/uncommitted changes…

novuhq/novu

Skill Claude CodeCodexCursor

Audits git worktrees and removes the ones that are safe to delete — merged into the base branch (including squash-merges via gh), missing on disk, or explicitly confirmed by the user — then deletes the associated local branches and runs git worktree prune. Use when the user asks to clean up worktrees, prune worktrees…

novuhq/novu

Skill Claude CodeCodexCursor

Git worktree command reference: path naming, create/remove/prune, .env copy, package-manager install, and cleanup. Use when implementing or debugging worktree setup — not as the primary user-facing workflow (see nv-worktree-create).

novuhq/novu

Skill Claude CodeCodexCursor

Create a sibling git worktree and a new branch with the same name, copy local .env files, initialize the enterprise submodule, wire enterprise symlinks, and move the agent into the worktree. Use when the user asks for a worktree, parallel branch checkout, or /worktree with a branch name.

novuhq/novu

Skill Claude CodeCodexCursor

Run e2e tests for the API service. Use when the user wants to run API E2E tests.

novuhq/novu

Skill Claude CodeCodexCursor

Create and publish Novu changelog entries in Sanity (changelogPost documents), including feature posts, "improvements & fixes" roundups built from Linear releases, and the Changes (changeBlock) component. Use when asked to write a changelog entry, announce a shipped feature on the changelog, roll up improvements/bug…

novuhq/novu

Skill Claude CodeCodexCursor

Triage failing @novu/agent-evals scenarios to decide whether a failure is real or flaky, and whether to fix the playbook/prompt or the test (grader, tape, scenario, or judge). Use when an agent-evals scenario fails, when the user asks why an eval is red, or when deciding whether to fix the test or the prompt.

novuhq/novu

Instructions file CodexOpenCode

AGENTS.md instructions for novuhq/novu, covering agents.md, cursor cloud specific instructions, build, ai boundaries and always.

novuhq/novu

Skill Claude CodeCodex

Author step content for Novu workflows defined in the Dashboard or generated/edited via the Novu MCP. Use when filling in step controls (subject, body, editorType, headers, body, conditions) for email, in-app, sms, push, chat, delay, digest, throttle, or HTTP Request steps.

novuhq/novu

Skill Claude CodeCodex

Design notification workflows the Novu way — choose channels, set severity, decide when a workflow is critical, configure digests, and route based on subscriber state. Applies to BOTH dashboard-authored and code-first (@novu/framework) workflows. Use when planning a new workflow, deciding which channels to include…