Caveat

This image represents stopping before the same trap is triggered again and carrying the warning learned there into the next execution.

Caveat

[](https://www.npmjs.com/package/caveat-cli) [](https://github.com/kitepon/Caveat/actions/workflows/ci.yml) [](LICENSE) [](https://nodejs.org/) [](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