llms.txt Content
# cachly — AI Brain for coding assistants
> cachly gives AI coding assistants (Claude Code, Cursor, GitHub Copilot, Windsurf, Cline, Zed) a persistent memory that survives across sessions. The Brain stores lessons, past fixes, architecture decisions, and session context — and recalls them in under 10 ms.
## Product
cachly is an MCP (Model Context Protocol) server + managed Brain backend. When installed, the AI coding assistant automatically:
- Starts a session on editor connect (no manual call needed as of v0.10.9)
- Loads the previous session summary, open tasks, and top lessons
- Stores what it learns via `learn_from_attempts()` after every fix or deploy
- Recalls past solutions via `recall_best_solution()` and `smart_recall()`
**Key facts:**
- 126 MCP tools (session management, memory, search, causal graph, prediction)
- Sessions fire automatically on `ListTools` (editor connection)
- Lessons persist across machines, editors, and engineers
- Causal Knowledge Graph with Bayesian confidence scores
- VS Code extension with offline queue (lessons saved without network)
- Free tier, EU servers (Germany), GDPR-native
- npm: `@cachly-dev/mcp-server` — 11,953 downloads in first 23 days
## Quick start
```bash
npx @cachly-dev/mcp-server@latest autopilot
```
Or add to `.mcp.json`:
```json
{
"mcpServers": {
"cachly": {
"command": "npx",
"args": ["-y", "@cachly-dev/mcp-server@latest"],
"env": {
"CACHLY_JWT": "your-api-key",
"CACHLY_BRAIN_INSTANCE_ID": "your-instance-uuid"
}
}
}
}
```
## Core MCP tools
- `session_start` — 🤖 Auto (fires on editor connect). Returns previous session summary, open tasks, top lessons.
- `session_end` — 🤖 Auto (fires on editor disconnect). Generates session summary from git log.
- `learn_from_attempts` — ⭐ Most important. Store what worked/failed after every fix or deploy.
- `recall_best_solution` — ⭐ Before any non-trivial task. Returns best known approach with con
OpenAPI Spec (preview)
openapi: "3.1.0"
info:
title: cachly API
version: "1.1.0"
description: |
cachly AI Brain — persistent memory and managed cache for AI coding assistants and autonomous agents.
Give Claude Code, Cursor, Windsurf, GitHub Copilot and any MCP-compatible editor a Brain that
remembers lessons, sessions, and code across every session, every machine, and every team member.
**Authentication:**
- `BearerAuth` – API key or Keycloak JWT in `Authorization: Bearer <token>` heade