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
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124

use crate::config::{get_project_root, AgentsConfig};
use crate::linker::is_symlink_valid;
use anyhow::Result;
use colored::*;
use std::fs;

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

    println!("{}", "Agents Status:".cyan().bold());
    println!();

    // List enabled agents
    let enabled = config.enabled_agents();
    if !enabled.is_empty() {
        println!("{}", "Enabled agents:".green().bold());
        for agent in &enabled {
            let link_path = agent.get_link_path(&project_root);
            let local_path = agent.get_local_path(&project_root);

            // Determine detailed status
            let status = if !local_path.exists() {
                "⚠ source missing".red().to_string()
            } else if !link_path.exists() && !link_path.is_symlink() {
                "⚠ not linked".yellow().to_string()
            } else if !is_symlink_valid(&link_path) {
                "⚠ link broken".yellow().to_string()
            } else {
                "✓ linked".green().to_string()
            };

            println!("  {} {} - {}", "●".green(), agent.name, status);

            // Show source
            match &agent.source {
                crate::agent::AgentSource::Local(path) => {
                    println!("    {} {}", "source:".dimmed(), path.display());
                }
                crate::agent::AgentSource::GitHub(url) => {
                    println!("    {} {}", "source:".dimmed(), url);
                }
            }
        }
    } else {
        println!("{}", "No enabled agents".dimmed());
    }

    println!();

    // List disabled agents from config
    let disabled = config.disabled_agents();
    if !disabled.is_empty() {
        println!("{}", "Disabled agents (in .agents.json):".yellow().bold());
        for agent in &disabled {
            println!(
                "  {} {} - {}",
                "○".yellow(),
                agent.name,
                "disabled".dimmed()
            );

            // Show source
            match &agent.source {
                crate::agent::AgentSource::Local(path) => {
                    println!("    {} {}", "source:".dimmed(), path.display());
                }
                crate::agent::AgentSource::GitHub(url) => {
                    println!("    {} {}", "source:".dimmed(), url);
                }
            }
        }
    }

    println!();

    // List available agents in .ccagents that are not in config
    let ccagents_dir = project_root.join(".ccagents");
    if ccagents_dir.exists() {
        let mut available_agents = Vec::new();

        for entry in fs::read_dir(&ccagents_dir)? {
            let entry = entry?;
            let path = entry.path();

            if path.is_dir() {
                let name = path
                    .file_name()
                    .and_then(|n| n.to_str())
                    .unwrap_or("")
                    .to_string();

                // Check if this agent is not already in config
                if !config.agents.iter().any(|a| a.name == name) {
                    available_agents.push(name);
                }
            }
        }

        if !available_agents.is_empty() {
            println!(
                "{}",
                "Available agents (in .ccagents but not configured):"
                    .blue()
                    .bold()
            );
            for name in available_agents {
                println!("  {} {} - {}", "◇".blue(), name, "not configured".dimmed());
                println!("    {} ccagents add .ccagents/{}", "hint:".dimmed(), name);
            }
        }
    }

    // Summary
    println!();
    println!(
        "{}: {} enabled, {} disabled",
        "Total".bold(),
        enabled.len(),
        disabled.len()
    );

    Ok(())
}