hookapp 2.0.5 → 2.0.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 06acc4dd72c5ca227e0cbf252542ca79e42a31d624b5e78f609cfb019220f3c3
-  data.tar.gz: 6f2f660014f3486dd80a0fd06c52aa6822844097580780b6addf247ee0ee8cee
+  metadata.gz: 5a5b6a517bd76ec8ddfc8ef6ffb98d6690dc56c2d5133bb1ad88635d72aaf55e
+  data.tar.gz: ddd95cde21eba658a09a98c04c49a03e98853bc450b257d2f6ad843cdf084f35
 SHA512:
-  metadata.gz: 4c3c57b1879c66c9ce671bf3eb7a676e9d543962a50c0647ade2d451f93207c071d34c67a93ccdde8fcf5d19e54a0bb53a056e8cba928e5c6b6cdf69868b69ab
-  data.tar.gz: 5ba08b7b5ef07d6d0062fc18cfea73957d83146194185de9e1d1cbaf8f5680f230792a919a954099b03e26c023fe204766ece2429acc9fe4de1b0e233418d76a
+  metadata.gz: 2ab5784b34f8a8380b37202cd1a674c78083e6ec1748f3320f4292933a7cc20cd20db520daa7fd697dade590fa32d5f7d21224e1ebae4396fe5ec2aaff7f6081
+  data.tar.gz: b45ce5ede9b4fa988f660fb5943b0ce1a7ee8e7bfffd9d0d5a45b0a4138c1db812a8f36dffcba02159e20f370e64e2b611e2e968a61fbf2d763ec03295d927d2

data/AUTHORS.md

@@ -0,0 +1,4 @@
+## Authors
+
+- Brett Terpstra <me@brettterpstra.com>
+- Josh Nichols <joshua.nichols@gmail.com>

data/CHANGELOG.md

@@ -1,3 +1,12 @@
+#### 2.0.9
+
+- Fix fzf integration across platforms
+
+#### 2.0.8
+
+- Bug fixes
+- New tests
+
 #### 2.0.3
 
 - Incorporate `fzf` for selecting and filtering hooks

data/Gemfile.lock

@@ -1,8 +1,9 @@
 PATH
   remote: .
   specs:
-    hookapp (2.0.4)
+    hookapp (2.0.9)
       gli (~> 2.20.1)
+      tty-which (~> 0.5, >= 0.5.0)
 
 GEM
   remote: http://rubygems.org/
@@ -17,53 +18,47 @@ GEM
     builder (3.2.4)
     childprocess (3.0.0)
     contracts (0.17)
-    cucumber (7.0.0)
+    cucumber (8.0.0)
       builder (~> 3.2, >= 3.2.4)
-      cucumber-core (~> 10.0, >= 10.0.1)
-      cucumber-create-meta (~> 6.0, >= 6.0.1)
-      cucumber-cucumber-expressions (~> 12.1, >= 12.1.1)
-      cucumber-gherkin (~> 20.0, >= 20.0.1)
-      cucumber-html-formatter (~> 16.0, >= 16.0.1)
-      cucumber-messages (~> 17.0, >= 17.0.1)
-      cucumber-wire (~> 6.0, >= 6.0.1)
-      diff-lcs (~> 1.4, >= 1.4.4)
-      mime-types (~> 3.3, >= 3.3.1)
-      multi_test (~> 0.1, >= 0.1.2)
+      cucumber-ci-environment (~> 9.0, >= 9.0.4)
+      cucumber-core (~> 11.0, >= 11.0.0)
+      cucumber-cucumber-expressions (~> 15.1, >= 15.1.1)
+      cucumber-gherkin (~> 23.0, >= 23.0.1)
+      cucumber-html-formatter (~> 19.1, >= 19.1.0)
+      cucumber-messages (~> 18.0, >= 18.0.0)
+      diff-lcs (~> 1.5, >= 1.5.0)
+      mime-types (~> 3.4, >= 3.4.1)
+      multi_test (~> 1.1, >= 1.1.0)
       sys-uname (~> 1.2, >= 1.2.2)
