Skip to content

mrbandler/flow

Flow

Thoughts captured. Focus unbroken.

Built with Rust License: AGPL-3 CI codecov

A developer-first, outliner-based note-taking tool that stays out of your way

Documentation · Roadmap · Contributing


You're deep in your work. An idea surfaces.

Most note apps make you stop what you're doing: open the app, find the right place, format it properly. By the time you're done, your train of thought is derailed.

Flow is different.

flow capture "Research CRDT sync options for offline-first #idea"

# Done. Back to work.

Your thought is captured. Your momentum continues. Find it later when you need it.


Why Flow?

  • Local-First — Your data stays on your machine, in plain Markdown
  • Outliner-First — Think in bullets, expand to prose when needed
  • Developer-Friendly — CLI-native, scriptable, fits your terminal workflow
  • No Lock-In — Your notes are just files, take them anywhere

What You Get

Component Description
CLI Quick capture and search from your terminal
TUI Full-featured terminal interface
GUI Native desktop app for longer sessions
Server Self-hosted sync across devices

Mix and match — use only what you need.

Quick Example

- Project X #project
  status:: 🟩 Active
  - Architecture decisions
    - Use microservices for scalability
    - [[PostgreSQL]] for main DB
  - Tasks
    - [ ] Set up CI/CD pipeline #task
    - [ ] Write API documentation #task

Every bullet is a node. Add tags to create objects you can query and connect across your knowledge graph.

Roadmap

⚠️ Flow is in early development. Star and watch to follow progress!

  • Project structure and architecture
  • Core storage layer (Markdown + Loro CRDT)
  • CLI integration
  • TUI interface
  • GUI application
  • Sync server

Getting Started

# Coming soon — Flow is in active development
# Star the repo to get notified when it's ready!

📖 Read the documentation for more details.

Contributing

Contributions are welcome! Please read the Contributing Guide to get started.

Inspiration

Flow draws inspiration from Logseq, Tana, Obsidian, Roam Research, and jrnl — combining the best of outliners, knowledge graphs, and CLI simplicity.

License

AGPL-3.0


⭐ Star this repo if you're excited about Flow!

Releases

No releases published

Contributors 2

  •  
  •