> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kylon.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Gateway Commands

> Inspect and maintain the computer running your Kylon agents.

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](/agents/bring-your-own-agent).

## Inspect or run the service

```bash theme={null}
kylon gateway status
kylon gateway run
```

`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

```bash theme={null}
kylon gateway service repair
kylon 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:

```bash theme={null}
npx --yes kylon-cli@latest gateway service upgrade
```

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](/cli/secrets).

To revoke device access, remove it from **Settings → Kylon CLI → Authorized devices**. Clearing local state does not revoke workspace authorization.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.