ggnmem v0.3.0-alpha
Pre-releaseggnmem v0.3.0-alpha: The Semantic Terminal Memory Engine
We are excited to announce the first alpha release of ggnmem, a local-first, privacy-focused terminal intelligence system.
ggnmem captures your shell history in the background and makes it instantly searchable using a combination of fast keyword search (FTS5) and offline AI semantic embeddings—meaning you can search for what you meant to do, not just the exact commands you typed.
✨ Core Features
Hybrid Search Engine: Combines Full-Text Search (keyword) with Semantic Vector Search (AI embeddings) using Reciprocal Rank Fusion (RRF) to deliver highly relevant results.
Local & Private AI: Runs all-MiniLM-L6-v2 entirely offline using ONNX Runtime. No cloud APIs, no telemetry, and your history never leaves your machine.
Interactive TUI: A lightning-fast terminal UI (ggnmem ui) to search, filter, and execute past commands. Press Ctrl+R (with shell hooks) to trigger hybrid search instantly.
Background Daemon Architecture: Uses a lightweight Tokio async daemon (ggnmem-daemon) backed by SQLite WAL mode to capture history with sub-10ms latency without slowing down your shell prompt.
🛠️ Recent Improvements (v0.3.0)
AI Setup Wizard & Doctor: Run ggnmem ai setup for an interactive, guided process to download models, verify checksums, and reindex your history. Run ggnmem ai doctor to instantly diagnose the health of your AI pipeline.
Automated Upgrades: Once installed, you can securely update ggnmem using the built-in upgrade command (ggnmem upgrade --bundle ), which automatically backs up binaries, validates checksums, handles the daemon lifecycle, and preserves your DB and config.
Robust Installation: The bundled install.sh script automatically detects system architecture, manages previous installations, and ensures safe rollbacks.
Expanded Diagnostics: ggnmem version --verbose and ggnmem doctor now provide deep visibility into daemon status, model health, SQLite stats, and binary fingerprints.
📦 Installation Instructions
Download the ggnmem-linux-x86_64.tar.gz and checksums.txt artifacts below.
Verify the checksums: sha256sum -c checksums.txt
Extract the tarball: tar xzf ggnmem-linux-x86_64.tar.gz
Run the installer: cd release && bash install.sh
Note on Windows Support: Native Windows support is deferred. WSL is fully supported via the standard Linux installation.
Downloads
Download the release assets below:
- ggnmem-linux-x86_64.tar.gz
- checksums.txt