notes

A fast CLI for capturing thoughts, viewing daily notes, and searching memory.

Designed for the OpenClaw memory folder structure, but works with any markdown notes directory.

Installation

# Clone the repo
git clone https://git.lucataco.dev/Catacolabs/notes-cli.git
cd notes-cli

# Install to ~/.local/bin
chmod +x notes
cp notes ~/.local/bin/

# Or symlink
ln -sf $(pwd)/notes ~/.local/bin/notes

Make sure ~/.local/bin is in your PATH.

Usage

Quick Capture

# Add a thought (with timestamp header)
notes "Just read an interesting paper on RAG optimization"

# Add a bullet point (no timestamp)
notes -b "TODO: review the draft"

View Notes

# Today's notes
notes

# Yesterday's notes
notes yesterday

# Specific date
notes 2026-02-05

# This week's overview
notes week

# Last 10 lines of today
notes tail
notes tail 20

Search & Browse

# Search across all notes
notes search "DGX Spark"

# List all memory files
notes list

# Statistics
notes stats

Edit

# Open today's notes in $EDITOR
notes edit

# Open specific file
notes open overnight-build

Sample Output

📝 Notes for 2026-02-08

# 2026-02-08 — Daily Notes

## 09:15

Meeting with team about content pipeline. Key points:
- Need better scheduling for tweets
- Quill handling drafts, Fury on research

## 14:30

Found interesting llama.cpp optimization flags for Spark.

📅 This Week's Notes

2026-02-08 (Saturday) — 12 lines
2026-02-07 (Friday) — 45 lines
2026-02-06 (Thursday) — no notes
2026-02-05 (Wednesday) — 28 lines
2026-02-04 (Tuesday) — 33 lines
2026-02-03 (Monday) — 15 lines
2026-02-02 (Sunday) — 67 lines

Environment Variables

Variable	Default	Description
NOTES_DIR	~/.openclaw/workspace-main/memory	Directory for notes
EDITOR	nano	Editor for notes edit

File Format

Daily notes are stored as YYYY-MM-DD.md with this structure:

# 2026-02-08 — Daily Notes

## 09:15

First note of the day.

## 14:30

Another note with a timestamp.

- Bullet points work too
- They don't get timestamp headers

Part of the CLI Toolkit

Tool	Purpose
notes	Quick capture and memory search
mc	Mission Control CLI
spark	DGX Spark llama.cpp interaction
newrepo	Forgejo project bootstrapping

---

Built during a 3am overnight session by Navi ✨