milo-cli 0.1.0__tar.gz → 0.2.0__tar.gz

{milo_cli-0.1.0 → milo_cli-0.2.0}/PKG-INFO

@@ -1,12 +1,13 @@
 Metadata-Version: 2.4
 Name: milo-cli
-Version: 0.1.0
+Version: 0.2.0
 Summary: Template-driven CLI applications for free-threaded Python
 License-Expression: MIT
-Project-URL: Homepage, https://lbliii.github.io/milo/
-Project-URL: Documentation, https://lbliii.github.io/milo/
-Project-URL: Repository, https://github.com/lbliii/milo
-Project-URL: Changelog, https://github.com/lbliii/milo/blob/main/CHANGELOG.md
+Project-URL: Homepage, https://lbliii.github.io/milo-cli/
+Project-URL: Documentation, https://lbliii.github.io/milo-cli/
+Project-URL: Repository, https://github.com/lbliii/milo-cli
+Project-URL: Changelog, https://github.com/lbliii/milo-cli/blob/main/CHANGELOG.md
+Project-URL: Issues, https://github.com/lbliii/milo-cli/issues
 Keywords: cli,terminal,forms,free-threading,template,elm
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
@@ -17,7 +18,7 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Typing :: Typed
 Requires-Python: >=3.14
 Description-Content-Type: text/markdown
-Requires-Dist: kida-templates>=0.3.0
+Requires-Dist: kida-templates>=0.4.0
 Provides-Extra: docs
 Requires-Dist: bengal>=0.2.6; extra == "docs"
 Provides-Extra: yaml
@@ -27,77 +28,110 @@ Requires-Dist: watchfiles>=1.0; extra == "watch"
 
 # ᗣᗣ Milo
 
