MemoryNoteCLI
UtilityFeaturedCapture thoughts and snippets instantly, local-first, beautiful UI.
Installation
git clone https://github.com/mdwcoder/MemoryNoteCLI.git && cd MemoryNoteCLI && ./init.shDocumentation
MemoryNoteCLI
MemoryNoteCLI is a robust, local-first command-line tool designed for developers who need to capture thoughts, code snippets, and tasks instantly without leaving the terminal.
Built with Python, Typer, and Rich, it offers a beautiful terminal interface, optional Age/SSH-based encryption for privacy, and a serverless Web View for reviewing notes in a browser. It stores data locally in SQLite, ensuring your notes are always yours, fast to access, and never lost in the cloud.
🚀 Installation
Linux / macOS
We provide an init.sh script (located in the repo) for automatic installation and shell integration.
git clone https://github.com/Antigravity/MemoryNoteCLI.git
cd MemoryNoteCLI
./init.sh
Restart your terminal or run source ~/.bashrc (or ~/.zshrc) to start using mmcli.
Windows (PowerShell)
You can install using the provided PowerShell script which sets up the environment and profile alias.
git clone https://github.com/Antigravity/MemoryNoteCLI.git
cd MemoryNoteCLI
.\scripts\install.ps1
Restart your PowerShell session to use mmcli.
⚡ Quick Start
1. Save a quick note
mmcli ideas "Refactor the authentication module using JWT"
2. Save from Clipboard
# Copies text currently in your clipboard
mmcli clipboard snippets --tags "code,python"
3. Write a long note (opens EDITOR)
mmcli large architecture
4. List and Search
mmcli list # Show recent notes (short preview)
mmcli list --long # Show full content
mmcli search "auth" # Search text
mmcli search --tag python # Filter by tag
5. Pin and Organize
mmcli pin 14 # Pin note #14 to top
mmcli tag add 14 urgent # Add tag 'urgent'
mmcli list --pinned # View only pinned notes
6. Share / Move
mmcli copy 14 # Copy note content to clipboard
mmcli export -o backup.json # Export all notes to JSON
7. Visual Review
mmcli web-view # Generates a beautiful HTML view (no server needed)
📖 Commands
| Command | Description | Usage |
|---|---|---|
mmcli <cat> <text> | Save a quick note | mmcli dev "Fix bug" |
mmcli list | List recent notes | mmcli list |
mmcli search <q> | Search notes | mmcli search "api" |
mmcli show <id> | Show full note details | mmcli show 5 |
mmcli large <cat> | Create note in $EDITOR | mmcli large docs |
mmcli clipboard <cat> | Save from clipboard | mmcli clipboard code |
mmcli delete <id> | Delete a note | mmcli delete 5 |
mmcli pin <id> | Pin a note to top | mmcli pin 5 |
mmcli unpin <id> | Unpin a note | mmcli unpin 5 |
mmcli tag add | Add tag to note | mmcli tag add 5 Work |
mmcli tag remove | Remove tag | mmcli tag remove 5 Work |
mmcli copy <id> | Copy note to clipboard | mmcli copy 5 |
mmcli export | Export notes to JSON | mmcli export -o notes.json |
mmcli import | Import notes from JSON | mmcli import notes.json |
mmcli web-view | Open read-only web view | mmcli web-view |
mmcli config | View/Set config | mmcli config set theme cyberpunk |
mmcli doctor | Check system health | mmcli doctor |
⚙️ Configuration
Configuration is stored in ~/.memorynote/config.json. You can modify it via mmcli config.
Themes
Change the visual style of the CLI.
mmcli config set theme cyberpunk # Options: minimal, terminal, cyberpunk, macos
Note Size Limit
Default limit is 16KB.
mmcli config set max_note_bytes 32000
🔒 Encryption
MemoryNoteCLI supports Age encryption using SSH keys (ed25519).
Prerequisites:
agetool must be installed (brew install ageorapt install age).
Setup:
mmcli encryption enable
# Follow the prompts to use an existing SSH key or generate a new one.
Effect:
- New notes will be valid Age ciphertext in the database.
mmcli list/showwill auto-decrypt if keys are available.- Web View will NOT display encrypted content (shows "Encrypted Content" placeholder) for security.
Disable:
mmcli encryption disable
# Disables encryption for NEW notes. Old notes remain encrypted.
🌐 Web View
The web-view command generates a static, self-contained HTML file and opens it in your default browser.
- Serverless: No process runs in the background.
- Features: Filtering by Category/Tag, Copy button, Pinned notes highlighted.
- Security: The file is temporary. Encrypted notes are safe (not rendered).
🔧 Troubleshooting
mmcli: command not found
Ensure you ran init.sh and accepted the shell integration. Check your ~/.bashrc or ~/.zshrc for the alias mmcli=... line.
Clipboard issues (Linux)
If mmcli clipboard or copy fails, install xclip or wl-clipboard.
sudo apt install xclip # or wl-clipboard
Encryption errors
Run mmcli doctor to verify age installation and key detection. Ensure your SSH agent or key path is correct.
Editor not opening
mmcli large uses $EDITOR or $VISUAL.
export EDITOR=nano # Add to your shell profile
Project finalized v1.1 - 2026