miniouto

miniouto logo

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

Three principles:

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

Preview

miniouto 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:

miniouto chat --model <name> (per-call override)
settings.model (legacy per-session override; cleared whenever the TUI model picker saves)
provider.default_model (set by provider add --default-model, provider custom add --default-model, or the TUI model chip)
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
`--reasoning`	Override reasoning for this call (effort level / `on` / `none`). Default: provider setting, else lma model default
`--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.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

miniouto-0.4.0.tar.gz (5.9 MB view details)

Uploaded Jul 27, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

miniouto-0.4.0-py3-none-any.whl (117.5 kB view details)

Uploaded Jul 27, 2026 Python 3

File details

Details for the file miniouto-0.4.0.tar.gz.

File metadata

Download URL: miniouto-0.4.0.tar.gz
Upload date: Jul 27, 2026
Size: 5.9 MB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for miniouto-0.4.0.tar.gz
Algorithm	Hash digest
SHA256	`b72f600480c24fc2abedc324b2dc5bb06816be6b4f10c78e8f83d2f72d0c26d5`
MD5	`bf02e49f7c8793ecfb4e5096c3cd2d69`
BLAKE2b-256	`3be1786fa8f7249303ce92bdbfc1b644fa46f261e6296aaab3f5dc84c213eaff`

See more details on using hashes here.

Provenance

The following attestation bundles were made for miniouto-0.4.0.tar.gz:

Publisher: release.yml on llaa33219/miniouto

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: miniouto-0.4.0.tar.gz
- Subject digest: b72f600480c24fc2abedc324b2dc5bb06816be6b4f10c78e8f83d2f72d0c26d5
- Sigstore transparency entry: 2257939039
- Sigstore integration time: Jul 27, 2026
Source repository:
- Permalink: llaa33219/miniouto@699205f0522b795b0e23805b0bd63293d191ad1f
- Branch / Tag: refs/tags/v0.4.0
- Owner: https://github.com/llaa33219
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@699205f0522b795b0e23805b0bd63293d191ad1f
- Trigger Event: push