-    cucumber-core (10.0.1)
-      cucumber-gherkin (~> 20.0, >= 20.0.1)
-      cucumber-messages (~> 17.0, >= 17.0.1)
-      cucumber-tag-expressions (~> 3.0, >= 3.0.1)
-    cucumber-create-meta (6.0.1)
-      cucumber-messages (~> 17.0, >= 17.0.1)
-      sys-uname (~> 1.2, >= 1.2.2)
-    cucumber-cucumber-expressions (12.1.3)
-    cucumber-gherkin (20.0.1)
-      cucumber-messages (~> 17.0, >= 17.0.1)
-    cucumber-html-formatter (16.0.1)
-      cucumber-messages (~> 17.0, >= 17.0.1)
-    cucumber-messages (17.1.1)
-    cucumber-tag-expressions (3.0.1)
-    cucumber-wire (6.1.1)
-      cucumber-core (~> 10.0, >= 10.0.1)
-      cucumber-cucumber-expressions (~> 12.1, >= 12.1.2)
-      cucumber-messages (~> 17.0, >= 17.0.1)
-    diff-lcs (1.4.4)
-    ffi (1.15.4)
+    cucumber-ci-environment (9.0.4)
+    cucumber-core (11.0.0)
+      cucumber-gherkin (~> 23.0, >= 23.0.1)
+      cucumber-messages (~> 18.0, >= 18.0.0)
+      cucumber-tag-expressions (~> 4.1, >= 4.1.0)
+    cucumber-cucumber-expressions (15.2.0)
+    cucumber-gherkin (23.0.1)
+      cucumber-messages (~> 18.0, >= 18.0.0)
+    cucumber-html-formatter (19.1.0)
+      cucumber-messages (~> 18.0, >= 18.0.0)
+    cucumber-messages (18.0.0)
+    cucumber-tag-expressions (4.1.0)
+    diff-lcs (1.5.0)
+    ffi (1.15.5)
     gli (2.20.1)
-    mime-types (3.3.1)
+    mime-types (3.4.1)
       mime-types-data (~> 3.2015)
-    mime-types-data (3.2021.0901)
-    multi_test (0.1.2)
+    mime-types-data (3.2022.0105)
+    multi_test (1.1.0)
     rake (13.0.6)
-    rdoc (6.3.2)
-    rspec-expectations (3.10.1)
+    rdoc (6.3.3)
+    rspec-expectations (3.11.0)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.10.0)
-    rspec-support (3.10.2)
+      rspec-support (~> 3.11.0)
+    rspec-support (3.11.0)
     sys-uname (1.2.2)
       ffi (~> 1.1)
-    thor (1.1.0)
+    thor (1.2.1)
+    tty-which (0.5.0)
 
 PLATFORMS
   ruby

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021 Brett Terpstra
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -2,9 +2,11 @@
 
 CLI interface for Hook.app (macOS)
 
-> Hook.app is a productivity tool for macOS <https://hookproductivity.com/>. This gem includes a `hook` binary that allows interaction with the features of Hook.app.
+> Hook.app is a productivity tool for macOS <https://hookproductivity.com/>.
 
-*v2.0.3*
+This gem includes a `hook` binary that allows interaction with the features of Hook.app.
+
+*v2.0.9*
 
 ## Installation
 
@@ -99,13 +101,13 @@ Display the program version
 
 ## Commands
 
-### `$ hook` <mark>`clip|cp`</mark> ` FILE_OR_URL`
+### `$ hook` <mark>`clip|cp`</mark> `FILE_OR_URL`
 
 *Copy Hook URL for file/url to clipboard*
 
 > Creates a bookmark for the specified file or URL and copies its Hook URL to the clipboard.
 > 
