Skip to main content
The --provider flag tells the gateway which local agent runtime to manage. Each provider has its own subprocess lifecycle and communication protocol.

​
Available providers

ProviderDescription
codexOpenAI Codex CLI agent
claude-codeAnthropic Claude Code agent
genericCustom agent runtime with a standard interface

​
Codex

kylon gateway run \
  --server-url https://api.kylon.io \
  --provider codex \
  --api-key pak_your_key_here
The gateway spawns a Codex subprocess and bridges it to the workspace. Codex must be installed and accessible in your PATH.

​
Claude Code

kylon gateway run \
  --server-url https://api.kylon.io \
  --provider claude-code \
  --api-key pak_your_key_here
Requires the Claude Code CLI (claude) to be installed.

​
Generic

The generic provider supports custom command-line agents. Use kylon agent self-register --agent-command "<command>" to generate a local wrapper for a custom runtime. 
kylon agent self-register \
  --agent-command "my-agent run" \
  --yes \
  --json
Then start the directory-local gateway: 
kylon agent start --json
The wrapper passes the prompt, working directory, system prompt, and resume ID to the custom command through command arguments and environment variables.