# oino

> Coding-agent runtime in Rust: a small core crate (`oino-core`), extensions and providers as WASM components in any language targeting wasm32-wasip2 (WIT `oino:extension@2.0.0`), and clients for the terminal, stdio protocols and embedding. 19 crates on crates.io; MIT OR Apache-2.0.

Rust SDK for building coding agents. Embed `oino-core` in process or drive `oino --mode rpc`. Extensions add tools, commands, UI and providers as sandboxed components.

## Docs

- [Overview](https://oino.dev/docs): what oino is, the layering, where each crate fits
- [Quick start](https://oino.dev/docs/quick-start): install the CLI, first prompt, embed in 40 lines, first extension
- [Concepts](https://oino.dev/docs/concepts): agent loop, sessions (format v3), tools, settings, resources, compaction, run modes
- [Embedding the SDK](https://oino.dev/docs/embedding): Services, AgentSessionRuntime, SessionBackend, in-process and RPC backends, loading extension packages
- [Extensions](https://oino.dev/docs/extensions): what components can do, load order, sandbox and permissions, WIT world overview
- [Rust guest SDK](https://oino.dev/docs/extensions/rust-sdk): complete walkthrough: tools, commands, events, host imports, build for wasm32-wasip2, testing
- [Extension packaging](https://oino.dev/docs/extensions/packaging): package layout, manifest fields, permissions, install and update
- [Providers and models](https://oino.dev/docs/providers): provider components, credentials, auth.json, models.json, model selection
- [Clients](https://oino.dev/docs/clients): TUI, print/JSON modes, JSONL RPC protocol, ACP for editors
- [Crate map](https://oino.dev/docs/reference/crates): every published crate with one line each and docs.rs links
- [Settings reference](https://oino.dev/docs/reference/settings): settings files and every core key
- [Environment variables](https://oino.dev/docs/reference/environment-variables): OINO_* variables, provider keys, variables exported to tools
- [CLI reference](https://oino.dev/docs/reference/cli): all flags and subcommands
- [Showcase: UniPi](https://oino.dev/docs/showcase-unipi): a full desktop and phone coding app built with oino; reference code

## Code

- [GitHub repository](https://github.com/Neuron-Mr-White/Oino): source, extensions, fixtures
- [crates.io](https://crates.io/search?q=oino): published crates
- [docs.rs/oino-core](https://docs.rs/oino-core): runtime rustdoc (each crate's docs open with an API map)
- [docs.rs/oino-extension](https://docs.rs/oino-extension): guest SDK rustdoc (module table for every host capability)