git-worktree-manager 0.0.40

CLI tool integrating git worktree with AI coding assistants
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91

//! Wrapper around the external `claude` CLI for plugin/marketplace ops.
//!
//! The trait exists so tests can inject a fake without spawning processes.
//! `RealClaudeCli` shells out via `std::process::Command`.

use std::path::Path;
use std::process::Command;

#[derive(Debug)]
pub enum ClaudeCliError {
    /// `claude` binary not on PATH.
    NotInstalled,
    /// `claude` exited with a non-zero status. Stderr captured for the user.
    NonZeroExit { code: Option<i32>, stderr: String },
    /// Failed to spawn the process for an OS-level reason.
    Io(std::io::Error),
}

impl std::fmt::Display for ClaudeCliError {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        match self {
            ClaudeCliError::NotInstalled => write!(f, "`claude` CLI not found on PATH"),
            ClaudeCliError::NonZeroExit { code, stderr } => write!(
                f,
                "`claude` exited with status {:?}: {}",
                code,
                stderr.trim()
            ),
            ClaudeCliError::Io(e) => write!(f, "failed to invoke `claude`: {}", e),
        }
    }
}

impl std::error::Error for ClaudeCliError {}

pub trait ClaudeCli {
    fn is_available(&self) -> bool;
    fn marketplace_add(&self, path: &Path) -> Result<(), ClaudeCliError>;
    fn marketplace_update(&self, name: &str) -> Result<(), ClaudeCliError>;
    fn plugin_install(&self, slug: &str) -> Result<(), ClaudeCliError>;
    fn plugin_update(&self, slug: &str) -> Result<(), ClaudeCliError>;
}

pub struct RealClaudeCli;

impl RealClaudeCli {
    fn run(&self, args: &[&str]) -> Result<(), ClaudeCliError> {
        let out = Command::new("claude").args(args).output().map_err(|e| {
            if e.kind() == std::io::ErrorKind::NotFound {
                ClaudeCliError::NotInstalled
            } else {
                ClaudeCliError::Io(e)
            }
        })?;
        if !out.status.success() {
            return Err(ClaudeCliError::NonZeroExit {
                code: out.status.code(),
                stderr: String::from_utf8_lossy(&out.stderr).to_string(),
            });
        }
        Ok(())
    }
}

impl ClaudeCli for RealClaudeCli {
    fn is_available(&self) -> bool {
        Command::new("claude")
            .arg("--version")
            .output()
            .map(|o| o.status.success())
            .unwrap_or(false)
    }
    fn marketplace_add(&self, path: &Path) -> Result<(), ClaudeCliError> {
        // `--scope user` so the registration is global, not per-project.
        let path_str = path.display().to_string();
        self.run(&["plugin", "marketplace", "add", &path_str, "--scope", "user"])
    }
    // No `--scope` flag: `claude plugin marketplace update` operates on the
    // marketplace registration itself, which has no scope concept.
    fn marketplace_update(&self, name: &str) -> Result<(), ClaudeCliError> {
        self.run(&["plugin", "marketplace", "update", name])
    }
    fn plugin_install(&self, slug: &str) -> Result<(), ClaudeCliError> {
        self.run(&["plugin", "install", slug, "--scope", "user"])
    }
    // No `--scope` arg: `claude plugin update`'s default scope is `user`,
    // which matches the scope we install under in `plugin_install`.
    fn plugin_update(&self, slug: &str) -> Result<(), ClaudeCliError> {
        self.run(&["plugin", "update", slug])
    }
}