ajianaz · Jun 11, 2026 · Jun 11, 2026
diff --git a/.agent.md b/.agent.md
@@ -8,7 +8,7 @@ Before creating any release PR, verify ALL of the following are updated:
 
 - [ ] `Cargo.toml` — version bump
 - [ ] All target issues merged to `develop`
-- [ ] `cargo test` — all 495+ tests pass
+- [ ] `cargo test` — all 506+ tests pass
 - [ ] `cargo clippy --all-targets -- -D warnings` — clean
 - [ ] `cargo fmt --all -- --check` — clean
 - [ ] `cargo build --release` — no errors

diff --git a/AGENT.md b/AGENT.md
@@ -17,7 +17,7 @@ no managed API, no cloud service. Runs locally against diffs, scans, or branches
 ```bash
 cargo build              # Build (debug)
 cargo build --release    # Build (release)
-cargo test               # Run all 495 tests
+cargo test               # Run all 506 tests
 cargo clippy --all-targets -- -D warnings  # Lint (strict)
 cargo fmt --all -- --check  # Format check
 ```
@@ -62,6 +62,7 @@ src/
 │   ├── language_analyzer.rs # Language-specific review guidance
 │   ├── secrets_scanner.rs   # Secret/credential detection
 │   ├── debt_tracker.rs  # Tech debt metrics + history snapshots
+│   ├── memory.rs        # Uteke memory integration (recall + learn)
 │   └── rules/           # Custom rule engine
 │       ├── mod.rs
 │       ├── builtin.rs   # Built-in rules
@@ -100,8 +101,8 @@ src/
 ## Testing
 
 ```bash
-cargo test               # 495 tests total
-                         #   473 unit tests
+cargo test               # 506 tests total
+                         #   484 unit tests
                          #    16 CLI integration tests
                          #     6 config tests
 cargo test --no-verify   # Skip pre-commit hooks (avoids timeout in hooks)
@@ -232,7 +233,7 @@ Missing any = release blocker.
 ### 1. Code
 
 - [ ] All target issues merged to `develop`
-- [ ] `cargo test` — all 495+ tests pass
+- [ ] `cargo test` — all 506+ tests pass
 - [ ] `cargo clippy --all-targets -- -D warnings` — clean
 - [ ] `cargo fmt --all -- --check` — clean
 - [ ] `cargo build --release` — no errors

diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -43,6 +43,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Auto-save after every review (best-effort, never fails review)
   - `debt:` config section in `.cora.yaml` (history_dir, retention_days)
   - 32 unit tests
+- **Uteke memory integration** — recall project patterns and learn from reviews (#232)
+  - `--memory` flag — recall context from Uteke before review
+  - `--learn` flag — recall + save findings after review
+  - `MemoryBackend` with auto-detect, graceful degradation when Uteke not installed
+  - 11 unit tests
 - **Multi-platform CI docs** — Gitea/Forgejo, GitLab CI, Bitbucket Pipelines workflow examples (#225)
 - **GitHub Marketplace action** — published as [`codecoradev/cora-review-action@v1`](https://github.com/marketplace/actions/cora-ai-code-review)
 - **Improved review prompt** — better consistency, lower false-negative rate, explicit error handling focus area

diff --git a/README.md b/README.md
@@ -138,6 +138,8 @@ Works on **all CI platforms** — [Gitea, GitLab, Bitbucket →](https://codecor
 | `cora config show` | Show resolved config |
 | `cora providers` | List available LLM providers |
 | `cora debt` | Show tech debt report from review history |
+| `cora review --memory` | Recall project patterns from Uteke before review |
+| `cora review --learn` | Recall + save findings to Uteke |
 | `cora mcp` | Start MCP server for AI coding agents |
 | `cora hook install` | Install pre-commit hook |
 

diff --git a/docs/changelog.md b/docs/changelog.md
@@ -43,6 +43,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Auto-save after every review (best-effort, never fails review)
   - `debt:` config section in `.cora.yaml` (history_dir, retention_days)
   - 32 unit tests
+- **Uteke memory integration** — recall project patterns and learn from reviews (#232)
+  - `--memory` flag — recall context from Uteke before review
+  - `--learn` flag — recall + save findings after review
+  - `MemoryBackend` with auto-detect, graceful degradation when Uteke not installed
+  - 11 unit tests
 - **Multi-platform CI docs** — Gitea/Forgejo, GitLab CI, Bitbucket Pipelines workflow examples (#225)
 - **GitHub Marketplace action** — published as [`codecoradev/cora-review-action@v1`](https://github.com/marketplace/actions/cora-ai-code-review)
 - **Improved review prompt** — better consistency, lower false-negative rate, explicit error handling focus area

diff --git a/docs/cli-reference.md b/docs/cli-reference.md
@@ -26,6 +26,8 @@ Complete command reference for the cora CLI.
 | `cora init` | Create `.cora.yaml` config file |
 | `cora review` | Review code changes (default: staged files) |
 | `cora review --staged` | Review staged git changes explicitly |
+| `cora review --memory` | Recall project patterns from Uteke before review |
+| `cora review --learn` | Recall + save findings to Uteke (implies --memory) |
 | `cora review --unstaged` | Review unstaged working changes |
 | `cora review --unpushed` | Review unpushed commits |
 | `cora review --base` `<branch>` | Compare current branch against target |

diff --git a/docs/configuration.md b/docs/configuration.md
@@ -374,6 +374,30 @@ cora debt --branch develop   # Filter by branch
 
 Snapshots are auto-saved after every review (best-effort, never fails the review).
 
+## Uteke Memory Integration
+
+cora can optionally integrate with [Uteke](https://github.com/codecoradev/uteke) — a local-first memory engine for AI agents.
+
+### Prerequisites
+
+Install Uteke: `curl -fsSL https://raw.githubusercontent.com/codecoradev/uteke/main/install.sh | sh`
+
+### Usage
+
+```bash
+cora review                  # Standalone review (default, no memory)
+cora review --memory         # Recall project patterns before review
+cora review --memory --learn # Recall + save findings after review
+```
+
+### How It Works
+
+1. **`--memory`**: Cora calls `uteke recall` to fetch project-specific patterns from previous reviews, enriching the LLM prompt with historical context.
+
+2. **`--learn`**: After review, Cora calls `uteke remember` to save findings, patterns, and stats for future recall.
+
+3. **Graceful degradation**: If Uteke is not installed, Cora warns and continues without memory. Reviews never fail due to memory issues.
+
 ## MCP Server
 
 cora includes a built-in MCP (Model Context Protocol) server that exposes rules and config to AI coding agents like Claude Code, Cursor, Copilot, and Windsurf.

diff --git a/docs/roadmap.md b/docs/roadmap.md
@@ -72,6 +72,7 @@ Demand-gated — we build what people actually need. Track progress on [GitHub I
 - [#238](https://github.com/codecoradev/cora-cli/issues/238) Quality profiles bug fix — path resolution, fail-fast, dedup — ✓ Done
 - [#188](https://github.com/codecoradev/cora-cli/issues/188) Auto-chunking for large diffs — ✓ Done
 - [#206](https://github.com/codecoradev/cora-cli/issues/206) Tech debt metrics — review history — ✓ Done
+- [#232](https://github.com/codecoradev/cora-cli/issues/232) Uteke memory integration — recall + learn — ✓ Done
 
 ## v0.6 — Growth & Marketplace