A local-first, Vim-modal note editor for networked thinking.

Bloom is a keyboard-driven note editor built in Rust. Your notes stay as plain Markdown on disk, linked with stable IDs, indexed locally with SQLite, and owned entirely by you. Think Obsidian's linking model with Neovim's editing feel and Doom Emacs' discoverability.

• Full Vim grammar — [count][operator][motion/text-object] with Normal, Insert, Visual, and Command modes
• Bloom-specific text objects — il/al (links), i#/a# (tags), i@/a@ (timestamps), ih/ah (headings)
• Branching undo tree — never lose an edit path
• Word wrap — visual wrapping with ↪ continuation indicators
• Inline completion — [[ triggers the page-link picker, # triggers tag completion

• Fuzzy picker — find pages, search full text, browse tags, backlinks, and unlinked mentions
• Full-text search — FTS5-backed search with line-level previews
• Which-key discoverability — press Space and see what is available
• Link following — [[page|display]] links resolve instantly via the local index
• Timeline — chronological context for the page you are in

• Bloom Markdown — standard Markdown plus [[wiki-links]], #tags, @due(...), and block IDs
• Daily journal — one page per day, with quick capture from anywhere
• Agenda view — overdue, today, and upcoming tasks across the vault
• Templates — tab stops, placeholder mirroring, and magic variables like ${AUTO} and ${DATE}
• Refactoring — move blocks and pages without turning links into dead text

• Window splits — binary splits with resize, swap, rotate, maximize, and spatial navigation
• 12 built-in themes — dark and light palettes with strong semantic contrast
• Adaptive layout — picker density and preview width adapt to the available space
• Session restore — layout, open panes, cursors, and scroll offsets survive restart

• Event-driven core — no busy polling while idle
• In-editor diagnostics — notifications, :messages, :log, and :stats
• Local-only by default — no network calls; MCP integration is optional and explicit
• Desktop GUI — shipped through the bloom-gui frontend and installed as bloom

curl -fsSL https://raw.githubusercontent.com/hindol/Bloom/main/install.sh | sh

irm https://raw.githubusercontent.com/hindol/Bloom/main/install.ps1 | iex

The install scripts place the app on your PATH as bloom.

Requires Rust 1.75+:

git clone https://github.com/hindol/Bloom.git
cd Bloom
cargo run --release -p bloom-gui

On first launch, Bloom opens a setup wizard to create or import a vault.

See docs/KEYBINDINGS.md for the full reference.

Benchmarked on a 10,365-page vault (24 MB of Markdown), Windows 11, NVMe SSD:

12 built-in themes, selectable with SPC T t and previewed live while you move through the picker.

Dark: Bloom Dark, Aurora, Ember, Twilight, Verdant, Ink

Light: Bloom Light, Frost, Solarium, Sakura, Lichen, Paper

All themes share a semantic palette model rather than per-screen color hacks. See docs/THEMING.md.

Bloom stores configuration in config.toml at the vault root. The checked-in template is comment-rich, versioned, and migrated forward when new keys are introduced.

config_version = 1

[startup]
mode = "journal"

autosave_debounce_ms = 300
which_key_timeout_ms = 500
scrolloff = 3
word_wrap = true
wrap_indicator = "↪"
auto_align = "page"

[theme]
name = "bloom-dark"

See docs/FILE_FORMAT.md for Bloom Markdown and config details.

crates/
├── bloom-core/          # Core editor, parser, index, views, history, themes
├── bloom-gui/           # Iced desktop frontend
├── bloom-mcp/           # MCP server for local LLM workflows
├── bloom-import/        # Logseq vault importer
└── bloom-test-harness/  # SimInput / e2e infrastructure

Future and exploratory work lives under docs/planning/.

For contributor workflow and doc-first development policy, see docs/AGENT_WORKFLOW.md.

API documentation: hindol.github.io/Bloom/bloom_core

1. Fork the repo and create a branch.
2. Make focused changes.
3. Run cargo test --workspace && cargo clippy --workspace && cargo fmt --all -- --check.
4. Open a pull request.

The docs in docs/ describe the current editor. The docs in docs/planning/ are where future work belongs.

Bloom is licensed under the GNU Affero General Public License v3.0.