Skip to content

armgit / cua

Public Imported from GitHub
0

Scale computer-use 2.0 with open-source drivers, cross-OS sandboxes, and benchmarks for training, evaluation, and data generation.

feat(cua-driver): auto-link skills for Pi (#4049)

Kevin Rajan402c6bd53bc2
diff --git a/docs/content/docs/cua-driver/guides/connect-your-agent.mdx b/docs/content/docs/cua-driver/guides/connect-your-agent.mdx
index 42e59cdfd5..77ec3cb907 100644
--- a/docs/content/docs/cua-driver/guides/connect-your-agent.mdx
+++ b/docs/content/docs/cua-driver/guides/connect-your-agent.mdx
@@ -72,7 +72,7 @@ Code, Qwen through Qwen Code. MiniMax documents setups for
The skill teaches an agent to pick tools, address elements, keep focus, and
verify each action. It links into Claude Code, Codex, Prime Agent, OpenClaw,
-OpenCode, Antigravity, and Hermes:
+OpenCode, Antigravity, Hermes, and Pi:
```bash test="cli-shape" id="cua-driver-skills-install"
cua-driver skills install
diff --git a/libs/cua-driver/rust/crates/cua-driver/src/skills.rs b/libs/cua-driver/rust/crates/cua-driver/src/skills.rs
index cd8016deef..8932d03dcf 100644
--- a/libs/cua-driver/rust/crates/cua-driver/src/skills.rs
+++ b/libs/cua-driver/rust/crates/cua-driver/src/skills.rs
@@ -42,6 +42,7 @@
//!
//! - Claude Code: `~/.claude/skills/`
//! - Codex: `~/.agents/skills/`
+//! - Pi: `~/.agents/skills/` (shared global location; Pi also reads `~/.pi/agent/skills/`)
//! - Prime Agent: `~/.prime/agent/skills/`
//! - OpenClaw: `~/.openclaw/skills/`
//! - OpenCode: `~/.config/opencode/skills/` (macOS / Linux),
@@ -57,7 +58,7 @@
//! vocabulary; the cua-driver pack provides the platform deep dives.
//!
//! Acts on a given agent when its parent skills dir already exists. For
-//! Claude Code and Codex, whose fresh installs may not create that directory,
+//! Claude Code, Codex, and Pi, whose fresh installs may not create that directory,
//! the explicit `skills install` verb also creates it when the client's own
//! home directory proves that client is installed. Never clobbers an existing
//! `<agent_skills>/cua-driver` link — preserves dev users' hand-rolled symlinks.
@@ -216,6 +217,14 @@ const AGENTS: &[Agent] = &[
parent: AgentParent::Home(".agents/skills"),
install_marker: Some(".codex"),
},
+ Agent {
+ label: "Pi",
+ // Pi discovers both ~/.pi/agent/skills and ~/.agents/skills. Reuse the
+ // latter so Pi + Codex converge on one managed cua-driver link instead
+ // of making Pi report a duplicate skill-name collision.
+ parent: AgentParent::Home(".agents/skills"),
+ install_marker: Some(".pi/agent"),
+ },
Agent {
label: "Prime Agent",
parent: AgentParent::Home(".prime/agent/skills"),
@@ -1018,6 +1027,54 @@ mod tests {
assert!(error.to_string().contains("exists but is not a directory"));
}
+ #[test]
+ fn pi_target_matches_its_native_global_skill_directory() {
+ let target = AGENTS
+ .iter()
+ .find(|agent| agent.label == "Pi")
+ .expect("Pi must remain a supported skill target");
+
+ assert!(matches!(target.parent, AgentParent::Home(".agents/skills")));
+ assert!(matches!(target.install_marker, Some(".pi/agent")));
+ }
+
+ #[test]
+ fn codex_and_pi_share_one_managed_global_skill_directory() {
+ let codex = AGENTS.iter().find(|agent| agent.label == "Codex").unwrap();
+ let pi = AGENTS.iter().find(|agent| agent.label == "Pi").unwrap();
+
+ assert!(matches!(codex.parent, AgentParent::Home(".agents/skills")));
+ assert!(matches!(pi.parent, AgentParent::Home(".agents/skills")));
+ assert!(matches!(codex.install_marker, Some(".codex")));
+ assert!(matches!(pi.install_marker, Some(".pi/agent")));
+ }
+
+ #[test]
+ fn pi_marker_creates_shared_link_and_codex_reuses_it() {
+ let home = tempdir().unwrap();
+ let parent = home.path().join(".agents/skills");
+ let pi_marker = home.path().join(".pi/agent");
+ let local_skill = home.path().join(".cua-driver/skills/cua-driver");
+
+ std::fs::create_dir_all(&pi_marker).unwrap();
+ std::fs::create_dir_all(&local_skill).unwrap();
+
+ assert_eq!(
+ link_agent_paths("Pi", &parent, Some(&pi_marker), &local_skill).unwrap(),
+ LinkStatus::Created
+ );
+ assert!(parent.join("cua-driver").exists());
+
+ // Codex and Pi intentionally share ~/.agents/skills. Once Pi has
+ // created the managed link, the Codex path must converge on that same
+ // link rather than creating or replacing another skill entry.
+ assert_eq!(
+ link_agent_paths("Codex", &parent, None, &local_skill).unwrap(),
+ LinkStatus::Existing
+ );
+ assert!(parent.join("cua-driver").exists());
+ }
+
#[test]
fn prime_agent_target_matches_its_native_global_skill_directory() {
let target = AGENTS