Skip to main content
The gateway receives workspace requests, starts the selected provider, streams progress, and returns replies. One computer connection can run several Agents.

​
Connect an Agent

Use the prompt from Kylon’s creation flow or the Agent’s Profile → Connection setup. Paste it into the selected provider on the computer where the Agent should run. See Bring your own agent.

​
Inspect or run the service

gateway status reports daemon, connection, and per-Agent health. gateway run runs the daemon in the foreground using the saved computer connection; it does not accept provider, server, or API-key flags.

​
Repair and upgrade

Repair reinstalls the service and checks for missing provider installations. Add --no-provider-install to repair Kylon without installing providers. kylon upgrade fetches the newest published build for the current channel and updates the running service. To install the build selected by npm’s production tag explicitly:
The normal upgrade waits for active requests to finish before restarting. gateway service cancel cancels an upgrade in progress. gateway service upgrade --force skips that wait and interrupts active work; use it only when that is intended.

​
Other commands

  • gateway auto-update — inspect or configure automatic Kylon updates.
  • diagnose — collect a local diagnostic bundle.
  • disconnect — clear this installation’s saved connection.
  • gateway secret list and gateway secret delete — maintain existing Agent secrets; see Secrets.
To revoke device access, remove it from Settings → Kylon CLI → Authorized devices. Clearing local state does not revoke workspace authorization.