Skip to content

Conversation

@gaojude
Copy link
Contributor

@gaojude gaojude commented Jan 8, 2026

  • Fix the contradictory instruction ('search is recommended' vs 'skip search') in the init tool
  • Forces consistent behaviour -- get index from init, and then read the docs from the path of that index; no search, force understanding of the model

Before

❯ init next devtools 

● I'll initialize the Next.js DevTools MCP for this project.

● next-devtools - init (MCP)(project_path:
                            "/home/judegao/projects/furry-together")
  ⎿  {                                                                     
       "success": true,
       "description": "Next.js DevTools MCP Initialization",
     … +114 lines (ctrl+o to expand)

● Initialization complete.

❯ what is refresh() api in next.js? 

● I'll look up the refresh() API in the Next.js documentation for you.

● next-devtools - nextjs_docs (MCP)(action: "search", query: "refresh() API")
  ⎿ {                                                                      
      "error": "SEARCH_NOT_NEEDED",
      "message": "You already have the complete Next.js docs index from the
    i
    … +4 lines (ctrl+o to expand)

● readMcpResource(Read resource "nextjs-docs://llms-index" from server
                 "next-devtools")
  ⎿  {                              
       "contents": [
         {
     … +863 lines (ctrl+o to expand)

● Let me get the full documentation for the refresh() API.

● next-devtools - nextjs_docs (MCP)(action: "get", path:
                                   "/docs/app/api-reference/functions/refresh")
  ⎿  {                                                                     
       "path": "/docs/app/api-reference/functions/refresh",
       "anchor": null,
     … +22 lines (ctrl+o to expand)

● refresh() API in Next.js

  The refresh() function allows you to refresh the client router from within a Server Action.

  Key Points:

After

❯ init next devtools

● I'll initialize the Next.js DevTools MCP for you.

● next-devtools - init (MCP)(project_path: "/home/judegao/next-devtools-mcp")
  ⎿  {
       "success": true,
       "description": "Next.js DevTools MCP Initialization",
     … +41 lines (ctrl+o to expand)

● Initialization complete.

❯ whats refresh api?

● I'll look up the refresh API in the Next.js documentation for you.

● readMcpResource(Read resource "nextjs-docs://llms-index" from server "next-devtools")
  ⎿  {
       "contents": [
         {
     … +523 lines (ctrl+o to expand)

● next-devtools - nextjs_docs (MCP)(path: "/docs/app/api-reference/functions/refresh")
  ⎿  {
       "path": "/docs/app/api-reference/functions/refresh",
       "anchor": null,
     … +14 lines (ctrl+o to expand)

● The refresh API in Next.js allows you to refresh the client router from within a Server Action.

  Key Points:

@gaojude gaojude changed the title Simplify nextjs_docs: remove search, require index lookup Perf: Optimize doc lookup Jan 8, 2026
@gaojude gaojude requested a review from huozhi January 8, 2026 06:02
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

unexpected change?

@gaojude gaojude force-pushed the jude/simplify-docs-search branch 2 times, most recently from fd23b53 to 3f165fd Compare January 8, 2026 14:35
@gaojude gaojude requested a review from huozhi January 8, 2026 14:35
@gaojude gaojude force-pushed the jude/simplify-docs-search branch from 3f165fd to b596526 Compare January 8, 2026 14:40
@gaojude gaojude force-pushed the jude/simplify-docs-search branch from b596526 to 5d25a09 Compare January 8, 2026 14:48
@gaojude gaojude merged commit 7330deb into main Jan 8, 2026
3 checks passed
@gaojude gaojude deleted the jude/simplify-docs-search branch January 8, 2026 20:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants