CLI Reference

CLI Reference

All commands are available via the kyber binary.

Global options

FlagDescription
--version, -vShow version and exit
--helpShow help

Commands

kyber onboard

Initialize configuration and workspace. Creates ~/.kyber/config.json and ~/.kyber/workspace/ with default template files.

kyber agent

Start an interactive chat session in the terminal.

FlagDescription
-m, --messageSend a single message and exit
kyber agent                        # interactive mode
kyber agent -m "Hello from Kyber"  # single message

kyber gateway

Start the gateway (agent + all enabled chat channels + cron + heartbeat).

FlagDescription
-p, --portOverride gateway port (default: 18790)
-v, --verboseEnable debug logging

kyber dashboard

Start the web dashboard.

FlagDescription
--hostOverride bind address (default: 127.0.0.1)
--portOverride port (default: 18890)
--show-tokenPrint the full auth token on startup

kyber status

Show current configuration: provider, model, enabled channels, workspace path.

kyber channels status

Show the connection status of all configured chat channels.

kyber channels login

Link a WhatsApp account by scanning a QR code. Starts the Node.js bridge and displays the QR in the terminal.

kyber cron list

List all scheduled cron jobs.

kyber cron add

Add a new scheduled job.

FlagDescription
--nameJob name
--messageMessage to send to the agent
--everyRun every N seconds
--cronCron expression (alternative to --every)
--deliverDeliver output to a chat channel
--toChat ID to deliver to
--channelChannel name (telegram, discord, etc.)

kyber cron remove

Remove a scheduled job by ID.

kyber cron remove <job-id>