summon-open 1.1.0 → 1.1.1

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "summon-open",
-	"version": "1.1.0",
+	"version": "1.1.1",
 	"description": "Open URLs, files, folders, and apps from one cross-platform command — with bookmarks, search, clipboard, reveal, dry-run, and stdin support.",
 	"license": "MIT",
 	"repository": {

package/readme.md

@@ -14,6 +14,8 @@
 Bookmarks, search, clipboard, reveal-in-file-manager, dry-run, multiple targets, and stdin — all in a tool small enough to forget it's there. No more remembering `xdg-open` vs `start` vs `open`.
 
 [![npm version](https://img.shields.io/npm/v/summon-open.svg)](https://www.npmjs.com/package/summon-open)
+[![npm downloads](https://img.shields.io/npm/dm/summon-open.svg)](https://www.npmjs.com/package/summon-open)
+[![install size](https://packagephobia.com/badge?p=summon-open)](https://packagephobia.com/result?p=summon-open)
 [![node](https://img.shields.io/node/v/summon-open.svg)](https://nodejs.org)
 [![license](https://img.shields.io/npm/l/summon-open.svg)](license)
 [![CI](https://github.com/Aditya060806/summon/actions/workflows/main.yml/badge.svg)](https://github.com/Aditya060806/summon/actions)
@@ -55,7 +57,7 @@ $ cat diagram.png | summon                  # pipe raw bytes straight in
   - [Web search](#web-search)
   - [Clipboard](#clipboard)
   - [Reveal in file manager](#reveal-in-file-manager)
-  - [Recent & interactive picker](#recent--interactive-picker)
+  - [Recent & fuzzy picker](#recent--fuzzy-picker)
   - [Dry run](#dry-run)
   - [Choosing the app](#choosing-the-app)
   - [Stdin](#stdin)
@@ -66,6 +68,7 @@ $ cat diagram.png | summon                  # pipe raw bytes straight in
 - [Comparison](#comparison)
   - [Feature matrix](#feature-matrix)
   - [Same task, side by side](#same-task-side-by-side)
+  - [vs other npm openers](#vs-other-npm-openers)
 - [Efficiency](#efficiency)
 - [Exit codes](#exit-codes)
 - [Platform support](#platform-support)
@@ -224,6 +227,8 @@ $ summon --help
     --extension         File extension for when stdin file type cannot be detected
     --dry-run, -n       Print what would be opened without opening it
     --search, -s        Treat the input as a search query
+    --engine, -e        Search engine to use with --search (see --engines)
+    --engines           List available search engines
     --clipboard, -c     Open the URL/path currently on the clipboard
     --reveal, -r        Reveal the file/folder in your file manager
     --recent            Pick from recently opened items
@@ -233,12 +238,13 @@ $ summon --help
 
   Examples
     $ summon https://sindresorhus.com
-    $ summon github.com
+    $ summon github.com                 # scheme added automatically
     $ summon report.pdf photo.png notes.txt
     $ summon https://github.com -- 'google chrome' --incognito
-    $ summon @docs
+    $ summon @docs                      # open a saved bookmark
     $ summon https://docs.example.com --save docs
     $ summon -s "rust async traits"
+    $ summon -s "flatMap" -e mdn
     $ echo '<h1>Hi</h1>' | summon --extension=html
     $ summon report.pdf --reveal
     $ summon --recent
@@ -338,7 +344,7 @@ summon report.pdf --reveal
 - **Windows** — `explorer /select,` (selects the file in Explorer)
 - **Linux/other** — opens the containing folder
 
-### Recent & interactive picker
+### Recent & fuzzy picker
 
 `summon` remembers what you open. Re-open something recent:
 
@@ -583,6 +589,33 @@ The value shows up most when you compare the actual commands for the same job.
 | Preview without launching | `summon x.com --dry-run` | no native equivalent |
 | Pipe + auto-detect type | `cat f \| summon` | no native equivalent |
 
+### vs other npm openers
+
+The npm ecosystem has a few ways to open things. `summon` builds on the excellent [`open`](https://github.com/sindresorhus/open) library (the programmatic API) and starts from [`open-cli`](https://github.com/sindresorhus/open-cli), then adds a workflow layer on top.
+
+| Capability | **summon** | [`open-cli`](https://www.npmjs.com/package/open-cli) | [`opener`](https://www.npmjs.com/package/opener) | [`open`](https://www.npmjs.com/package/open) |
+| --- | :---: | :---: | :---: | :---: |
+| Ships a CLI command | ✅ | ✅ | ✅ | ❌ (library) |
+| Cross-platform | ✅ | ✅ | ✅ | ✅ |
+| Open URL / file / folder / app | ✅ | ✅ | ✅ | ✅ (API) |
+| Choose app + pass args (`-- app …`) | ✅ | ✅ | ❌ | ✅ (API) |
+| Wait / background | ✅ | ✅ | ❌ | ✅ (API) |
+| Stdin + file-type detection | ✅ | ✅ | ❌ | ❌ |
+| Multiple targets in one call | ✅ | ❌ | ❌ | ❌ |
+| Auto `https://` for bare domains | ✅ | ❌ | ❌ | ❌ |
+| Bookmarks / aliases | ✅ | ❌ | ❌ | ❌ |
+| Web search + configurable engines | ✅ | ❌ | ❌ | ❌ |
+| Open from clipboard | ✅ | ❌ | ❌ | ❌ |
+| Reveal in file manager | ✅ | ❌ | ❌ | ❌ |
+| Recent + fuzzy picker | ✅ | ❌ | ❌ | ❌ |
+| Dry-run preview | ✅ | ❌ | ❌ | ❌ |
+| Typed exit codes + friendly errors | ✅ | ⚠️ | ⚠️ | n/a |
+| Shell completions | ✅ | ❌ | ❌ | n/a |
+
+✅ yes · ⚠️ basic/partial · ❌ no · n/a not applicable
+
+**In short:** reach for [`open`](https://www.npmjs.com/package/open) when you need a programmatic API inside Node code; reach for `open-cli` or `opener` for a bare "open this one thing" command; reach for **summon** when you want that same reliability *plus* multiple targets, bookmarks, search, clipboard, reveal, a fuzzy picker, and dry-run in day-to-day terminal use.
+
 ## Efficiency
 
 `summon` is designed to add as little overhead as possible on top of the native OS handler.