emilandClaude Opus 4.7
b873144b69
- Config in ~/.memwalk/config.toml (typer init writes it) - Sources: git log walker + bash history parser with secret/noise filters - Ingest orchestrator feeds events into a memba Session and saves ~/.memwalk/current.memb via the rewritten Session.chat() that preserves loaded state (raw eval+sample, no KV-cache reset) - Daily snapshot rotation under ~/.memwalk/snapshots/ - CLI commands: init, update, ask, standup, status, prune Validated on Nemotron-3-Nano-4B Q4_K_M end-to-end: ingest 304 events (303 commits + 1 shell session) in 2.8s on GPU, recall in fresh process returns accurate per-project summaries. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
70 lines
2.0 KiB
Markdown
70 lines
2.0 KiB
Markdown
# memwalk
|
|
|
|
> Walk through your work memory.
|
|
|
|
A local-first CLI that watches your git activity (and optionally your shell
|
|
history) and feeds it into a Mamba-based LLM via persistent state. You can
|
|
then ask in plain English what you were doing last week, why you started that
|
|
branch, or generate a standup from yesterday's commits — without your data
|
|
ever leaving the machine.
|
|
|
|
Built on **[memba](https://github.com/emil28092005/Memba)** for state
|
|
persistence and **[NVIDIA Nemotron-3-Nano-4B](https://huggingface.co/nvidia/NVIDIA-Nemotron-3-Nano-4B-GGUF)**
|
|
(or any other GGUF SSM/hybrid model) for inference.
|
|
|
|
## Status
|
|
|
|
v0.1 — alpha. Works end-to-end on Linux for the maintainer; APIs and on-disk
|
|
format may change.
|
|
|
|
## Install
|
|
|
|
```bash
|
|
# Until memba is on PyPI, install both editable from local clones:
|
|
pip install -e /path/to/Memba
|
|
pip install -e /path/to/memwalk
|
|
```
|
|
|
|
Make sure you have a GGUF Mamba-2 or hybrid model. Recommended:
|
|
|
|
```bash
|
|
hf download nvidia/NVIDIA-Nemotron-3-Nano-4B-GGUF \
|
|
NVIDIA-Nemotron3-Nano-4B-Q4_K_M.gguf \
|
|
--local-dir ~/.memwalk/models
|
|
```
|
|
|
|
## Quickstart
|
|
|
|
```bash
|
|
memwalk init # interactive setup
|
|
memwalk update # ingest last 30 days of git+bash
|
|
memwalk standup # auto-generate daily standup
|
|
memwalk ask "What was I working on last week?"
|
|
memwalk status
|
|
```
|
|
|
|
## What it actually does
|
|
|
|
`memwalk update` walks your configured git repos and (optionally) your bash
|
|
history, formats new events into a readable activity block, and feeds that
|
|
into the SSM model. The model's hidden state — a fixed ~85 MB blob — is
|
|
saved to `~/.memwalk/current.memb` via memba.
|
|
|
|
`memwalk ask` and `memwalk standup` load that state and query it. The model
|
|
recalls themes, projects, and trajectory across processes and reboots.
|
|
|
|
## Layout
|
|
|
|
```
|
|
~/.memwalk/
|
|
├── config.toml
|
|
├── current.memb ← rolling state
|
|
├── last_update.txt
|
|
└── snapshots/
|
|
└── 2026-05-16.memb ← daily snapshot before each update
|
|
```
|
|
|
|
## License
|
|
|
|
MIT.
|