use std::path::{Path, PathBuf};
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct AgentTarget {
pub name: String,
pub label: String,
pub marker_dir: PathBuf,
pub skills_dir: PathBuf,
}
const AGENTS: &[(&str, &str, &str, &str)] = &[
("claude", "Claude Code", ".claude", ".claude/skills"),
("cursor", "Cursor", ".cursor", ".cursor/skills"),
("opencode", "OpenCode", ".opencode", ".opencode/skills"),
("codex", "Codex", ".codex", ".codex/skills"),
];
fn target_for(
project_dir: &Path,
name: &str,
label: &str,
marker: &str,
skills_rel: &str,
) -> AgentTarget {
AgentTarget {
name: name.to_string(),
label: label.to_string(),
marker_dir: project_dir.join(marker),
skills_dir: project_dir.join(skills_rel),
}
}
pub fn detect_agents(project_dir: &Path) -> Vec<AgentTarget> {
AGENTS
.iter()
.filter(|(_, _, marker, _)| project_dir.join(marker).exists())
.map(|(name, label, marker, skills_rel)| {
target_for(project_dir, name, label, marker, skills_rel)
})
.collect()
}
pub fn resolve_agent_names(
project_dir: &Path,
names: &[String],
) -> anyhow::Result<Vec<AgentTarget>> {
names
.iter()
.map(|name| {
AGENTS
.iter()
.find(|(n, _, _, _)| *n == name)
.map(|(n, label, marker, skills_rel)| {
target_for(project_dir, n, label, marker, skills_rel)
})
.ok_or_else(|| {
anyhow::anyhow!(
"unknown agent '{name}'. Supported: {}",
supported_agents().join(", ")
)
})
})
.collect()
}
pub fn supported_agents() -> Vec<&'static str> {
AGENTS.iter().map(|(n, _, _, _)| *n).collect()
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn detects_only_present_markers() {
let dir = tempfile::tempdir().unwrap();
std::fs::create_dir_all(dir.path().join(".claude")).unwrap();
std::fs::create_dir_all(dir.path().join(".cursor")).unwrap();
let found = detect_agents(dir.path());
let names: Vec<&str> = found.iter().map(|a| a.name.as_str()).collect();
assert_eq!(names, vec!["claude", "cursor"]);
assert_eq!(found[0].skills_dir, dir.path().join(".claude/skills"));
}
#[test]
fn resolve_names_does_not_require_marker() {
let dir = tempfile::tempdir().unwrap();
let got = resolve_agent_names(dir.path(), &["codex".to_string()]).unwrap();
assert_eq!(got.len(), 1);
assert_eq!(got[0].name, "codex");
assert_eq!(got[0].skills_dir, dir.path().join(".codex/skills"));
}
#[test]
fn resolve_unknown_name_errors() {
let dir = tempfile::tempdir().unwrap();
assert!(resolve_agent_names(dir.path(), &["bogus".to_string()]).is_err());
}
#[test]
fn supported_agents_order() {
assert_eq!(
supported_agents(),
vec!["claude", "cursor", "opencode", "codex"]
);
}
}