A postfix stack-based DSL for tracking todo inside a project.

Warning

I wouldn't recommend using this in production. I use it for my own personal projects.

Install

curl -fsSL https://raw.githubusercontent.com/subrange/nag/main/install.sh | sh

Requires python3 and either curl or wget.

Keywords

Keyword	Description
init	Initialize a nag project
new	Create a new issue object
tag	Add a tag
untag	Remove a tag from the loaded issue or issues
retag	Rename a tag across every issue
priority	Set priority (low, medium, high)
note	Append text to body.md
attach	Copy a file into attachments/
depends	Add a dependency
save	Write changes to disk
close	Delete issues and their source comments
fetch	Load a single issue by ID
all	Load all issues
pick	Assign loaded issues to the current user
filter	Filter list by predicate string
not	Invert the predicate before it
sort:<field>	Sort list by field name
reverse	Flip the order of the loaded issues
show	Print issue list
view	Print full detail and body of loaded issues
graph	Print ASCII dependency DAG
sync	Scan source files, assign IDs, detect orphans
help	Print help message
+	Separate multiple pipelines in one command

Examples

Show all open high priority codegen todo:

nag all status:open filter priority:high filter tag:codegen filter show

Create a new issue with tags:

nag "fix register allocator" new "high" priority "codegen" tag save

Add a note and attachment to an existing issue:

nag "x91b" fetch "see the dump for the failure case" note "assets/crash.png" attach save

Show the dependency graph:

nag all graph

Sync TODOs from source files:

nag sync

Close all orphaned issues:

nag all status:orphaned filter close