nuxtnuxt/devtools/AGENTS.md

devtools

AGENTS.md3.3k starsChanged 45 days agoMITView on GitHub

Guidance for contributors and AI agents working in this repo. - packages/devtools — the main Nuxt module. Its client/ directory is a separate Nuxt app that renders the DevTools UI; src/server-rpc/** is the server surface that runs on the Node dev server and is called from that browser client. - packages/devtools-kit — the module-author API, built with unbuild. - packages/devtools-ui-kit — a Nuxt UI component module used by the client. (pnpm test:e2e runs both the dev and built e2e suites;…

Jan 13, 2025feat(nuxt): support tracking changes to nuxt options by modules — nuxt/nuxt26 reactions · 9 comments
Apr 10, 2023v3.4.0 — nuxt/nuxt21 reactions · 1 comment
Feb 6, 2025feat: upgrade `@nuxt/devtools` to v2 — nuxt/nuxt18 reactions · 6 comments
Sep 27, 2024feat(nuxt,schema): add directives folder — nuxt/nuxt6 reactions · 5 comments
Jul 19, 2026Replace `semver` with `verkit` — e18e/ecosystem-issues5 reactions · 7 comments

32 more on GitHub

Aug 14, 2023Issue with npx nuxt generate Command When Using ssr: false Configuration in nuxt.config.js — nuxt-content/docus4 reactions · 2 comments
Oct 13, 2026perf(nuxt): use `@nuxt/devtools-onboard` as a minimal devtools shim — nuxt/nuxt3 reactions · 6 comments
Jan 5, 2026chore(deps): bump the npm_and_yarn group across 8 directories with 19 updates — Cokedoutlawyer/supabase2 reactions · 1 comment
Dec 12, 2025Bump the npm_and_yarn group across 18 directories with 7 updates — q1blue/ai2 reactions · 3 comments
Nov 19, 2025Auth System — vitejs/devtools2 reactions
Feb 6, 2024Integration with Nuxt Devtools for Performance insights — nuxt-modules/web-vitals2 reactions
Aug 5, 2023feat: minimize panel on inactive — webfansplz/vite-plugin-vue-devtools2 reactions
Oct 8, 2026fix: isolate DevTools styles and support v4 docks — nuxt-modules/better-auth1 reaction · 7 comments
Aug 7, 2026chore(deps-dev): bump @nuxt/devtools from 3.2.4 to 3.4.2 — zitadel/nuxt-auth1 reaction · 2 comments
Aug 7, 2026chore(deps): bump @nuxt/devtools from 3.2.4 to 3.4.1 — euler-xyz/euler-lite1 reaction · 1 comment
Apr 21, 2026Bump the npm_and_yarn group across 2 directories with 19 updates — cicero-im/lenis1 reaction · 2 comments
Apr 14, 2026chore: add pnpm catalog support — comarkdown/comark1 reaction · 4 comments
Mar 23, 2026Add Open Graph inspector to Vite DevTools — vitejs/devtools1 reaction · 6 comments
Mar 14, 2026chore(deps): bump the npm-minor-patch group with 133 updates — laoshuikaixue/VoiceHub1 reaction · 2 comments
Mar 9, 2026Bump the all-dependencies group with 2 updates — synmux/syn-horse1 reaction
Feb 25, 2026Bump the all-dependencies group across 1 directory with 3 updates — synmux/syn-horse1 reaction
Jan 15, 2026Bump diff and @nuxt/devtools — starred-com/starred-case1 reaction
Jan 14, 2026Bump diff, nuxt and @nuxt/devtools — digitalservicebund/wie-viele-menschen1 reaction · 1 comment
Jan 1, 2026build(deps): Bump the npm_and_yarn group across 1 directory with 13 updates — sahillangoo/nuxt_cms1 reaction
Dec 8, 2025feat: add `nuxt/no-nuxt-config-test-key` — nuxt/eslint1 reaction
Nov 7, 2025Bump @nuxt/devtools from 2.5.0 to 2.7.0 — YUSU-Dev/roses-live1 reaction · 1 comment
Nov 7, 2025build(deps-dev): bump @nuxt/devtools from 1.6.3 to 2.6.4 in /examples/nuxt-openai — Credal-ai/ai1 reaction · 1 comment
Mar 19, 2025fix: devtools not showing up for nuxt 3.16 — vuejs/pinia1 reaction · 6 comments
Sep 23, 2024fix: top level await (chrome 129) — elk-zone/elk1 reaction · 3 comments
Jul 31, 2023feat: video assets preview — webfansplz/vite-plugin-vue-devtools1 reaction
Jul 21, 2023feat(assets): tree view for list mode — webfansplz/vite-plugin-vue-devtools1 reaction
Jun 22, 2023fix(deps): update dependency nuxt to v3 [security] - autoclosed — ecamp/ecamp31 reaction
May 24, 2023feat(client): add WebSocket connections events — vitejs/vite1 reaction · 2 comments
Nov 9, 2026chore(pnpm): bump @nuxt/devtools from 3.4.4 to 4.1.0 — nicokempe/nuxt-feature-flags-module0 reactions
Nov 8, 2026build(deps): bump simple-git and @nuxt/devtools — cyrus07424/fzeroMaximumVelocityVermilionCodeGenerator0 reactions · 1 comment
Nov 5, 2026chore(deps-dev): bump @nuxt/devtools from 3.4.4 to 4.1.0 — renalreg/ukrdc-nuxt-30 reactions · 3 comments
Nov 5, 2026chore(deps): bump @nuxt/vite-builder and @nuxt/devtools — orderofmagnitude1/tillyworkkanban0 reactions

On Hacker News · 1

Feb 9, 2023Nuxt DevTools Preview Announced1 point

On Bluesky · 1

Jan 11, 2026https://github.com/nuxt/devtools — @tom-doerr.bsky.social1 likes and repost

On Stack Overflow · 1

Jun 10, 2025Enable Nuxt Devtools on production build1 vote

The file

Create a free account to mount

Files

AGENTS.md

Guidance for contributors and AI agents working in this repo.

High-Level Instructions

Right now we are working on Nuxt DevTools v4, which is built on top of Vite DevTools Kit and Devframe
Nuxt DevTools v4 will be default in Nuxt 5, while we it should still work with Nuxt 4.
There are quite some Nuxt Module built on top of Nuxt DevTools v3's legacy API, we should make sure those modules are still working with Nuxt DevTools v4 (backward compatibility) and provide a migration guide for module authors to migrate to the new vite-devtools-based API.
Nuxt 5 introduce Nitro v3 (nitro@3) while Nuxt 4 is still using Nitro v2 (nitropack@2). We should make sure that Nuxt DevTools v4 works with both Nitro v2 and v3, without introduce hard dependency on either of them.

Packages

packages/devtools — the main Nuxt module. Its client/ directory is a separate Nuxt app that renders the DevTools UI; src/server-rpc/** is the server surface that runs on the Node dev server and is called from that browser client.
packages/devtools-kit — the module-author API, built with unbuild.
packages/devtools-ui-kit — a Nuxt UI component module used by the client.

Everyday commands

Command	Purpose
`pnpm lint`	ESLint over the whole repo
`pnpm typecheck`	`vue-tsc --noEmit` (requires prepare/build first)
`pnpm knip`	Find unused files/deps/exports (requires prepare/build first)
`pnpm test`	Runs `pnpm lint && pnpm test:unit`
`pnpm test:unit`	Unit tests via `vitest run`
`pnpm test:e2e:dev`	Playwright e2e against the dev server
`pnpm test:e2e:built`	Playwright e2e against a built app

(pnpm test:e2e runs both the dev and built e2e suites; config lives at tests/e2e/playwright.config.ts.)

Dependency model

Dependency versions are pinned centrally via pnpm catalogs in pnpm-workspace.yaml (e.g. catalog:cli, catalog:prod, catalog:frontend, catalog:buildtools). When adding a dependency, reference it as catalog:<name> in the package's package.json rather than pinning a raw version — add the version to the appropriate catalog in pnpm-workspace.yaml if it isn't there yet.

Package manager

This repo uses pnpm 11 (see packageManager in the root package.json). Use pnpm, not npm or yarn.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

It worked
Partly
It didn't

What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free