ycli

ycli is the full-screen ncurses sibling of ycommand: the same control plane (connect to a yuno, send commands, read responses), but in a windowed terminal UI built for live debugging and browsing rather than scripting. Use ycli when you want to keep several views open and watch a system interactively; use ycommand when you want a single command or a scriptable pipe.

(The source directory was yunos/c/yuno_cli before 7.4.x; the binary has always been ycli.)

Usage¶

ycli [--url ws://host:port]

Navigate with the arrow keys; press ? inside the UI for help. The connection and authentication options match ycommand (default ws://127.0.0.1:1991; OAuth2 / OIDC flags for the remote / TLS path — see Authentication).

What it adds over ycommand¶

• Multi-session / multi-window — open several connections and views at once; the active window decides where a command is sent.

• Shared line editor — ycli and ycommand both use the C_EDITLINE gclass, so line editing, history, Ctrl+R / Ctrl+S incremental search (ESC / Ctrl+G to cancel) and TAB completion behave identically in both.

• Popup completion — the multi-candidate TAB list is drawn as an ncurses popup above the editline: Tab / Up / Down navigate, Enter commits the candidate to the line without submitting, ESC / Ctrl+G cancel.

• Per-connection command cache — the remote command set is warmed on connect via list-gobj-commands, so completions follow whichever window has focus.

• Local vs remote routing — commands prefixed with ! run locally (in ycli itself); everything else goes to the focused remote yuno.

Key bindings¶

In addition to the shared editline shortcuts:

Window gclasses¶

ycli is itself a yuno; its TUI is composed from a small set of window gclasses driven by C_CLI:

See also¶

• ycommand — the line-oriented control plane (single command, interactive shell, or stdin pipe).

• Repository README (for code navigators): utils/c/ycli/README.md.