execkit 0.3.1

Stateful, structured, safe shell sessions for AI agents on real infrastructure.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

// SPDX-License-Identifier: Apache-2.0
//! A persistent shell session inside a running Docker container.
//!
//! Run:
//!   docker run -d --name ek alpine sleep 600
//!   EXECKIT_DOCKER=ek cargo run --example docker
//!
//! Needs the `docker` CLI on PATH. Same structured ExecResult, policy, redaction,
//! and bounding as the local and SSH transports.

use execkit::Session;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let container =
        std::env::var("EXECKIT_DOCKER").map_err(|_| "set EXECKIT_DOCKER=<container name or id>")?;

    let mut session = Session::docker(&container)?;
    let r = session.exec("uname -a; cat /etc/os-release | grep PRETTY")?;
    println!("{}", r.stdout);

    // State persists across commands, inside the container.
    session.exec("cd /tmp")?;
    println!("cwd is now: {}", session.exec("pwd")?.cwd);

    Ok(())
}