@nuniapp/cli

Sets up Nuni in any project.

npx @nuniapp/cli@latest init           # new project ID + install steps for your framework
npx @nuniapp/cli@latest init --json    # the same, machine-readable (for agents)
npx @nuniapp/cli@latest prompt         # the ready-made prompt for your coding agent
npx @nuniapp/cli@latest id             # just a new project ID

Read, reply to and resolve comments from the terminal, or let your coding agent do it over MCP:

npx @nuniapp/cli@latest login              # approve this terminal in the Nuni dashboard
npx @nuniapp/cli@latest comments           # open comments, newest first
npx @nuniapp/cli@latest comments --search "typo" --group element
npx @nuniapp/cli@latest pages              # pages with open comments
npx @nuniapp/cli@latest comment <id>       # one comment with the element, DOM, console and screenshot
npx @nuniapp/cli@latest reply <id> "message"
npx @nuniapp/cli@latest resolve <id...> --note "what changed"
npx @nuniapp/cli@latest reopen <id...>
npx @nuniapp/cli@latest whoami             # or logout
npx @nuniapp/cli@latest help <command>     # every command and flag
claude mcp add nuni -- npx -y @nuniapp/cli@latest mcp

See Coding agents for Cursor, Codex and other MCP clients.

init does not edit your files. It detects your framework (Next.js, React, Vue, Nuxt, SvelteKit, Astro, Angular, plain HTML and more) and package manager, and prints exactly what to add and where.

Agent prompt

Add Nuni (pinned comments on the live site) to this project.

Get a project ID by running: npx @nuniapp/cli@latest init (it prints the ID and the exact snippet for this framework).

Steps:
1. Detect the framework and package manager.
2. If the app uses React (Next.js, Vite, Remix, React Router, TanStack Start, etc.):
   - Install @nuniapp/react@latest.
   - Render <Nuni project="PROJECT_ID" /> once, globally, in the root layout or app entry (for Next.js App Router: app/layout.tsx, inside <body>). It is already a client component.
3. Otherwise, if there is a bundler (Vue, Svelte, Astro, Angular, etc.):
   - Install @nuniapp/widget@latest.
   - Call init({ project: "PROJECT_ID" }) once on the client, in the app entry or root layout. import { init } from "@nuniapp/widget".
4. If there is no bundler (plain HTML, WordPress, Webflow): add this before </body> on every page:
   <script src="https://cdn.jsdelivr.net/npm/@nuniapp/widget@latest/dist/nuni.global.js" data-project="PROJECT_ID" defer></script>
5. Commit the project ID directly in the code. It is public, not a secret. Do not put it in an env var.
6. Do not add Nuni to server-only code, and do not load it more than once.
7. If the site sends a Content-Security-Policy, allow connect-src https://*.convex.cloud wss://*.convex.cloud https://*.convex.site (and script-src cdn.jsdelivr.net for the script tag).
8. Start the dev server, open the site, and confirm the Nuni button appears in the bottom-right corner.
9. Tell the user they can let you read and resolve comments later: run npx @nuniapp/cli@latest login once, then add the MCP server (for Claude Code: claude mcp add nuni -- npx -y @nuniapp/cli@latest mcp). Do not run login yourself unless asked.

Docs: https://nuni.praveenjuge.com/quickstart