ccagents 0.1.0

CLI tool for managing Claude Code agents in local projects
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
92
93
94
95
96
97

use crate::config::{get_project_root, AgentsConfig};
use anyhow::Result;
use colored::*;
use std::io::{self, Write};

pub fn execute(force: bool) -> Result<()> {
    let project_root = get_project_root()?;
    let mut config = AgentsConfig::load(&project_root)?;

    println!("{}", "Checking for orphaned agents...".cyan().bold());

    // Find orphaned agents (source doesn't exist)
    let mut orphaned = Vec::new();
    for agent in &config.agents {
        let local_path = agent.get_local_path(&project_root);
        if !local_path.exists() {
            orphaned.push(agent.clone());
        }
    }

    if orphaned.is_empty() {
        println!("{} No orphaned agents found.", "✓".green().bold());
        return Ok(());
    }

    // Report orphaned agents
    println!("\n{}", "Found orphaned agents:".yellow().bold());
    for agent in &orphaned {
        println!(
            "  {} {} - {}",
            "○".red(),
            agent.name,
            "source missing".red()
        );
        match &agent.source {
            crate::agent::AgentSource::Local(path) => {
                println!("    {} {}", "missing:".dimmed(), path.display());
            }
            crate::agent::AgentSource::GitHub(url) => {
                println!("    {} {} (can be re-downloaded)", "missing:".dimmed(), url);
            }
        }
    }

    // Ask for confirmation or use force flag
    let should_remove = if force {
        true
    } else {
        println!(
            "\n{}",
            "Remove these orphaned entries from .agents.json?".yellow()
        );
        print!("Confirm [y/N]: ");
        io::stdout().flush()?;

        let mut input = String::new();
        io::stdin().read_line(&mut input)?;

        matches!(input.trim().to_lowercase().as_str(), "y" | "yes")
    };

    if should_remove {
        // Remove orphaned agents
        let initial_count = config.agents.len();
        config
            .agents
            .retain(|agent| !orphaned.iter().any(|o| o.name == agent.name));

        let removed_count = initial_count - config.agents.len();

        // Save the cleaned configuration
        config.save(&project_root)?;

        println!(
            "\n{} Removed {} orphaned agent{}",
            "✓".green().bold(),
            removed_count,
            if removed_count == 1 { "" } else { "s" }
        );

        // Also clean up any orphaned symlinks
        let claude_agents_dir = project_root.join(".claude").join("agents");
        if claude_agents_dir.exists() {
            for agent in &orphaned {
                let link_path = agent.get_link_path(&project_root);
                if link_path.exists() || link_path.is_symlink() {
                    std::fs::remove_file(&link_path).ok();
                    println!("  {} Removed orphaned symlink: {}", "→".cyan(), agent.name);
                }
            }
        }
    } else {
        println!("{}", "Clean operation cancelled.".yellow());
    }

    Ok(())
}