na 1.2.27 → 1.2.29

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e1ae4b30284b89cff9f9e5469ec923668c2b314e907b9f8c398b6b6cc46dee37
-  data.tar.gz: 4b4b84c3b995e38a1d02e487129324316a3949d36003418b09602a214a2d560e
+  metadata.gz: fb14c4a36c28fce7e726c0a4c5b50680e05b9efa87c2f41d02a1af3040027401
+  data.tar.gz: 461c9f651ec9838548288efd9b972d7d21ffeca11089fe01b92a10676ce018bc
 SHA512:
-  metadata.gz: f1d145af86c822a521d991ff1dcc2e759a96a88d86b317249ed48eba1e60d1a5425f91c09d5a452418e75162b249fc1c55a74f3dc9ba2d6736dbe2dd3489d23a
-  data.tar.gz: 0aae383f45f4f73e96d15dd24d1e0002b2dcaca77ebf5e6dd7a0a6d956f3233c01e959497b8f60cd328c6d0a690f2575583f7760cb433a9ea5a60d33268425f6
+  metadata.gz: e664e139c0927e205b8f16c3d7036d8912ed5e75aa2da772d8ac5a11b0a3fc72cec49cbb4f07fb45cb533130ed49f10efa4b348d5b708f7840b04b9492347252
+  data.tar.gz: f1b9bb77e3d73d73dd6d3b4ac4db52979cf6345d7cb5231106fec6670e914116375762619bfe67c9697caa5622b65053935edee91bf21116d07be69b9d16ee4c

data/CHANGELOG.md

@@ -1,3 +1,15 @@
+### 1.2.29
+
+2023-08-21 11:08
+
+#### FIXED
+
+- Reverting subcommand breakup
+
+### 1.2.28
+
+2023-08-21 11:01
+
 ### 1.2.27
 
 2023-08-21 10:58

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    na (1.2.27)
+    na (1.2.29)
       chronic (~> 0.10, >= 0.10.2)
       gli (~> 2.21.0)
       mdless (~> 1.0, >= 1.0.32)

data/README.md

@@ -9,7 +9,7 @@
 _If you're one of the rare people like me who find this useful, feel free to
 [buy me some coffee][donate]._
 
-The current version of `na` is 1.2.27
+The current version of `na` is 1.2.29
 .
 
 `na` ("next action") is a command line tool designed to make it easy to see what your next actions are for any project, right from the command line. It works with TaskPaper-formatted files (but any plain text format will do), looking for `@na` tags (or whatever you specify) in todo files in your current folder. 
@@ -77,7 +77,7 @@ SYNOPSIS
     na [global options] command [command options] [arguments...]
 
 VERSION
-    1.2.27
+    1.2.29
 
 GLOBAL OPTIONS
     -a, --add               - Add a next action (deprecated, for backwards compatibility)
@@ -138,7 +138,7 @@ SYNOPSIS
     na [global options] add [command options] ACTION
 
 DESCRIPTION
-    Provides an easy way to store todos while you work. Add quick reminders and (if you set up Prompt Hooks) they'll automatically display next time you enter the directory. If multiple todo files are found in the current directory, a menu will allow you to pick to which file the action gets added. 
+    Provides an easy way to store todos while you work. Add quick   reminders and (if you set up Prompt Hooks) they'll automatically display   next time you enter the directory.   If multiple todo files are found in the current directory, a menu will   allow you to pick to which file the action gets added. 
 
 COMMAND OPTIONS
     --at=POSITION                   - Add task at [s]tart or [e]nd of target project (default: none)
@@ -175,7 +175,7 @@ SYNOPSIS
     na [global options] edit [command options] 
 
 DESCRIPTION
-    Let the system choose the defualt, (e.g. TaskPaper), or specify a command line utility (e.g. vim).            If more than one todo file is found, a menu is displayed. 
+    Let the system choose the defualt, (e.g. TaskPaper), or specify a command line utility (e.g. vim).              If more than one todo file is found, a menu is displayed. 
 
 COMMAND OPTIONS
     -a, --app=EDITOR    - Specify a Mac app (default: none)
@@ -188,7 +188,7 @@ EXAMPLES
     na edit
 
     # Display a menu of all todo files three levels deep from the
