Skip to article frontmatterSkip to article content
Site not loading correctly?

This may be due to an incorrect BASE_URL configuration. See the MyST Documentation for reference.

Utilities

Command-line tools shipped with Yuneta. All binaries are installed into $YUNETAS_OUTPUTS/bin/ by yunetas build.

Source: utils/c/

Control Plane

BinaryDescription
ycommandControl-plane CLI — sends commands and stats requests to a running yuno over a local socket or WebSocket. Single-command, interactive and batch modes. Interactive mode has TAB completion, inline parameter hints, Ctrl+R/Ctrl+S history search, !help / !history / !source local commands, bash-style !! / !N history expansion, did-you-mean suggestions on errors and schema-driven table output. Non-interactive accepts commands either via -c, as positional args or piped on stdin, with ; chaining and -cmd ignore-fail (the ybatch convention). See utils/c/ycommand/README.md for the full syntax and shortcut reference.
ybatchBatch command runner — executes a JSON-formatted script of commands against a yuno. Useful for automation, provisioning, and smoke tests. Complementary to ycommand’s line-oriented scripting.
ystatsReal-time statistics subscriber — displays live stats from a yuno with configurable refresh interval and filtering.
ytestsTest-suite runner against a live service — supports repeat/interval options for soak testing.
ylistList running yunos on the local machine with process information. Use --pids for scripting.
yshutdownShut down all Yuneta processes on the local machine. Supports selective modes (--agent-only, --keep-agent).

Data Inspection

BinaryDescription
tr2listList records from a timeranger2 topic. Supports time-range filtering, field selection, metadata display, and local timestamps.
tr2keysList all keys (primary ids) stored in a timeranger2 topic.
tr2searchSearch records inside a timeranger2 topic by content filters and key, with optional base64 decoding.
tr2migrateMigrate data from legacy timeranger (v1) to timeranger2.
treedb_listList nodes of a TreeDB graph database — walks topics and their hook/fkey relationships.
msg2db_listList messages from a msg2db database (dict-style message store on timeranger2).
list_queue_msgs2List messages from a msg2db persistent queue.
stats_listList persisted statistics with filtering by group, variable, metric, units, and time range.
json_diffSemantic diff of two JSON files — supports unordered array comparison and metadata/private-key filtering.

Code Generation

BinaryDescription
yuno-skeletonCreate a new yuno from a pre-defined template. Use --list to see available skeletons.
ymake-skeletonGenerate a yuno skeleton from an existing project, renaming identifiers to match a new role.
yclone-gclassClone a GClass template under a new name — rewrites file names and identifiers automatically.
yclone-projectClone a whole Yuneta project (yuno, util, …) under a new name.
yscapecEscape a file’s contents into a C string literal. Handy for embedding JSON, SQL, or HTML in .c source.

Diagnostics

BinaryDescription
fs_watcherTest harness for the fs_watcher library — prints every filesystem event on a path.
inotifyRaw Linux inotify diagnostic tool — decodes and prints inotify event flags.
ytestconfigValidate a JSON configuration file — exits non-zero on parse failure.
time2dateBidirectional converter between Unix timestamps and ASCII date/time strings.
time2rangeConvert a Unix timestamp into a human-friendly time range (seconds → years).
static_binary_testSmoke test for fully-static builds (CONFIG_FULLY_STATIC).

Security

BinaryDescription
keycloak_pkey_to_jwksConvert an RSA private key (base64 DER) to a JWKS document for OAuth 2 / JWT providers.
Built-in GClasses
Built-in Yunos
Built-in GClasses
Test Suite