sparrow-cli 0.5.1

A local-first Rust agent cockpit — route, run, replay, rewind
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

use async_trait::async_trait;
use serde_json::json;
use std::path::PathBuf;
use std::process::Command as StdCommand;

use super::{Tool, ToolCtx, ToolResult};
use crate::event::RiskLevel;

pub struct Git;

#[async_trait]
impl Tool for Git {
    fn name(&self) -> &str {
        "git"
    }
    fn description(&self) -> &str {
        "Git operations: status, diff, log, branch, checkout"
    }
    fn schema(&self) -> serde_json::Value {
        json!({
            "type": "object",
            "properties": {
                "action": {
                    "type": "string",
                    "enum": ["status", "diff", "log", "branch", "checkout", "add", "commit"]
                },
                "args": { "type": "array", "items": { "type": "string" } }
            },
            "required": ["action"]
        })
    }
    fn risk(&self) -> RiskLevel {
        RiskLevel::ReadOnly
    }
    async fn call(&self, args: serde_json::Value, ctx: &ToolCtx) -> anyhow::Result<ToolResult> {
        let action = args["action"].as_str().unwrap_or("status");
        let extra_args: Vec<String> = args["args"]
            .as_array()
            .map(|a| {
                a.iter()
                    .filter_map(|v| v.as_str().map(String::from))
                    .collect()
            })
            .unwrap_or_default();

        // Update risk based on action
        let mut git_args = vec![action.to_string()];
        git_args.extend(extra_args);

        // Special handling for commit
        let mut message_file: Option<PathBuf> = None;
        if action == "commit" {
            let msg = args["message"].as_str().unwrap_or("auto-commit");
            let msg_file = ctx.workspace_root.join(".git").join("SPARROW_COMMIT_MSG");
            std::fs::write(&msg_file, msg)?;
            git_args.push("-F".into());
            git_args.push(msg_file.to_string_lossy().to_string());
            message_file = Some(msg_file);
        }

        let output = StdCommand::new("git")
            .args(&git_args)
            .current_dir(&ctx.workspace_root)
            .output()?;

        // Cleanup temp file
        if let Some(f) = message_file {
            let _ = std::fs::remove_file(f);
        }

        let stdout = String::from_utf8_lossy(&output.stdout).to_string();
        let stderr = String::from_utf8_lossy(&output.stderr).to_string();

        let result = if stdout.is_empty() { stderr } else { stdout };

        Ok(ToolResult::text(result))
    }
}