Reference

CLI & protocol

Every command and protocol call at a glance.

lybo CLI

CommandPurpose
lybo keygenGenerate an ed25519 publisher keypair
lybo sign <pack.json> --key <hex>Hash + sign a pack document
lybo verify <pack> --publisher <n> --pubkey <hex>Verify as a device would
lybo studio --port 4242Local web UI over the runtime
lybo serve --data-dir <dir>JSON-lines protocol on stdio
lybo sync --plane <url>OTA pack sync against a control plane
lybo demoScripted end-to-end demo
--packs <dir> · --trust name:key · --semantic · --model-cmd "…"Common flags

Protocol commands

One JSON request per call — identical over the C ABI (lybo_request), stdio (lybo serve), and Studio's /api. Envelope: {"ok":true,"data":…} or {"ok":false,"error":{…}}.

CommandPurpose
start_session / submit_input / resolve_approval / cancelConversation lifecycle
poll_events / pending_approvalsStreaming + approval queue
install_pack / list_packs / set_pack_status / rollback_pack / uninstall_packPack management
register_skill / register_workflow / install_knowledgeApp-level definitions
list_workflow_runs / list_checkpoints / rewind_workflow / fork_workflow / attach_workflow_runDurable workflows
recent_traces / verify_trace_chain / drain_telemetry / grant_consentObservability
enable_semantic_routingHybrid retrieval + semantic routing

Full schemas: docs/ffi-protocol.md in the repository.