Skip to main content

Crate agshell

Crate agshell 

Source
Expand description

agshell — a supervised execution shell for coding agents.

The shell is a library here, not a subprocess: Session owns a live brush-core shell, so cd, export, functions and options survive between calls, and a Session::snapshot is a cheap checkpoint.

use agshell::{Options, Session};

let mut session = Session::new(Options::default()).await?;
let report = session.run("cd /tmp; false | head -1").await;
assert_eq!(report.class, "stage_failed");

Re-exports§

pub use check::CheckReport;
pub use check::Finding;
pub use report::CommandRecord;
pub use report::Report;
pub use session::NoopObserver;
pub use session::Observer;
pub use session::Options;
pub use session::Session;
pub use session::StateSummary;

Modules§

check
Static analysis: what this script will hide, before it runs.
daemon
A persistent shell behind a per-directory daemon.
report
The envelope: what actually ran, as data.
scan
A deliberately small scanner over shell source.
serve
A line-oriented server: one shell, many commands.
session
The supervisor, and the session that owns a shell.
sys
Platform bits: finding and killing a command’s whole process tree, and asking the kernel to keep orphaned grandchildren reachable.
trace
Seeing inside a statement the shell runs whole.