-> The copied Hook URL can be used to link to other files (use `hook link --paste FILE/URL),
+> The copied Hook URL can be used to link to other files (use `hook link --paste FILE/URL`,
 > or to paste into another app as a link. Use the -m flag to copy a full Markdown link.
 
 #### Options
@@ -120,15 +122,17 @@ Copy as Markdown
 
 * * * * * *
 
-### `$ hook` <mark>`clone`</mark> ` SOURCE TARGET`
+### `$ hook` <mark>`clone`</mark> `SOURCE TARGET`
 
 *Clone all hooks from one file or url onto another*
 
-> Copy all the files and urls that the first file is hooked to onto another file. Exactly two arguments (SOURCE, TARGET) required.
+> Copy all the files and urls that the first file is hooked to onto another file.
+> 
+> Exactly two arguments (SOURCE, TARGET) required.
 
 * * * * * *
 
-### `$ hook` <mark>`find|search`</mark> ` SEARCH_STRING`
+### `$ hook` <mark>`find|search`</mark> `[SEARCH_STRING]`
 
 *Search bookmarks*
 
@@ -138,7 +142,7 @@ Copy as Markdown
 
 #### Options
 
-##### `-o` | `--output_format` format
+##### `-o` | `--output_format` FORMAT
 
 Output format [(h)ooks, (p)aths, (m)arkdown, (v)erbose]
 
@@ -158,7 +162,7 @@ Separate results with NULL separator, only applies with "paths" output for singl
 
 * * * * * *
 
-### `$ hook` <mark>`from`</mark> ` APPLICATION_NAME`
+### `$ hook` <mark>`from`</mark> `APPLICATION_NAME`
 
 *Get a Hook URL for the frontmost window of an app*
 
@@ -179,7 +183,7 @@ Output as Markdown
 
 * * * * * *
 
-### `$ hook` <mark>`help`</mark> ` command`
+### `$ hook` <mark>`help`</mark> `command`
 
 *Shows a list of commands or help for one command*
 
@@ -193,7 +197,7 @@ List commands one per line, to assist with shell completion
 
 * * * * * *
 
-### `$ hook` <mark>`link|ln`</mark> ` SOURCE [SOURCE...] TARGET`
+### `$ hook` <mark>`link|ln`</mark> `SOURCE... TARGET`
 
 *Create bidirectional hooks between two or more files/urls*
 
@@ -217,7 +221,7 @@ Paste URL from clipboard
 
 * * * * * *
 
-### `$ hook` <mark>`list|ls`</mark> ` FILE_OR_URL [FILE_OR_URL...]`
+### `$ hook` <mark>`list|ls`</mark> `[FILE_OR_URL]...`
 
 *List hooks on a file or url*
 
@@ -227,7 +231,7 @@ Paste URL from clipboard
 
 #### Options
 
-##### `-o` | `--output_format` format
+##### `-o` | `--output_format` FORMAT
 
 Output format [(h)ooks, (p)aths, (m)arkdown, (v)erbose]
 
@@ -249,15 +253,35 @@ Generate a menu to select hook(s) for opening
 
 * * * * * *
 
-### `$ hook` <mark>`open|gui`</mark> ` FILE_OR_URL`
+### `$ hook` <mark>`open|gui`</mark> `FILE_OR_URL`
 
 *Open the specified file or url in Hook GUI*
 
-> Opens Hook.app on the specified file/URL for browsing and performing actions. Exactly one argument (File/URL) required.
+> Opens Hook.app on the specified file/URL for browsing and performing actions.
+> 
+> Exactly one argument (File/URL) required.
+
+* * * * * *
+
+### `$ hook` <mark>`percent`</mark> `STRING`
+
+*Percent encode/decode a string*
+
+> Use encode or decode to apply Hook's url encoding to a string argument. Use '-' to read input from STDIN.
+
+#### Commands
+
+##### `$ hook` <mark>`percent decode`</mark> `STRING`
+
+*decode a percent-encoded string*
+
+##### `$ hook` <mark>`percent encode`</mark> `STRING`
+
+*percent encode a string*
 
 * * * * * *
 
-### `$ hook` <mark>`remove|rm`</mark> ` ITEM_1 ITEM_2`
+### `$ hook` <mark>`remove|rm`</mark> `FILE_OR_URL...`
 
 *Remove a hook between two files/urls*
 
@@ -271,9 +295,13 @@ Generate a menu to select hook(s) for opening
 
 Remove ALL links on files, requires confirmation
 
+##### `-f`|`--force`
+
+
+
 * * * * * *
 
-### `$ hook` <mark>`scripts`</mark> ` SHELL`
+### `$ hook` <mark>`scripts`</mark> `SHELL`
 
 *Shell completion examples*
 
@@ -281,7 +309,7 @@ Remove ALL links on files, requires confirmation
 
 * * * * * *
 
-### `$ hook` <mark>`select`</mark> ` FILE_OR_URL`
+### `$ hook` <mark>`select`</mark> `FILE_OR_URL`
 
 *Select from hooks on a file/url and open in default application*
 
@@ -292,6 +320,11 @@ Remove ALL links on files, requires confirmation
 * * * * * *
 
 #### [Default Command] help
+## Authors
+
+- Brett Terpstra <me@brettterpstra.com>
+- Josh Nichols <joshua.nichols@gmail.com>
+
 ## Credits
 
 HookApp embeds [Fuzzy Finder](https://github.com/junegunn/fzf) under the [MIT License](https://github.com/junegunn/fzf/blob/master/LICENSE)
@@ -325,5 +358,5 @@ This software is licensed under the MIT License.
 	THE SOFTWARE.
 
 
-Documentation generated 2021-09-18 12:29
+Documentation generated 2022-05-26 08:29
 

data/Rakefile

@@ -4,6 +4,7 @@ require 'rubygems/package_task'
 require 'rdoc/task'
 require 'cucumber'
 require 'cucumber/rake/task'
+require 'rake/testtask'
 Rake::RDocTask.new do |rd|
   rd.main = "README.rdoc"
   rd.rdoc_files.include("README.rdoc","lib/**/*.rb","bin/**/*")
@@ -14,6 +15,7 @@ spec = eval(File.read('hookapp.gemspec'))
 
 Gem::PackageTask.new(spec) do |pkg|
 end
+
 CUKE_RESULTS = 'results.html'
 CLEAN << CUKE_RESULTS
 desc 'Run features'
@@ -35,10 +37,12 @@ end
 task :cucumber => :features
 task 'cucumber:wip' => 'features:wip'
 task :wip => 'features:wip'
-require 'rake/testtask'
+
 Rake::TestTask.new do |t|
-  t.libs << "test"
+  t.libs << ['test', 'test/helpers']
   t.test_files = FileList['test/*_test.rb']
+  t.verbose = ENV['VERBOSE'] =~ /(true|1)/i ? true : false
 end
 
-task :default => [:test,:features]
+# task :default => [:test,:features]
+task :default => [:test]

data/bin/hook

@@ -1,14 +1,17 @@
-#!/usr/bin/env ruby
+#!/usr/bin/env ruby -W1
 # frozen_string_literal: true
 
 require 'hook'
+require 'shellwords'
 
 # Main class for GLI app
 class App
   extend GLI::App
 
   program_desc 'CLI interface for Hook.app (macOS)'
-  program_long_desc 'Hook.app is a productivity tool for macOS <https://hookproductivity.com/>. This gem includes a `hook` binary that allows interaction with the features of Hook.app.'
+  program_long_desc 'Hook.app is a productivity tool for macOS <https://hookproductivity.com/>.
+
+This gem includes a `hook` binary that allows interaction with the features of Hook.app.'
   default_command 'help'
   autocomplete_commands = true
   synopsis_format(:terminal)
@@ -19,14 +22,13 @@ class App
   arguments :strict
 
   hookapp = nil
+  stdin = nil
 
   desc 'List hooks on a file or url'
-  long_desc %{
-Output a list of all hooks attached to given url(s) or file(s) in the specified format (default "paths").
-
-Run `hook list` with no file/url argument to list all bookmarks.}
+  long_desc %(Output a list of all hooks attached to given url(s) or file(s) in the specified format (default "paths").
 
-  arg_name 'FILE_OR_URL [FILE_OR_URL...]'
+Run `hook list` with no file/url argument to list all bookmarks.)
+  arg_name 'FILE_OR_URL', [:optional, :multiple]
   command %i[list ls] do |c|
     c.desc 'Generate a menu to select hook(s) for opening'
     c.long_desc 'This option is a shortcut to `hook select` and overrides any other arguments.'
@@ -41,20 +43,22 @@ Run `hook list` with no file/url argument to list all bookmarks.}
     valid_formats = %w[hooks paths markdown verbose]
     fmt_list = valid_formats.map { |fmt| fmt.sub(/^(.)(.*?)$/, '(\1)\2') }.join(', ')
     c.desc "Output format [#{fmt_list}]"
-    c.flag %i[o output_format], { arg_name: 'format', default_value: 'paths' }
+    c.arg_name 'FORMAT'
+    c.flag %i[o output_format], { arg_name: 'FORMAT', default_value: 'paths' }
 
     c.action do |_global_options, options, args|
       if options[:s]
-        return hookapp.open_linked(args[0])
-      end
-      valid_format = hookapp.validate_format(options[:o], valid_formats)
-      exit_now!("Invalid output format: \"#{options[:o]}\"", 6) unless valid_format
+        hookapp.open_linked(args[0])
+      else
+        valid_format = hookapp.validate_format(options[:o], valid_formats)
+        help_now!("Invalid output format: \"#{options[:o]}\"", 6) unless valid_format
 
-      result = hookapp.linked_bookmarks(args, { files_only: options[:f],
-                                               format: valid_format,
-                                               null_separator: options[:null] })
+        result = hookapp.linked_bookmarks(args, { files_only: options[:f],
+                                                 format: valid_format,
+                                                 null_separator: options[:null] })
 
-      puts result
+        puts result
+      end
     end
   end
 
@@ -62,25 +66,21 @@ Run `hook list` with no file/url argument to list all bookmarks.}
   # the full shell name as the extension, e.g. "hook_completion.bash".
   desc 'Shell completion examples'
   valid_shells = %w[bash zsh fish]
-  long_desc %{
-Output completion script example for the specified shell (#{valid_shells.join(', ')})
-  }
+  long_desc %(Output completion script example for the specified shell (#{valid_shells.join(', ')}))
   arg_name 'SHELL'
   command %i[scripts] do |c|
     c.action do |_global_options, _options, args|
       if args.length > 1
-        exit_now!("Invalid number of arguments, (expected 1)", 5)
+        help_now!('Invalid number of arguments, (expected 1)', 5)
       elsif args.nil? || args.empty?
-        exit_now!("Specify a shell (#{valid_shells.join(', ')})", 0)
+        help_now!("Specify a shell (#{valid_shells.join(', ')})", 0)
+      elsif valid_shells.include?(args[0])
+        base_dir = File.expand_path(File.join(File.dirname(__FILE__), '../lib/completion'))
+        completion = File.join(base_dir, "hook_completion.#{args[0]}")
+        script = IO.read(completion)
+        $stdout.puts script
       else
-        if valid_shells.include?(args[0])
-          base_dir = File.expand_path(File.join(File.dirname(__FILE__), '../lib/completion'))
-          completion = File.join(base_dir, "hook_completion.#{args[0]}")
-          script = IO.read(completion)
-          $stdout.puts script
-        else
-          exit_now!("Invalid shell name, must be one of #{valid_shells.join(', ')}", 1)
-        end
+        help_now!("Invalid shell name, must be one of #{valid_shells.join(', ')}", 1)
       end
     end
   end
@@ -88,11 +88,10 @@ Output completion script example for the specified shell (#{valid_shells.join(',
 
 
   desc 'Search bookmarks'
-  long_desc %{
-Search bookmark urls and names for a string and output in specified format (default "paths").
+  long_desc %(Search bookmark urls and names for a string and output in specified format (default "paths").
 
-Run `hook find` with no search argument to list all bookmarks.}
-  arg_name 'SEARCH_STRING'
+Run `hook find` with no search argument to list all bookmarks.)
+  arg_name 'SEARCH_STRING', :optional
   command %i[find search] do |c|
     c.desc 'Output only bookmarks with file paths (exclude e.g. emails)'
     c.switch %i[f files_only], { negatable: false, default_value: false }
@@ -104,7 +103,7 @@ Run `hook find` with no search argument to list all bookmarks.}
     fmt_list = valid_formats.map { |fmt| fmt.sub(/^(.)(.*?)$/, '(\1)\2') }.join(', ')
 
     c.desc "Output format [#{fmt_list}]"
-    c.flag %i[o output_format], { arg_name: 'format', default_value: 'paths' }
+    c.flag %i[o output_format], { arg_name: 'FORMAT', default_value: 'paths' }
 
     c.desc "Search only bookmark names"
     c.switch %i[n names_only], { negatable: false, default_value: false }
@@ -123,16 +122,15 @@ Run `hook find` with no search argument to list all bookmarks.}
   end
 
   desc 'Create bidirectional hooks between two or more files/urls'
-  long_desc %{
-If two files/urls are provided, links will be bi-directional.
+  long_desc 'If two files/urls are provided, links will be bi-directional.
 If three or more are provided, `link` defaults to creating bi-directional
 links between each file and the last file in the list. Use `-a` to create
 bi-directional links between every file in the list.
 
 If using `--paste`, the URL/hook link in the clipboard will be used as one argument,
 to be combined with one or more file/url arguments.
-  }
-  arg_name 'SOURCE [SOURCE...] TARGET'
+  '
+  arg_name 'SOURCE... TARGET'
   command %i[link ln] do |c|
     c.desc 'Link every listed file or url to every other'
     c.switch %i[a all],  { negatable: false, default_value: false }
@@ -158,12 +156,10 @@ to be combined with one or more file/url arguments.
   end
 
   desc 'Copy Hook URL for file/url to clipboard'
-  long_desc %{
-Creates a bookmark for the specified file or URL and copies its Hook URL to the clipboard.
+  long_desc %{Creates a bookmark for the specified file or URL and copies its Hook URL to the clipboard.
 
-The copied Hook URL can be used to link to other files (use `hook link --paste FILE/URL),
-or to paste into another app as a link. Use the -m flag to copy a full Markdown link.
-  }
+The copied Hook URL can be used to link to other files (use `hook link --paste FILE/URL`,
+or to paste into another app as a link. Use the -m flag to copy a full Markdown link.}
   arg_name 'FILE_OR_URL'
   command %i[clip cp] do |c|
     c.desc 'Copy as Markdown'
