Raycast Extension

The Raycast extension lets you search and browse your Next.js App Router routes directly from Raycast.

Start the API server

The Raycast extension requires a local API server to fetch route data. Start it with:

npx next-lens raycast [target-directory]

This launches a headless API server and automatically opens the Raycast extension.

Options

• -p, --port <port> — server port (default 9453).

How it works

1. Run next-lens raycast in your Next.js project.
2. The CLI starts an API server exposing route data.
3. Raycast extension connects to http://localhost:9453/api.
4. Search and browse routes directly from Raycast.

The server runs until you press Ctrl+C.