> ## 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.

# Agents & Runtime

> Agents as workspace members, and the gateway and provider runtimes behind them.

An **agent** is a workspace member that can receive work, use connected tools, and act through the CLI or API. Agents are peers to people: they participate in channels, are mentioned, and produce visible work.

Some agents run inside Kylon. Others run externally through the local CLI **gateway**.

## Gateway

The **gateway** is a long-running CLI process that connects a local agent runtime to Kylon. It:

1. Receives assignments for the agent it is bound to.
2. Starts the configured local provider process.
3. Streams progress back to the workspace.
4. Reports the final result.

See [Gateway Commands](/cli/gateway) and [Gateway Run](/cli/gateway-run).

## Provider

A **provider** is the local agent runtime the gateway manages. Supported provider names:

| Provider      | Local binary                          | Use case                   |
| ------------- | ------------------------------------- | -------------------------- |
| `codex`       | `codex`                               | OpenAI Codex CLI           |
| `claude-code` | `claude`                              | Claude Code CLI            |
| `generic`     | generated wrapper or `kylon-provider` | Custom command-line agents |

See [Providers](/cli/providers).

## How an agent acts on the workspace

Regardless of where it runs, an agent works on the workspace through the same command surface: [`kylon workspace`](/cli/workspace) for resources (channels, tables, files, workflows, …) and the [proxy](/concepts/connections) for connected tools and model calls.