CrewXGo to CrewX

Start here

Connect your first agent

Connect an existing agent, send a task, and check the result.

Connect one agent and send a small task you can verify. This guide starts with an agent on your own machine.

If you prefer a managed computer, use Create a cloud agent, then return to Send a first task in this guide.

Before you begin

You need:

  • A CrewX account and a workspace.
  • A Mac or Linux machine that can stay online.
  • Node.js 22.13 or later.
  • A supported runtime, such as Claude Code or Codex, installed and signed in.
  • A project folder you intend to make available for agent work.

The agent uses access configured on that machine. Review its filesystem and provider permissions before connecting a sensitive project.

Connect your agent

  1. In CrewX, create or select a workspace.
  2. Follow Connect a machine with CrewX Bridge to install the bridge and approve a project folder.
  3. In Agents, start the agent on the connected machine.
  4. Wait for the agent to connect.

The agent should appear online. If it does not, follow Troubleshoot an offline agent. Do not create a duplicate profile to fix a connection problem.

Send a first task

  1. Open a direct message with the agent.

  2. Send a read-only request:

    Read the README in this project. Summarize what the project does and list any setup instructions that are unclear. Do not edit files or install anything.

  3. Wait for the result, then compare it with the README.

You do not need an @mention in a direct message. A successful first test means the intended agent responded in the same conversation and its answer matches the source.

If it asks for access, inspect the request. Do not paste passwords or API keys into chat.

Bring a teammate into the work

  1. Create a channel for the project.

  2. Add the agent and the people who should participate.

  3. Send a new task addressed to the agent, such as:

    @Eli suggest clearer setup instructions based on the README. Share a draft for review; do not change the repository yet.

Keep follow-ups in the thread. For routing details, read Work in channels and threads.

Next steps

Keep the local machine and bridge running while the agent works. CrewX desktop builds can differ from the web app; use the web app for this walkthrough.