Skip to content

Commit 54d2e6e

Browse files
committed
docs(readme): publish project overview
1 parent 33682fa commit 54d2e6e

1 file changed

Lines changed: 57 additions & 0 deletions

File tree

‎README.md‎

Lines changed: 57 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,57 @@
1+
# Lore
2+
3+
Lore is a local desktop app for browsing and searching your coding-agent history.
4+
5+
It reads the session files Claude Code and Codex already save on your computer, connects them to their repositories and Git history, and puts everything in one searchable archive. It does not wrap your agents or change their files.
6+
7+
## How it works
8+
9+
```text
10+
Claude Code and Codex logs
11+
↓
12+
read-only adapters
13+
↓
14+
local SQLite archive + Git evidence
15+
↓
16+
search and browse in the desktop app
17+
```
18+
19+
Lore keeps different kinds of evidence separate. A commit recorded during a session is not treated as the same thing as repository state observed later during ingestion.
20+
21+
Everything in the archive stays on the machine. V0 has no accounts, telemetry, cloud database, or LLM calls.
22+
23+
## Development
24+
25+
You will need Rust, Node.js, the Xcode command-line tools, and the Tauri 2 prerequisites for macOS.
26+
27+
```bash
28+
npm install
29+
npm run build
30+
npm test
31+
npm run lint
32+
33+
cargo test --workspace
34+
cargo clippy --workspace --all-targets --all-features -- -D warnings
35+
cargo fmt --all -- --check
36+
```
37+
38+
Run the web UI with `npm run dev`. Run the desktop app with `cargo tauri dev` once the Tauri CLI is installed.
39+
40+
## Repository layout
41+
42+
```text
43+
crates/lore-core/ ingestion, storage, Git, search, and safety
44+
crates/lore-ipc/ Rust IPC types and generated TypeScript bindings
45+
src-tauri/ Tauri application layer
46+
src/ React interface
47+
```
48+
49+
## Scope
50+
51+
Lore currently focuses on Claude Code and Codex. It is an archive, not an IDE, agent runtime, or cloud memory service. More integrations and generated skills are deliberately deferred until the core archive is finished.
52+
53+
## License
54+
55+
[Apache License 2.0](LICENSE)
56+
57+
Lore is not affiliated with Anthropic or OpenAI.

0 commit comments

Comments
 (0)