@@ -184,12 +180,10 @@ or to paste into another app as a link. Use the -m flag to copy a full Markdown
   end
 
   desc 'Get a Hook URL for the frontmost window of an app'
-  long_desc %{
-Specify an application by name (without '.app') to bring that app to the foreground and create a bookmark
+  long_desc %(Specify an application by name (without '.app') to bring that app to the foreground and create a bookmark
 for the active document, note, task, etc., returning a Hook URL.
 
-Use -m to get the response as Markdown, and/or -c to copy the result directly to the clipboard.
-  }
+Use -m to get the response as Markdown, and/or -c to copy the result directly to the clipboard.)
   arg_name 'APPLICATION_NAME'
   command %i[from] do |c|
     c.desc 'Output as Markdown'
@@ -206,26 +200,25 @@ Use -m to get the response as Markdown, and/or -c to copy the result directly to
   end
 
   desc 'Remove a hook between two files/urls'
-  long_desc %{
-Remove a hook between two files or URLs. If you use --all, all hooks on a given file will be removed.
+  long_desc %(Remove a hook between two files or URLs. If you use --all, all hooks on a given file will be removed.
 
-If --all isn't specified, exactly two arguments (Files/URLs) are required.
-  }
-  arg_name 'ITEM_1 ITEM_2'
+If --all isn't specified, exactly two arguments (Files/URLs) are required.)
+  arg_name 'FILE_OR_URL', :multiple
   command %i[remove rm] do |c|
     c.desc 'Remove ALL links on files, requires confirmation'
     c.switch %i[a all], { negatable: false, default_value: false }
+    c.switch %i[f force], { negatable: false, default_value: false }
 
     c.action do |_global_options, options, args|
-      result = hookapp.delete_hooks(args, { all: options[:a] })
+      result = hookapp.delete_hooks(args, { all: options[:all], force: options[:force] })
       puts result
     end
   end
 
   desc 'Clone all hooks from one file or url onto another'
-  long_desc %{
-Copy all the files and urls that the first file is hooked to onto another file. Exactly two arguments (SOURCE, TARGET) required.
-  }
+  long_desc 'Copy all the files and urls that the first file is hooked to onto another file.
+
+Exactly two arguments (SOURCE, TARGET) required.'
   arg_name 'SOURCE TARGET'
   command %i[clone] do |c|
     c.action do |_global_options, _options, args|
@@ -237,39 +230,83 @@ Copy all the files and urls that the first file is hooked to onto another file.
   end
 
   desc 'Select from hooks on a file/url and open in default application'
-  long_desc %{
-If the target file/URL has hooked items, a menu will be provided. Selecting one or more files
+  long_desc %(If the target file/URL has hooked items, a menu will be provided. Selecting one or more files
 from this menu will open the item(s) using the default application assigned to the
-filetype by macOS. Allows multiple selections with tab key, and type-ahead fuzzy filtering of results.
-}
+filetype by macOS. Allows multiple selections with tab key, and type-ahead fuzzy filtering of results.)
   arg_name 'FILE_OR_URL'
   command %i[select] do |c|
     c.action do |_global_options, _options, args|
-      exit_now!("Wrong number of arguments. One file path or url required (#{args.length} given)", 5) if args.length != 1
+      help_now!("Wrong number of arguments. One file path or url required (#{args.length} given)", 5) if args.length != 1
 
       hookapp.open_linked(args[0])
     end
   end
 
   desc 'Open the specified file or url in Hook GUI'
-  long_desc %{
-Opens Hook.app on the specified file/URL for browsing and performing actions. Exactly one argument (File/URL) required.
-  }
+  long_desc 'Opens Hook.app on the specified file/URL for browsing and performing actions.
+
+Exactly one argument (File/URL) required.'
   arg_name 'FILE_OR_URL'
   command %i[open gui] do |c|
     c.action do |_global_options, _options, args|
-      exit_now!("Wrong number of arguments. One file path or url required (#{args.length} given)", 5) if args.length != 1
+      if args.length != 1
+        help_now!("Wrong number of arguments. One file path
+                or url required (#{args.length} given)", 5)
+      end
 
       hookapp.open_gui(args[0])
     end
   end
 
+  desc 'Percent encode/decode a string'
+  long_desc %(Use encode or decode to apply Hook's url encoding to a string argument. Use '-' to read input from STDIN.)
+  arg_name 'STRING'
+  command :percent do |c|
+    c.desc 'percent encode a string'
+    c.arg_name 'STRING'
+    c.command :encode do |enc|
+      enc.action do |_global_options, _options, args|
+        if stdin
+          string = stdin
+        else
+          help_now!('No string provided') unless args.size.positive?
+
+          string = args.join(' ').strip
+        end
+
+        print hookapp.encode(string)
+      end
+    end
+
+    c.desc 'decode a percent-encoded string'
+    c.arg_name 'STRING'
+    c.command :decode do |dec|
+      dec.action do |_global_options, _options, args|
+        if stdin
+          string = stdin
+        else
+          help_now!('no string provided') unless args.size.positive?
+
+          string = args.join(' ').strip
+        end
+
+        print hookapp.decode(string)
+      end
+    end
+
+    # c.default_command :encode
+  end
+
   pre do |global, _command, _options, _args|
     # Pre logic here
     # Return true to proceed; false to abort and not call the
     # chosen command
     # Use skips_pre before a command to skip this block
     # on that command only
+    if !STDIN.tty?
+      stdin = STDIN.read.strip
+    end
+
     hookapp = HookApp.new
     true
   end