Question 1

What is Thally?

Accepted Answer

Thally is an AI-native documentation platform for machines and humans. You write MDX once, and every page ships as JSON, JSON-LD, and Markdown for AI agents and as polished HTML for readers, all from the same URL. It also automates the upkeep: a docs agent turns product changes into reviewed pull requests.

Question 2

How is Thally different from other docs tools?

Accepted Answer

Conventional docs tools render pages for people and stop there. Thally treats machines as first-class readers of the same source, ships a remote MCP server with every deploy, grades every build with an agent-readiness score, and keeps docs current automatically with agent-drafted PRs from your product repos.

Question 3

How do I migrate from Mintlify, Docusaurus, or GitBook?

Accepted Answer

One command: npx create-thally migrate <your-repo-url>. The migrator detects the platform (Mintlify, Docusaurus, GitBook, Nextra, VitePress, Starlight, or plain Markdown), converts every page to clean MDX, rebuilds navigation, carries your redirects, and wires OpenAPI specs into the API reference automatically.

Question 4

What is Thally Track?

Accepted Answer

Track watches the product repos you register. When a PR merges there, it distills what changed and the docs agent drafts a documentation PR for your review. Label a PR docs-preview and the docs are drafted before the feature even merges, so reviewers see docs alongside code.

Question 5

Can Thally write docs for me?

Accepted Answer

Yes, as reviewed pull requests. Give the agent an instruction, a diff, or a product PR, or just comment @thally on any GitHub issue or pull request. It drafts the smallest correct change in your house style and self-validates before opening the PR. It never merges; a human always does.

Question 6

Is there a free plan?

Accepted Answer

Thally is MIT-licensed and free to self-host forever, commercial use included. Paid plans add managed hosting, Thally AI answers, Track with the one-click GitHub App, and team features.

Question 7

What does the readiness score measure?

Accepted Answer

Every build gets a deterministic 0 to 100 grade covering structured data, metadata, discovery files, machine readability, and OpenAPI coverage, with subscores that name the exact pages dragging the number down. You can gate CI on a threshold, and the agent can open PRs to fix what's ailing.

Question 8

What are agent endpoints?

Accepted Answer

Every deploy ships llms.txt, ai.txt, skill.md, AGENTS.md, per-page JSON, and a remote MCP server at /api/mcp, so crawlers and AI agents consume your docs correctly instead of scraping them. Attach the MCP endpoint to any agent and your docs become native tools, no key or account required.

Question 9

How does the AI chat avoid hallucinating?

Accepted Answer

Answers are retrieval-grounded: the engine only quotes your indexed docs and cites the exact pages inline. If the docs don't contain an answer, it says so.

Question 10

Where can I deploy Thally?

Accepted Answer

Anywhere Next.js runs: Vercel, Netlify, Cloudflare, Docker with the included Dockerfile, or a static export. Your docs are a repo you own, so there's no vendor lock-in in either direction.

Question 11

What's in the admin dashboard?

Accepted Answer

A live dashboard at /admin: first-party analytics with top pages and content gaps, branding and theming that apply without a rebuild, the agent-readiness report, a queue of agent-drafted docs PRs, and team access with Owner, Editor, and Viewer roles from a git-committed roster. OIDC sign-in, no per-seat database.

Question 12

Does Thally support multiple languages?

Accepted Answer

Yes. One command translates your entire site while preserving code blocks, components, and URLs. Every locale gets its own indexable URL with automatic hreflang tags, a built-in language switcher, and graceful fallbacks; a missing translation never returns a 404.

Free to self-host, simple to scale

Free

Cloud

Enterprise

Cloud

Free

Cloud

Enterprise

Usage

Features

Support

Frequently asked questions