https://github.com/varalys/lore
Capture AI coding sessions and link them to git commits.
https://github.com/varalys/lore
ai aider claude cli coding-assistant developer-tools git rust sqlite
Last synced: 7 days ago
JSON representation
Capture AI coding sessions and link them to git commits.
- Host: GitHub
- URL: https://github.com/varalys/lore
- Owner: varalys
- License: apache-2.0
- Created: 2025-12-22T21:05:34.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-01-11T04:56:46.000Z (21 days ago)
- Last Synced: 2026-01-11T10:19:03.588Z (20 days ago)
- Topics: ai, aider, claude, cli, coding-assistant, developer-tools, git, rust, sqlite
- Language: Rust
- Homepage: https://lore.varalys.com
- Size: 687 KB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# Lore
[](https://opensource.org/licenses/Apache-2.0)
[](https://github.com/varalys/lore/actions/workflows/ci.yml)
[](https://github.com/varalys/lore/releases)
**Reasoning history for code.** Lore captures AI coding sessions and links them to git commits.
Lore saves all your AI coding sessions from Claude Code, Codex, etc and links them to commits. When you look at code later, you can see the conversation that produced it.
**Documentation:** [lore.varalys.com](https://lore.varalys.com)
## Use Cases
- **Code review**: See the AI conversation that produced a PR, not just the diff
- **Debugging**: Understand why code was written a certain way
- **Knowledge transfer**: AI conversations stay with the code when people leave
- **Search**: Find that conversation where you solved a similar problem
## Installation
### Homebrew (macOS)
```bash
brew install varalys/tap/lore
```
### Arch Linux (AUR)
```bash
yay -S lore-cli-bin
```
Or with any AUR helper. See [lore-cli-bin](https://aur.archlinux.org/packages/lore-cli-bin).
### From crates.io
```bash
cargo install lore-cli
```
### From Releases
Download from [GitHub Releases](https://github.com/varalys/lore/releases).
## Quick Start
```bash
# Initial setup (detects tools, imports sessions)
lore init
# List sessions
lore sessions
# View a session
lore show abc123
# Link to current commit
lore link abc123
# Link active sessions in this repo to HEAD
lore link --current
# Find sessions for a commit
lore show --commit HEAD
# Trace a line of code to its AI session
lore blame src/main.rs:42
# Search across all sessions
lore search "authentication"
```
### Example: ```lore blame```
```
$ lore blame src/auth.rs:42
Commit:
a1b2c3d4 2025-12-15 14:30
feat: add rate limiting to login endpoint
Line content:
if attempts > 5 { return Err(RateLimitExceeded) }
Linked sessions (1):
f8e7d6c5 claude-code (127 messages)
Started: 2025-12-15 13:45
Relevant context:
...decided on 5 attempts as the threshold based on industry standards...
Let me add rate limiting to prevent brute force attacks.
```
## Key Features
| Feature | Description |
|---------|-------------|
| **Session Capture** | Import from 10+ AI coding tools |
| **Git Linking** | Connect sessions to commits |
| **Full-text Search** | Find any conversation |
| **Blame Integration** | Trace code to sessions |
| **MCP Server** | Let AI tools query your history |
| **Background Daemon** | Real-time capture |
## Supported Tools
Claude Code, Codex CLI, Gemini CLI, Amp, Aider, Continue.dev, Cline, Roo Code, Kilo Code, OpenCode
See [Supported Tools](https://lore.varalys.com/reference/supported-tools/) for details.
## MCP Integration
Let Claude Code query your session history:
```bash
claude mcp add lore -- lore mcp serve
```
Claude can then search sessions, retrieve context, and continue where you left off.
See [MCP Guide](https://lore.varalys.com/guides/mcp/) for setup details.
## Documentation
Full documentation at **[lore.varalys.com](https://lore.varalys.com)**:
- [Installation](https://lore.varalys.com/getting-started/installation/)
- [Quick Start](https://lore.varalys.com/getting-started/quick-start/)
- [Command Reference](https://lore.varalys.com/commands/)
- [Guides](https://lore.varalys.com/guides/linking/)
- [FAQ](https://lore.varalys.com/about/faq/)
## Data Location
```
~/.lore/
├── lore.db # SQLite database
├── config.yaml # Configuration
└── daemon.log # Daemon logs
```
All data stays on your machine.
## Contributing
See [CONTRIBUTING.md](CONTRIBUTING.md).