-             current directory, open selection in vim.
+               current directory, open selection in vim.
     na edit -d 3 -a vim
 ```
 
@@ -207,7 +207,7 @@ SYNOPSIS
     na [global options] find [command options] PATTERN
 
 DESCRIPTION
-    Search tokens are separated by spaces. Actions matching all tokens in the pattern will be shown (partial matches allowed). Add a + before a token to make it required, e.g. `na find +feature +maybe`, add a - or ! to ignore matches containing that token. 
+    Search tokens are separated by spaces. Actions matching all tokens in the pattern will be shown   (partial matches allowed). Add a + before a token to make it required, e.g. `na find +feature +maybe`,   add a - or ! to ignore matches containing that token. 
 
 COMMAND OPTIONS
     -d, --depth=DEPTH                      - Recurse to depth (default: none)
@@ -274,7 +274,7 @@ SYNOPSIS
     na [global options] next [command options] [QUERY]
 
 DESCRIPTION
-    Next actions are actions which contain the next action tag (default @na), do not contain @done, and are not in the Archive project. Arguments will target a todo file from history, whether it's in the current directory or not. Todo file queries can include path components separated by / or :, and may use wildcards (`*` to match any text, `?` to match a single character). Multiple queries allowed (separate arguments or separated by comma). 
+    Next actions are actions which contain the next action tag (default @na),   do not contain @done, and are not in the Archive project.   Arguments will target a todo file from history, whether it's in the current   directory or not. Todo file queries can include path components separated by /   or :, and may use wildcards (`*` to match any text, `?` to match a single character). Multiple queries allowed (separate arguments or separated by comma). 
 
 COMMAND OPTIONS
     -d, --depth=DEPTH                      - Recurse to depth (default: none)
@@ -315,7 +315,7 @@ SYNOPSIS
     na [global options] projects [command options] [QUERY]
 
 DESCRIPTION
-    Arguments will be interpreted as a query for a known todo file, fuzzy matched. Separate directories with /, :, or a space, e.g. `na projects code/marked` 
+    Arguments will be interpreted as a query for a known todo file,   fuzzy matched. Separate directories with /, :, or a space, e.g. `na projects code/marked` 
 
 COMMAND OPTIONS
     -d, --depth=DEPTH - Search for files X directories deep (default: 1)
@@ -380,7 +380,7 @@ SYNOPSIS
     na [global options] next [command options] [QUERY]
 
 DESCRIPTION
-    Next actions are actions which contain the next action tag (default @na), do not contain @done, and are not in the Archive project. Arguments will target a todo file from history, whether it's in the current directory or not. Todo file queries can include path components separated by / or :, and may use wildcards (`*` to match any text, `?` to match a single character). Multiple queries allowed (separate arguments or separated by comma). 
+    Next actions are actions which contain the next action tag (default @na),   do not contain @done, and are not in the Archive project.   Arguments will target a todo file from history, whether it's in the current   directory or not. Todo file queries can include path components separated by /   or :, and may use wildcards (`*` to match any text, `?` to match a single character). Multiple queries allowed (separate arguments or separated by comma). 
 
 COMMAND OPTIONS
     -d, --depth=DEPTH                      - Recurse to depth (default: none)
@@ -421,7 +421,7 @@ SYNOPSIS
     na [global options] todos [QUERY]
 
 DESCRIPTION
-    Arguments will be interpreted as a query against which the list of todos will be fuzzy matched. Separate directories with /, :, or a space, e.g. `na todos code/marked`
+    Arguments will be interpreted as a query against which the   list of todos will be fuzzy matched. Separate directories with   /, :, or a space, e.g. `na todos code/marked`
 ```
 
 ##### update
@@ -467,7 +467,7 @@ SYNOPSIS
     na [global options] update [command options] ACTION
 
 DESCRIPTION
-    Provides an easy way to complete, prioritize, and tag existing actions. If multiple todo files are found in the current directory, a menu will allow you to pick which file to act on. 
+    Provides an easy way to complete, prioritize, and tag existing actions.   If multiple todo files are found in the current directory, a menu will   allow you to pick which file to act on. 
 
 COMMAND OPTIONS
     -a, --archive                   - Add a @done tag to action and move to Archive
