difflore-core 0.4.0

Core library for the difflore CLI — rule store, retrieval, MCP server, hooks, cloud sync. Not intended for direct use; depend on `difflore-cli` instead.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114

# difflore

[![CI](https://img.shields.io/github/actions/workflow/status/difflore/difflore-cli/ci.yml?branch=main&label=CI)](https://github.com/difflore/difflore-cli/actions)
[![Apache 2.0](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
[![MCP](https://img.shields.io/badge/MCP-stdio-green.svg)](https://modelcontextprotocol.io)

DiffLore is an open-source CLI that imports your private PR/MR review backlog
into source-backed local rules for AI coding agents.

It stores rules in local SQLite, wires them into local AI CLIs through MCP and
hooks, and serves the relevant review judgment before an agent edits code.

## Install

macOS/Linux:

```bash
curl -fsSL https://difflore.dev/install.sh | sh
```

Windows PowerShell:

```powershell
irm https://difflore.dev/install.ps1 | iex
```

Update later:

```bash
difflore update
```

GitHub import needs `git` and `gh auth login`. GitLab import uses a stored PAT:

```bash
echo "<TOKEN>" | difflore auth gitlab
```

## Quickstart

Try the demo:

```bash
difflore try
```

Use it in a repo:

```bash
cd your-repo
difflore init
difflore import-reviews --dry-run
difflore import-reviews
difflore agents install
difflore status
difflore recall --diff
```

DiffLore works with private repos and local AI CLIs. It never requires a public
repo, and it never commits, pushes, opens PRs, or posts GitHub comments.

## Commands

| Command | Purpose |
| --- | --- |
| `difflore try` | Run the demo |
| `difflore init` | Set up the current repo |
| `difflore import-reviews` | Import private GitHub PR or GitLab MR review backlog locally |
| `difflore agents install` | Wire DiffLore into local AI CLIs and agents |
| `difflore status` | Show readiness and the next command |
| `difflore memory` | Inspect local rules, drafts, queues, and autopilot state |
| `difflore memory review` | Review pending local memory |
| `difflore recall --diff` | Retrieve matching rules for the current diff |
| `difflore review --diff all` | Review the current diff without modifying files |
| `difflore fix` | Apply rule-aware local fixes |
| `difflore capabilities --json` | Print the machine-readable CLI/MCP contract |

Run `difflore --help` for the full command list.

## Agents

`difflore agents install` configures MCP and hooks for supported local agents.
Run `difflore agents status` to inspect the current machine.

Local AI CLI calls that need an LLM backend use `gate4agent`.

## Data

DiffLore is local-first:

- Rules and activity are stored in local SQLite by default.
- Private review imports do not require public repos or cloud upload.
- Cloud sync is optional and explicit through `difflore cloud ...`; use it for
  team sync, multi-device access, or managed token/embedding paths.
- MCP is for agent context, retrieval, explanation, and proposals.
- Approval, rejection, sync, auth, provider setup, and file mutation stay in the CLI.

## Development

```bash
cargo fmt --all --check
cargo check -p difflore-cli
cargo test -p difflore-cli
```

Issues and PRs are welcome. Do not include secrets, private PR text, or private
code in examples.

For suspected vulnerabilities, email **hello@difflore.dev** instead of opening
a public issue. See [SECURITY.md](SECURITY.md).

## License

Apache 2.0. See [LICENSE](LICENSE).