bronotes 1.8.1

A commandline note organization tool.

Bronotes

Basically a wrapper to access notes in a directory on your system anywhere from the commandline. And keep it in sync with git.

Functionality so far:

• Create a note directory on your system on first start
• Add new notes
• Remove notes
• Move notes and directories around
• Edit notes with your $EDITOR
• List notes dir in a tree
• Generate autocompletions for zsh
• Sync with git
• The show and edit actions search for matching notes if no valid path is given

Installation

$ pip install bronotes

On first command a folder to be used is asked.

Completions

For now there's no built-in completions. ZSH completions can be generated so you can place them where needed:

$ bnote completions | tee ~/.oh-my-zsh/completions/_BRONOTES

Usage

By default this wraps any shell command you feed it and executes it in your notes directory. When using any of the defined actions (see bnote -h) it will do that instead. The default can be changed, and the regular shell alternatives for actions like 'rm' can be used by just using the 'exec' action manually.

$ bnote -h
usage: bnote [-h] action ...

positional arguments:
  action       Bronote actions.
    add        Add a note or directory.
    rm         Delete a note or directory.
    list       Show the notes structure as a tree.
    edit       Edit a note.
    mv         Move a note or directory.
    set        Set config options.
    completions
               Generate zsh autocompletions.
    show       Show the contents of a note.
    sync       Sync the notes dir with git.

optional arguments:
  -h, --help   show this help message and exit

• Subcommands have their own help pages.
• When using the edit or show subcommand, it falls back on the -s option if the path to your note is not valid.
• If the first argument given is not recognized by bronotes, a default action will be taken and the first argument will be fed to that action instead. This is configurable with the 'set' action and defaults to 'list'

Git

You can use the sync command to keep a repo in sync with git. Using basic pull/push on master. If you want to have more control simply don't use this. If the repo isn't a git repo yet you will be asked to initialize an empty one and set up remotes. When quit halfway through this process it's probably better to either start over or just fix it manually.

Autosyncing is possible, but will do so after every edit or add action. So figure out if you want that yourself.