cli + tui to publish to leaflet (wip) & manage tasks, notes & watch/read lists 馃崈
charm
leaflet
readability
golang
1# Noteleaf
2
3[](https://codecov.io/gh/stormlightlabs/noteleaf)
4[](https://goreportcard.com/report/github.com/stormlightlabs/noteleaf)
5[](LICENSE)
6[](go.mod)
7
8```sh
9 ,, ,...
10`7MN. `7MF' mm `7MM .d' ""
11 MMN. M MM MM dM`
12 M YMb M ,pW"Wq.mmMMmm .gP"Ya MM .gP"Ya ,6"Yb. mMMmm
13 M `MN. M 6W' `Wb MM ,M' Yb MM ,M' Yb 8) MM MM
14 M `MM.M 8M M8 MM 8M"""""" MM 8M"""""" ,pm9MM MM
15 M YMM YA. ,A9 MM YM. , MM YM. , 8M MM MM
16.JML. YM `Ybmd9' `Mbmo`Mbmmd'.JMML.`Mbmmd' `Moo9^Yo..JMML.
17```
18
19Noteleaf is a unified personal productivity CLI that combines task management, note-taking, and media tracking in one place.
20It 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.
21
22## Why?
23
24- **Fragmented productivity tools**: Instead of juggling multiple apps for tasks, notes, reading lists, and media queues, Noteleaf provides a single CLI interface
25- **Terminal-native workflow**: For developers and power users who prefer staying in the terminal, Noteleaf offers rich TUIs without leaving your command line
26 - **Lightweight and fast**: No desktop apps or web interfaces - just a fast, focused CLI tool
27- **Unified data model**: Tasks, notes, and media items can reference each other, creating a connected knowledge and productivity system
28
29## Getting started
30
31### Prerequisites
32
33Go v1.24+
34
35### Installation
36
37```sh
38git clone https://github.com/stormlightlabs/noteleaf
39cd noteleaf
40go build -o ./tmp/noteleaf ./cmd
41go install
42```
43
44### Basic usage
45
46```sh
47# Initialize the application
48noteleaf setup
49
50# Add sample data for exploration
51noteleaf setup seed
52
53# Create your first task
54noteleaf task add "Learn Noteleaf CLI"
55
56# View tasks
57noteleaf task list
58
59# Create a note
60noteleaf note add "My first note"
61
62# Add a book to your reading list
63noteleaf media book add "The Name of the Wind"
64```
65
66## Status
67
68**Status**: Work in Progress (MVP completed)
69
70### Completed
71
72Core functionality is complete and stable:
73
74- Task management with projects and tags
75- Note-taking system
76- Article parsing from URLs
77- Media tracking (books, movies, TV shows)
78
79### Planned
80
81- Time tracking integration
82- Advanced search and filtering
83- Export/import functionality
84- Plugin system