Superseded. This Python version has been replaced by a from-scratch Go rewrite: i-am-fran/bearkit — same features, single-binary, zero-runtime-dependency distribution. This repo is kept for history only.
A companion tool for Bear notes. It checks and fixes common Markdown inconsistencies, finds orphaned/duplicate/dangling-linked notes, and can open random notes for review — all by reading and writing your notes directly via bearcli.
- Lint & auto-fix — standardises bullets, checklists, bold/italic markers, heading spacing, horizontal rules, curly quotes, trailing whitespace, and more across every note
- Orphans — finds notes that nothing else links to
- Duplicates — finds notes that share the same title
- Wikilinks — finds
[[wikilinks]]pointing to notes that don't exist, and can mark them in place - Random — opens random notes in Bear for review
- Every write goes through
bearcliwith tag-scoping, dry-run previews, and a confirmation prompt before anything destructive happens
- macOS with Bear 2.8 or later installed
- Python 3.8+ (pre-installed on macOS)
git clone https://github.com/i-am-fran/bearkit.gitThen make it runnable as bearkit from anywhere. Pick one:
Alias (add to ~/.zshrc):
alias bearkit='python3 /path/to/bearkit/bearkit.py'Symlink (makes it a first-class command on your PATH):
chmod +x /path/to/bearkit/bearkit.py
ln -s /path/to/bearkit/bearkit.py /usr/local/bin/bearkitAfter either, reload your shell and bearkit --help will work.
i-am-fran.github.io/bearkit — every command, flag, lint rule, and safety note.
Found a bug or have a feature request? Open a GitHub issue — pull requests aren't accepted, but issue reports are very welcome.
MIT, see LICENSE.