trylore

The lore CLI. Registers the Lore MCP server so AI coding agents can fetch focused coding guides.

Supported agents

| Agent | macOS / Linux | Windows (native) | Windows (WSL) | |---|---|---|---| | Cursor | ✓ | ✓ | ✓ | | Codex | ✓ | ✓ | ✓ | | Claude Code | ✓ | ✓ | ✓ |

Lore is installed user-wide in each detected agent config.

Commands

Run with npx trylore@latest <command>:

| Command | Aliases | Description | |---|---|---| | login | auth, authenticate | Validate, activate, and save a license key | | logout | | Deactivate this device and remove the saved license key | | init | i, initialize, start | Configure Lore for detected coding agents |

Development

npm install
npm run build    # esbuild → dist/bin/lore.js
npm run check    # tsc --noEmit
npm run lore -- --help   # run the built CLI

Or link it globally for convenience:

npm run build && npm link
lore --help

Adding a command

1. Create src/commands/<name>.ts and export a Command via defineCommand
2. Import it in src/cli.ts and add it to the commands array

The dispatcher, --help handling, error formatting, and did-you-mean suggestions are all provided automatically.

Project layout

src/
  command.ts          Command type + defineCommand builder
  cli.ts              Registry and dispatcher
  suggest.ts          Fuzzy did-you-mean matching
  auth.ts             Read/write ~/.lore/auth.json
  commands/
    login.ts
    logout.ts
    init.ts
  adapter.ts          Adapter type shared by every agent integration
  adapters/           One file per supported agent (index.ts aggregates them)