Keyboard shortcuts

Press ← or β†’ to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Unio

Local intelligent agent runtime

Build, inspect, and automate from one terminal agent.

Unio is a Rust workspace for a general-purpose intelligent agent. It combines a CLI, local daemon, model providers, tool execution, approval policy, skills, storage, and trace events into one cohesive developer workflow.

cargo run -p unio -- exec "inspect README.md"
cargo run -p unio -- tool read --args path=README.md

Agent Workflows

Run prompts, resume sessions, inspect traces, and keep conversation state attached to a workspace.

Tools With Policy

Read files, write files, and execute registered tools through an approval layer instead of unguarded shell access.

Skills

Load repository or user skills from `.unio/skills/` and invoke them through the same tool contract as other capabilities.

Observable Runs

Trace IDs, run IDs, JSONL records, and SQLite metadata make agent work inspectable after the command finishes.

One Runtime, Multiple Entry Points

  1. Start from the terminal with `unio`, `unio exec`, or a direct tool command.
  2. The CLI submits work to the daemon, which owns sessions, runs, approvals, tools, storage, and trace events.
  3. The agent uses the configured model provider or the mock provider for local development.
  4. Security policy decides whether a tool call is allowed, denied, or waiting for approval.

Start Here