Lovely Docs

Hierarchically optimized documentation for AI coding agents

Why Lovely Docs?

AI coding tools work best when given access to up-to-date documentation.

Lovely Docs places the documentation inside a folder ( lovely-docs/ by default) in your project. The documentation is available in both condensed and fulltext forms - noise is removed from pages, and content summaries are created for each directory.

Your coding agent should have an easy time searching and reading the documentation using its built-in tools, and you can also directly point it to any particular file using @lovely-docs/... or equivalent mechanism.

You can also use Lovely Docs MCP Server , but a local folder works better for AI coding agents.

Want me to add more libraries or have feedback? Reach out on Discord or .

Tokens ain't cheap, buy me a coffee .

Quick Start

Note: The Lovely Docs CLI is written in TypeScript, but your project can be written in any language

Initialize

npx -y lovely-docs@latest init

List Libraries

npx -y lovely-docs@latest list

Add Library

npx -y lovely-docs@latest add sveltejs/svelte

Directory structure

You can experiment with the installed. So far I found that "Diegst only" without directory summaries and llm map works best in Windsurf and Antigravity, but give it a try and let me know how it goes.

Don't add lovely-docs to .gitignore.

Even if you alow agent access to ignored files, it's likely to be reluctant to use them, depending on the agent of couese. The IDE might also get in the way by not allowing to @ the ignored files.

◇

Installation directory:

◇

Installation mode

◇

Install directory summaries?

◇

Generate LLM_MAP.md?

lovely-docs/

sveltejs_svelte/

introduction/

getting-started.md # Page digest

svelte-files.md # Page digest

runes/

$derived.md # Page digest

$effect.md # Page digest

$state.md # Page digest

what-are-runes.md # Page digest

Example rules

You can add the following rule to your .cursorrules or similar configuration to help your AI agent use the documentation effectively:

We have dehydrated documentation in lovely-docs/. When you start a new session, check what's available. Refer to the docs first time you use a feature of a documented library.

Or a more agressive

We have curated, dehydrated documentation in lovely-docs/ WORKFLOW: 1. At the START of EVERY session, run: list_dir on lovely-docs/ 2. If documentation exists for a library you're about to use, read the relevant sections before using a feature for the first time.

MCP Server

You can run a Lovely Docs MCP server locally. Or you can access the one I'm running publicly.

Read the docs the way your agent sees them over MCP

{
  "mcpServers": {
    "lovely-docs": {
      "command": "npx",
      "args": [
        "-y",
        "lovely-docs@latest",
        "mcp"
      ]
    }
  }
}

{
  "mcpServers": {
    "lovely-docs": {
      "command": "npx",
      "args": [
        "-y",
        "lovely-docs@latest",
        "mcp"
      ]
    }
  }
}

{
  "mcpServers": {
    "lovely-docs": {
      "command": "npx",
      "args": [
        "-y",
        "lovely-docs@latest",
        "mcp"
      ]
    }
  }
}

{
  "mcpServers": {
    "lovely-docs": {
      "command": "npx",
      "args": [
        "-y",
        "lovely-docs@latest",
        "mcp"
      ]
    }
  }
}

{
  "mcpServers": {
    "lovely-docs": {
      "command": "npx",
      "args": [
        "-y",
        "lovely-docs@latest",
        "mcp"
      ]
    }
  }
}

File → Preferences → Cursor Settings → Features → MCP Servers → "Add New MCP Server" → Paste configuration

{
  "mcpServers": {
    "lovely-docs": {
      "command": "npx",
      "args": [
        "-y",
        "lovely-docs@latest",
        "mcp"
      ]
    }
  }
}

{
  "mcpServers": {
    "lovely-docs": {
      "command": "npx",
      "args": [
        "-y",
        "lovely-docs@latest",
        "mcp"
      ]
    }
  }
}

{
  "mcpServers": {
    "lovely-docs": {
      "command": "npx",
      "args": [
        "-y",
        "lovely-docs@latest",
        "mcp"
      ]
    }
  }
}

{
  "mcpServers": {
    "lovely-docs": {
      "command": "npx",
      "args": [
        "-y",
        "lovely-docs@latest",
        "mcp"
      ]
    }
  }
}

{
  "mcpServers": {
    "lovely-docs": {
      "command": "npx",
      "args": [
        "-y",
        "lovely-docs@latest",
        "mcp"
      ]
    }
  }
}

Settings → Developer → "Edit Config" → Add to claude_desktop_config.json

claude mcp add --transport stdio --scope user lovely-docs -- npx -y lovely-docs@latest mcp

claude mcp add --transport stdio --scope user lovely-docs -- npx -y lovely-docs@latest mcp

