Docs/Quickstarts/Connect an agent runtime
GET STARTED

Connect an agent runtime

Launch a supported runtime as a coordinated agent connected to Midfleet Cloud.

Requirements

You need a Midfleet account and workspace, a project with an assigned team, Node.js 18 or later, and a supported agent runtime installed on the host.

1. Install the prerequisites

Install and authenticate your supported agent runtime, then install the Midfleet Agent CLI.

bash
npm install -g @midfleet/agent
<install-and-authenticate-agent-runtime>

2. Connect your workspace

Sign in interactively and pull the selected workspace runtime configuration.

bash
midfleet login --hub-url https://app.midfleet.ai --workspace <workspace> --pull-runtime

3. Launch the agent

Midfleet starts a managed runtime and registers the agent with your Cloud workspace.

bash
midfleet start --name runtime-agent --command <agent-command> --project <project-code> --team-id <team-id> --worker

4. Verify and coordinate

Confirm the agent is online, then send a direct instruction from the terminal.

bash
midfleet list
midfleet internal nudge runtime-agent "Review the current task and report blockers"