Basic Memory
Reference

AI-Friendly Documentation

Access documentation as clean markdown for AI agents using llms.txt and content negotiation.

This documentation is optimized for AI agents. Get clean markdown through multiple methods - no HTML parsing required.

Want your AI to read the docs? Just ask it to fetch the documentation:
Fetch https://docs.basicmemory.com/llms.txt and read the Basic Memory documentation
Your AI will use its fetch tool to retrieve clean markdown directly - no browser or HTML parsing needed.

Quick reference

MethodURLDescription
Index/llms.txtList of all pages with links
Full docs/llms-full.txtComplete documentation in one file
Raw markdown/raw/<path>.mdAny page as markdown
Content negotiationAny page + Accept: text/markdownReturns markdown directly

Content negotiation

The simplest method for AI agents. Add the Accept: text/markdown header to any documentation URL:

curl -H "Accept: text/markdown" https://docs.basicmemory.com/start-here/what-is-basic-memory

Returns clean markdown directly - no redirects, no HTML parsing.

Example response:

# What is Basic Memory

Basic Memory is a knowledge base that you and your AI assistant share...

llms.txt index

The /llms.txt endpoint provides an index of all documentation pages with direct links to raw markdown:

curl https://docs.basicmemory.com/llms.txt

Example response:

# Basic Memory Documentation

> Documentation for Basic Memory - a knowledge management system...

## Documentation Sets

- [Basic Memory Complete Documentation](https://docs.basicmemory.com/llms-full.txt)

## Docs

- [What is Basic Memory](https://docs.basicmemory.com/raw/start-here/what-is-basic-memory.md)
- [Quickstart: Cloud](https://docs.basicmemory.com/raw/start-here/quickstart-cloud.md)
...

Use this as a starting point to discover available documentation.


Full documentation

Get the entire documentation in a single request:

curl https://docs.basicmemory.com/llms-full.txt

This concatenates all pages into one markdown file - useful for loading complete context.


Raw markdown paths

Access any page directly as markdown using the /raw/ prefix:

# Pattern
https://docs.basicmemory.com/raw/<path>.md

# Examples
https://docs.basicmemory.com/raw/start-here/what-is-basic-memory.md
https://docs.basicmemory.com/raw/reference/mcp-tools-reference.md
https://docs.basicmemory.com/raw/concepts/knowledge-format.md

Usage patterns

Progressive discovery

Start with the index, then fetch specific pages:

# 1. Get the index
curl https://docs.basicmemory.com/llms.txt

# 2. Fetch specific pages based on need
curl https://docs.basicmemory.com/raw/start-here/quickstart-cloud.md

Full context loading

Load everything at once for comprehensive context:

curl https://docs.basicmemory.com/llms-full.txt

Content negotiation in code

import httpx

# Just add the Accept header
response = httpx.get(
    "https://docs.basicmemory.com/start-here/what-is-basic-memory",
    headers={"Accept": "text/markdown"}
)
markdown = response.text
// Same pattern in TypeScript
const response = await fetch(
  "https://docs.basicmemory.com/start-here/what-is-basic-memory",
  { headers: { Accept: "text/markdown" } }
);
const markdown = await response.text();

Why AI-friendly docs?

  • No parsing required - Clean markdown, not HTML
  • Structured discovery - llms.txt provides an index
  • Standard patterns - Uses llms.txt specification
  • Content negotiation - Same URLs work for humans and AI