Skip to content

stormlightlabs/noteleaf

Repository files navigation

Noteleaf

codecov Go Report Card License Go Version

                                    ,,                       ,...
`7MN.   `7MF'         mm          `7MM                     .d' ""
  MMN.    M           MM            MM                     dM`
  M YMb   M  ,pW"Wq.mmMMmm .gP"Ya   MM  .gP"Ya   ,6"Yb.   mMMmm
  M  `MN. M 6W'   `Wb MM  ,M'   Yb  MM ,M'   Yb 8)   MM    MM
  M   `MM.M 8M     M8 MM  8M""""""  MM 8M""""""  ,pm9MM    MM
  M     YMM YA.   ,A9 MM  YM.    ,  MM YM.    , 8M   MM    MM
.JML.    YM  `Ybmd9'  `Mbmo`Mbmmd'.JMML.`Mbmmd' `Moo9^Yo..JMML.

Noteleaf is a unified personal productivity CLI that combines task management, note-taking, and media tracking in one place. It provides TaskWarrior-inspired task management with additional support for notes, articles, books, movies, and TV shows - all built with Golang & Charm.sh libs. Inspired by TaskWarrior & todo.txt CLI applications.

Why?

  • Fragmented productivity tools: Instead of juggling multiple apps for tasks, notes, reading lists, and media queues, Noteleaf provides a single CLI interface
  • Terminal-native workflow: For developers and power users who prefer staying in the terminal, Noteleaf offers rich TUIs without leaving your command line
    • Lightweight and fast: No desktop apps or web interfaces - just a fast, focused CLI tool
  • Unified data model: Tasks, notes, and media items can reference each other, creating a connected knowledge and productivity system

Getting started

Prerequisites

Go v1.24+

Installation

git clone https://github.com/stormlightlabs/noteleaf
cd noteleaf
go build -o ./tmp/noteleaf ./cmd
go install

Basic usage

# Initialize the application
noteleaf setup

# Add sample data for exploration
noteleaf setup seed

# Create your first task
noteleaf task add "Learn Noteleaf CLI"

# View tasks
noteleaf task list

# Create a note
noteleaf note add "My first note"

# Add a book to your reading list
noteleaf media book add "The Name of the Wind"

Status

Status: Work in Progress (MVP completed)

Completed

Core functionality is complete and stable:

  • Task management with projects and tags
  • Note-taking system
  • Article parsing from URLs
  • Media tracking (books, movies, TV shows)

Planned

  • Time tracking integration
  • Advanced search and filtering
  • Export/import functionality
  • Plugin system

About

Organize your life through the command-line

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages