Private memory, from the terminal¶
Waymark is a local-first CLI and guided terminal app for capturing memories, tracking decisions, reviewing patterns, and asking grounded questions over your own saved context.
capture -> timeline -> ask with sources -> reflect -> review decisions
Package name
The PyPI distribution is waymark-memory because waymark is already used
by another package. The installed command remains waymark.
Install¶
Install Waymark with pipx:
py -m pip install --user pipx
py -m pipx ensurepath
py -m pipx install waymark-memory
waymark --version
brew install pipx
pipx ensurepath
pipx install waymark-memory
waymark --version
python3 -m pip install --user pipx
python3 -m pipx ensurepath
python3 -m pipx install waymark-memory
waymark --version
You can also install the latest GitHub Release wheel directly:
python -m pip install https://github.com/shusingh/waymark/releases/download/v0.3.1/waymark_memory-0.3.1-py3-none-any.whl
First minute¶
waymark today
waymark capture --type project "Shipped the first import flow today."
waymark timeline
waymark ask "import flow"
waymark reflect --period week
What Waymark Does¶
Daily loop
See what needs attention today: new capture, due reflection, or decision review.
Grounded recall
Ask questions over saved memories and imported sources with visible citations.
Decisions
Track choices, review dates, outcomes, and the memories that informed them.
Portability
Back up and restore your local memory trail without sending it to a service.
Local-First Rules¶
- Data is stored under your Waymark home in a local SQLite database.
- Manual capture works without AI models.
- Local AI is opt-in and uses your own Ollama installation.
- Folders are never scanned without an explicit command.
- Generated answers must cite saved memories or imported sources.
Continue with Getting Started or the Installation guide.