# Clovis

Clovis is a local-first bookkeeping CLI and MCP server for AI agents using Anthropic, OpenAI, and other agent runtimes.

Package: clovis@1.3.0
Install: npm install -g clovis
CLI: clovis --help
MCP: CLOVIS_DB=./ledger.db clovis-mcp

Primary docs:
- https://cloviscomputing.com/docs/
- https://cloviscomputing.com/docs/agent-guide.md
- https://cloviscomputing.com/docs/mcp-tools.json
- https://cloviscomputing.com/docs/clovis-tools.json
- https://cloviscomputing.com/docs/clovis-cli.json
- https://cloviscomputing.com/docs/schema/
- https://cloviscomputing.com/docs/clovis-schema.json
- https://cloviscomputing.com/docs/changelog/
- https://cloviscomputing.com/docs/clovis-changelog.json

For agents:
- Use /docs/mcp-tools.json for canonical MCP tool names, parameters, annotations, and safety hints.
- Use /docs/clovis-schema.json for SQLite tables, fields, relationships, indexes, triggers, and raw DDL.
- Use /docs/clovis-changelog.json for release history and recent behavior changes.
- Use read-only tools first.
- Prefer dry-run mode before writes when available.
- Treat destructive tools as approval-required.