keepnote 3.0: What's New
Dual search modes, git sync, and better workflows for the fastest note-taking CLI.
keepnote is a CLI tool for instant note-taking with plain text files. If you’re new here, read the intro post for the full story.
Version 3.0 adds features that make it even faster to capture and find your notes.
What’s New
Dual Search Modes
Search by filename or file content - toggle with Tab.
knType to filter. Press Tab to switch between modes. The search adapts instantly.
Why? Sometimes you remember the note title. Sometimes you remember a phrase inside. Now you can search both ways without leaving the tool.
Git Status in Search
Git status appears at the top of your search, color-coded:
- Green: clean working directory
- Yellow: modified or untracked files with counts
Know what’s changed before you even open a note.
Delete Notes with Ctrl+D
Press Ctrl+D while browsing to delete a note. No need to exit the search interface.
Quick cleanup without breaking your flow.
Git Sync Built-In
One command to backup your notes.
keepnote syncCommits all changes and pushes to your git remote with a timestamped message. No manual git commands needed.
Shows what will run (commit, push, or both) and asks for confirmation. Smart enough to handle different scenarios.
First time? keepnote shows you how to initialize the repository. After that, it’s one command to sync.
Why? Your notes are plain text files - they belong in version control. Manual commits are friction. This removes the friction.
Run Git Commands Anywhere
keepnote git <command>Run any git command in your notes directory from anywhere. keepnote git status, keepnote git log, keepnote git diff - all work regardless of your current directory.
Why? Notes live in ~/notes but you’re working in ~/projects/foo. No need to cd back and forth.
Opens at Matched Line
Search results open your editor at the exact matched line. Jump straight to what you were looking for.
This worked in previous versions too, but now with dual search modes, it’s even more powerful - whether you matched a filename or content, you land exactly where you need to be.
The Same Philosophy
Plain text files. Battle-tested CLI tools (ripgrep, fzf, bat). No lock-in. No complexity.
Just faster workflows for the things you do every day: create, search, sync.