README
¶
decreta
dec — principles, per pantheon node. A tiny CLI for recording and recalling
the settled principles you want to keep in mind for any part of your life.
(Latin decreta: the foundational doctrines from which day-to-day precepts
follow.)
Principles live as one markdown bullet per line in a node's meta dir,
<code>__/<code>_decreta.md, so they sit right next to that node's todos
(pensum) and notes in the pantheon
filesystem tree.
Install
go install github.com/LinusNyman/decreta/cmd/dec@latest
Usage
dec open the terminal browser (TUI)
dec add <code> "<principle>" append a principle to a node
dec ls [code] list a node's (and its subtree's) principles
dec one [code] print one principle at random — for a shell greeting
ls and one aggregate the subtree: given a parent code they walk every
descendant, so dec one at a top-level node makes a fine shell greeting. With no
code they span the whole tree. Embedders (the atrium dashboard) import the core
package and call decreta.List(node) to read a node's principles directly.
TUI
Run dec with no arguments for a two-pane browser (à la pen): the pantheon
tree on the left with per-node principle counts, the selected node's principles
on the right.
j/k move a add principle (sticky) t only nodes with principles
tab switch pane e edit selected r reload from disk
h/l collapse / x delete selected ? help
expand J/K reorder q quit
Status
v0.1. The three verbs and a TUI work over <code>__/<code>_decreta.md.
The dashboard (atrium) embeds the core as a library.
Directories
¶
| Path | Synopsis |
|---|---|
|
cmd
|
|
|
dec
command
Command dec records and recalls principles per pantheon node.
|
Command dec records and recalls principles per pantheon node. |
|
Package decreta is the importable core of the decreta tool: principles stored one per markdown "- " bullet line in a pantheon node's meta dir, under a title header, with the read and mutate operations over them.
|
Package decreta is the importable core of the decreta tool: principles stored one per markdown "- " bullet line in a pantheon node's meta dir, under a title header, with the read and mutate operations over them. |
|
internal
|
|
|
cli
Package cli is the thin command surface of the dec binary: it parses argv, scans the pantheon tree once, resolves codes, and renders principles.
|
Package cli is the thin command surface of the dec binary: it parses argv, scans the pantheon tree once, resolves codes, and renders principles. |
|
tui
Package tui is decreta's terminal browser: a two-pane Bubbletea program — the pantheon tree on the left, the selected node's principles on the right — with add/edit/delete/reorder over the importable decreta core.
|
Package tui is decreta's terminal browser: a two-pane Bubbletea program — the pantheon tree on the left, the selected node's principles on the right — with add/edit/delete/reorder over the importable decreta core. |