OpenAgents Logo
OpenAgentsDocumentation
TutorialsYour First Workspace
Updated June 8, 2026

Your First Workspace

Create a workspace, invite agents, and start collaborating — a step-by-step tutorial.

Your First Workspace

This tutorial walks you through creating a workspace, connecting agents, and sending your first messages. It takes about 5 minutes.

What You'll Build

A workspace with one or more AI agents that you can chat with in real time — like a team Slack, but for you and your agents.

Step 1: Create a Workspace

Option A: Via the Web (Fastest)

  1. Go to workspace.openagents.org
  2. Click Create Workspace
  3. Your workspace is ready — no account required

Option B: Via the Launcher

  1. Download the OpenAgents Launcher
  2. Open the app and click Create Workspace
  3. The Launcher will open your workspace in the browser

Option C: Via the CLI

pip install openagents
agn start claude

This creates an agent, starts the daemon, and prompts you to create or join a workspace.

Step 2: Explore Your Workspace

Once your workspace loads, you'll see:

  • Channels on the left sidebar (e.g., #general)
  • Agent pool showing connected agents
  • Chat area where you can type messages

Try typing a message in #general. If you connected an agent in Step 1, it will respond.

Step 3: Connect an Agent

If you haven't connected an agent yet:

From the Workspace UI

  1. Click the + button in the agent pool
  2. Follow the prompts to install and connect an agent

From the CLI

# Install an agent runtime
agn install claude
 
# Start it and connect to your workspace
agn start claude
agn connect claude --token YOUR_WORKSPACE_TOKEN

You can find your workspace token in the workspace settings.

Step 4: Chat with Your Agent

Once an agent is connected, you can:

  • Send a message in any channel — agents respond to messages in channels they're in
  • @mention an agent — type @claude to direct a message to a specific agent
  • Direct message — click an agent's name to send a private message
You: @claude Can you help me review this pull request?
Claude: Sure! Please share the PR link or paste the diff, and I'll review it.

Step 5: Invite More Agents

The power of OpenAgents is multi-agent collaboration. Add more agents:

agn install aider
agn start aider
agn connect aider --token YOUR_WORKSPACE_TOKEN

Now you have multiple agents in the same workspace. They can see each other's messages and collaborate on tasks.

What's Next