Skip to content

LLMs.txt File Details ​

This page provides detailed information about the documentation files (llms.txt and llms-full.txt) for LLMs to reference.

About llms.txt ​

Purpose ​

llms.txt is a summary version document for LLMs to understand Kirox CLI. It includes a project overview and links to major documentation.

Content ​

  1. Project Overview

    • What is Kirox
    • Key features
    • Usage overview
  2. Links to Major Documentation

    • Guides
    • CLI Reference
    • API Specifications
    • Configuration

Usage Example ​

When an LLM is asked about Kirox CLI, it can quickly understand the overview by first referencing llms.txt.

About llms-full.txt ​

Purpose ​

llms-full.txt is a complete document for LLMs to understand detailed technical information about Kirox CLI.

Content ​

  1. All Guide Documents

    • Getting Started
    • Basic Usage
    • Advanced Usage
    • Troubleshooting
  2. Complete CLI Reference

    • kirox command
    • add subcommand
    • completion subcommand
  3. API Specifications

    • GitHub Fetcher
    • FileSystem Writer
  4. Configuration Reference

    • .kiroxrc.json
    • Configuration options
    • Configuration examples
  5. Performance Analysis

    • Performance metrics
    • Benchmark results
    • Optimization methods

Usage Example ​

When an LLM needs to provide accurate answers to specific technical questions, it references llms-full.txt.

Generation Process ​

These files are automatically generated by the vitepress-plugin-llms plugin.

Generation Timing ​

  1. Generated during VitePress build process
  2. Generated when development server starts
  3. Distributed as build artifacts

Generation Location ​

Generated files are placed in the following location:

docs/.vitepress/dist/
├── llms.txt
└── llms-full.txt

Browser Access ​

You can access these files in the built site at the following URLs:

Download ​

Generated files are accessible at the following URLs:

LLM Integration ​

LangChain Example ​

python
from langchain.document_loaders import TextLoader

# Load llms.txt
loader = TextLoader('https://yukihirop.github.io/kirox/llms.txt')
docs = loader.load()

# Create vector store
vectorstore = FAISS.from_documents(docs, embeddings)

# Answer questions
response = chain.run("How do I use Kirox CLI?")

OpenAI API Example ​

python
import requests

# Fetch llms.txt
response = requests.get('https://yukihirop.github.io/kirox/llms.txt')
llms_content = response.text

# Send to OpenAI API
response = openai.ChatCompletion.create(
    model="gpt-4",
    messages=[
        {"role": "system", "content": llms_content},
        {"role": "user", "content": "How do I use Kirox CLI?"}
    ]
)

File Format ​

llms.txt Format ​

# Kirox

> Recycle .kiro CLI

CLI tool to fetch Kiro specification and steering files from remote GitHub repositories

## Table of Contents

### Guide

- [Guide](/kirox/guide.md): User guide for Kirox CLI
- [Getting Started](/kirox/guide/getting-started.md): ...
...

llms-full.txt Format ​

---
url: /kirox/config/kiroxrc.md
description: Kirox CLI configuration file reference
---

# .kiroxrc.json

Reference for the Kirox CLI configuration file.
...

Best Practices ​

Writing Optimized for LLMs ​

  1. Clear headings: Use clear titles for each section
  2. Concrete examples: Include code examples and usage scenarios
  3. Concise descriptions: Avoid long sentences, use bullet points
  4. Structured information: Use tables and lists to organize information

File Size Management ​

  • llms.txt: Approximately 40 lines (summary version)
  • llms-full.txt: Approximately 3,000+ lines (complete version)

Troubleshooting ​

File Not Found ​

  1. Check if the build completed successfully
  2. Check the .vitepress/dist/ directory
  3. Verify plugin configuration is correct

Outdated Content ​

  1. Update the source documentation files
  2. Rebuild VitePress
  3. Clear cache

Released under the MIT License.