miniouto 0.1.1

A minimal, file-driven CLI agent harness built on coreouto.

miniouto

A minimal, file-driven CLI agent harness built on coreouto.

Three principles:

1. Minimalism — No bloat. Extend with styles.
2. Automation-friendly — Full CLI; TUI is optional.
3. Fluidity — Adapts to any environment.

Preview

Install

uv tool install miniouto
# or
pip install miniouto

License

Apache License 2.0

Quick start

# Either add a custom provider by hand:
miniouto provider custom add \
  --name openai \
  --api-key sk-... \
  --base-url https://api.openai.com/v1 \
  --default-model gpt-5.5            # optional; used when chat --model is not given

# Or browse the lma (llm-model-api) catalog and add from there:
miniouto provider providers          # see all 144 catalog providers
miniouto provider add Anthropic --api-key sk-ant-...   # adds it with the first catalog model

miniouto provider default openai
miniouto style set default
miniouto chat "hello"
miniouto                              # TUI mode

Model resolution

The active model is chosen by the first match in:

1. miniouto chat --model <name> (per-call override)
2. settings.model (legacy per-session override; cleared whenever the TUI model picker saves)
3. provider.default_model (set by provider add --default-model, provider custom add --default-model, or the TUI model chip)
4. error — no model can be inferred

Commands

Command	Purpose
miniouto chat "prompt"	One-shot chat turn
miniouto	TUI mode
miniouto status	Show current configuration
miniouto provider providers/models/add	Browse the lma catalog and add providers from it
miniouto provider custom add	Add a custom provider by hand (api_format, base_url, api_key, default_model)
miniouto provider list/remove/default	Manage saved providers
miniouto style list/set/add/update/show	Manage style documents (update re-seeds bundled + re-fetches all repo styles)
miniouto skill list/show	List/show skills from ~/.agents/skills/

chat flags

Flag	Effect
--name	Session name (persists to ~/.miniouto/settings.toml)
--provider	Override the active provider for this call
--model	Override the resolved model for this call
--style	Override the active style for this call
--max-tokens	Cap output tokens
--temperature	Sampling temperature
--continue / -c	Prepend the session's previous history
--answer-only / -a	Print only the final answer (no session marker, no loop events, no finish marker)
--with-session	Print only the session marker + final answer (no loop events, no finish marker)

Storage

Everything lives under ~/.miniouto/:

• providers.toml — provider configs (one top-level TOML table per provider: api_format, base_url, api_key, default_model, source)
• settings.toml — active provider, model (legacy), style, session, theme
• style/<name>.md — style documents
• sessions/<name>.json — conversation history
• logs/ — reserved (currently unused)

Skills live outside this tree, at ~/.agents/skills/<name>/SKILL.md (the Anthropic convention).

Override the root with the MINIOUTO_HOME environment variable.