Lore CLI v0.1.0: First Official Release

Mar 22, 2026

Ivan Stetsenko

Creator of Lore Protocol

The Lore CLI is officially available on npm. Install it with:

npm install -g lore-protocol

This is the first public release of the tool described in our paper. It implements the full Revised Specification v1.0 — every command, trailer type, and output format described in the documentation.

What’s in v0.1.0

15 commands covering the full workflow:

Setup: lore init, lore doctor
Query: lore context, lore constraints, lore rejected, lore directives, lore tested (alias: coverage), lore why, lore search, lore log, lore stale, lore trace
Authoring: lore commit, lore validate
Maintenance: lore squash

12 trailer types for structured decision context: Lore-id, Constraint, Rejected, Confidence, Scope-risk, Reversibility, Directive, Tested, Not-tested, Supersedes, Depends-on, Related.

Dual output: human-readable colored text by default, structured JSON with --json for agent consumption.

Agent Skill Files

v0.1.0 ships with pre-built instruction files that teach AI coding agents to use Lore automatically. Copy one file into your project:

Agent	Destination
Claude Code	Append `skills/adapters/claude-code.md` to your `CLAUDE.md`
Cursor	Copy `skills/adapters/cursor.mdc` to `.cursor/rules/lore.mdc`
GitHub Copilot	Append `skills/adapters/github-copilot.md` to `.github/copilot-instructions.md`
Windsurf	Append `skills/adapters/windsurf.md` to `.windsurfrules`
Aider	Copy `skills/adapters/aider.md` to `.aider/lore-instructions.md`

Each adapter tells the agent to query lore constraints, lore rejected, and lore directives before modifying code, and to write Lore-enriched commits with structured JSON.

Open Source

Lore Protocol is MIT licensed and built in the open. Source code, issues, and contributions are welcome on GitHub.

Getting Started

npm install -g lore-protocol
cd your-project
lore init

Then follow the Quick Start guide or jump straight to the CLI command reference.