claude mcp add --transport stdio --scope user lovely-docs -- npx -y lovely-docs@latest mcp

claude mcp add --transport stdio --scope user lovely-docs -- npx -y lovely-docs@latest mcp

claude mcp add --transport stdio --scope user lovely-docs -- npx -y lovely-docs@latest mcp

Run the command in your terminal.

gemini mcp add --transport stdio --scope user lovely-docs npx -y lovely-docs@latest mcp

gemini mcp add --transport stdio --scope user lovely-docs npx -y lovely-docs@latest mcp

gemini mcp add --transport stdio --scope user lovely-docs npx -y lovely-docs@latest mcp

gemini mcp add --transport stdio --scope user lovely-docs npx -y lovely-docs@latest mcp

gemini mcp add --transport stdio --scope user lovely-docs npx -y lovely-docs@latest mcp

Run the command in your terminal.

[mcp_servers.lovely-docs]
command = "npx"
args = [
  "-y",
  "lovely-docs@latest",
  "mcp"
]

[mcp_servers.lovely-docs]
command = "npx"
args = [
  "-y",
  "lovely-docs@latest",
  "mcp"
]

[mcp_servers.lovely-docs]
command = "npx"
args = [
  "-y",
  "lovely-docs@latest",
  "mcp"
]

[mcp_servers.lovely-docs]
command = "npx"
args = [
  "-y",
  "lovely-docs@latest",
  "mcp"
]

[mcp_servers.lovely-docs]
command = "npx"
args = [
  "-y",
  "lovely-docs@latest",
  "mcp"
]

Add to ~/.codex/config.toml

{
  "mcp": {
    "lovely-docs": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "lovely-docs@latest",
        "mcp"
      ]
    }
  }
}

{
  "mcp": {
    "lovely-docs": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "lovely-docs@latest",
        "mcp"
      ]
    }
  }
}

{
  "mcp": {
    "lovely-docs": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "lovely-docs@latest",
        "mcp"
      ]
    }
  }
}

{
  "mcp": {
    "lovely-docs": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "lovely-docs@latest",
        "mcp"
      ]
    }
  }
}

{
  "mcp": {
    "lovely-docs": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "lovely-docs@latest",
        "mcp"
      ]
    }
  }
}

Add to opencode.jsonc configuration file

{
  "context_servers": {
    "lovely-docs": {
      "command": "npx",
      "args": [
        "-y",
        "lovely-docs@latest",
        "mcp"
      ]
    }
  }
}

{
  "context_servers": {
    "lovely-docs": {
      "command": "npx",
      "args": [
        "-y",
        "lovely-docs@latest",
        "mcp"
      ]
    }
  }
}

{
  "context_servers": {
    "lovely-docs": {
      "command": "npx",
      "args": [
        "-y",
        "lovely-docs@latest",
        "mcp"
      ]
    }
  }
}

{
  "context_servers": {
    "lovely-docs": {
      "command": "npx",
      "args": [
        "-y",
        "lovely-docs@latest",
        "mcp"
      ]
    }
  }
}

{
  "context_servers": {
    "lovely-docs": {
      "command": "npx",
      "args": [
        "-y",
        "lovely-docs@latest",
        "mcp"
      ]
    }
  }
}

Ctrl+Alt+, (or "zed: open settings") → Add to settings.json (~/.config/zed/settings.json)

{
  "mcpServers": {
    "lovely-docs": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "lovely-docs@latest",
        "mcp"
      ],
      "tools": [
        "*"
      ]
    }
  }
}

{
  "mcpServers": {
    "lovely-docs": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "lovely-docs@latest",
        "mcp"
      ],
      "tools": [
        "*"
      ]
    }
  }
}

{
  "mcpServers": {
    "lovely-docs": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "lovely-docs@latest",
        "mcp"
      ],
      "tools": [
        "*"
      ]
    }
  }
}

{
  "mcpServers": {
    "lovely-docs": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "lovely-docs@latest",
        "mcp"
      ],
      "tools": [
        "*"
      ]
    }
  }
}

{
  "mcpServers": {
    "lovely-docs": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "lovely-docs@latest",
        "mcp"
      ],
      "tools": [
        "*"
      ]
    }
  }
}

Repository Settings → Copilot → Coding agent → Edit MCP configuration

Command: npx
Args: -y lovely-docs@latest mcp

Command: npx
Args: -y lovely-docs@latest mcp

Command: npx
Args: -y lovely-docs@latest mcp

Command: npx
Args: -y lovely-docs@latest mcp

Command: npx
Args: -y lovely-docs@latest mcp

Refer to your client's documentation for adding MCP servers.