Make path input the first argument (#23)

* make path first arg

* fix release formatting

* cleanup readme

Author: martinabeleda

.github/workflows/release.yml

@@ -43,12 +43,10 @@ jobs:
           {
             echo "## ripdiff $GITHUB_REF_NAME"
             echo
-            echo "Published to crates.io from tag \\`$GITHUB_REF_NAME\\`."
-            echo
             echo "Install with:"
-            echo "\\`\\`\\`bash"
+            echo "```bash"
             echo "cargo install ripdiff"
-            echo "\\`\\`\\`"
+            echo "```"
           } > release-notes.md
 
       - name: Create GitHub release

README.md

@@ -52,7 +52,7 @@ rd
 Or point it at a specific repo:
 
 ```
-ripdiff --path /some/repo
+ripdiff /some/repo
 ```
 
 ## Key Bindings
@@ -92,33 +92,3 @@ ripdiff --path /some/repo
 | `]` / `[` | Jump to next / previous hunk |
 | `Space e` | Hide / show file list sidebar |
 | `Enter` | Toggle diff visibility for selected file |
-
-## Quick Test
-
-```
-cd $(mktemp -d)
-git init && git commit --allow-empty -m "init"
-echo "hello" > test.txt
-git add test.txt
-ripdiff
-```
-
-Edit a file in another terminal — the diff auto-updates within ~1 second.
-
-## Layout
-
-```
-  ripdiff  [repo: myproject]   main  3 files changed  mode: inline  panel: files
-  M src/main.rs  +5-2 │ src/main.rs
-  A src/lib.rs   +3   │
-  M README.md    +1-1 │   fn main() {
-  ? new_file.rs  +12  │ -     println!("old");
-                      │ +     println!("new");
-                      │   }
-```
-
-- 25% left: file list with status indicators (M/A/D/R/?) and stage markers (`●` staged, `○` unstaged, `◐` mixed)
-- 75% right: diff output with scrollbar
-- `h` opens a help popup with keybinding and symbol descriptions
-- Minimal borders — just a vertical divider between panels
-- Auto-refreshes on `.git/index` changes and every 500ms

docs/strava-demo.tape

@@ -7,7 +7,7 @@ Set FontSize 20
 Set Padding 24
 Set TypingSpeed 0ms
 
-Type "rd --path ~/Development/strava"
+Type "rd ~/Development/strava"
 Enter
 Sleep 2s
 

src/main.rs

@@ -23,7 +23,7 @@ use tokio::sync::watch;
 #[command(name = "ripdiff", about = "Terminal UI for navigating git diffs")]
 struct Args {
     /// Path to the git repository (defaults to current directory)
-    #[arg(short, long)]
+    #[arg(value_name = "PATH")]
     path: Option<PathBuf>,
 }
 
@@ -87,3 +87,31 @@ async fn main() -> Result<()> {
         }
     }
 }
+
+#[cfg(test)]
+mod tests {
+    use super::Args;
+    use clap::Parser;
+    use std::path::PathBuf;
+
+    #[test]
+    fn parses_positional_path_argument() {
+        let args = Args::parse_from(["ripdiff", "/tmp/repo"]);
+
+        assert_eq!(args.path, Some(PathBuf::from("/tmp/repo")));
+    }
+
+    #[test]
+    fn defaults_path_when_not_provided() {
+        let args = Args::parse_from(["ripdiff"]);
+
+        assert_eq!(args.path, None);
+    }
+
+    #[test]
+    fn rejects_legacy_named_path_argument() {
+        let result = Args::try_parse_from(["ripdiff", "--path", "/tmp/repo"]);
+
+        assert!(result.is_err());
+    }
+}