na 1.2.84 → 1.2.85

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1bdcec170985481e8d49edf6e599f0d1fba33bd250fcae7d0e900e24d3f8d8e4
-  data.tar.gz: 7e9d815b0dee8abed829216771c8d4177a49629f37b54f76ff2000fede7172d9
+  metadata.gz: da5eb39ed44c356c713172455a60fe197de3d1d1f00dc2eedadeb24fe40c9dde
+  data.tar.gz: 5e58a4e4c17fac35a091b3cc49e7dca7aca06289b1fbc897be752bb4cdb93817
 SHA512:
-  metadata.gz: c45055a0a92ad0cbcfcf670a9717b585a5fa0c2ddad5ffe84644a4a64fe3df564f7d0683fd9be47942c3d829f3148be1836039a57b82d108518a63b3d1de1e28
-  data.tar.gz: 97d7a6616eae0ea5b967068a28154717aafd4c5f37aca62064bf86d2a82f719fe941aaacf98dd1158250e83d5d332f296eb99cb5d39d751852fc071e461d7ac7
+  metadata.gz: 053e5636721b5c9544e22099840ef279462cbba96bd8f561c6a37c3f5b5453d7872bf549da8e8f78009f2c0a417805711ee3c7eebe2dfdf05538bbad84f7aafc
+  data.tar.gz: 4626f2c6808056d9de394bd1eec109c0c56a8622015157ecc95bdf555523729254735550a775ae4542b5c20023d7bfc152152db0cf042661e07e5ec6ef1bc9ef

data/.rubocop_todo.yml

@@ -1,6 +1,6 @@
 # This configuration was generated by
 # `rubocop --auto-gen-config`
-# on 2025-10-25 14:39:51 UTC using RuboCop version 1.75.7.
+# on 2025-10-26 12:18:27 UTC using RuboCop version 1.75.7.
 # The point is for the user to remove these configuration records
 # one by one as the offenses are removed from the code base.
 # Note that changes in the inspected code, or installation of new
@@ -13,12 +13,7 @@ Lint/DuplicateBranch:
     - 'lib/na/action.rb'
     - 'lib/na/colors.rb'
 
-# Offense count: 1
-Lint/SelfAssignment:
-  Exclude:
-    - 'lib/na/string.rb'
-
-# Offense count: 1
+# Offense count: 2
 # This cop supports safe autocorrection (--autocorrect).
 # Configuration parameters: AutoCorrect, AllowUnusedKeywordArguments, IgnoreEmptyMethods, IgnoreNotImplementedMethods, NotImplementedExceptions.
 # NotImplementedExceptions: NotImplementedError
@@ -40,9 +35,9 @@ Metrics/BlockLength:
 # Offense count: 4
 # Configuration parameters: CountComments, CountAsOne.
 Metrics/ClassLength:
-  Max: 762
+  Max: 763
 
-# Offense count: 22
+# Offense count: 23
 # Configuration parameters: AllowedMethods, AllowedPatterns.
 Metrics/CyclomaticComplexity:
   Max: 66
@@ -55,14 +50,14 @@ Metrics/MethodLength:
 # Offense count: 2
 # Configuration parameters: CountComments, CountAsOne.
 Metrics/ModuleLength:
-  Max: 764
+  Max: 765
 
 # Offense count: 4
 # Configuration parameters: CountKeywordArgs, MaxOptionalParameters.
 Metrics/ParameterLists:
   Max: 19
 
-# Offense count: 21
+# Offense count: 22
 # Configuration parameters: AllowedMethods, AllowedPatterns.
 Metrics/PerceivedComplexity:
   Max: 76

data/CHANGELOG.md