@@ -480,7 +480,7 @@ COMMAND OPTIONS
     -f, --finish                    - Add a @done tag to action
     --file=PATH                     - Specify the file to search for the task (default: none)
     --in, --todo=TODO_FILE          - Use a known todo file, partial matches allowed (default: none)
-    -n, --note                      - Prompt for additional notes. Input will be appended to any existing note.   If STDIN input (piped) is detected, it will be used as a note.
+    -n, --note                      - Prompt for additional notes. Input will be appended to any existing note.     If STDIN input (piped) is detected, it will be used as a note.
     -o, --overwrite                 - Overwrite note instead of appending
     -p, --priority=PRIO             - Add/change a priority level 1-5 (default: 0)
     -r, --remove=TAG                - Remove a tag to the action (may be used more than once, default: none)

data/bin/commands/add.rb

@@ -0,0 +1,183 @@
+# frozen_string_literal: true
+
+desc 'Add a new next action'
+long_desc 'Provides an easy way to store todos while you work. Add quick
+reminders and (if you set up Prompt Hooks) they\'ll automatically display
+next time you enter the directory.
+
+If multiple todo files are found in the current directory, a menu will
+allow you to pick to which file the action gets added.'
+arg_name 'ACTION'
+command :add do |c|
+  c.example 'na add "A cool feature I thought of @idea"', desc: 'Add a new action to the Inbox, including a tag'
+  c.example 'na add "A bug I need to fix" -p 4 -n',
+            desc: 'Add a new action to the Inbox, set its @priority to 4, and prompt for an additional note.'
+  c.example 'na add "An action item (with a note)"',
+            desc: 'A parenthetical at the end of an action is interpreted as a note'
+
+  c.desc 'Prompt for additional notes. STDIN input (piped) will be treated as a note if present.'
+  c.switch %i[n note], negatable: false
+
+  c.desc 'Add a priority level 1-5'
+  c.arg_name 'PRIO'
+  c.flag %i[p priority], must_match: /[1-5]/, type: :integer, default_value: 0
+
+  c.desc 'Add action to specific project'
+  c.arg_name 'PROJECT'
+  c.default_value 'Inbox'
+  c.flag %i[to project proj]
+
+  c.desc 'Add task at [s]tart or [e]nd of target project'
+  c.arg_name 'POSITION'
+  c.flag %i[at], must_match: /^[sbea].*?$/i
+
+  c.desc 'Add to a known todo file, partial matches allowed'
+  c.arg_name 'TODO_FILE'
+  c.flag %i[in todo]
+
+  c.desc 'Use a tag other than the default next action tag'
+  c.arg_name 'TAG'
+  c.flag %i[t tag]
+
+  c.desc 'Don\'t add next action tag to new entry'
+  c.switch %i[x], negatable: false
+
+  c.desc 'Specify the file to which the task should be added'
+  c.arg_name 'PATH'
+  c.flag %i[f file]
+
+  c.desc 'Mark task as @done with date'
+  c.switch %i[finish done], negatable: false
+
+  c.desc 'Search for files X directories deep'
+  c.arg_name 'DEPTH'
+  c.flag %i[d depth], must_match: /^[1-9]$/, type: :integer, default_value: 1
+
+  c.action do |global_options, options, args|
+    reader = TTY::Reader.new
+    append = options[:at] ? options[:at] =~ /^[ae]/i : global_options[:add_at] =~ /^[ae]/
+
+    if NA.global_file
+      target = File.expand_path(NA.global_file)
+      unless File.exist?(target)
+        res = NA.yn(NA::Color.template('{by}Specified file not found, create it'), default: true)
+        if res
+          basename = File.basename(target, ".#{NA.extension}")
+          NA.create_todo(target, basename, template: global_options[:template])
+        else
+          puts NA::Color.template('{r}Cancelled{x}')
+          Process.exit 1
+        end
+      end
+    elsif options[:file]
+      target = File.expand_path(options[:file])
+      unless File.exist?(target)
+        res = NA.yn(NA::Color.template('{by}Specified file not found, create it'), default: true)
+        if res
+          basename = File.basename(target, ".#{NA.extension}")
+          NA.create_todo(target, basename, template: global_options[:template])
+        else
+          puts NA::Color.template('{r}Cancelled{x}')
+          Process.exit 1
+        end
+      end
+    elsif options[:todo]
+      todo = []
+      all_req = options[:todo] !~ /[+!\-]/
+      options[:todo].split(/ *, */).each do |a|
+        m = a.match(/^(?<req>[+\-!])?(?<tok>.*?)$/)
+        todo.push({
+                    token: m['tok'],
+                    required: all_req || (!m['req'].nil? && m['req'] == '+'),
+                    negate: !m['req'].nil? && m['req'] =~ /[!\-]/
+                  })
+      end
+      dirs = NA.match_working_dir(todo)
+      if dirs.count.positive?
+        target = dirs[0]
+      else
+        todo = "#{options[:todo].sub(/#{NA.extension}$/, '')}.#{NA.extension}"
+        target = File.expand_path(todo)
+        unless File.exist?(target)
+
+          res = NA.yn(NA::Color.template("{by}Specified file not found, create #{todo}"), default: true)
+          NA.notify('{r}Cancelled{x}', exit_code: 1) unless res
+
+          basename = File.basename(target, ".#{NA.extension}")
+          NA.create_todo(target, basename, template: global_options[:template])
+        end
+
+      end
+    else
+      files = NA.find_files(depth: options[:depth])
+      if files.count.zero?
+        res = NA.yn(NA::Color.template('{by}No todo file found, create one'), default: true)
+        if res
+          basename = File.expand_path('.').split('/').last
+          target = "#{basename}.#{NA.extension}"
+          NA.create_todo(target, basename, template: global_options[:template])
+          files = NA.find_files(depth: 1)
+        end
+      end
+      target = files.count > 1 ? NA.select_file(files) : files[0]
+      NA.notify('{r}Cancelled{x}', exit_code: 1) unless files.count.positive? && File.exist?(target)
+
+    end
+
+    action = if args.count.positive?
+               args.join(' ').strip
+             elsif $stdin.isatty && TTY::Which.exist?('gum')
+               `gum input --placeholder "Enter a task" --char-limit=500 --width=#{TTY::Screen.columns}`.strip
+             elsif $stdin.isatty
+               puts NA::Color.template('{bm}Enter task:{x}')
+               reader.read_line(NA::Color.template('{by}> {bw}')).strip
+             end
+
+    if action.nil? || action.empty?
+      puts 'Empty input, cancelled'
+      Process.exit 1
+    end
+
+    if options[:priority]&.to_i&.positive?
+      action = "#{action.gsub(/@priority\(\d+\)/, '')} @priority(#{options[:priority]})"
+    end
+
+    note_rx = /^(.+) \((.*?)\)$/
+    split_note = if action =~ note_rx
+                   n = Regexp.last_match(2)
+                   action.sub!(note_rx, '\1').strip!
+                   n
+                 end
+
+    na_tag = NA.na_tag
+    if options[:x]
+      na_tag = ''
+    else
+      na_tag = options[:tag] unless options[:tag].nil?
+      na_tag = " @#{na_tag}"
+    end
+
+    action = "#{action.gsub(/#{na_tag}\b/, '')}#{na_tag}"
+
+    stdin_note = NA.stdin ? NA.stdin.split("\n") : []
+
+    line_note = if options[:note] && $stdin.isatty
+                  puts stdin_note unless stdin_note.nil?
+                  if TTY::Which.exist?('gum')
+                    args = ['--placeholder "Enter additional note, CTRL-d to save"']
+                    args << '--char-limit 0'
+                    args << '--width $(tput cols)'
+                    `gum write #{args.join(' ')}`.strip.split("\n")
+                  else
+                    puts NA::Color.template('{bm}Enter a note, {bw}CTRL-d{bm} to end editing{bw}')
+                    reader.read_multiline
+                  end
+                end
+
+    note = stdin_note.empty? ? [] : stdin_note
+    note.concat(split_note) unless split_note.nil?
+    note.concat(line_note) unless line_note.nil?
+
+    NA.add_action(target, options[:project], action, note, finish: options[:finish], append: append)
+  end
+end

