# taskfinder
Find tasks within a particular set of files.
By default, these files are defined as .md and .txt files in your home directory. To change this, open the configuration file that was created and placed in $HOME/taskfinder/config.toml. You may also change how long it takes for a file to be considered stale (tasks from a stale file will not be shown unless you pass the `--stale` flag). Alternatively, you can override this and include "@stale" in a file for it to be marked as stale.
This relies on some conventions in the files, how configurable that will be is an open question. For now (most of which are at the file (note) level):
* notes must contain the text "TODO" to appear in the results.
* `[ ]` or `[]` identifies an incomplete task
* `[X]` or `[x]` is a completed task
* `[/]` is a partially completed task
* a note is excluded if it's stale by date or contains @stale somewhere within it
* priorities are essentially special note-level tags.
* tags and priorities are actually just whatever string the user passes, but the convention I'm following is that tags are in the form "@sometag" and priorties in "pri@1", "pri@2", etc.
See `tf --help`.
This is still an early work in progress; install by building from source for now.