From 8b398363576f8795b6fb0477f74dd8dd92f3bc78 Mon Sep 17 00:00:00 2001
From: Yang Jun <harttleharttle@gmail.com>
Date: Tue, 28 Jul 2026 00:01:15 +0800
Subject: [PATCH] feat!: remove --template CLI option

Template is positional-only; bare stdin template and --template/-t are both removed. Keep @- for template and --context.

Co-authored-by: Cursor <cursoragent@cursor.com>
---
 README.md                      |  1 -
 bin/liquid.js                  | 15 ++-------------
 docs/source/tutorials/setup.md |  3 +--
 3 files changed, 3 insertions(+), 16 deletions(-)

diff --git a/README.md b/README.md
index 16affc679..bdda8ace2 100644
--- a/README.md
+++ b/README.md
@@ -47,7 +47,6 @@ npm install liquidjs
 
 ```bash
 npx liquidjs 'Hello, {{ name }}!' --context '{"name": "Liquid"}'
-# or: npx liquidjs --template 'Hello, {{ name }}!' --context '{"name": "Liquid"}'
 ```
 
 See the [setup guide][setup] for partials, layouts, caching, and other options.
diff --git a/bin/liquid.js b/bin/liquid.js
index 964f8515b..03e534a39 100755
--- a/bin/liquid.js
+++ b/bin/liquid.js
@@ -14,8 +14,7 @@ async function render () {
   program
     .name('liquidjs')
     .description('Render a Liquid template')
-    .argument('[template]', 'liquid template to render (inline, @path, or @- for stdin)')
-    .option('-t, --template <liquid | @path>', 'liquid template to render (inline, @path, or @- for stdin)')
+    .argument('<template>', 'liquid template to render (inline, @path, or @- for stdin)')
     .option('-c, --context <json | @path>', 'input context in JSON format (inline, @path, or @- for stdin)')
     .option('-o, --output <path>', 'write rendered output to file (omit to write to stdout)')
     .option('--cache [size]', 'cache previously parsed template structures (default cache size: 1024)')
@@ -46,17 +45,7 @@ async function render () {
     .parse()
 
   const options = program.opts()
-  const positionalTemplate = program.args[0]
-  const optionTemplate = options.template
-
-  if (positionalTemplate && optionTemplate && positionalTemplate !== optionTemplate) {
-    throw new Error(`Conflicting templates: positional argument and --template differ.`)
-  }
-
-  const templateOption = positionalTemplate || optionTemplate
-  if (!templateOption) {
-    throw new Error(`A template is required. Pass a positional <template> or --template.`)
-  }
+  const templateOption = program.args[0]
 
   if (Object.values({ template: templateOption, context: options.context }).filter((value) => value === '@-').length > 1) {
     throw new Error(`The stdin input specifier '@-' must only be used once.`)
diff --git a/docs/source/tutorials/setup.md b/docs/source/tutorials/setup.md
index f0799126f..20889f0a6 100644
--- a/docs/source/tutorials/setup.md
+++ b/docs/source/tutorials/setup.md
@@ -53,11 +53,10 @@ Pre-built UMD bundles are also available:
 
 ## LiquidJS in CLI
 
-LiquidJS can also be used to render a template directly from CLI using `npx`. Pass the template as a positional argument, or with `--template` / `-t`:
+LiquidJS can also be used to render a template directly from CLI using `npx`. Pass the template as a positional argument:
 
 ```bash
 npx liquidjs '{{"hello" | capitalize}}'
-npx liquidjs --template '{{"hello" | capitalize}}'
 ```
 
 You can either pass the template inline (as shown above), read it from a file with `@` followed by a path, or from `stdin` with `@-`: