From 715e0988dcb510df24d8d8bcee0a3ccc50c3b45e Mon Sep 17 00:00:00 2001
From: Jef Roosens <jefroosens@outlook.com>
Date: Fri, 22 May 2026 10:34:53 +0200
Subject: [PATCH] refactor(cli): replace positional input argument with --input
 / -i flag

---
 .coverage             | Bin 53248 -> 53248 bytes
 AGENTS.md             |  12 ++++++------
 src/timesheets/cli.py |   5 +++--
 3 files changed, 9 insertions(+), 8 deletions(-)

diff --git a/.coverage b/.coverage
index addd3c52561f65f5f222abf75ab137ed6f313f69..b76cff1a3599a955c473ac05b7730def79a36333 100644
GIT binary patch
delta 297
zcmZozz}&Eac>{}s5Idg_1OI;h7JfH=R=yK_U3@;91qICbm~7Z5_xKreX5|;;WajA=
zRBrC_t77D0=ksOYKfvG0=ewCFz@Be%cbo|qTnYQ;?zl=tA$I<L2L7M?&-kzLpWt84
zKZm~`XksOQJvTcGBc}xGGXH)4%SAZZfE*E)W&efk<XM4C2R6M-uOI3M-c37D_xb$#
z+tU9%9tiK*|1GoW?>-(DpaLo8dw>4%*WQiiV+Qi%*qL<B)-vtb{hU{j3CLGrx+ly4
z1}qK?4y=qUoSb}ITtESK{)-I!zxluLKjYxP!GDqeKL1;wYj*Q1f$V2wWd~C%Y+#Cw
R6-+U+fGPIPpXc)$002_jP^JI?

delta 230
zcmZozz}&Eac>{}s02^Ny1OI;h7JfH=R=yK_U7H03%J`UU*e3h=8E@Y2=gP>z#@Efj
ze}KPrGhcu`-^2wDlYQe%Ht&yfRTN<3-@w5Clm89>J^mB?d-*p2_0Hi>;bvoD<dk4t
z=D*K>xd<mKkR!sf?7y&`2n&#@#WwAOf5QHsd(KJ!_Yi*bot1|fC@RH#@6SK}+Pm@G
zOd!2X_k<Z37#vs`SvWcQxVV69HvSt7{J;6X@W181&wqpe8PKL9{L&zc7+KlC6bmbu
PVq*bQ%$q;Y=QRKT`1w5a

diff --git a/AGENTS.md b/AGENTS.md
index 03e77ae..f803a08 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -53,22 +53,22 @@ Do **not** use `pip` or `python` directly.
 
 ```sh
 # Print CSV to stdout (date defaults to today)
-uv run timesheets input.md
+uv run timesheets --input input.md
 
 # Write CSV to a file
-uv run timesheets input.md -o output.csv
+uv run timesheets --input input.md -o output.csv
 
 # Override the date (DD/MM/YY)
-uv run timesheets input.md --date 22/05/26
+uv run timesheets --input input.md --date 22/05/26
 
 # Use a specific project map file
-uv run timesheets input.md --map /path/to/project_map.json
+uv run timesheets --input input.md --map /path/to/project_map.json
 
 # Print a human-readable summary instead of CSV
-uv run timesheets input.md --summary
+uv run timesheets --input input.md --summary
 
 # Read from stdin
-cat input.md | uv run timesheets -
+cat input.md | uv run timesheets --input -
 
 # Fetch today's entries from Joplin (token via env var)
 JOPLIN_TOKEN=your_token uv run timesheets --joplin
diff --git a/src/timesheets/cli.py b/src/timesheets/cli.py
index e48103b..9d7f8b7 100644
--- a/src/timesheets/cli.py
+++ b/src/timesheets/cli.py
@@ -16,9 +16,10 @@ def build_parser() -> argparse.ArgumentParser:
 
     source = parser.add_mutually_exclusive_group(required=True)
     source.add_argument(
-        "input",
-        nargs="?",
+        "--input",
+        "-i",
         help="Path to the markdown file containing the timesheet table, or '-' to read from stdin.",
+        default=None,
     )
     source.add_argument(
         "--joplin",