claude-wrapper 0.10.0

A type-safe Claude Code CLI wrapper for Rust
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

#[cfg(feature = "async")]
use crate::Claude;
use crate::command::ClaudeCommand;
#[cfg(feature = "async")]
use crate::error::Result;
#[cfg(feature = "async")]
use crate::exec;
use crate::exec::CommandOutput;

/// **Deprecated.** Wraps `claude agents`, which as of Claude Code
/// 2.1.143 is an interactive TUI for managing background agent
/// sessions -- not a way to list user-defined subagent definitions.
/// Calling `.execute()` non-interactively just emits
/// `'claude agents' is not available in this environment.` to
/// stderr and returns empty stdout.
///
/// Use [`crate::artifacts::AgentsRoot`] to enumerate / read /
/// write user-level subagent definitions in `~/.claude/agents/`.
/// There is no current non-interactive CLI surface for the
/// background-session manager.
///
/// Kept for back-compat; will be removed in a future major release.
#[deprecated(
    since = "0.10.0",
    note = "`claude agents` is now an interactive TUI in Claude Code 2.1.143+ (background-session manager). \
            For listing/reading/writing user subagents in `~/.claude/agents/`, use \
            `claude_wrapper::artifacts::AgentsRoot`."
)]
#[derive(Debug, Clone, Default)]
pub struct AgentsCommand {
    setting_sources: Option<String>,
}

#[allow(deprecated)]
impl AgentsCommand {
    #[must_use]
    pub fn new() -> Self {
        Self::default()
    }

    /// Set which setting sources to load (comma-separated: user, project, local).
    #[must_use]
    pub fn setting_sources(mut self, sources: impl Into<String>) -> Self {
        self.setting_sources = Some(sources.into());
        self
    }
}

#[allow(deprecated)]
impl ClaudeCommand for AgentsCommand {
    type Output = CommandOutput;

    fn args(&self) -> Vec<String> {
        let mut args = vec!["agents".to_string()];
        if let Some(ref sources) = self.setting_sources {
            args.push("--setting-sources".to_string());
            args.push(sources.clone());
        }
        args
    }

    #[cfg(feature = "async")]
    async fn execute(&self, claude: &Claude) -> Result<CommandOutput> {
        exec::run_claude(claude, self.args()).await
    }
}

#[cfg(test)]
#[allow(deprecated)]
mod tests {
    use super::*;
    use crate::command::ClaudeCommand;

    #[test]
    fn test_agents_default() {
        let cmd = AgentsCommand::new();
        assert_eq!(ClaudeCommand::args(&cmd), vec!["agents"]);
    }

    #[test]
    fn test_agents_with_sources() {
        let cmd = AgentsCommand::new().setting_sources("user,project");
        assert_eq!(
            ClaudeCommand::args(&cmd),
            vec!["agents", "--setting-sources", "user,project"]
        );
    }
}