Documentation

iota is an agent CLI, not a framework. You configure agents — a model, a prompt, a set of tools — in ~/.iota.yaml, and run them: iota run <agent>, or a bare iota for the agent called default.

brew install iotash/tap/iota
iota config init          # writes ~/.iota.yaml with one provider, one model and agents.default
export OPENAI_API_KEY=…   # or put `key:` in the file
iota                      # runs agents.default

Start here

InstallationHomebrew, a curl one-liner, a PowerShell one-liner, cargo, or a build from source. macOS, Linux and Windows.Your first runThe five commands, the nine flags, and where the API key comes from.The config fileproviders, models and agents — the three layers of ~/.iota.yaml.Built-in toolsetsshell, code, skills and ask — what each one can do and what it asks before doing it.MCP serversstdio and HTTP servers, namespaced tools, deferred loading.Agent modeworkspace: true — AGENTS.md overlays, Agent Skills, project-scoped sessions.Image generationimagen and images providers, /edit, /redo, inline rendering.Slash commandsEvery slash command, and the keys that drive a session.ExamplesInvocations, from an interactive run to headless turns and attachments.