What is Llms Txt Generator

The llms-txt-generator is an AI-powered tool designed to automatically create structured documentation files, specifically llms.txt and llms-full.txt, that aid language models in understanding codebases with clarity and depth. It leverages AI capabilities to produce documentation that meets the unique needs of AI models.

Use cases

This tool is ideal for developers and teams looking to streamline the documentation process, enhance project navigability, and facilitate better understanding for AI models. It is beneficial in environments where projects evolve rapidly, requiring consistent and comprehensive documentation that can be autonomously generated and maintained.

How to use

Users can start by initializing the configuration with the command ‘npx llms-txt-generator init’, followed by generating the documentation with ‘npx llms-txt-generator build’. The tool supports auto mode to simplify the process, executing necessary commands based on the presence of configuration files. Custom configurations can also be setup as needed.

Key features

Key features include the generation of concise llms.txt for project navigation, comprehensive llms-full.txt for detailed understanding, MCP server integration for AI assistant workflows, a simple CLI interface for easy setup, and flexible configuration options for output paths and formats.

Where to use

The llms-txt-generator can be utilized in diverse software development projects, especially those involving AI and machine learning where precise and well-structured documentation is critical. It is particularly advantageous for teams using TypeScript or other modern programming languages, allowing integration into existing development workflows.

llms-txt-generator

The ultimate AI-powered generator for llms.txt and llms-full.txt files. Leveraging advanced AI capabilities to create the most comprehensive and AI-optimized documentation that helps language models understand your project with unprecedented clarity and depth.

Why AI-Generated Documentation?

AI understands AI best. Traditional documentation is written for humans, but AI models need structured, comprehensive information to truly understand your codebase. This tool leverages AI to generate documentation that:

• 🧠 Speaks AI’s language - Uses patterns and structures that AI models process most effectively
• 🎯 Focuses on what matters - Highlights the information AI needs for accurate code understanding
• 📊 Maintains consistency - Ensures uniform documentation format across all projects
• ⚡ Saves time - Automatically generates comprehensive documentation without manual effort

Key Features

• 📄 Generate llms.txt files for quick project navigation
• 📚 Generate llms-full.txt files for comprehensive project understanding
• 🤖 MCP server integration for seamless AI assistant workflows
• 🚀 Simple CLI interface with interactive setup
• 🔧 Flexible configuration supporting custom output paths and formats

Quick Start

CLI Usage

# Initialize configuration file (creates llms-txt-generator.yaml)
npx llms-txt-generator init

# Build documentation files (requires configuration)
npx llms-txt-generator build

# Show help information
npx llms-txt-generator help

# Auto mode: checks for config file and runs accordingly
# - If llms-txt-generator.yaml exists: runs build
# - If no config file: runs init then build
npx llms-txt-generator

# Or if installed globally
llms-txt-generator init
llms-txt-generator build
llms-txt-generator        # auto mode

Command Details

• init: Interactive setup wizard to create llms-txt-generator.yaml configuration
• build: Generate documentation files based on existing configuration
• help: Display usage information and available commands
• No arguments: Smart mode that initializes if needed, then builds documentation

Generated Files

llms.txt Structure

The generated llms.txt file provides a concise navigation view of your project:

# Project Name

> Project introduction, briefly describing the purpose and functionality of the project.

## Core Documentation
- [Document Title](https://raw.githubusercontent.com/grasplabs/llms-txt-generator/master/URL): Brief description
- [Document Title](https://raw.githubusercontent.com/grasplabs/llms-txt-generator/master/URL): Brief description

## Optional Content
- [Resource Name](https://raw.githubusercontent.com/grasplabs/llms-txt-generator/master/URL): Brief description

llms-full.txt Content

The llms-full.txt file contains comprehensive documentation including:

• Detailed project overview
• Core features explanation
• Installation and usage instructions
• Complete project structure description
• Code examples and explanations
• Development requirements and commands

This file is designed to give AI models a thorough understanding of your project.

MCP Integration

The llms-txt-generator includes a Model Context Protocol (MCP) server that allows AI assistants to generate documentation files directly.

Using with Cursor

Configure llms-txt-generator as an MCP tool in Cursor:

1. Add MCP Configuration: Add the following to your Cursor settings (cursor-settings.json):

{
  "mcpServers": {
    "llms-generator": {
      "command": "npx",
      "args": [
        "-y",
        "llms-txt-generator-mcp"
      ]
    }
  }
}

2. Restart Cursor to load the new MCP configuration.

3. Use the Tool by asking your AI assistant:

Use the llms-generator MCP tool to create llms.txt and llms-full.txt for this project

Using with Claude Desktop

For Claude Desktop, add to your claude_desktop_config.json:

{
  "mcpServers": {
    "llms-generator": {
      "command": "npx",
      "args": [
        "-y",
        "llms-txt-generator-mcp"
      ]
    }
  }
}

Available MCP Tools

The MCP server provides this tool:

• generate-llms: Generate llms.txt and llms-full.txt files for the current project based on user requirements

Example Prompts

# Basic generation
Generate llms.txt and llms-full.txt files for this project

# With specific requirements
Generate documentation files with these requirements:
1. Output to ./docs directory
2. Include comprehensive project details
3. Focus on TypeScript implementation

# Custom configuration
Create llms files with custom names: project-nav.txt and project-full.txt

Development

Requirements

• Node.js v18+
• pnpm (package manager)
• TypeScript knowledge

Getting Started

1. Clone and Install:

git clone <repository-url>
cd llms-txt-generator
pnpm install

2. Build the Project:

pnpm build

3. Run Tests:

pnpm test

Contributing

We welcome contributions! Please follow these guidelines:

Development Workflow

1. Fork the repository
2. Create a feature branch: git checkout -b feature/amazing-feature
3. Follow the project rules in .trae/project_rules.md
4. Write tests for new functionality
5. Ensure all tests pass: pnpm test
6. Lint your code: pnpm lint
7. Format your code: pnpm format
8. Commit with conventional commits: feat: add amazing feature
9. Push to your branch: git push origin feature/amazing-feature
10. Create a Pull Request

Code Standards

• ✅ TypeScript: All code must be written in TypeScript
• ✅ Tests: New features require test coverage
• ✅ Documentation: Update README and JSDoc comments
• ✅ Linting: Code must pass ESLint checks
• ✅ Formatting: Use Prettier for consistent formatting
• ✅ Commits: Follow Conventional Commits specification

Troubleshooting

Common Issues

Q: “Module not found” error when using CLI

# Solution: Install globally or use npx
npm install -g llms-txt-generator
# Or use npx
npx llms-txt-generator init

Q: “Permission denied” when running CLI

# Solution: Make sure the binary is executable
chmod +x node_modules/.bin/llms-txt-generator
# Or reinstall the package
pnpm install llms-txt-generator

Q: “Configuration file not found”

# Solution: Run init command to create configuration
npx llms-txt-generator init
# Or copy from example
cp llms-txt-generator.example.yaml llms-txt-generator.yaml

Q: “TypeScript compilation errors”

# Solution: Check Node.js version and dependencies
node --version  # Should be >= 18
pnpm install    # Reinstall dependencies

Q: “MCP server connection issues”

# Solution: Check MCP server configuration
# Make sure the server path is correct in your MCP client
# Use full path: /path/to/node_modules/.bin/llms-txt-generator-mcp

Changelog

See CHANGELOG.md for detailed version history.

License

MIT License - see LICENSE file for details.

Made with ❤️ for the AI development community