Release · 2026-08-03T16:41:55+02:00 · By Threadnote

Threadnote 4.0.0

Threadnote 4 is a self-contained, local-first memory and code-intelligence layer built for coding agents. It replaces the Python/OpenViking runtime chain with one standalone executable and makes private continuity, deliberate team sharing, local AI, and current-source graph inspection part of the same dependable workflow.

What's new

A runtime Threadnote owns. The macOS and Linux archives embed Bun and need no Node.js, npm, Python, OpenViking, database server, background daemon, or separately installed model runtime. Canonical memories, resources, models, indexes, logs, locks, and sharing metadata live under ~/.threadnote.
Local recall that explains itself. Install and repair automatically provision the pinned BGE Small embedding model. Semantic similarity, BM25, exact terms, fields, scope, lifecycle, authority, currentness, graph links, and feedback produce ranked threadnote:// pointers with confidence and compact ranking reasons. Lexical recall remains available if native inference is temporarily unavailable.
Memory designed for agent work. Durable decisions, active handoffs, preferences, incidents, seeded guidance, and additional review candidates keep distinct lifecycles. Stable project/topic identities replace current knowledge in place instead of accumulating timestamped duplicates.
Explicit cross-team sharing. Publish only selected durable memories or reusable artifacts to a Git-backed team store. Exact preview, secret scanning, optional local-path redaction, conflict-safe sync, and private-by-default lifecycle rules keep handoffs, preferences, and unpublished work local.
A native polyglot code graph. Separate MCP and CLI graph tools inspect the current Git commit plus the active worktree overlay. Query definitions and concepts, round-trip stable symbol IDs, walk neighbors, explain a symbol, find paths, trace change impact, and analyze communities, structural groups, hubs, confidence gaps, and surprising links. Compiler-backed TypeScript/JavaScript joins broad bundled language packs, document and schema extraction, and static Maven, Gradle, SwiftPM, Xcode, and Bazel workspace modeling without executing repository builds.
Large repositories are first-class. Repository size is not an admission gate. Bounded parser workers feed one backpressured SQLite writer; durable checkpoints resume interrupted work; incremental worktree overlays reuse clean committed facts; generated roots and low-value data payloads are pruned before hydration; and CLI progress identifies scanning, parsing, persistence, resolution, and activation work. MCP responses stay concise even when the underlying graph is large.
Manager visualizations. The local Manager provides memory, sharing, model, index, process, migration, and graph views. Snapshot-pinned graph catalogs, bounded WebGL projections, lazy expansion, structural analysis, and a dedicated graph-query flow make large graphs inspectable without loading the complete topology into the browser.
Optional Obsidian bridge. Allowlisted vault notes can participate in recall as untrusted external resources, while explicitly selected Threadnote memories can be published into deterministic, drift-protected Obsidian projections. No Obsidian plugin is required.
Safer installation, update, and migration. Releases are immutable and checksum-verified; macOS builds are signed and notarized. Side-by-side installation, atomic launcher promotion, process leases, rollback preservation, and evidence-driven post-update actions make upgrades recoverable. The 3.x home is imported through a non-destructive, hash-verified migration and is never deleted automatically.
Agent-first operations. threadnote_guide provides an on-demand capability tour, doctor and repair cover the complete native stack, bounded privacy-safe logs never contain prompts or memory payloads, and issue submission is preview-first and requires explicit approval.

Install Threadnote 4 on macOS or Linux:

curl -fsSL https://raw.githubusercontent.com/Kashkovsky/threadnote/v4.0.0/scripts/install.sh | sh

Existing Threadnote 4 beta installations can switch to the stable channel in place:

threadnote update --stable

Threadnote 3 cannot cross the standalone-runtime boundary with its old updater. Install Threadnote 4 using the command above, then run the non-destructive migration:

threadnote migrate
threadnote migrate --apply
threadnote doctor

Official Windows 4 archives remain paused until Authenticode signing and clean-machine verification are approved; the project will not publish an unsigned Windows binary.