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
8Noteleaf is a unified personal productivity CLI that combines task management, note-taking, and media tracking in one place.
9It 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.
10
11## Why?
12
13- **Fragmented productivity tools**: Instead of juggling multiple apps for tasks, notes, reading lists, and media queues, Noteleaf provides a single CLI interface
14- **Terminal-native workflow**: For developers and power users who prefer staying in the terminal, Noteleaf offers rich TUIs without leaving your command line
15 - **Lightweight and fast**: No desktop apps or web interfaces - just a fast, focused CLI tool
16- **Unified data model**: Tasks, notes, and media items can reference each other, creating a connected knowledge and productivity system
17
18## Getting started
19
20### Prerequisites
21
22Go v1.24+
23
24### Installation
25
26```sh
27git clone https://github.com/stormlightlabs/noteleaf
28cd noteleaf
29go build -o ./tmp/noteleaf ./cmd
30go install
31```
32
33### Basic usage
34
35```sh
36# Initialize the application
37noteleaf setup
38
39# Add sample data for exploration
40noteleaf setup seed
41
42# Create your first task
43noteleaf task add "Learn Noteleaf CLI"
44
45# View tasks
46noteleaf task list
47
48# Create a note
49noteleaf note add "My first note"
50
51# Add a book to your reading list
52noteleaf media book add "The Name of the Wind"
53
54# Generate docs
55noteleaf docgen --format docusaurus --out ./website/docs/manual
56```
57
58## Status
59
60**Status**: Work in Progress (MVP completed)
61
62### Completed
63
64- Task management with projects and tags
65- Note-taking system
66- Article parsing from URLs
67- Media tracking (books, movies, TV shows)
68
69### Planned
70
71- Time tracking integration
72- Advanced search and filtering
73- Export/import functionality
74- Plugin system