dvorka/mindforger

Thinking notebook and Markdown editor with LLM wingman.

Thinking Notebook & Markdown Editor

Are you drowning in information, but starving for knowledge? Where do you keep your private remarks like ideas, personal plans, gift tips, how-tos, dreams, business vision, finance strategy, auto coaching notes? Loads of documents, sketches and remarks spread around the file system, cloud, web and Post-it notes? Are you afraid of your knowledge privacy? Are you able to find them once you create them? Do you know how are they mutually related when you read or write them? No?

https://www.mindforger.com

Thinking Notebook

MindForger is human mind inspired personal knowledge management tool.

Markdown Editor

MindForger is open, free, well performing Markdown editor / IDE which respects your privacy.

Features

MindForger features overview: open, free, OpenAI GPT integrated, knowledge manager, Markdown editor (math, diagrams, images, table of contents generator), outliner, spell-check, Markdown IDE (multi-document workspace, section refactoring, cloning, scopes and stencils), organizer (Eisenhower matrix, Kanban), knowledge graph navigator, knowledge autolinking, think as you browse, think as you write, find by name/tag/text/regexp, find similar sections (associations), tagging, emojis, checklists, recent sections, external section editor, themes, internationalization, export (CSV with OHE for machine learning, HTML) and import (TWiki).

Installation

Install:

• macOS
• Windows
• Ubuntu
• Debian
• Fedora
• FreeBSD
• Arch Linux
• NixOS
• openSUSE
• WSL

Build:

• build on macOS
• build on Windows
• build on Ubuntu
• build on Debian
• build on Fedora
• build on Gentoo
• build on NixOS
• build on WSL

Docker:

• build and run container

Tarball:

• download tarball

Nightly builds:

• macOS .dmg nightly
• Windows installer nightly
• tarball nightly

Check also packages for Linux and Unix.

Documentation

Read:

• Getting started
• Installation
• User documentation
• Developer documentation
• Project history
• FAQs

Watch:

• YouTube tutorials

Check:

• man mindforger

In the News

Read about MindForger on FOSSMint, Fedora Magazine, UbuntuPIT, AppImageHub, AwesomeOpenSource, root.cz (2024) and MOONGIFT.jp.

Bugs and Feature Requests

https://github.com/dvorka/mindforger/issues

mindforger's Issues

Delete (current) Outline

O can be deleted when O tree view is opened.

Edit O

Edit O name and metada in UI.

Outline w/ 1 note: unable to select note

The problem is that if note is selected, it cannot be selected again and right panel w/ note is NOT refreshed.

Outline header click to steal focus from note tree OR handled event must be changed from "selection changed" to row clicked or similar.

N edit: name & metadata M/S/C buttons

Edit name and tags + layout.

Lib memleak when deleting O

Use Valgrind to correctly dealocate deleted O.

Reads and Read metadata fields optimization

Think up how to handle these two fields (possible configurable from Configuration) as it means writing O/N on read, perhaps doing it very lazy on dream time, ...

Find O by name - listview NOT sorted

Ensure quoting of # within saved Note

