# Clone

> A persistent user model that predicts what you will type

This file contains links to documentation sections following the llmstxt.org standard.

## Table of Contents

- [Authentication](https://clone.is/docs/api-reference/authentication.md): Two credential shapes — short-lived JWT for browser sessions, long-lived API key for headless clients. Both go through /api/auth/.
- [Memory](https://clone.is/docs/api-reference/memory.md): Four-tier memory model — profile, semantic facts, episodes, raw — plus the headline /context/ bundle and LLM-driven promotion.
- [API Reference](https://clone.is/docs/api-reference/overview.md): REST surface area for Clone — auth, recording, memory, and predictions endpoints under api.clone.is.
- [Predictions](https://clone.is/docs/api-reference/predictions.md): Predict, batch-predict, mark feedback, list past predictions, aggregate stats. The headline endpoint is POST /predict/.
- [Recording](https://clone.is/docs/api-reference/recording.md): Idempotent batch ingest for CloneEvent rows, plus session listing and per-event detail. Validated against packages/schema/events.schema.json.
- [CLI](https://clone.is/docs/apps/cli.md): Terminal client for Clone — interactive sessions, recording, and direct API access from the shell.
- [Desktop](https://clone.is/docs/apps/desktop.md): Python + ocap recorder + Nuitka standalone. Record + upload, no AI.
- [MCP server](https://clone.is/docs/apps/mcp.md): Drop-in MCP server that exposes Clone's prediction surface to any MCP-aware agent. Two transports — stdio for local installs, HTTP for clone.is/mcp.
- [Apps](https://clone.is/docs/apps/overview.md): One directory per product surface — three are placeholder, the others are active. All consume `packages/schema` and call `apps/server`.
- [Server](https://clone.is/docs/apps/server.md): Django + DRF backend. Owns Recording, Memory, Prediction, Voice, Sources, Access, Accounts, Monitoring, Jobs, News.
- [Web](https://clone.is/docs/apps/web.md): Marketing site and authenticated dashboard for Clone. Vite + React 19 + Tailwind v4 + react-router 7. Also hosts /docs and the /mcp reverse proxy.
- [Architecture](https://clone.is/docs/architecture.md): Clone's three-layer Recording → Memory → Prediction model and how a single prediction call flows through it.
- [Changelog](https://clone.is/docs/changelog.md): Notable changes to Clone. Detailed history is in the GitHub commit log.
- [Contributing](https://clone.is/docs/development/contributing.md): Trunk-based workflow, branch naming, commit style, and the PR template. English-only, always assigned to cloneisme.
- [Local setup](https://clone.is/docs/development/local-setup.md): Clone, install, and run each surface against a local Django on port 8001.
- [Development](https://clone.is/docs/development/overview.md): How to clone, build, and contribute to Clone. Trunk-based, English-only PRs, and the AGENTS.md ecosystem.
- [Testing](https://clone.is/docs/development/testing.md): What to run before opening a PR. Each surface owns its own suite — there is no monorepo test harness.
- [FAQ & Troubleshooting](https://clone.is/docs/faq.md): Common gotchas — DNS NXDOMAIN, MCP source enum, prediction 504s, cold-start confidence — and how to spot each.
- [Clone — a persistent user model that predicts what you will type](https://clone.is/docs/introduction.md): Clone is a personalized user model that sits between humans and AI agents. Agents address Clone instead of interrupting the human; Clone predicts t...
- [MCP Server reference](https://clone.is/docs/mcp-reference/overview.md): Complete reference for the MCP tools Clone exposes, headlined by predict_next_prompt.
- [predict_next_prompt](https://clone.is/docs/mcp-reference/predict-next-prompt.md): Predict the human's reply to an agent prompt. Returns top-K ranked candidates with calibrated probabilities.
- [Memory layer](https://clone.is/docs/memory-layer.md): How raw user signal is layered, compacted, and made retrievable for the prediction surface, with provenance preserved.
- [@clone/design](https://clone.is/docs/packages/design.md): Brand assets — logos, icons, social cards. Consumed via Vite alias by Desktop and Web.
- [Packages](https://clone.is/docs/packages/overview.md): Cross-stack shared packages — `@clone/schema` (event SSOT) and `@clone/design` (logos and icons).
- [@clone/schema](https://clone.is/docs/packages/schema.md): Single source of truth for cross-stack event shapes. TypeScript types and JSON Schema move together.
- [Product thesis](https://clone.is/docs/product-thesis.md): Who Clone is built for, what we're actually selling them, and the honest contract behind it.
- [Quickstart](https://clone.is/docs/quickstart.md): Issue an API key, push a few recording events, and get your first calibrated prediction in five minutes — REST or MCP.
- [Schema](https://clone.is/docs/schema.md): CloneEvent JSON Schema, oneOf variants, and validation rules. The single source of truth that the server, MCP, and TypeScript clients all read from.
- [DNS & TLS](https://clone.is/docs/self-hosting/dns-tls.md): DNS records you need for the apex, www, and api subdomains. Let's Encrypt setup. The api.clone.is NXDOMAIN gotcha and how to spot it.
- [Docker Compose](https://clone.is/docs/self-hosting/docker-compose.md): Bring up Clone with docker-compose. Four services (db, api, mcp, web), one volume, and a handful of env vars.
- [Self-hosting](https://clone.is/docs/self-hosting/overview.md): Run your own Clone with docker-compose, a Postgres volume, and an Anthropic key. nginx fronts api, web, mcp, and docs from a single container.
- [Smithery](https://clone.is/docs/self-hosting/smithery.md): Publish the Clone MCP server URL to Smithery so end users can install it from any MCP-aware client without editing config.
- [Warm-start](https://clone.is/docs/self-hosting/warmstart.md): Configure the warm-start sources (local agent transcripts and GitHub) on a self-hosted Clone, including the GitHub OAuth App registration and token...