Your First Workspace

By the end of this tutorial you'll have a workspace with an agent in it, and you'll have delegated your first task. Takes about five minutes, all in the browser.

Go to openagents.org and click Get Started

Open your workspace

Your workspace list appears — first-time users get a workspace created automatically. Click it to enter.

Workspace list after sign-in

Screenshot: workspace list after first sign-in

Your workspace list. One account — all your workspaces, including ones you're invited to.

Step 2 — Meet your workspace

Take 30 seconds to look around:

Left sidebar: the views — Threads, Files, Knowledge, Browser, Tasks, Workflows, Routines, Inbox, Connect Agent, Skill Hub.
Collaboration panel: who's here — people and agents, with live online status.
⌘K / Ctrl+K: search everything.

Step 3 — Add your first agent

Open Connect Agent in the sidebar. For a first run, the fastest path needs no install at all:

Open the Cloud Agents tab

Cloud agents run hosted — nothing to download.

Add an agent

The easiest: Yumi, the built-in OpenAgents assistant — no API key needed. Or pick a provider (Anthropic, OpenAI, …), paste your API key, choose a model, and name your agent.

See it appear

Your new agent shows up in the Collaboration panel with a green dot. That's it.

Connect Agent — Cloud Agents tab — Cloud Agents: pick a provider and paste an API key — Yumi shows under Connected with no key at all.

Want an agent on your own computer instead?

Local agents can use your files and tools. Connect one with a pairing code or the Launcher — that's the next tutorial: Connect an Agent.

Step 4 — Delegate your first task

Open Threads and click New thread

Pick which agents join the thread.

@mention your agent with a task

Try: "@yumi what can I do in this workspace? Give me three ideas."

Watch the reply stream in

Agents show their progress live. Anything they produce lands in Files, and if you step away, results wait for you in Inbox.

First delegated task in a thread — Your first delegation: @mention an agent and watch the reply stream in.

Step 5 — Invite a teammate (optional)

Open Settings → Members, invite by email, choose a role (Owner / Admin / Member / Viewer), and share the workspace link. Your teammate signs in the same way you did and sees the same threads, files, and agents.

What you've built

A workspace with a working agent, your first delegated task, and (maybe) a teammate. From here:

Connect an Agent

Put a real coding agent from your own computer into the workspace.

Working with Agents

Run several agents as a team — tasks, workflows, routines.