Skip to content

lorehq/create-lore

create-lore

Scaffold a new Lore instance — a coding agent harness.

The Problem

AI coding agents (Claude Code, Cursor, OpenCode) forget everything between sessions. Every session you re-explain project structure, re-discover API quirks, and repeat lessons learned yesterday. Lore fixes that.

What Lore Does

Lore is a harness that wraps your coding agent in a git-versioned knowledge base with convention enforcement, orchestrated delegation, and work tracking. Hooks fire automatically to reinforce knowledge capture as you work. Gotchas become skills, conventions are enforced at write-time, and complex work delegates to focused workers loaded with curated skills.

  • Skills — API quirks, auth gotchas, encoding tricks. Captured once, loaded forever.
  • Knowledge docs — Environment details, runbooks, architecture decisions. Accumulated across sessions.
  • Work tracking — Roadmaps, plans, and brainstorms that persist and appear in every session banner.
  • Hooks — Session init, capture reminders, memory protection. All automatic.
  • Docs UI & Semantic Search — Run /lore-docker to start a local Docker sidecar. Gives agents semantic search over the full knowledge base and opens a live MkDocs site for browsing it visually. Falls back to Grep/Glob without Docker — works for small knowledge bases, degrades as docs grow.

Quick Start

npx create-lore my-project
cd my-project
git add -A && git commit -m "Init Lore"

Then open the project in your agent. Hooks fire automatically.

Supported Platforms

Platform Integration
Claude Code .lore/hooks/ + CLAUDE.md
Cursor .lore/hooks/ + .cursor/hooks/ + .cursor/mcp/ + .cursor/rules/
OpenCode .opencode/plugins/ + opencode.json

All platforms share the same knowledge base. No configuration needed.

Options

npx create-lore my-project       # creates ./my-project/
npx create-lore ./custom-path    # creates at specific path
npx create-lore --help           # show usage
npx create-lore --version        # show version

Requirements

  • Node.js 18+
  • git
  • Docker (highly recommended — enables semantic search and docs UI; not required)

Docs

Full documentation: lorehq.github.io/lore-docs

License

Apache-2.0