Agent Commands - Kylon

Use the connection prompt from 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.

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.

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 for per-agent recipes and troubleshooting.