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
//! Run an installed CLI for a usage probe. A missing program is silence: the
//! probe is skipped until the agent is installed.
use crate::hub::Hub;
use serde_json::Value;
use std::path::{Path, PathBuf};
use std::time::Duration;
use super::Window;
use super::reading::{UsageReadStage, report};
/// `name` on the login-shell PATH.
pub(super) fn program(name: &str) -> Option<PathBuf> {
crate::agent::backends::which(name)
}
/// Stdout of `program`, with terminal colour removed. Nothing when it isn't
/// installed, the process produces no output, or it doesn't finish in time.
/// A non-zero exit still returns stdout: the parser decides whether it is usage.
pub(super) async fn output(
program: &Path,
args: &[&str],
stdin_text: Option<&str>,
timeout: Duration,
) -> Option<String> {
let mut cmd = tokio::process::Command::new(program);
cmd.args(args)
.kill_on_drop(true)
.stdin(if stdin_text.is_some() { std::process::Stdio::piped() } else { std::process::Stdio::null() })
.stdout(std::process::Stdio::piped())
.stderr(std::process::Stdio::null());
if let Some(home) = dirs::home_dir() {
cmd.current_dir(home);
}
let mut child = cmd.spawn().ok()?;
if let Some(text) = stdin_text
&& let Some(mut input) = child.stdin.take()
{
use tokio::io::AsyncWriteExt;
// A CLI that didn't get its command prints no usage: the empty answer below reads as no reading.
let _ = input.write_all(text.as_bytes()).await;
}
let done = tokio::time::timeout(timeout, child.wait_with_output()).await.ok()?.ok()?;
let text = strip_ansi(&String::from_utf8_lossy(&done.stdout));
(!text.trim().is_empty()).then_some(text)
}
/// What `name` prints, read by `parse`. Printing no limits keeps the last reading.
pub(super) async fn windows(
name: &str,
args: &[&str],
stdin_text: Option<&str>,
timeout: Duration,
parse: impl FnOnce(&str) -> Vec<Window>,
) -> Option<Vec<Window>> {
let text = output(&program(name)?, args, stdin_text, timeout).await?;
let windows = parse(&text);
if windows.is_empty() {
tracing::debug!(name, "the usage report had no limits");
return None;
}
Some(windows)
}
/// The JSON report of the agent `name`'s CLI, read by `parse`: `None` from it means the format changed.
/// Nothing printed (not installed, signed out, timed out) or the CLI's words for being signed out are
/// no reading and no failure.
pub(super) async fn json_windows(
hub: &Hub,
name: &str,
args: &[&str],
timeout: Duration,
parse: impl FnOnce(&Value) -> Option<Vec<Window>>,
) -> Option<Vec<Window>> {
let text = output(&program(name)?, args, None, timeout).await?;
let reading = match serde_json::from_str::<Value>(&text) {
Ok(document) => parse(&document).ok_or(UsageReadStage::Parse),
Err(_) if says_signed_out(&text) => return None,
Err(_) => Err(UsageReadStage::Parse),
};
report(hub, name, &reading);
reading.ok()
}
fn says_signed_out(text: &str) -> bool {
let text = text.to_lowercase();
["not authenticated", "logged in", "log in", "signed in", "sign in"].iter().any(|words| text.contains(words))
}
/// Drop CSI colour sequences (`ESC [ … m`). Other characters stay, including
/// the cursor-position query a Windows console sends.
pub(crate) fn strip_ansi(text: &str) -> String {
let mut out = String::with_capacity(text.len());
let mut chars = text.chars().peekable();
while let Some(c) = chars.next() {
if c == '\u{1b}' && chars.peek() == Some(&'[') {
chars.next();
for d in chars.by_ref() {
if d.is_ascii_alphabetic() {
break;
}
}
continue;
}
out.push(c);
}
out
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn colour_codes_drop_out_of_a_usage_line() {
let raw = "Credits \u{1b}[32m(12 of 100\u{1b}[0m covered)";
assert_eq!(strip_ansi(raw), "Credits (12 of 100 covered)");
}
#[test]
fn a_cli_saying_it_is_signed_out_is_told_from_a_changed_format() {
assert!(says_signed_out("You are not currently logged in to Augment."));
assert!(says_signed_out("Error: Not authenticated with Kilo Gateway"));
assert!(!says_signed_out("usage: unknown flag --json"));
}
}