@@ -1,3 +1,17 @@
+### 1.2.85
+
+2025-10-26 08:43
+
+#### IMPROVED
+
+- YARD documentation
+- Currently at 100% YARD documentation
+
+#### FIXED
+
+- Nil handler for trunc_middle
+- Nil handler for hihglight_file
+
 ### 1.2.84
 
 2025-10-25 15:50

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    na (1.2.84)
+    na (1.2.85)
       chronic (~> 0.10, >= 0.10.2)
       git (~> 3.0.0)
       gli (~> 2.21.0)

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.84.
+The current version of `na` is 1.2.85.
 
 `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.
 
@@ -76,7 +76,7 @@ SYNOPSIS
     na [global options] command [command options] [arguments...]
 
 VERSION
-    1.2.84
+    1.2.85
 
 GLOBAL OPTIONS
     -a, --add               - Add a next action (deprecated, for backwards compatibility)

data/lib/na/action.rb

@@ -1,10 +1,16 @@
 # frozen_string_literal: true
 
 module NA
+  # Represents a single actionable item in a todo file, with tags, notes, and project context.
+  #
+  # @example Create a new action
+  #   action = NA::Action.new('todo.txt', 'Inbox', [], '- Buy milk', 1)
   class Action < Hash
     attr_reader :file, :project, :tags, :line
     attr_accessor :parent, :action, :note
 
+    # @example
+    #   action = NA::Action.new('todo.txt', 'Inbox', [], '- Buy milk', 1)
     def initialize(file, project, parent, action, idx, note = [])
       super()
 
@@ -25,6 +31,8 @@ module NA
     # @param remove_tag [Array<String>] Tags to remove
     # @param note [Array<String>] Notes to set
     # @return [void]
+    # @example
+    #   action.process(priority: 5, finish: true, add_tag: ['urgent'], remove_tag: ['waiting'], note: ['Call Bob'])
     def process(priority: 0, finish: false, add_tag: [], remove_tag: [], note: [])
       string = @action.dup
 
@@ -54,6 +62,8 @@ module NA
     # String representation of the action
     #
     # @return [String]
+    # @example
+    #   action.to_s #=> "{ project: 'Inbox', ... }"
     def to_s
       note = if @note.count.positive?
                "\n#{@note.join("\n")}"
@@ -127,7 +137,7 @@ module NA
 
         # Create the source filename string (optimized)
         filename = if needs_filename
-                     path = @file.sub(%r{^\./}, '').sub(/#{Dir.home}/, '~')
+                     path = @file ? @file.sub(%r{^\./}, '').sub(/#{Dir.home}/, '~') : ''
                      if File.dirname(path) == '.'
                        fname = NA.include_ext ? File.basename(path) : File.basename(path, ".#{extension}")
                        fname = "./#{fname}" if NA.show_cwd_indicator

data/lib/na/array.rb

@@ -1,10 +1,17 @@
 # frozen_string_literal: true
 
+##
+# Extensions to Ruby's Array class for todo management and formatting.
+#
+# @example Remove bad elements from an array
+#   ['foo', '', nil, 0, false, 'bar'].remove_bad #=> ['foo', 'bar']
 class ::Array
   # Like Array#compact -- removes nil items, but also
   # removes empty strings, zero or negative numbers and FalseClass items
   #
   # @return [Array] Array without "bad" elements
+  # @example
+  #   ['foo', '', nil, 0, false, 'bar'].remove_bad #=> ['foo', 'bar']
   def remove_bad
     compact.map { |x| x.is_a?(String) ? x.strip : x }.select(&:good?)
   end
@@ -15,6 +22,8 @@ class ::Array
   # @param indent [Integer] Indentation spaces
   # @param color [String] Color code to apply
   # @return [Array, String] Wrapped and colorized lines
+  # @example
+  #   ['foo', 'bar'].wrap(80, 2, '{g}') #=> "\n{g}  • foo{x}\n{g}  • bar{x}"
   def wrap(width, indent, color)
     return map { |l| "#{color}  #{l.wrap(width, 2)}" } if width < 60
 

data/lib/na/benchmark.rb

@@ -1,6 +1,10 @@
 # frozen_string_literal: true
 
 module NA
+  # Provides benchmarking utilities for measuring code execution time.
+  #
+  # @example Measure a block of code
+  #   NA::Benchmark.measure('sleep') { sleep(1) }
   module Benchmark
     class << self
       attr_accessor :enabled, :timings
@@ -18,6 +22,8 @@ module NA
       #
       # @param label [String] Label for the measurement
       # @return [Object] Result of the block
+      # @example
+      #   NA::Benchmark.measure('sleep') { sleep(1) }
       def measure(label)
         return yield unless @enabled
 
@@ -31,6 +37,8 @@ module NA
       # Output a performance report to STDERR
       #
       # @return [void]
+      # @example
+      #   NA::Benchmark.report
       def report
         return unless @enabled
 

data/lib/na/colors.rb

@@ -3,6 +3,9 @@
 # Cribbed from <https://github.com/flori/term-ansicolor>
 module NA
   # Terminal output color functions.
+  #
+  # @example Clear the color template cache
+  #   NA::Color.clear_template_cache
   module Color
     # Regexp to match excape sequences
     ESCAPE_REGEX = /(?<=\[)(?:(?:(?:[349]|10)[0-9]|[0-9])?;?)+(?=m)/.freeze
@@ -199,6 +202,10 @@ module NA
         @template_cache ||= {}
       end
 
+      # Clears the cached compiled color templates.
+      # @return [void]
+      # @example
+      #   NA::Color.clear_template_cache
       def clear_template_cache
         @template_cache = {}
       end
@@ -231,15 +238,15 @@ module NA
       # i: italic, x: reset (remove background, color,
       # emphasis)
       #
-      # Also accepts {#RGB} and {#RRGGBB} strings. Put a b
+      # Also accepts `{#RGB}` and `{#RRGGBB}` strings. Put a b
       # before the hash to make it a background color
       #
       # @example    Convert a templated string
-      # Color.template('{Rwb}Warning:{x} {w}you look a
-      # little {g}ill{x}')
+      # Color.template('\\{Rwb\\}Warning:\\{x\\} \\{w\}\you look a
+      # little \\{g\\}ill\\{x\\}')
       #
       # @example    Convert using RGB colors
-      # Color.template('{#f0a}This is an RGB color')
+      # Color.template('\\{#f0a\\}This is an RGB color')
       #
       # @param      input  [String, Array] The template
       #                    string. If this is an array, the

data/lib/na/editor.rb

@@ -3,8 +3,12 @@
 require 'English'
 
 module NA
+  # Provides editor selection and argument helpers for launching text editors.
   module Editor
     class << self
+      # Returns the default editor command, checking environment variables and available editors.
+      # @param prefer_git_editor [Boolean] Prefer GIT_EDITOR over EDITOR
+      # @return [String, nil] Editor command or nil if not found
       def default_editor(prefer_git_editor: true)
         editor ||= if prefer_git_editor
                      ENV['NA_EDITOR'] || ENV['GIT_EDITOR'] || ENV.fetch('EDITOR', nil)
@@ -29,10 +33,15 @@ module NA
         nil
       end
 
+      # Returns the default editor command with its arguments.
+      # @return [String] Editor command with arguments
       def editor_with_args
         args_for_editor(default_editor)
       end
 
+      # Returns the editor command with appropriate arguments for file opening.
+      # @param editor [String] Editor command
+      # @return [String] Editor command with arguments
       def args_for_editor(editor)
         return editor if editor =~ /-\S/
 

data/lib/na/hash.rb

@@ -1,9 +1,16 @@
 # frozen_string_literal: true
 
+##
+# Extensions to Ruby's Hash class for symbolizing keys and deep freezing values.
+#
+# @example Symbolize all keys in a hash
+#   { 'foo' => 1, 'bar' => { 'baz' => 2 } }.symbolize_keys #=> { :foo => 1, :bar => { :baz => 2 } }
 class ::Hash
   # Convert all keys in the hash to symbols recursively
   #
   # @return [Hash] Hash with symbolized keys
+  # @example
+  #   { 'foo' => 1, 'bar' => { 'baz' => 2 } }.symbolize_keys #=> { :foo => 1, :bar => { :baz => 2 } }
   def symbolize_keys
     each_with_object({}) { |(k, v), hsh| hsh[k.to_sym] = v.is_a?(Hash) ? v.symbolize_keys : v }
   end
@@ -12,6 +19,8 @@ class ::Hash
   # Freeze all values in a hash
   #
   # @return     Hash with all values frozen
+  # @example
+  #   { foo: { bar: 'baz' } }.deep_freeze
   def deep_freeze
     chilled = {}
     each do |k, v|

data/lib/na/help_monkey_patch.rb

@@ -1,17 +1,26 @@
 # frozen_string_literal: true
 
+##
+# Monkeypatches for GLI CLI framework to support paginated help output.
+#
+# @example Show help for a command
+#   GLI::Commands::Help.new.show_help({}, {}, [], $stdout, $stderr)
 module GLI
+  ##
+  # Command extensions for GLI CLI framework.
   module Commands
     # Help Command Monkeypatch for paginated output
     class Help < Command
       # Show help output for GLI commands with paginated output
       #
-      # @param global_options [Hash] Global CLI options
+      # @param _global_options [Hash] Global CLI options
       # @param options [Hash] Command-specific options
       # @param arguments [Array] Command arguments
       # @param out [IO] Output stream
       # @param error [IO] Error stream
       # @return [void]
+      # @example
+      #   GLI::Commands::Help.new.show_help({}, {}, [], $stdout, $stderr)
       def show_help(_global_options, options, arguments, out, error)
         NA::Pager.paginate = true
 

data/lib/na/next_action.rb

@@ -8,10 +8,17 @@ module NA
     attr_accessor :verbose, :extension, :include_ext, :na_tag, :command_line, :command, :globals, :global_file,
                   :cwd_is, :cwd, :stdin, :show_cwd_indicator
 
+    # Returns the current theme hash for color and style settings.
+    # @return [Hash] The theme settings
     def theme
       @theme ||= NA::Theme.load_theme
     end
 
+    # Print a message to stderr, optionally exit or debug.
+    # @param msg [String] The message to print
+    # @param exit_code [Integer, Boolean] Exit code or false for no exit
+    # @param debug [Boolean] Only print if verbose
+    # @return [void]
     def notify(msg, exit_code: false, debug: false)
       return if debug && !NA.verbose
 
@@ -23,6 +30,8 @@ module NA
       Process.exit exit_code if exit_code
     end
 
+    # Returns a map of priority levels to numeric values.
+    # @return [Hash{String=>Integer}] Priority mapping
     def priority_map
       {
         'h' => 5,
@@ -128,6 +137,11 @@ module NA
       end
     end
 
+    # Shift project indices after a given index by a length.
+    # @param projects [Array<NA::Project>] Projects to shift
+    # @param idx [Integer] Index after which to shift
+    # @param length [Integer] Amount to shift
+    # @return [Array<NA::Project>] Shifted projects
     def shift_index_after(projects, idx, length = 1)
       projects.map do |proj|
         proj.line = proj.line - length if proj.line > idx
@@ -194,9 +208,8 @@ module NA
     #
     # @param target [String] Path to the todo file
     # @param project [String] Project name
-    # @param projects [Array<NA::Project>] Existing projects
     # @return [NA::Project] The new project
-    def insert_project(target, project, _projects)
+    def insert_project(target, project)
       path = project.split(%r{[:/]})
       todo = NA::Todo.new(file_path: target)
       built = []
@@ -602,6 +615,19 @@ module NA
       end
     end
 
+    # Find files matching criteria and containing actions.
+    # @param options [Hash] Options for file search
+    # @option options [Integer] :depth Search depth
+    # @option options [Boolean] :done Include done actions
+    # @option options [String] :file_path File path
+    # @option options [Boolean] :negate Negate search
+    # @option options [Boolean] :hidden Include hidden files
+    # @option options [String] :project Project name
+    # @option options [String] :query Query string
+    # @option options [Boolean] :regex Use regex
+    # @option options [String] :search Search string
+    # @option options [String] :tag Tag to filter
+    # @return [Array<String>] Matching files
     def find_files_matching(options = {})
       defaults = {
         depth: 1,
@@ -690,6 +716,10 @@ module NA
       end
     end
 
+    # Find a directory with an exact match from a list.
+    # @param dirs [Array<String>] Directories to search
+    # @param search [Array<Hash>] Search tokens
+    # @return [Array<String>] Matching directories
     def find_exact_dir(dirs, search)
       terms = search.filter { |s| !s[:negate] }.map { |t| t[:token] }.join(' ')
       out = dirs
@@ -878,6 +908,12 @@ module NA
       File.open(file, 'w') { |f| f.puts dirs.join("\n") }
     end
 
+    # List projects in a todo file or matching query.
+    # @param query [Array] Query tokens
+    # @param file_path [String, nil] File path
+    # @param depth [Integer] Search depth
+    # @param paths [Boolean] Show full paths
+    # @return [void]
     def list_projects(query: [], file_path: nil, depth: 1, paths: true)
       files = if NA.global_file
                 [NA.global_file]
@@ -906,6 +942,9 @@ module NA
       end
     end
 
+    # List todo files matching a query.
+    # @param query [Array] Query tokens
+    # @return [void]
     def list_todos(query: [])
       dirs = if query
                match_working_dir(query, distance: 2, require_last: false)
@@ -922,6 +961,10 @@ module NA
       puts NA::Color.template(dirs.join("\n"))
     end
 
+    # Save a search definition to the database.
+    # @param title [String] The search title
+    # @param search [String] The search string
+    # @return [void]
     def save_search(title, search)
       file = database_path(file: 'saved_searches.yml')
       searches = load_searches

data/lib/na/project.rb

@@ -1,6 +1,10 @@
 # frozen_string_literal: true
 
 module NA
+  # Represents a project section in a todo file, with indentation and line tracking.
+  #
+  # @example Create a new project
+  #   project = NA::Project.new('Inbox', 0, 1, 5)
   class Project < Hash
     attr_accessor :project, :indent, :line, :last_line
 
@@ -11,6 +15,8 @@ module NA
     # @param line [Integer] Starting line number
     # @param last_line [Integer] Ending line number
     # @return [void]
+    # @example
+    #   project = NA::Project.new('Inbox', 0, 1, 5)
     def initialize(project, indent = 0, line = 0, last_line = 0)
       super()
       @project = project
@@ -22,6 +28,8 @@ module NA
     # String representation of the project
     #
     # @return [String]
+    # @example
+    #   project.to_s #=> "{ project: 'Inbox', ... }"
     def to_s
       { project: @project, indent: @indent, line: @line, last_line: @last_line }.to_s
     end

data/lib/na/string.rb

@@ -1,15 +1,39 @@
 # frozen_string_literal: true
 
+# Special handling for nil strings
+class ::NilClass
+  # Always returns an empty string for nil.
+  # @return [String]
+  def highlight_filename
+    ''
+  end
+
+  # Always returns an empty string for nil.
+  # @param max [Integer] Maximum allowed length
+  # @return [String]
+  def trunc_middle(max)
+    ''
+  end
+end
+
+# Matches day names (e.g., mon, tue, wednesday)
+# @return [Regexp]
 REGEX_DAY = /^(mon|tue|wed|thur?|fri|sat|sun)(\w+(day)?)?$/i.freeze
+
+# Matches clock times (e.g., 12:30 pm, midnight)
+# @return [String]
 REGEX_CLOCK = '(?:\d{1,2}+(?::\d{1,2}+)?(?: *(?:am|pm))?|midnight|noon)'
+
+# Matches time strings using REGEX_CLOCK
+# @return [Regexp]
 REGEX_TIME = /^#{REGEX_CLOCK}$/i.freeze
 
 # String helpers
 class ::String
   # Insert a comment character at the start of every line
   # @param char [String] The character to insert (default #)
-  def comment(_char = '#')
-    split("\n").map { |l| "# #{l}" }.join("\n")
+  def comment(char = '#')
+    split("\n").map { |l| "#{char} #{l}" }.join("\n")
   end
 
   # Tests if object is nil or empty
@@ -25,6 +49,10 @@ class ::String
     line =~ /^#/ || line.strip.empty?
   end
 
+  # Returns the contents of the file, or raises if missing.
+  # Handles directories and NA extension.
+  # @return [String] Contents of the file
+  # @raise [RuntimeError] if the file does not exist
   def read_file
     file = File.expand_path(self)
     raise "Missing file #{file}" unless File.exist?(file)
@@ -64,11 +92,15 @@ class ::String
     !action? && self =~ /:( +@\S+(\([^)]*\))?)*$/
   end
 
+  # Returns the project name if matched, otherwise nil.
+  # @return [String, nil]
   def project
     m = match(/^([ \t]*)([^\-][^@:]*?): *(@\S+ *)*$/)
     m ? m[2] : nil
   end
 
+  # Returns the action text with leading dash and whitespace removed.
+  # @return [String]
   def action
     sub(/^[ \t]*- /, '')
   end
@@ -84,6 +116,8 @@ class ::String
   # Colorize the dirname and filename of a path
   # @return [String] Colorized string
   def highlight_filename
+    return '' if nil?
+
     dir = File.dirname(self).shorten_path.trunc_middle(TTY::Screen.columns / 3)
     file = NA.include_ext ? File.basename(self) : File.basename(self, ".#{NA.extension}")
     "#{NA.theme[:dirname]}#{dir}/#{NA.theme[:filename]}#{file}{x}"
@@ -135,14 +169,15 @@ class ::String
   # @param max [Integer] Maximum allowed length of the string
   # @return [String] Truncated string with middle replaced if necessary
   def trunc_middle(max)
-  return '' if self.nil?
-  return self unless length > max
-
-  half = (max / 2).floor - 3
-  chars = chars
-  pre = chars.slice(0, half)
-  post = chars.reverse.slice(0, half).reverse
-  "#{pre.join}[...]#{post.join}"
+    return '' if nil?
+
+    return self unless length > max
+
+    half = (max / 2).floor - 3
+    cs = chars
+    pre = cs.slice(0, half)
+    post = cs.reverse.slice(0, half).reverse
+    "#{pre.join}[...]#{post.join}"
   end
 
   # Wrap the string to a given width, indenting each line and preserving tag formatting.

data/lib/na/theme.rb

@@ -1,10 +1,16 @@
 # frozen_string_literal: true
 
 module NA
+  # Provides theme and color template helpers for todo CLI output.
+  #
+  # @example Get theme help text
+  #   NA::Theme.template_help
   module Theme
     class << self
       # Returns a help string describing available color placeholders for themes.
       # @return [String] Help text for theme placeholders
+      # @example
+      #   NA::Theme.template_help
       def template_help
         <<~EOHELP
           Use {X} placeholders to apply colors. Available colors are:
@@ -28,6 +34,8 @@ module NA
       # Writes the help text and theme YAML to the theme file.
       # @param template [Hash] Additional theme settings to merge
       # @return [Hash] The merged theme configuration
+      # @example
+      #   NA::Theme.load_theme(template: { action: '{r}' })
       def load_theme(template: {})
         NA::Benchmark.measure('Theme.load_theme') do
           # Default colorization, can be overridden with full or partial template variable

data/lib/na/todo.rb

@@ -1,6 +1,10 @@
 # frozen_string_literal: true
 
 module NA
+  # Represents a parsed todo file, including actions, projects, and file management.
+  #
+  # @example Parse a todo file
+  #   todo = NA::Todo.new(file_path: 'todo.txt')
   class Todo
     attr_accessor :actions, :projects, :files
 
@@ -8,6 +12,8 @@ module NA
     #
     # @param options [Hash] Options for parsing todo files
     # @return [void]
+    # @example
+    #   todo = NA::Todo.new(file_path: 'todo.txt')
     def initialize(options = {})
       @files, @actions, @projects = parse(options)
     end
@@ -26,6 +32,8 @@ module NA
     # @option options [Boolean] :require_na Require @na tag
     # @option options [String] :file_path file path to parse
     # @return [Array] files, actions, projects
+    # @example
+    #   files, actions, projects = todo.parse(file_path: 'todo.txt')
     def parse(options)
       NA::Benchmark.measure('Todo.parse') do
         defaults = {

data/lib/na/version.rb

@@ -1,5 +1,9 @@
 # frozen_string_literal: true
 
+##
+# Main module for the na gem, providing version information.
 module Na
-  VERSION = '1.2.84'
+  ##
+  # Current version of the na gem.
+  VERSION = '1.2.85'
 end

data/src/_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 <!--VER-->1.2.83<!--END VER-->.
+The current version of `na` is <!--VER-->1.2.84<!--END VER-->.
 
 `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.
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: na
 version: !ruby/object:Gem::Version
-  version: 1.2.84
+  version: 1.2.85
 platform: ruby
 authors:
 - Brett Terpstra