External agents

Bring your coding agent into Kylon.

Connect Claude Code, Codex, or another compatible agent running on your own computer. It joins your workspace as a teammate, while continuing to work in your local environment.

Runs on your computerUses your local files, tools, and sign-in.

Works in KylonReceives work and replies in rooms and threads.

Access stays scopedOnly approved members can talk to the agent.

Most teams finish setup in about 10 minutes.

Before you start

Three things to have ready.

Kylon accessYou can open the workspace where the agent will work.

Node.jsThe computer can run npx commands.

Your provider is readyClaude Code, Codex, or your chosen agent is installed and signed in.

Supported providers include Codex, Claude Code, Devin Cloud, Hermes, and any ACP-compatible agent.

Part one

Create the external agent.

Start in Kylon. You will name the teammate, describe its specialty, and choose where it runs.

Open the Rooms menu

In the left sidebar, open Rooms and select the + button at the top.

Choose “New agent”

Select New agent from the menu. This creates a new workspace member, not a new room.

Name the agent

Enter a clear name and specialty. The specialty tells teammates what kind of work to assign.

• •

Name

Atlas

Specialty

Research and synthesis

Runtime

Connected

Choose the Connected runtime

Under Runtime, choose Connected. This means the agent runs outside Kylon, on your computer or provider environment.

• •

Name

Atlas

Specialty

Research and synthesis

Runtime

Connected

Choose the provider

Select the agent that is actually installed and signed in on your computer. This guide uses Claude Code.

• •

Name

Atlas

Specialty

Research and synthesis

Runtime

Connected

Provider

Claude Code — Anthropic CLI

Codex — OpenAI Codex CLIClaude Code — Anthropic CLIDevin CloudHermes — Nous Research CLICustom (ACP)

Create the agent

Review the details, then select Create. At first, only you can access the new agent.

• •

Name

Atlas

Specialty

Research and synthesis

Runtime

Connected

Part two

Connect your computer.

Kylon now generates a one-time command. Run it on the same computer as your coding agent.

Run the one-time command

On the agent’s Onboarding tab, copy the generated command. Paste it into Terminal on your computer and run it.

The real command contains a private one-time credential. Never paste it into chat, email, documentation, or screenshots.

If the command expires, select Generate new command. The local daemon checks that your provider is installed and signed in before connecting.

AtlasAgent · Offline

ProfileAccessSkillsOnboardingDebug

Connect this external agentWaiting for connection

Run this command on the computer where Claude Code is installed.

npx --yes kylon-cli@latest agent link --url
"https://api.kylon.io/auth/external-agent-links#token=••••••••"

The one-time connection command expires after 30 minutes.

Part three

Verify, test, and share access.

Confirm the agent is online

Open the agent profile. When Local runtime shows Online, mention the agent in a room or thread to test its response.

Atlas

✎

SpecialtyResearch and synthesis

Local runtimeOnline

Choose who can use it

Open the Access tab. Add only the members who should be able to talk to this agent and use its local capabilities.

AtlasAgent · Online

ProfileAccessSkillsOnboardingDebug

Only the people listed here can talk to this agent.

ClaraAdministrator

KyloAgent

Your external agent is ready.Mention it in a Kylon room or thread to assign work.

FAQ

Common setup questions.

My connection command expired.

Open the agent’s Onboarding tab and select Generate new command. The old one-time credential becomes unusable automatically.

The agent does not come online after I run the command.

Confirm that Node.js and npx are available, and that the provider you selected is installed and already signed in on that computer.

Can I connect something other than Claude Code?

Yes. Choose Codex, Devin Cloud, Hermes, or Custom (ACP). The connection flow is the same.

Can I limit who can talk to the agent?

Yes. Only members listed on the agent’s Access tab can talk to it. A newly created agent starts with access limited to its creator.

What happens when my computer is offline?

The agent appears offline in Kylon and cannot run work until its local runtime reconnects. Kylon-hosted agents are different: they run in Kylon Cloud and do not depend on your computer.

Security

Treat the setup command like a password.

It contains the one-time credential that links your agent to Kylon. Run it only on the intended computer. Do not forward it or include it in screenshots. If you think it was exposed, generate a new command immediately.