v0.4.1

Nudge v0.4.1: repo memory for agents

This release introduces Nudge Learn: a lightweight way for a project to remember the fixes, debugging trails, and repo-specific gotchas that agents should not have to rediscover.

Tip

What makes this different from memory?

Learned incident notes are deliberately narrower than built-in agent memory. Built-in Claude or Codex memory is useful for facts that should follow you everywhere, but it can activate in the wrong repo, branch, or worktree. Nudge learnings live in Git with the code, so a checkout only sees the notes present in that checkout. If a learning was added on a branch that has not merged, another worktree will not see it.

The note format is also part of the design. A learning should name a concrete problem, the fix, and the verification, not every interesting fact about a project. That focused shape gives retrieval sharper terms and keeps unrelated sessions from receiving stale or useless context that just confuses the model.

Highlights

• Add learned notes with nudge learn add, then inspect them with nudge learn list and nudge learn search.
• Store learnings as plain Markdown under .nudge/learned, so the memory stays reviewable, portable, and close to the code it describes.
• Let Nudge surface relevant learned context during agent sessions, turning past debugging work into timely guidance for future runs.
• Install the bundled nudge-learnings skill during agent setup so Claude and Codex know how to search, apply, and record project learnings.
• Use BM25 lexical retrieval everywhere by default, which works well for exact errors, commands, paths, package names, and framework terms.
• Opt into local semantic embeddings for paraphrase-friendly learned-note search on supported binaries with nudge learn embeddings enable.

Local embeddings

Semantic embeddings are local and optional. They are available in release binaries where the ONNX Runtime dependency is supported, currently Apple Silicon macOS and x64 GNU Linux. Other release binaries still include the full learned-note workflow with BM25 search, but report Embedding support: unavailable in this binary from nudge learn embeddings status.

Try it

nudge learn add --title "Metro cache after dependency update" --body "What went wrong: Expo could not resolve modules after a dependency update.

Fix: clear the Metro cache and restart the dev server.

Verification: expo start completed and the app loaded."

nudge learn search expo metro cannot resolve module
nudge learn list

For semantic search on supported binaries:

nudge learn embeddings enable
nudge learn embeddings status
nudge learn embeddings reindex

Release reliability

This release also hardens release builds: release artifacts are now exercised in PR CI, FastEmbed downloads use rustls-backed features, and platform targets that cannot link ONNX Runtime are built without the embedding feature rather than dropping installer support.