agent-tools

Small Rust helpers for running local commands and Codex-powered tools.

Features

Run commands with args, cwd, env, stdin, timeout, and output capture.
Run shell commands when shell syntax is needed.
Call the local codex CLI from Rust.
Use Codex web search with a simple web_search(query) function.

Install

[dependencies]
agent-tools = "0.1"

Run a Command

use agent_tools::{CmdRequest, CmdTool};

let output = CmdTool::run(CmdRequest {
    program: "echo".to_string(),
    args: vec!["hello".to_string()],
    cwd: None,
    env: None,
    timeout_ms: Some(1_000),
    fail_on_non_zero: true,
    stdin: None,
    background: false,
})?;

assert_eq!(output.stdout.trim(), "hello");
# Ok::<(), Box<dyn std::error::Error>>(())

Web Search

use agent_tools::web_search;

let answer = web_search("What is the latest stable Rust version?")?;
println!("{answer}");
# Ok::<(), Box<dyn std::error::Error>>(())

Web search uses the local codex CLI with --search. It does not call a separate search API directly. Make sure codex is installed and logged in before using it.

For advanced configuration, use WebSearchRequest and WebSearchTool.

Notes