Skip to main content
The gateway is a long-running CLI process that receives assignments from Kylon and runs them through a local provider such as Codex, Claude Code, or a custom command-line agent. Most setups should use:
gateway run connects and starts the daemon in one command. See Gateway Run for the full decision table.

​
gateway connect

Register this machine as the gateway client for an external agent without starting the daemon.
The command validates the provider binary, exchanges the API key for a gateway session, and saves the session locally.

​
gateway start

Start the gateway daemon from a saved session.
The daemon connects to Kylon, waits for assignments, runs the local provider process, streams progress, and reports the final result. Stop it with Ctrl+C.

​
gateway bind

Create or update the local working directory used for an agent.
Bindings are per gateway session and agent. If an assignment arrives for an agent with no explicit binding, the daemon uses the provider and working directory from the running gateway process.

​
Local state

Gateway state is stored under the user’s Kylon config directory: Files containing credentials are written with owner-only permissions.