The smallest thing between your terminal and a model.

iota is an agent CLI written in Rust. You configure agents — a model, a prompt, a set of tools — and run them: iota run <agent>.

orcargo install --git https://github.com/iotash/iota

v0.1.0  ·  7.56 MiB  ·  MIT  ·  macOS, Linux and Windows

let (rx, tx) = pipe()?;drop(tx);  // ← before the await

An actual session — agent mode, one bash call, one answer. No cuts.

# why it is small

The terminal is already an interface: it has scrollback, a clipboard, pipes and a shell. We did not want to rebuild any of that in a window, so iota adds the one thing the terminal is missing — a model that can use your tools — and stops there. Nothing it does is hidden from you: a session is a directory holding meta.json and messages.jsonl, one JSON record per line, appended as you talk, and /debug shows the exact request and response bodies that went over the wire. The config is one YAML file with three maps in it. There is no account, no daemon and no telemetry. And there is nothing to be locked into — any endpoint that speaks OpenAI, Anthropic or Gemini works, including one you run yourself, and a child agent is just iota run <agent> -m "<task>" run from bash, like anything else.

# what it is, and is not