-[![PyPI version](https://img.shields.io/pypi/v/milo.svg)](https://pypi.org/project/milo/)
-[![Build Status](https://github.com/lbliii/milo/actions/workflows/tests.yml/badge.svg)](https://github.com/lbliii/milo/actions/workflows/tests.yml)
-[![Python 3.14+](https://img.shields.io/badge/python-3.14+-blue.svg)](https://pypi.org/project/milo/)
+[![PyPI version](https://img.shields.io/pypi/v/milo-cli.svg)](https://pypi.org/project/milo-cli/)
+[![Build Status](https://github.com/lbliii/milo-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/lbliii/milo-cli/actions/workflows/ci.yml)
+[![Python 3.14+](https://img.shields.io/badge/python-3.14+-blue.svg)](https://pypi.org/project/milo-cli/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
 
-**Template-driven CLI applications for free-threaded Python**
+**Build CLIs that humans and AI agents both use natively**
 
 ```python
-from milo import App, Action
+from milo import CLI
 
-def reducer(state, action):
-    if state is None:
-        return {"count": 0}
-    if action.type == "@@KEY" and action.payload.char == " ":
-        return {**state, "count": state["count"] + 1}
-    return state
+cli = CLI(name="deployer", description="Deploy services to environments")
 
-app = App(template="counter.kida", reducer=reducer, initial_state=None)
-final_state = app.run()
+@cli.command("deploy", description="Deploy a service", annotations={"destructiveHint": True})
+def deploy(environment: str, service: str, version: str = "latest") -> dict:
+    """Deploy a service to the specified environment."""
+    return {"status": "deployed", "environment": environment, "service": service, "version": version}
+
+cli.run()
+```
+
+Three protocols from one decorator:
+
+```bash
+# Human CLI
+deployer deploy --environment production --service api
+
+# MCP tool (AI agent calls this via JSON-RPC)
+echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"deploy","arguments":{"environment":"staging","service":"api"}}}' \
+  | deployer --mcp
+
+# AI-readable discovery document
+deployer --llms-txt
 ```
 
 ---
 
 ## What is Milo?
 
-Milo is a framework for building interactive terminal applications in Python 3.14t. It uses the Elm Architecture (Model-View-Update) — an immutable state tree managed by pure reducer functions, a view layer driven by Kida templates, and generator-based sagas for side effects. The result is CLI apps that are predictable, testable, and free-threading ready.
+Milo is a Python framework where every CLI is simultaneously a terminal app, a command-line tool, and an MCP server. Write one function with type annotations and a docstring — Milo generates the argparse subcommand, the MCP tool schema, and the llms.txt entry automatically.
 
 **Why people pick it:**
 
+- **Every CLI is an MCP server** — `@cli.command` produces an argparse subcommand, MCP tool, and llms.txt entry from one function. AI agents discover and call your tools with zero extra code.
+- **Dual-mode commands** — The same command shows an interactive UI when a human runs it, and returns structured JSON when an AI calls it via MCP.
+- **Annotated schemas** — Type hints + `Annotated` constraints generate rich JSON Schema. Agents validate inputs before calling.
+- **Streaming progress** — Commands that yield `Progress` objects stream notifications to MCP clients in real time.
 - **Elm Architecture** — Immutable state, pure reducers, declarative views. Every state transition is explicit and testable.
-- **Template-driven UI** — Render terminal output with Kida templates. Same syntax you use for HTML, now for CLI.
 - **Free-threading ready** — Built for Python 3.14t (PEP 703). Sagas run on `ThreadPoolExecutor` with no GIL contention.
-- **Declarative flows** — Chain multi-screen state machines with the `>>` operator. No manual navigation plumbing.
-- **Built-in forms** — Text, select, confirm, and password fields with validation, keyboard navigation, and TTY fallback.
 - **One runtime dependency** — Just `kida-templates`. No click, no rich, no curses.
 
 ## Use Milo For
 
+- **AI agent toolchains** — Every CLI doubles as an MCP server; register multiple CLIs behind a single gateway
 - **Interactive CLI tools** — Wizards, installers, configuration prompts, and guided workflows
+- **Dual-mode commands** — Interactive when a human runs them, structured when an AI calls them
 - **Multi-screen terminal apps** — Declarative flows with `>>` operator for screen-to-screen navigation
 - **Forms and data collection** — Text, select, confirm, and password fields with validation
 - **Dev tools with hot reload** — `milo dev` watches templates and live-reloads on change
 - **Session recording and replay** — Record user sessions to JSONL, replay for debugging or CI regression tests
-- **Styled terminal output** — Kida terminal templates with ANSI colors, progress bars, and live rendering
-- **AI agent integration** — Every CLI is an MCP server; register multiple CLIs behind a single gateway
 
 ---
 
 ## Installation
 
 ```bash
-pip install milo
+pip install milo-cli
 ```
 
+The PyPI package is **milo-cli**; import the **`milo`** namespace in Python. The `milo` console command is installed with the package.
+
 Requires Python 3.14+
 
 ---
 
 ## Quick Start
 
+### AI-Native CLI
+
+| Function | Description |
+|----------|-------------|
+| `CLI(name, description, version)` | Create a CLI application |
+| `@cli.command(name, description)` | Register a typed command |
+| `cli.group(name, description)` | Create a command group |
+| `cli.run()` | Parse args and dispatch |
+| `cli.call("cmd", **kwargs)` | Programmatic invocation |
+| `--mcp` | Run as MCP server |
+| `--llms-txt` | Generate AI discovery doc |
+| `--mcp-install` | Register in gateway |
+| `annotations={...}` | MCP behavioral hints |
+| `Annotated[str, MinLen(1)]` | Schema constraints |
+
+### Interactive Apps
+
 | Function | Description |
 |----------|-------------|
 | `App(template, reducer, initial_state)` | Create a single-screen app |
 | `App.from_flow(flow)` | Create a multi-screen app from a `Flow` |
-| `app.run()` | Run the event loop, return final state |
-| `Store(reducer, initial_state)` | Standalone state container |
-| `combine_reducers(**reducers)` | Compose slice-based reducers |
 | `form(*specs)` | Run an interactive form, return `{field: value}` |
 | `FlowScreen(name, template, reducer)` | Define a named screen |
 | `flow = screen_a >> screen_b` | Chain screens into a flow |
-| `render_html(state, template)` | One-shot static HTML render |
+| `ctx.run_app(reducer, template, state)` | Bridge CLI commands to interactive apps |
+| `quit_on`, `with_cursor`, `with_confirm` | Reducer combinator decorators |
+| `Cmd(fn)`, `Batch(cmds)`, `Sequence(cmds)` | Side effects on thread pool |
+| `ViewState(cursor_visible=True, ...)` | Declarative terminal state |
 | `DevServer(app, watch_dirs)` | Hot-reload dev server |
 
 ---
@@ -106,26 +140,125 @@ Requires Python 3.14+
 
 | Feature | Description | Docs |
 |---------|-------------|------|
-| **State Management** | Redux-style `Store` with dispatch, listeners, middleware, and saga scheduling | [State →](https://lbliii.github.io/milo/docs/usage/state/) |
-| **Sagas** | Generator-based side effects: `Call`, `Put`, `Select`, `Fork`, `Delay` | [Sagas →](https://lbliii.github.io/milo/docs/usage/sagas/) |
-| **Flows** | Multi-screen state machines with `>>` operator and custom transitions | [Flows →](https://lbliii.github.io/milo/docs/usage/flows/) |
-| **Forms** | Text, select, confirm, password fields with validation and TTY fallback | [Forms →](https://lbliii.github.io/milo/docs/usage/forms/) |
-| **Input Handling** | Cross-platform key reader with full escape sequence support (arrows, F-keys, modifiers) | [Input →](https://lbliii.github.io/milo/docs/usage/input/) |
-| **Templates** | Kida-powered terminal rendering with built-in form, field, help, and progress templates | [Templates →](https://lbliii.github.io/milo/docs/usage/templates/) |
-| **Dev Server** | `milo dev` with filesystem polling and `@@HOT_RELOAD` dispatch | [Dev →](https://lbliii.github.io/milo/docs/usage/dev/) |
-| **Session Recording** | JSONL action log with state hashes for debugging and regression testing | [Testing →](https://lbliii.github.io/milo/docs/usage/testing/) |
-| **Replay** | Time-travel debugging, speed control, step-by-step mode, CI hash assertions | [Testing →](https://lbliii.github.io/milo/docs/usage/testing/) |
-| **Snapshot Testing** | `assert_renders`, `assert_state`, `assert_saga` for deterministic test coverage | [Testing →](https://lbliii.github.io/milo/docs/usage/testing/) |
-| **Help Rendering** | `HelpRenderer` — drop-in `argparse.HelpFormatter` using Kida templates | [Help →](https://lbliii.github.io/milo/docs/usage/help/) |
-| **MCP Server** | Every CLI doubles as an MCP server — AI agents discover and call commands via JSON-RPC | [MCP →](https://lbliii.github.io/milo/docs/usage/mcp/) |
-| **MCP Gateway** | Single gateway aggregates all registered Milo CLIs for unified AI agent access | [MCP →](https://lbliii.github.io/milo/docs/usage/mcp/) |
-| **llms.txt** | Generate AI-readable discovery documents from CLI command definitions | [llms.txt →](https://lbliii.github.io/milo/docs/usage/llms/) |
-| **Error System** | Structured error hierarchy with namespaced codes (`M-INP-001`, `M-STA-003`) | [Errors →](https://lbliii.github.io/milo/docs/reference/errors/) |
+| **MCP Server** | Every CLI doubles as an MCP server — AI agents discover and call commands via JSON-RPC | [MCP →](https://lbliii.github.io/milo-cli/docs/usage/mcp/) |
+| **MCP Gateway** | Single gateway aggregates all registered Milo CLIs for unified AI agent access | [MCP →](https://lbliii.github.io/milo-cli/docs/usage/mcp/) |
+| **Tool Annotations** | Declare `readOnlyHint`, `destructiveHint`, `idempotentHint` per MCP spec | [MCP →](https://lbliii.github.io/milo-cli/docs/usage/mcp/) |
+| **Streaming Progress** | Commands yield `Progress` objects; MCP clients receive real-time notifications | [MCP →](https://lbliii.github.io/milo-cli/docs/usage/mcp/) |
+| **Schema Constraints** | `Annotated[str, MinLen(1), MaxLen(100)]` generates rich JSON Schema | [CLI →](https://lbliii.github.io/milo-cli/docs/usage/cli/) |
+| **llms.txt** | Generate AI-readable discovery documents from CLI command definitions | [llms.txt →](https://lbliii.github.io/milo-cli/docs/usage/llms/) |
+| **Middleware** | Intercept MCP calls and CLI commands for logging, auth, and transformation | [CLI →](https://lbliii.github.io/milo-cli/docs/usage/cli/) |
+| **Observability** | Built-in request logging with latency stats (`milo://stats` resource) | [MCP →](https://lbliii.github.io/milo-cli/docs/usage/mcp/) |
+| **State Management** | Redux-style `Store` with dispatch, listeners, middleware, and saga scheduling | [State →](https://lbliii.github.io/milo-cli/docs/usage/state/) |
+| **Commands** | Lightweight `Cmd` thunks, `Batch`, `Sequence`, `TickCmd` for one-shot effects | [Commands →](https://lbliii.github.io/milo-cli/docs/usage/commands-effects/) |
+| **Sagas** | Generator-based side effects: `Call`, `Put`, `Select`, `Fork`, `Delay`, `Retry` | [Sagas →](https://lbliii.github.io/milo-cli/docs/usage/sagas/) |
+| **ViewState** | Declarative terminal state (`cursor_visible`, `alt_screen`, `window_title`, `mouse_mode`) | [Commands →](https://lbliii.github.io/milo-cli/docs/usage/commands-effects/) |
+| **Flows** | Multi-screen state machines with `>>` operator and custom transitions | [Flows →](https://lbliii.github.io/milo-cli/docs/usage/flows/) |
+| **Forms** | Text, select, confirm, password fields with validation and TTY fallback | [Forms →](https://lbliii.github.io/milo-cli/docs/usage/forms/) |
+| **Input Handling** | Cross-platform key reader with full escape sequence support (arrows, F-keys, modifiers) | [Input →](https://lbliii.github.io/milo-cli/docs/usage/input/) |
+| **Templates** | Kida-powered terminal rendering with built-in form, field, help, and progress templates | [Templates →](https://lbliii.github.io/milo-cli/docs/usage/templates/) |
+| **Dev Server** | `milo dev` with filesystem polling and `@@HOT_RELOAD` dispatch | [Dev →](https://lbliii.github.io/milo-cli/docs/usage/dev/) |
+| **Session Recording** | JSONL action log with state hashes for debugging and regression testing | [Testing →](https://lbliii.github.io/milo-cli/docs/usage/testing/) |
+| **Snapshot Testing** | `assert_renders`, `assert_state`, `assert_saga` for deterministic test coverage | [Testing →](https://lbliii.github.io/milo-cli/docs/usage/testing/) |
+| **Help Rendering** | `HelpRenderer` — drop-in `argparse.HelpFormatter` using Kida templates | [Help →](https://lbliii.github.io/milo-cli/docs/usage/help/) |
+| **Context** | Execution context with verbosity, output format, global options, and `run_app()` bridge | [Context →](https://lbliii.github.io/milo-cli/docs/usage/context/) |
+| **Configuration** | `Config` with validation, init scaffolding, and profile support | [Config →](https://lbliii.github.io/milo-cli/docs/usage/config/) |
+| **Shell Completions** | Generate bash/zsh/fish completions from CLI definitions | [CLI →](https://lbliii.github.io/milo-cli/docs/usage/cli/) |
+| **Doctor Diagnostics** | `run_doctor()` validates environment, dependencies, and config health | [CLI →](https://lbliii.github.io/milo-cli/docs/usage/cli/) |
 
 ---
 
 ## Usage
 
+<details>
+<summary><strong>Dual-Mode Commands</strong> — Interactive for humans, structured for AI</summary>
+
+```python
+from milo import CLI, Context, Action, Quit, SpecialKey
+from milo.streaming import Progress
+from typing import Annotated
+from milo import MinLen
+
+cli = CLI(name="deployer", description="Deploy services")
+
+@cli.command("deploy", description="Deploy a service", annotations={"destructiveHint": True})
+def deploy(
+    environment: Annotated[str, MinLen(1)],
+    service: Annotated[str, MinLen(1)],
+    ctx: Context = None,
+) -> dict:
+    """Deploy a service to an environment."""
+    # Interactive mode: show confirmation UI
+    if ctx and ctx.is_interactive:
+        if not ctx.confirm(f"Deploy {service} to {environment}?"):
+            return {"status": "cancelled"}
+
+    # Stream progress (MCP clients see real-time notifications)
+    yield Progress(status=f"Deploying {service}", step=0, total=2)
+    yield Progress(status="Verifying health", step=1, total=2)
+
+    return {"status": "deployed", "environment": environment, "service": service}
+```
+
+Run by a human: interactive confirmation, then progress output.
+Called via MCP: progress notifications stream, then structured JSON result.
+
+</details>
+
+<details>
+<summary><strong>MCP Server & Gateway</strong> — AI agent integration</summary>
+
+Every Milo CLI is automatically an MCP server:
+
+```bash
+# Run as MCP server (stdin/stdout JSON-RPC)
+myapp --mcp
+
+# Register with an AI host directly
+claude mcp add myapp -- uv run python examples/deploy/app.py --mcp
+```
+
+For multiple CLIs, register them and run a single gateway:
+
+```bash
+# Register CLIs
+taskman --mcp-install
+deployer --mcp-install
+
+# Run the unified gateway
+uv run python -m milo.gateway --mcp
+
+# Or register the gateway with your AI host
+claude mcp add milo -- uv run python -m milo.gateway --mcp
+```
+
+The gateway namespaces tools automatically: `taskman.add`, `deployer.deploy`, etc. Implements MCP 2025-11-25 with `outputSchema`, `structuredContent`, tool `annotations`, and streaming `Progress` notifications.
+
+Built-in `milo://stats` resource exposes request latency, error counts, and throughput.
+
+</details>
+
+<details>
+<summary><strong>Schema Constraints</strong> — Rich validation from type hints</summary>
+
+```python
+from typing import Annotated
+from milo import CLI, MinLen, MaxLen, Gt, Lt, Pattern, Description
+
+cli = CLI(name="app")
+
+@cli.command("create-user", description="Create a user account")
+def create_user(
+    name: Annotated[str, MinLen(1), MaxLen(100), Description("Full name")],
+    age: Annotated[int, Gt(0), Lt(200)],
+    email: Annotated[str, Pattern(r"^[^@]+@[^@]+$")],
+) -> dict:
+    return {"name": name, "age": age, "email": email}
+```
+
+Generates JSON Schema with `minLength`, `maxLength`, `exclusiveMinimum`, `exclusiveMaximum`, `pattern`, and `description` — AI agents validate inputs before calling.
+
+</details>
+
 <details>
 <summary><strong>Single-Screen App</strong> — Counter with keyboard input</summary>
 
@@ -210,64 +343,20 @@ def reducer(state, action):
     return state
 ```
 
-Effects: `Call(fn, args)`, `Put(action)`, `Select(selector)`, `Fork(saga)`, `Delay(seconds)`.
-
-</details>
-
-<details>
-<summary><strong>Middleware</strong> — Intercept and transform dispatches</summary>
-
-```python
-def logging_middleware(dispatch, get_state):
-    def wrapper(action):
-        print(f"Action: {action.type}")
-        return dispatch(action)
-    return wrapper
-
-app = App(
-    template="app.kida",
-    reducer=reducer,
-    initial_state=None,
-    middleware=[logging_middleware],
-)
-```
-
-</details>
-
-<details>
-<summary><strong>Dev Server</strong> — Hot reload templates</summary>
+Saga effects: `Call(fn, args)`, `Put(action)`, `Select(selector)`, `Fork(saga)`, `Delay(seconds)`, `Retry(fn, ...)`.
 
-```bash
-# Watch templates and reload on change
-milo dev myapp:app --watch ./templates --poll 0.25
-```
+For one-shot effects, use `Cmd` instead — no generator needed:
 
 ```python
-from milo import App, DevServer
-
-app = App(template="dashboard.kida", reducer=reducer, initial_state=None)
-server = DevServer(app, watch_dirs=("./templates",), poll_interval=0.5)
-server.run()
-```
+from milo import Cmd, ReducerResult
 
-</details>
+def fetch_status():
+    return Action("STATUS", payload=urllib.request.urlopen(url).status)
 
-<details>
-<summary><strong>Session Recording & Replay</strong> — Debug and regression testing</summary>
-
-```python
-# Record a session
-app = App(template="app.kida", reducer=reducer, initial_state=None, record=True)
-app.run()  # Writes to session.jsonl
-
-# Replay for debugging
-milo replay session.jsonl --speed 2.0 --diff
-
-# CI regression: assert state hashes match
-milo replay session.jsonl --assert --reducer myapp:reducer
-
-# Step-by-step interactive replay
-milo replay session.jsonl --step
+def reducer(state, action):
+    if action.type == "CHECK":
+        return ReducerResult(state, cmds=(Cmd(fetch_status),))
+    return state
 ```
 
 </details>
@@ -293,37 +382,6 @@ Set `MILO_UPDATE_SNAPSHOTS=1` to regenerate snapshot files.
 
 </details>
 
-<details>
-<summary><strong>MCP Server & Gateway</strong> — AI agent integration</summary>
-
-Every Milo CLI is automatically an MCP server:
-
-```bash
-# Run as MCP server (stdin/stdout JSON-RPC)
-myapp --mcp
-
-# Register with an AI host directly
-claude mcp add myapp -- uv run python examples/taskman/app.py --mcp
-```
-
-For multiple CLIs, register them and run a single gateway:
-
-```bash
-# Register CLIs
-taskman --mcp-install
-ghub --mcp-install
-
-# Run the unified gateway
-uv run python -m milo.gateway --mcp
-
-# Or register the gateway with your AI host
-claude mcp add milo -- uv run python -m milo.gateway --mcp
-```
-
-The gateway namespaces tools automatically: `taskman.add`, `ghub.repo.list`, etc. Implements MCP 2025-11-25 with `outputSchema`, `structuredContent`, and tool `title` fields.
-
-</details>
-
 ---
 
 ## Architecture
@@ -354,7 +412,7 @@ The gateway namespaces tools automatically: `taskman.add`, `ghub.repo.list`, etc
 1. **Model** — Immutable state (plain dicts or frozen dataclasses)
 2. **View** — Kida templates render state to terminal output
 3. **Update** — Pure `reducer(state, action) -> state` functions
-4. **Effects** — Generator-based sagas scheduled on `ThreadPoolExecutor`
+4. **Effects** — `Cmd` thunks (one-shot) or generator-based sagas (multi-step) on `ThreadPoolExecutor`
 
 </details>
 
@@ -397,22 +455,23 @@ App.run()
 
 | Section | Description |
 |---------|-------------|
-| [Get Started](https://lbliii.github.io/milo/docs/get-started/) | Installation and quickstart |
-| [Usage](https://lbliii.github.io/milo/docs/usage/) | State, sagas, flows, forms, templates |
-| [Testing](https://lbliii.github.io/milo/docs/usage/testing/) | Snapshots, recording, replay |
-| [MCP & AI](https://lbliii.github.io/milo/docs/usage/mcp/) | MCP server, gateway, and llms.txt |
-| [Reference](https://lbliii.github.io/milo/docs/reference/) | Complete API documentation |
+| [Get Started](https://lbliii.github.io/milo-cli/docs/get-started/) | Installation and quickstart |
+| [MCP & AI](https://lbliii.github.io/milo-cli/docs/usage/mcp/) | MCP server, gateway, annotations, streaming, and llms.txt |
+| [Usage](https://lbliii.github.io/milo-cli/docs/usage/) | State, sagas, flows, forms, templates |
+| [Testing](https://lbliii.github.io/milo-cli/docs/usage/testing/) | Snapshots, recording, replay |
+| [Reference](https://lbliii.github.io/milo-cli/docs/reference/) | Complete API documentation |
 
 ---
 
 ## Development
 
 ```bash
-git clone https://github.com/lbliii/milo.git
-cd milo
+git clone https://github.com/lbliii/milo-cli.git
+cd milo-cli
 # Uses Python 3.14t by default (.python-version)
 uv sync --group dev --python 3.14t
-PYTHON_GIL=0 uv run --python 3.14t pytest
+PYTHON_GIL=0 uv run --python 3.14t pytest tests/
+make ci   # optional: ruff + ty + tests with coverage
 ```
 
 ---
@@ -430,7 +489,7 @@ A structured reactive stack — every layer written in pure Python for 3.14t fre
 | **)彡** | [Kida](https://github.com/lbliii/kida) | Template engine | [Docs](https://lbliii.github.io/kida/) |
 | **ฅᨐฅ** | [Patitas](https://github.com/lbliii/patitas) | Markdown parser | [Docs](https://lbliii.github.io/patitas/) |
 | **⌾⌾⌾** | [Rosettes](https://github.com/lbliii/rosettes) | Syntax highlighter | [Docs](https://lbliii.github.io/rosettes/) |
-| **ᗣᗣ** | **Milo** | CLI framework ← You are here | [Docs](https://lbliii.github.io/milo/) |
+| **ᗣᗣ** | **Milo** (PyPI: `milo-cli`) | CLI framework ← You are here | [Docs](https://lbliii.github.io/milo-cli/) |
 
 Python-native. Free-threading ready. No npm required.