# Na (next action by Terpstra)
| | url:: [na - BrettTerpstra.com](https://brettterpstra.com/projects/na/) |
| --- | ---------------------------------------------------------------------- |
## Usage
- na init
- na add example todo
- na move example todo
- na finish example todo
- na unfinish
- na archive example todo
- na update
- -p (priority
- -t (tag)
- -n (note)
- --project
- na update --note example todo (will open vi-like interface to add note)
- na update -t waiting "A bug I need to fix" -p 4 -n
- Find "A bug..." action, add @waiting, add/update @priority(4), and prompt for an additional note
- na edit example todo
- opens that todo in a vi-ilke editor
- na find
- na open
- opens todo file in default editor
- na projects
- na undo
- na tag
- na tagged
- na
- na show
- na next
- args
- -d 3
- depth=3
- #to/bug
- --file=todo.md
- --in=todo
- --to=exampleProject
- --from=exampleProject
- --tagged or -t
- -x
- exact match
- -n
- note
- --save
- save a search for easier use
- -p
- priority
- --proj
- or --project
- project
- --remove na
- remove the tag @na
- --delete
## My Main Workflow
I want a todo.md file in any project to track todos. That way I can use na from the CLI, but also TaskPaper or Obsidian as needed. I could add it to version control, but normally i want it gitignored
I use a .na.template file for git init to use to create that file. I'd like to also use na recursively with the -d depth command but it doesn't seem to work right. Maybe because of how I switched to .md extension. But the `na next "*"` command works to list all todo.md tasks.
- na init
- na add exampleTodo
- na
- lists actions
- na move exampleTodo
- will then prompt with a list of sections/projects to move to and you can select multiple
- na finish exampleTodo (na unfinish)
- marks as @done
- na archive exampleTodo
- marks @done and moves to archive project
- na -d exampleTodo ? I think (delete)
- na find searchPattern
- na projects
- na undo
## Configuration
global config file: .na.rc
save new settings with the initcofig command
- `na --add_at end initconfig --force`