Skip to content
Lore Lore

Quick Start

This guide will help you set up Lore and import your first AI coding sessions.

Initial Setup

Section titled “Initial Setup”

Run the setup wizard:

Terminal window
lore init

The wizard will:

  1. Detect installed AI coding tools
  2. Show which tools have existing sessions
  3. Let you choose which watchers to enable
  4. Offer to import existing sessions
  5. If Aider is enabled, offer to scan additional directories for aider projects
  6. Offer to configure a summary provider (for LLM-powered session summaries)
  7. Offer to install shell completions
  8. Offer to start the background service

Manual Setup

Section titled “Manual Setup”

If you prefer to configure manually:

Terminal window
# Import existing sessions
lore import


# List imported sessions
lore sessions


# View a session
lore show <session-id>

Linking Sessions to Commits

Section titled “Linking Sessions to Commits”

After making a commit with AI assistance:

Terminal window
# Link a session to the most recent commit
lore link <session-id>


# View sessions linked to a commit
lore show --commit HEAD

Syncing Reasoning History

Section titled “Syncing Reasoning History”

Optionally share and back up your sessions over git. Sync is encrypted end to end, with no server and no account.

Terminal window
# Set a passphrase for this repository's store
lore sync setup


# Fetch, encrypt, and push reasoning history
lore sync

Install the pre-push hook to sync automatically on every git push:

Terminal window
lore hooks install

See the Syncing guide for the global store and team sharing.

Starting the Daemon

Section titled “Starting the Daemon”

The daemon is optional. It captures sessions in real time and auto-links them, but it is not required for sync.

Terminal window
# macOS with Homebrew
brew services start lore


# Manual start
lore daemon start

Example Workflow

Section titled “Example Workflow”
Terminal window
# 1. You're reviewing a PR and want to understand a change
git log --oneline -1
# a1b2c3d feat: add rate limiting to API


# 2. See which AI sessions informed this commit
lore show --commit a1b2c3d
# Session: 7f3a2b1
# Tool: claude-code
# Messages: 23


# 3. View the full conversation
lore show 7f3a2b1

Next Steps

Section titled “Next Steps”