Open source Grok Bot alternative, Bring your own agent and subscription: message Claude Code, Codex, Gemini CLI, Cursor, Copilot and 40+ AI agents as bots on your own computer, from iPhone, Mac, Windows, Linux or terminal. Agent-agnostic and free. Also a Muse and Dots alternative. Built in Rust.
Rust acpagent-client-protocolai-agentsai-assistantclaudeclaude-codecodexcoding-agentscursorgeminigemini-cligrok-bot-alternativeiosiphonelinuxmacosmcpopen-sourcerustself-hosted
use super::*;
use crate::remote::identity::Identity;
use crate::store::Store;
fn hub(dir: &std::path::Path) -> Arc<Hub> {
let store = Store::open(std::path::Path::new(":memory:")).unwrap();
for (id, manage) in [("lead", true), ("dev", false)] {
let cfg: BotConfig = serde_json::from_value(json!({"id": id, "name": id, "backend": "claude",
"cwd": dir.to_string_lossy(), "manageTeam": manage, "connectors": ["github"], "skills": [],
"permission": "auto", "mode": "plan"}))
.unwrap();
store.save_bot(&cfg).unwrap();
}
let hub = Hub::new(store, "manage-test".into(), Identity::load_or_create(dir).unwrap(), "test".into(), 0);
hub.start().unwrap();
hub
}
fn notices(hub: &Hub, bot: &str) -> Vec<Value> {
hub.store.history(bot, i64::MAX, 20).unwrap().into_iter().map(|e| e.data["text"].clone()).collect()
}
#[tokio::test]
async fn a_manager_creates_and_changes_bots_that_record_who_made_them() {
let dir = std::env::temp_dir().join(format!("codync-manage-{}", uuid::Uuid::new_v4()));
std::fs::create_dir_all(&dir).unwrap();
let hub = hub(&dir);
let team = call(&hub, "lead", "list_team", &json!({})).await.unwrap();
let team: Vec<_> = team["bots"]
.as_array()
.unwrap()
.iter()
.map(|b| (b["id"].clone(), b["you"].clone(), b["manageTeam"].clone()))
.collect();
assert_eq!(team.len(), 2);
assert!(team.contains(&(json!("lead"), json!(true), json!(true))));
assert!(team.contains(&(json!("dev"), json!(false), json!(false))));
let routine =
json!({"name": "Scan", "instruction": "Scan the repo", "triggers": [{"type": "interval", "seconds": 1800}]});
let args = json!({"name": " Security Analyst ", "instructions": "Reviews code.", "agent": "claude",
"avatarColor": "red", "routines": [routine]});
let made = call(&hub, "lead", "create_bot", &args).await.unwrap();
let id = made["bot"]["id"].as_str().unwrap();
let cfg = hub.store.bot(id).unwrap().unwrap().config;
assert_eq!(
(cfg.name.as_str(), cfg.description.as_str(), cfg.avatar_color.as_str()),
("Security Analyst", "Reviews code.", "red")
);
// It manages the team like the bot that made it, and asks no less.
assert_eq!((cfg.created_by.as_deref(), cfg.permission, cfg.manage_team), (Some("lead"), Permission::Auto, true));
assert_eq!(cfg.mode.as_deref(), Some("plan"), "in the same mode");
// Another agent may not have that mode: no bot is made on it.
let other = json!({"name": "Reviewer", "agent": "codex"});
let refused = call(&hub, "lead", "create_bot", &other).await.unwrap_err().to_string();
assert!(refused.contains("plan mode, which Codex may not have"), "{refused}");
// And reaches only the connectors and skills it does, not every installed one.
assert_eq!((cfg.connectors, cfg.skills), (vec!["github".to_owned()], vec![]));
assert_eq!(made["routines"][0]["triggerDescriptions"][0], "Every 30 minutes");
call(&hub, "lead", "update_bot", &json!({"botId": "dev", "instructions": "Writes code.", "hidden": true}))
.await
.unwrap();
let dev = hub.store.bot("dev").unwrap().unwrap().config;
assert_eq!((dev.description.as_str(), dev.hidden), ("Writes code.", true));
// A manager changes its own setup too.
call(&hub, "lead", "update_bot", &json!({"botId": "lead", "name": "Boss", "model": "opus"})).await.unwrap();
let lead = hub.store.bot("lead").unwrap().unwrap().config;
assert_eq!((lead.name.as_str(), lead.model.as_deref(), lead.auto_name), ("Boss", Some("opus"), false));
assert_eq!(
notices(&hub, "lead"),
[
json!("Created bot Security Analyst"),
json!("Updated dev: hidden, instructions"),
json!("Updated lead: name, model")
]
);
// Who made a bot is the host's record: a client's save can't rewrite it.
hub.update_bot(&json!({"id": id, "createdBy": "dev"})).unwrap();
assert_eq!(hub.store.bot(id).unwrap().unwrap().config.created_by.as_deref(), Some("lead"));
let refused = |bot: &'static str, name: &'static str, args: Value| {
let hub = hub.clone();
async move { call(&hub, bot, name, &args).await.unwrap_err().to_string() }
};
assert!(refused("dev", "create_bot", json!({"name": "x"})).await.contains("may not manage the team"));
assert!(refused("lead", "create_bot", json!({"name": "x", "avatarColor": "plaid"})).await.contains("avatarColor"));
assert!(refused("lead", "create_bot", json!({"name": "x", "folder": "projects/x"})).await.contains("absolute"));
let no_trigger = json!({"name": "x", "routines": [{"name": "r", "instruction": "i", "triggers": []}]});
assert!(refused("lead", "create_bot", no_trigger).await.contains("triggers"));
// Routines are checked as `save_routine` checks them, for the bot they're for.
let lead_routine = hub.routines.save(&hub, "lead", &routine).unwrap()["routine"]["id"].clone();
let other = json!({"botId": "dev", "routines": [{"id": lead_routine, "name": "r", "instruction": "i",
"triggers": [{"type": "interval", "seconds": 1800}]}]});
assert!(refused("lead", "update_bot", other).await.contains("routine not found"));
let no_time = json!({"botId": "dev", "routines": [{"name": "r", "instruction": "i", "timeoutSeconds": 0,
"triggers": [{"type": "interval", "seconds": 1800}]}]});
assert!(refused("lead", "update_bot", no_time).await.contains("timeoutSeconds"));
// A manager's own fallbacks are the user's once they turned that off, also through update_bot.
hub.update_bot(&json!({"id": "lead", "selfFallbacks": false})).unwrap();
let own = json!({"botId": "lead", "fallbacks": [{"agent": "codex"}]});
assert!(refused("lead", "update_bot", own).await.contains("turned off setting your own fallbacks"));
// Under Ask, a change too long for its card to show in full never reaches the card.
hub.update_bot(&json!({"id": "lead", "permission": "ask"})).unwrap();
let long = json!({"name": "x", "agent": "claude", "instructions": "a".repeat(MAX_INSTRUCTIONS_CHARS)});
assert!(refused("lead", "create_bot", long).await.contains("too long for its approval card"));
assert_eq!(hub.store.bots().unwrap().len(), 3, "a refused change creates nothing");
assert_eq!(hub.routines.list("dev")["routines"], json!([]));
// Bots that bots made stop at MAX_CREATED, so managers making managers can't multiply without end.
for n in 1..MAX_CREATED {
let cfg: BotConfig =
serde_json::from_value(json!({"id": format!("made{n}"), "name": "made", "backend": "claude",
"cwd": dir.to_string_lossy(), "createdBy": "lead"}))
.unwrap();
hub.store.save_bot(&cfg).unwrap();
}
assert!(refused("lead", "create_bot", json!({"name": "x"})).await.contains("already created"));
std::fs::remove_dir_all(&dir).unwrap();
}
#[test]
fn a_card_lists_the_routines_before_the_instructions() {
let fields = setup_patch(&json!({"name": "Scout", "instructions": "Watches the repo."}), &[]).unwrap();
assert_eq!(
describe(&fields, &["• Scan (Every 30 minutes): Scan it".into()]),
"Name: Scout\nRoutines:\n• Scan (Every 30 minutes): Scan it\nInstructions:\nWatches the repo."
);
}