# Source: https://nuxt.com/raw/docs/3.x/guide/ai/llms-txt.md

# Source: https://nuxt.com/raw/docs/4.x/guide/ai/llms-txt.md

# Nuxt LLMs.txt

> How to get AI tools like Cursor, Windsurf, GitHub Copilot, ChatGPT, and Claude to understand Nuxt concepts, APIs, and best practices.

## What is LLMs.txt?

LLMs.txt is a structured documentation format specifically designed for large language models (LLMs). Nuxt provides LLMs.txt files that contain comprehensive information about the framework, making it easy for AI tools to understand and assist with Nuxt development.

These files are optimized for AI consumption and contain structured information about concepts, APIs, usage patterns, and best practices.

## Available routes

We provide LLMs.txt routes to help AI tools access our documentation:

- **/llms.txt** - Contains a structured overview of all documentation pages and their links (~5K tokens)
- **/llms-full.txt** - Provides comprehensive documentation including getting started guides, API references, blog posts, and deployment guides (~1M+ tokens)

## Choosing the Right File

<note icon="i-lucide-info">

**Most users should start with /llms.txt** - it contains all essential information and works with standard LLM context windows.

Use `/llms-full.txt` only if you need comprehensive implementation details and your AI tool supports large contexts (200K+ tokens).

</note>

## Important usage notes

<warning icon="i-lucide-alert-triangle">

**@-symbol must be typed manually** - When using tools like Cursor or Windsurf, the `@` symbol must be typed by hand in the chat interface. Copy-pasting breaks the tool's ability to recognize it as a context reference.

</warning>

## Usage with AI Tools

### Cursor

Nuxt provides specialized LLMs.txt files that you can reference in Cursor for better AI assistance with Nuxt development.

#### How to use

1. **Direct reference**: Mention the LLMs.txt URLs when asking questions
2. Add these specific URLs to your project context using `@docs`

[Read more about Cursor Web and Docs Search](https://cursor.com/docs/context/symbols)

### Windsurf

Windsurf can directly access the Nuxt LLMs.txt files to understand framework usage and best practices.

#### Using LLMs.txt with Windsurf

- Use `@docs` to reference specific LLMs.txt URLs
- Create persistent rules referencing these URLs in your workspace

[Read more about Windsurf Web and Docs Search](https://docs.windsurf.com/windsurf/cascade/web-search)

### Other AI Tools

Any AI tool that supports LLMs.txt can use these routes to better understand Nuxt.

#### Examples for ChatGPT, Claude, or other LLMs

- "Using Nuxt documentation from [https://nuxt.com/llms.txt](https://nuxt.com/llms.txt)"
- "Follow complete Nuxt guidelines from [https://nuxt.com/llms-full.txt](https://nuxt.com/llms-full.txt)"