data/bin/commands/archive.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+desc 'Mark an action as @done and archive'
+arg_name 'ACTION'
+command %i[archive] do |c|
+  c.example 'na archive "An existing task"',
+            desc: 'Find "An existing task", mark @done if needed, and move to archive'
+
+  c.desc 'Prompt for additional notes. Input will be appended to any existing note.
+  If STDIN input (piped) is detected, it will be used as a note.'
+  c.switch %i[n note], negatable: false
+
+  c.desc 'Overwrite note instead of appending'
+  c.switch %i[o overwrite], negatable: false
+
+  c.desc 'Archive all done tasks'
+  c.switch %i[done], negatable: false
+
+  c.desc 'Specify the file to search for the task'
+  c.arg_name 'PATH'
+  c.flag %i[file]
+
+  c.desc 'Search for files X directories deep'
+  c.arg_name 'DEPTH'
+  c.flag %i[d depth], must_match: /^[1-9]$/, type: :integer, default_value: 1
+
+  c.desc 'Match actions containing tag. Allows value comparisons'
+  c.arg_name 'TAG'
+  c.flag %i[tagged], multiple: true
+
+  c.desc 'Act on all matches immediately (no menu)'
+  c.switch %i[all], negatable: false
+
+  c.desc 'Interpret search pattern as regular expression'
+  c.switch %i[e regex], negatable: false
+
+  c.desc 'Match pattern exactly'
+  c.switch %i[x exact], negatable: false
+
+  c.action do |global, options, args|
+    if options[:done]
+      options[:tagged] = ['done']
+      options[:all] = true
+    end
+
+    options[:done] = true
+    options[:finish] = true
+    options[:project] = 'Archive'
+    options[:archive] = true
+    options[:a] = true
+
+    cmd = commands[:update]
+    action = cmd.send(:get_action, nil)
+    action.call(global, options, args)
+  end
+end