Enhancement of the save to avoid killing of section w/ codes (# allowed only in code block).

Note table: add Done column

[code quality] MaFry trainer Git repository

Use git repo to experiment with copy/move/return ref/*/unique_ptr and other language features (C++, Qt, ...) to improve MF code performance and code quality.

Warn dialog WHENEVER leaving N in edit mode i.e. when current facet is EDIT N

Create a generic method for this.

Find N by Name dialog

• make CLI undocumented feature
• introduce dialog
• when O opened then search Ns within O, when on all Os do search Ns of all Os i.e. scope (might be checkbox)
• case in/sensitive

[S7 only] Find O/N by name/FTS - QLineEdit doesn't get focus

The problem is reproducible on older dev environment only. It works perfectly on Beast.

[DISTRO] Ubuntu PPA @ Launchpad

Steps:

• remind bazaar, create manually new bzr project, upload it to lp
• create Qt hello world in bzr project
• customize hh scripts to build (trick is in using qmake to create makefile and then passing it to the standard pipeline) and release qt hello via lp
• replace hello w/ MF (copy & delete everything what's not needed)
• release MF via LP
• VirtualBox - create clean Ubuntu 16.04 installation
• VirtualBox - backup clean snapshot and clone working snapshot
• VirtualBox install MF to working snapshot

Suggestions:

• create MD file in MF: packaging-for-ubuntu.md
• name scripts: launchpad-...sh

Inspiration:

• https://ubuntuforums.org/showthread.php?t=1642956
• https://github.com/keepassx/keepassx

After edit N, new note CANNOT be created (orloj view check failed)

UNIT: create O from Ns > assert

Load from GitHub URL

Ability to load MD repo from GitHub. Is there any real value in this enhancement?

UNIT: fix test touching test data in Git

Redirect it to /tmp - impacted file ../lib/test/resources/basic-repository/memory/outline.md

Edit N: multiple tags

Handle more than just primary tag.

BROKEN Os since 17/12/5 > fix all MDs & fix parser

Review all commits in personal repository + rescue lost content + fix parser (create unit tests ensuring this will NOT happen). If MD is simply wrong, ensure such construction cannot be done in editor i.e. quoting of # and other key terminals.

Outline's note tree: de-select row on view leave

... or handle up/down keys in a different way: orloj should NOT propagate it from Outlines facet to Outline facet.

[codereview] Qt frontend for memory leaks

While backend is covered by unit test w/ Valgrind, frontend (both architecture and implementation) needs additional effort to ensure it's leak-free:

• Qt component hierarchy inspector
• valgrind

Menu/MF/Learn repository

Add find directory dialog to open a MF repository + add MF repository detection method to Memory.

Render WHOLE O (not N by N) by clicking Whole... @ Header page

Find O by Name dialog

• make CLI undocumented feature
• introduce dialog
• case in/sensitive

MD parser/serializer: deadline + UNIT

Unable to delete N

When using Alt-N F it's OK (as N is clicked in the tree), but if I click to menu, then it fails (it's clear - no note selected in the tree). Fix it by: if null in the tree, then use current N from view-note to be deleted.

MD parser: skip preamble and keep it for save (and edit) + UNIT

Skip leading (junk). Test it e.g. on Apiary blueprints (https://help.apiary.io/api_101/api_blueprint_tutorial/).

Alt-Left to work when view N, but note tree doesn't have focus

Add key handler to note viewer.

Support non-MF repos: no metadata show/edit/save

Edit N dialog: deadline handling w/ calendar + time

Fix CORE @ minforger directory or mindforger file

If it's directory, check whether it's MF repository and load it (even if w/o -r), if it's file then exit, but don't crash.

Emacs level syntax highlighting @ editor

My black theme - 1:1 look.

Consider Configuration as Singleton

Determine the best option for Configuration class design. It's needed everywhere (both frontend and backend), it contains information from file paths to element colors. Does it make sense to propagate it through presenters to all instances? Does it make sense to set it to views? What about to set it to MAIN presenter and MAIN view and allow presenters/views to navigate to the MAIN and get it there? Don't forget about widgets and dialogs (sub view granularity) - even these entities may need Configuration.

On singleton in C++ https://stackoverflow.com/questions/1008019/c-singleton-design-pattern

Outline tree: Rs cannot be < Ws

Update both metadata - fix in lib.

Rename i18n outline test data

New Note

Dialog and N creation + child: first/last.

Note TS not updated on save

TS not refreshed in Outline's tree of Notes.

QLayout: Attempting to add QLayout "" to m8r::MainWindowView "", which already has a layout

MD parser: multiline section support

Keep a hint to save section in proper style - either # or === style.

FTS/find N: select note in N tree on its opening > NotePicker code

• FTS note
• find N (global OR O scope)

On new N: open it in EDIT mode

Edit N

Edit N name and metada in UI.

Outline file location @ metadata

Edit O dialog should indicate where to find particular O file (user knows where to find/edit).

Delete (current) Note

N can be deleted when viewed or edited.

[codereview] malloc/free > stack or new/delete

Ensure m/f is not used on the backend.

FTS dialog

• make CLI undocumented feature
• introduce dialog
• FTS when O open within O, when on Os all Os searched i.e. scope (might be checkbox)

[test] Unit test(s) for Color class

FTS search scoped by O

When an O opened, FTS only that O, not all Os.

memory/howto.md BROKEN on load/save

It might be structure fault - # where they should NOT be i.e. either parser must be fixed OR text in that outline fixed (is big 400k).