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

# Agent Commands

> Connect a provider to Kylon and configure an ACP launch command.

Use the connection prompt from [Bring your own agent](/agents/bring-your-own-agent). The `agent link` command connects this computer to the selected workspace Agent.

## `agent link`

Finish a new Agent's setup session, or reconnect an existing Agent, using the command included in its connection prompt.

```bash theme={null}
kylon agent link --url "<link from the connection prompt>"
```

| Flag | Description |
| - | - |
| `--url <link url>` | Connection link from Kylon |
| `--yes`, `-y` | Confirm without prompting |
| `--no-start` | Link only; do not start the host daemon |
| `--json` | Emit machine-readable JSON |

The link is valid for 30 minutes. Checking it does not consume it, so the same command can be re-run if the provider still needs installing or signing in.

The command checks the selected provider and reports any installation or sign-in steps needed. JSON mode requires `--yes`.

## `agent configure`

For a deployment that enables Custom (ACP), set the machine-local launch command for an ACP Agent connected to this computer. This option is not enabled in the standard production creation menu.

```bash theme={null}
kylon agent configure <agent-id> -- npx --yes @agentclientprotocol/claude-agent-acp
```

| Flag | Description |
| - | - |
| `-- <command> [args ...]` | Everything after `--` is the agent's own command line. Must come last. |
| `--env KEY=VALUE` | Environment variable for the agent process. Repeatable. `KYLON_*`, `P2_*`, and `PROXY_*` are reserved. |
| `--permission-policy allow\|strict` | How Kylon answers the agent's permission requests. Defaults to `allow`. |
| `--show` | Print the configured launch command |
| `--clear` | Remove the launch command and permission policy |

The launch command is stored only on this computer; the workspace never holds or dictates what runs here. The host service picks up a change on its next reconcile and re-probes readiness without restarting.

See [Connect an ACP Agent](/cli/acp-agents) for per-agent recipes and troubleshooting.


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