1.0.3

Require branch to exist to avoid chaos

Author: mfornet

CHANGELOG.md

@@ -1,5 +1,7 @@
 # Changelog
 
+## 1.0.3 - 2026-01-30
+- Require branches to exist; `terris <branch>` errors if missing.
+
 ## 1.0.2 - 2026-01-30
 - Add shell completions for bash, zsh, and fish.
-

Cargo.lock

@@ -1,6 +1,6 @@
 [package]
 name = "terris"
-version = "1.0.2"
+version = "1.0.3"
 edition = "2024"
 description = "A simple git worktree manager."
 license = "MIT"

Cargo.toml

@@ -28,7 +28,7 @@ cargo install --path .
 ## Usage
 
 ```bash
-# Jump to a worktree. Create branch and worktree if missing.
+# Jump to a worktree. Branch must exist.
 cd "$(terris feature-a)"
 
 # List worktrees
@@ -80,9 +80,9 @@ terris --completions fish > ~/.config/fish/completions/terris.fish
 ```
 
 ## How it works
-- `terris <branch>` creates the worktree if missing and prints the path every time.
+- `terris <branch>` creates the worktree (branch must exist) and prints the path every time.
 - If the branch exists, it is used directly.
-- If the branch does not exist, it is created from the current HEAD.
+- If the branch does not exist, the command fails with an error.
 - Default path is `~/.terris-worktrees/<repo-name>/<branch>-<random-key>`.
 
 ## Notes

README.md

@@ -154,16 +154,13 @@ fn cmd_ensure_branch(branch: &str) -> Result<()> {
     }
 
     let branch_exists = git_branch_exists(&root, branch)?;
-
-    let mut args: Vec<String> = vec!["worktree".into(), "add".into()];
     if !branch_exists {
-        args.push("-b".into());
-        args.push(branch.to_string());
+        bail!("branch '{}' does not exist", branch);
     }
+
+    let mut args: Vec<String> = vec!["worktree".into(), "add".into()];
     args.push(target_path.to_string_lossy().to_string());
-    if branch_exists {
-        args.push(branch.to_string());
-    }
+    args.push(branch.to_string());
 
     run_git(&args, &root).with_context(|| format!("create worktree '{}'", branch))?;
     println!("{}", target_path.display());