Milo API Reference

Project scaffolding for `milo new`.

Input handling — key reading and escape sequence parsing.

Public test API: assert_renders, replay, record, MCP client.

Terminal display-cell width helpers. Python string length counts code points, but terminals lay text out in...

Persistent child process for MCP gateway communication.

Markdown help generation for CLI command trees.

Command definition types and helpers.

Cross-platform compatibility helpers.

Structured error hierarchy with format_compact() for terminal display.

Shared JSON-RPC output helpers for mcp.py and gateway.py.

Shared MCP method dispatch for leaf servers and gateway.

Protocols — stdlib/typing only, no internal imports.

Frozen dataclasses, enums, and type aliases — no internal imports.

App event loop and terminal rendering.

CLI entry point — milo dev, milo replay.

CLI application with command decorator and dispatch.

Shell completion generation for bash, zsh, fish, and PowerShell.

`milo components` — discover bundled and user-defined template components.

Configuration system with deep merge, environment overlays, and origin tracking.

Execution context for CLI command handlers.

Hot-reload dev server with smart file watching.

Built-in diagnostic command for CLI health checks.

Declarative screen state machine with >> operator.

Form fields and form reducer.

Milo MCP gateway — one MCP server that proxies to all registered CLIs.

Nestable command groups for hierarchical CLI structures.

HelpRenderer — argparse formatter_class for styled help output.

Live-rendering primitives for non-event-loop use. Re-exports from `kida.terminal`.

llms.txt generation from CLI command definitions.

MCP server — expose CLI commands as tools via JSON-RPC on stdin/stdout.

Middleware stack for MCP and CLI call interception.

Milo — Template-driven CLI applications for free-threaded Python.

Observability for MCP requests — logging, stats, correlation IDs.

Structured output formatting for CLI commands.

Pipeline orchestration with observable state through the Store/saga system.

Plugin system with hook registry and Store middleware integration.

Composable reducer combinators for common interaction patterns.

Milo CLI registry — tracks installed CLIs for gateway discovery.

Function signature → JSON Schema for MCP tool compatibility.

Store, dispatch, saga runner, combine_reducers.

Streaming support for long-running CLI commands.

Built-in templates and template environment factory.

Theme system for styled CLI output.

Self-diagnosis for agent-built milo CLIs (`milo verify`). Answers "is this CLI correctly built?" via six checks: 1.

Non-blocking version check with periodic caching.