kitepon

Caveat — Documentation skill for Claude Code

Documentation community

Long-term memory layer for Claude Code and Codex — markdown-in-git knowledge base, SQLite FTS5 retrieval, MCP, and native agent hooks.

How to install Caveat

This entry records only its repository, not the path inside it, so there is no exact command to give. Open kitepon/Caveat and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Caveat does

Long-term memory layer for Claude Code and Codex — markdown-in-git knowledge base, SQLite FTS5 retrieval, MCP, and native agent hooks.

Alternatives in Documentation

Hyperresearch — Agent-driven research knowledge base 2.4k ★
Doc Fix — Document a recently solved problem for the knowledge base 209 ★
Cchooks — by GowayLee - A lightweight Python SDK with a clean API and good documentation; simplifies the process of writ 121 ★

README

Caveat — a raven noticing a hidden snare and carrying the warning forward
This image represents stopping before the same trap is triggered again and carrying the warning learned there into the next execution.

Caveat

[![npm](https://img.shields.io/npm/v/caveat-cli?color=cb3837&label=caveat-cli)](https://www.npmjs.com/package/caveat-cli) [![CI](https://github.com/kitepon/Caveat/actions/workflows/ci.yml/badge.svg)](https://github.com/kitepon/Caveat/actions/workflows/ci.yml) [![license](https://img.shields.io/npm/l/caveat-cli?color=blue)](LICENSE) [![node](https://img.shields.io/node/v/caveat-cli?color=339933&logo=node.js&logoColor=white)](https://nodejs.org/) [![GitHub release](https://img.shields.io/github/v/release/kitepon/Caveat?color=24292e&logo=github)](https://github.com/kitepon/Caveat/releases)

**Stop rediscovering the same trap.** Caveat is a long-term memory layer for Claude Code, Codex, and Cursor: every time you bleed for an external-spec quirk or a repo-specific oddity, write it down once — and the next time anyone (you or your AI) is about to step on the same rake, the relevant note surfaces automatically.

🇯🇵 **日本語版**: [README.ja.md](README.ja.md)

Built and maintained by [Quo](https://x.com/QLyun35332) at [kitepon.dev](https://kitepon.dev/en).

Ownership boundary

This repository owns Caveat's install, configuration, state, schema, migrations, diagnostics, recovery, updates, and releases. Caveat operates standalone. [dotagents](https://github.com/kitepon/dotagents) owns optional cross-product integration and compatibility contracts; it does not control Caveat's product state. The third-party MarkItDown CLI is managed separately.

What it does in 30 seconds

npm install -g caveat-cli
caveat init                          # registers Claude Code MCP + hooks
caveat codex-hook install            # optional: register native Codex hooks
cave