Skip to content

MemoryWhale v0.1.0

Choose a tag to compare

@wuisabel-gif wuisabel-gif released this 20 Jun 07:14

MemoryWhale's first release — a local-first, Rust/Tauri terminal-memory system that turns your commands, errors, fixes, and whole shell sessions into a durable, searchable, visual memory. Everything stays on your machine; nothing is uploaded.

Highlights

Record

  • mw — record a whole interactive shell session (every command + real output); mw list / mw show <id>, and mw global on|off to auto-record every new terminal.
  • mw-remember — log a single command run (args, exit code, stdout/stderr, notes).
  • mw-recover — rescue an interrupted session whose recording was cut off before it saved (also auto-runs when the dashboard starts).

View

  • mw-view <id> — open one memory as a friendly local web page.
  • mw-serve — a local web dashboard (works headless / over the LAN, ideal for a Jetson): browse command runs and sessions, open detail pages with suggested next steps mined from your history, an interactive knowledge graph (commands sized by frequency, shared arguments as bridges), and project grouping that stitches multi-terminal work into one timeline via a project:<name> tag.

For agents

  • A Claude Code skill (.claude/skills/memorywhale/) and AGENTS.md (Codex) that teach AI coding agents to recall prior attempts before debugging and record what they do.

Install

Build from source (see SOP.md and DEBUG.md):

cd src-tauri
cargo build --release --bin mw --bin mw-remember --bin mw-serve --bin mw-view --bin mw-recover
mkdir -p ~/.local/bin && cp target/release/{mw,mw-remember,mw-serve,mw-view,mw-recover} ~/.local/bin/
# macOS only: codesign --force --sign - ~/.local/bin/mw*

Data

Local SQLite at <data_local>/MemoryWhale/memorywhale.sqlite3 (~/.local/share on Linux/Jetson, ~/Library/Application Support on macOS).

See README.md for the full overview and SOP.md for day-to-day usage.