Skip to content

zenobi-us/opennotes

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

OpenNotes

OpenNotes Banner

A simple, fast, and powerful CLI tool for managing your markdown notes. OpenNotes helps you organize, search, and manage your thoughts without leaving the terminal.

Features

  • Notebook Storage: choose where you want the notes stored, here in your repo, there in your home directory, or anywhere else on your filesystem.
  • Create, list, search, and view notes from the command line.
  • Associate default metadata based on groups or folders.
  • Preset queries: Kanban, Daily Notes, Tags, and more
  • Advanced SQL search powered by DuckDB

Installation

go install github.com/zenobi-us/opennotes@latest

Requires Go 1.24+

Quick Start

Get started in seconds:

  1. Initialize a notebook in your current directory:

    opennotes init
  2. Create your first note:

    opennotes notes add "My First Idea"
  3. List your notes:

    opennotes notes list
  4. Search your notes:

    opennotes notes search "Idea"

Common Commands

Creating Notes

Create a new note with a title. You can also specify a path if you want to organize notes into folders.

# Create a note in the root
opennotes notes add "Meeting Notes"

# Create a note in a subfolder
opennotes notes add "Project Specs" projects/

Listing Notes

See all your notes in the current notebook.

opennotes notes list

Searching Notes

Find notes instantly by keyword.

opennotes notes search "important"

Views

Opennotes supports various preset views to help you organize and visualize your notes.

Output is JSON by default.

# view all available views
opennotes notes view

# display notes in kanban view
opennotes notes view kanban

Configuration

OpenNotes works out of the box, but you can customize it.

Global configuration is stored in:

  • Linux: ~/.config/opennotes/config.json
  • macOS: ~/Library/Preferences/opennotes/config.json
  • Windows: %APPDATA%\opennotes\config.json

Advanced Usage

OpenNotes is built on DuckDB, allowing for powerful SQL querying, automation, and complex data extraction for power users.

For advanced features like SQL search, JSON output for automation, and multi-notebook management, please see our Advanced Documentation.

About

No description, website, or topics provided.

Resources

License

Contributing

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •  

Languages