data/bin/commands/changes.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+desc 'Display the changelog'
+command %i[changes changelog] do |c|
+  c.action do |_, _, _|
+    changelog = File.expand_path(File.join(File.dirname(__FILE__), '..', 'CHANGELOG.md'))
+    pagers = [
+      'mdless',
+      'mdcat',
+      'bat',
+      ENV['PAGER'],
+      'less -FXr',
+      ENV['GIT_PAGER'],
+      'more -r'
+    ]
+    pager = pagers.find { |cmd| TTY::Which.exist?(cmd.split.first) }
+    system %(#{pager} "#{changelog}")
+  end
+end

data/bin/commands/complete.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+desc 'Find and mark an action as @done'
+arg_name 'ACTION'
+command %i[complete finish] do |c|
+  c.example 'na complete "An existing task"',
+            desc: 'Find "An existing task" and mark @done'
+  c.example 'na finish "An existing task"',
+            desc: 'Alias for complete'
+
+  c.desc 'Prompt for additional notes. Input will be appended to any existing note.
+  If STDIN input (piped) is detected, it will be used as a note.'
+  c.switch %i[n note], negatable: false
+
+  c.desc 'Overwrite note instead of appending'
+  c.switch %i[o overwrite], negatable: false
+
+  c.desc 'Add a @done tag to action and move to Archive'
+  c.switch %i[a archive], negatable: false
+
+  c.desc 'Specify the file to search for the task'
+  c.arg_name 'PATH'
+  c.flag %i[file]
+
+  c.desc 'Search for files X directories deep'
+  c.arg_name 'DEPTH'
+  c.flag %i[d depth], must_match: /^[1-9]$/, type: :integer, default_value: 1
+
+  c.desc 'Match actions containing tag. Allows value comparisons'
+  c.arg_name 'TAG'
+  c.flag %i[tagged], multiple: true
+
+  c.desc 'Act on all matches immediately (no menu)'
+  c.switch %i[all], negatable: false
+
+  c.desc 'Interpret search pattern as regular expression'
+  c.switch %i[e regex], negatable: false
+
+  c.desc 'Match pattern exactly'
+  c.switch %i[x exact], negatable: false
+
+  c.action do |global, options, args|
+    options[:finish] = true
+    options[:f] = true
+    options[:project] = 'Archive' if options[:archive]
+
+    cmd = commands[:update]
+    action = cmd.send(:get_action, nil)
+    action.call(global, options, args)
+  end
+end

data/bin/commands/edit.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+desc 'Open a todo file in the default editor'
+long_desc 'Let the system choose the defualt, (e.g. TaskPaper), or specify a command line utility (e.g. vim).
+           If more than one todo file is found, a menu is displayed.'
+command %i[edit] do |c|
+  c.example 'na edit', desc: 'Open the main todo file in the default editor'
+  c.example 'na edit -d 3 -a vim', desc: 'Display a menu of all todo files three levels deep from the
+             current directory, open selection in vim.'
+
+  c.desc 'Recurse to depth'
+  c.arg_name 'DEPTH'
+  c.default_value 1
+  c.flag %i[d depth], type: :integer, must_match: /^\d+$/
+
+  c.desc 'Specify an editor CLI'
+  c.arg_name 'EDITOR'
+  c.flag %i[e editor]
+
+  c.desc 'Specify a Mac app'
+  c.arg_name 'EDITOR'
+  c.flag %i[a app]
+
+  c.action do |global_options, options, args|
+    depth = if global_options[:recurse] && options[:depth].nil? && global_options[:depth] == 1
+              3
+            else
+              options[:depth].nil? ? global_options[:depth].to_i : options[:depth].to_i
+            end
+    files = NA.find_files(depth: depth)
+    files.delete_if { |f| f !~ /.*?(#{args.join('|')}).*?.#{NA.extension}/ } if args.count.positive?
+
+    file = if files.count > 1
+             NA.select_file(files)
+           else
+             files[0]
+           end
+
+    if options[:editor]
+      system options[:editor], file
+    else
+      NA.edit_file(file: file, app: options[:app])
+    end
+  end
+end

data/bin/commands/find.rb

@@ -0,0 +1,135 @@
+# frozen_string_literal: true
+
+desc 'Find actions matching a search pattern'
+long_desc 'Search tokens are separated by spaces. Actions matching all tokens in the pattern will be shown
+(partial matches allowed). Add a + before a token to make it required, e.g. `na find +feature +maybe`,
+add a - or ! to ignore matches containing that token.'
+arg_name 'PATTERN'
+command %i[find grep] do |c|
+  c.example 'na find feature idea swift', desc: 'Find all actions containing feature, idea, and swift'
+  c.example 'na find feature idea -swift', desc: 'Find all actions containing feature and idea but NOT swift'
+  c.example 'na find -x feature idea', desc: 'Find all actions containing the exact text "feature idea"'
+
+  c.desc 'Interpret search pattern as regular expression'
+  c.switch %i[e regex], negatable: false
+
+  c.desc 'Match pattern exactly'
+  c.switch %i[x exact], negatable: false
+
+  c.desc 'Recurse to depth'
+  c.arg_name 'DEPTH'
+  c.flag %i[d depth], type: :integer, must_match: /^\d+$/
+
+  c.desc 'Show actions from a specific todo file in history. May use wildcards (* and ?)'
+  c.arg_name 'TODO_PATH'
+  c.flag %i[in]
+
+  c.desc 'Include notes in output'
+  c.switch %i[notes], negatable: true, default_value: false
+
+  c.desc 'Combine search tokens with OR, displaying actions matching ANY of the terms'
+  c.switch %i[o or], negatable: false
+
+  c.desc 'Show actions from a specific project'
+  c.arg_name 'PROJECT[/SUBPROJECT]'
+  c.flag %i[proj project]
+
+  c.desc 'Match actions containing tag. Allows value comparisons'
+  c.arg_name 'TAG'
+  c.flag %i[tagged], multiple: true
+
+  c.desc 'Include @done actions'
+  c.switch %i[done]
+
+  c.desc 'Show actions not matching search pattern'
+  c.switch %i[v invert], negatable: false
+
+  c.desc 'Save this search for future use'
+  c.arg_name 'TITLE'
+  c.flag %i[save]
+
+  c.desc 'Output actions nested by file'
+  c.switch %[nest], negatable: false
+
+  c.desc 'Output actions nested by file and project'
+  c.switch %[omnifocus], negatable: false
+
+  c.action do |global_options, options, args|
+    options[:nest] = true if options[:omnifocus]
+
+    if options[:save]
+      title = options[:save].gsub(/[^a-z0-9]/, '_').gsub(/_+/, '_')
+      NA.save_search(title, "#{NA.command_line.join(' ').sub(/ --save[= ]*\S+/, '').split(' ').map { |t| %("#{t}") }.join(' ')}")
+    end
+
+
+    depth = if global_options[:recurse] && options[:depth].nil? && global_options[:depth] == 1
+              3
+            else
+              options[:depth].nil? ? global_options[:depth].to_i : options[:depth].to_i
+            end
+
+    all_req = options[:tagged].join(' ') !~ /[+!\-]/ && !options[:or]
+    tags = []
+    options[:tagged].join(',').split(/ *, */).each do |arg|
+      m = arg.match(/^(?<req>[+\-!])?(?<tag>[^ =<>$\^]+?)(?:(?<op>[=<>]{1,2}|[*$\^]=)(?<val>.*?))?$/)
+
+      tags.push({
+                  tag: m['tag'].wildcard_to_rx,
+                  comp: m['op'],
+                  value: m['val'],
+                  required: all_req || (!m['req'].nil? && m['req'] == '+'),
+                  negate: !m['req'].nil? && m['req'] =~ /[!\-]/
+                })
+    end
+
+    tokens = nil
+    if options[:exact]
+      tokens = args.join(' ')
+    elsif options[:regex]
+      tokens = Regexp.new(args.join(' '), Regexp::IGNORECASE)
+    else
+      tokens = []
+      all_req = args.join(' ') !~ /[+!\-]/ && !options[:or]
+
+      args.join(' ').split(/ /).each do |arg|
+        m = arg.match(/^(?<req>[+\-!])?(?<tok>.*?)$/)
+        tokens.push({
+                      token: m['tok'],
+                      required: all_req || (!m['req'].nil? && m['req'] == '+'),
+                      negate: !m['req'].nil? && m['req'] =~ /[!\-]/
+                    })
+      end
+    end
+
+    todo = nil
+    if options[:in]
+      todo = []
+      options[:in].split(/ *, */).each do |a|
+        m = a.match(/^(?<req>[+\-!])?(?<tok>.*?)$/)
+        todo.push({
+                    token: m['tok'],
+                    required: all_req || (!m['req'].nil? && m['req'] == '+'),
+                    negate: !m['req'].nil? && m['req'] =~ /[!\-]/
+                  })
+      end
+    end
+
+    files, actions, = NA.parse_actions(depth: depth,
+                                       done: options[:done],
+                                       query: todo,
+                                       search: tokens,
+                                       tag: tags,
+                                       negate: options[:invert],
+                                       regex: options[:regex],
+                                       project: options[:project],
+                                       require_na: false)
+    regexes = if tokens.is_a?(Array)
+                tokens.delete_if { |token| token[:negate] }.map { |token| token[:token] }
+              else
+                [tokens]
+              end
+
+    NA.output_actions(actions, depth, files: files, regexes: regexes, notes: options[:notes], nest: options[:nest], nest_projects: options[:omnifocus])
+  end
+end

data/bin/commands/init.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+desc 'Create a new todo file in the current directory'
+arg_name 'PROJECT', optional: true
+command %i[init create] do |c|
+  c.example 'na init', desc: 'Generate a new todo file, prompting for project name'
+  c.example 'na init warpspeed', desc: 'Generate a new todo for a project called warpspeed'
+
+  c.action do |global_options, _options, args|
+    reader = TTY::Reader.new
+    if args.count.positive?
+      project = args.join(' ')
+    elsif
+      project = File.expand_path('.').split('/').last
+      project = reader.read_line(NA::Color.template('{y}Project name {bw}> {x}'), value: project).strip if $stdin.isatty
+    end
+
+    target = "#{project}.#{NA.extension}"
+
+    if File.exist?(target)
+      res = NA.yn(NA::Color.template("{r}File {bw}#{target}{r} already exists, overwrite it"), default: false)
+      Process.exit 1 unless res
+
+    end
+
+    NA.create_todo(target, project, template: global_options[:template])
+  end
+end