notes - Manage notes with ease from the command-line using your $EDITOR.

Notes is a powerful and efficient command-line application for managing notes. Designed for developers and command-line enthusiasts, it offers a range of features to create, search, and organize your notes seamlessly.

• Create named or scratch notes fast
• Search and filter notes and pipe the results elsewhere
• Create notes from templates (i.e. forms)
• Use inclusion/exclusion terms to search notes and open them
• Create and execute saved searches
• Support for Zettelkasten personal knowledge management
• Support for backlinking

You have notes that you want to create and edit with your $EDITOR and keep organized at the command-line.

1. Create a directory for your notes:

   mkdir journal

2. Change the directory:

   cd journal

3. Initialize a new Notes project:

   notes init

4. Create a new note:

   notes new

5. List the notes created so far:

   notes list

1. Clone the repository:

   git clone /path/to/notes.git

2. Make the script executable:

   chmod +x notes/notes

3. Add the directory to the PATH environment variable:

   PATH="$PATH:$PWD/notes"

The following are common usage examples:

Find backlinks for the PATH provided.

notes back PATH

Example:

notes back /path/to/notes/file.txt

Change the notes base (i.e. the base path).

notes base PATH

Example:

notes base /path/to/notes

Print the environment variables.

notes conf

Examples:

notes conf

Open filtered list of files based on the filter EXPR provided.

notes edit EXPR

Examples:

notes edit home
notes edit release

Execute a function handler using the NAME provided.

notes exec NAME

Example:

notes exec archive

Create a new note and print the filename. Optionally providing a filename.

notes file [NAME]

Examples:

notes file
notes file todo

Find notes matching the terms provided and print the filename(s).

notes find TERM [TERM, ...]

Examples:

notes find release
notes find release 0.0.1

Create a new note using the FORM provided. Optionally providing a filename.

notes for FORM [NAME]

Examples:

notes for release
notes for release release-0.0.1

Create a note form (i.e. template) using the NAME provided.

notes form NAME

Example:

notes form release

Create a function handler using the NAME provided.

notes func NAME

Example:

notes func archive

Find notes matching the terms provided and print matches using grep.

notes grep TERM [TERM, ...]

Examples:

notes grep release
notes grep release 0.0.1

Create a runtime hook using the NAME provided.

notes hook NAME

Example:

notes hook vars

Initialize the notes repository.

notes init

Examples:

notes init

Print relative file path for the FILE provided.

notes link PATH

Example:

notes link /path/to/notes/file.txt

List all notes and forms (i.e. templates). Optionally providing a filter EXPR.

notes list [EXPR]

Examples:

notes list
notes list release

Edit your default note.

notes main

Example:

notes main

Create a new note and launch the EDITOR. Optionally providing a filename.

notes new [NAME]

Examples:

notes new
notes new todo

Find notes matching the terms provided and open the file(s) in the EDITOR.

notes open TERM [TERM, ...]

Examples:

notes open release
notes open release 0.0.1

Change the notes path for notes.

notes path PATH

Example:

notes path /path/to/notes/.notes

Open a single random note. Optionally providing a filter EXPR.

notes rand [EXPR]

Examples:

notes rand
notes rand release

Change the notes root path name (i.e. under the base).

notes root NAME

Example:

notes root .notes

Find notes matching the terms provided and print the results and filename(s).

notes search TERM [TERM, ...]

Examples:

notes search release
notes search release 0.0.1

Change the notes type (i.e. the file suffix).

notes type NAME

Example:

notes type md

Create and execute saved searches using the NAME provided.

notes view NAME [TERM, ...]

Examples:

notes view releases
notes view releases release 0.0.1

Find backlinks for the PATH provided and open the file(s) in the EDITOR.

notes with PATH

Example:

notes with /path/to/notes/file.txt

This application supports searching through notes using inclusion and exclusion terms. Use of inclusion and exclusion terms are supported by find, open, search, and view commands.

By default, any term provided, not prefixed, will be treated as an inclusion term.

Example:

notes search release

Any term provided that is prefixed with a + symbol, will be treated as an inclusion term. Notes containing the term will be included in the results.

Example:

notes search +release

Any term provided that is prefixed with a - symbol, will be treated as an exclusion term. Notes containing the term will be excluded from the results.

Example:

notes search -release

The following are overridable environment variables:

The NOTES_BASE variable is the filepath for the parent directory of the notes folder where all notes will be stored, and defaults to $PWD.

Example:

export NOTES_BASE=$HOME

The NOTES_INIT variable is the fully-qualified filepath for the initial (or bootstrapping) notes directory, and defaults to $PWD/.notes. This directory is checked for pre-processing hooks before executing the program.

Example:

export NOTES_INIT=$PWD/.notes

The NOTES_MAIN variable is the filename of the "main" note used by the notes main command, and defaults to main.

Example:

export NOTES_MAIN=index

The NOTES_PATH variable is the fully-qualified filepath for the notes directory, and defaults to $NOTES_BASE/$NOTES_ROOT.

Example:

export NOTES_PATH=$HOME/notes

The NOTES_ROOT variable is the directory name of the notes folder, and defaults to .notes.

Example:

export NOTES_ROOT=notes

The NOTES_TYPE variable is the file suffix used when operating on notes, and defaults to txt.

Example:

export NOTES_TYPE=md

Contributions are welcome! Please fork the repository and submit a pull request.

This project is licensed under the MIT License. See the LICENSE file for details.

Manage your notes with ease using notes.