Getting started

AG2 Space puts your team and AI teammates in shared rooms — they do real work, and nothing goes out without your ok. Setup takes about five minutes on any Apple Silicon Mac running macOS 15 or newer. Here's the whole thing.

What is AG2 Space and Sutando?

AG2 Space is the app. It gives your team and your AI teammates the same rooms — chat, voice, shared context, and a marketplace of capabilities your agents can equip. People and agents work in one place instead of you copying things between tools.

Sutando is the agent. It runs on your own Mac inside that app and thinks using your own Claude or Codex account. You reach it in a DM or by @mentioning it in a room; it keeps working between chats, including while you are away, and nothing goes out without your ok.

The rest of this page sets both up. It takes about five minutes.

Grab the app from desktop.ag2.space and open it. Any Apple Silicon Mac (M1 or newer) on macOS 15+ works.

Opening the download mounts a small window with two icons. Drag AG2 Space onto the Applications folder to install it, then eject the disk image. The app is now in Launchpad and Spotlight.

Open AG2 Space from Applications. The first screen is a single card — click Sign in →.

Your browser opens at the AG2 Space login page and the app waits on Complete sign-in in your browser…. Choose Google or Apple, or use the email your access is tied to.

If your browser asks to allow access to your local network, choose Allow. That is how the page hands the session back to the app on this Mac; the sign-in cannot finish without it.

The app hands you straight to your agent. It arrives already named after you, with a seeded avatar and a permanent handle — the address people and rooms use to reach it, and the one thing here you cannot change later. The name, colour and temperament you can change any time.

Pick the core it runs on — Claude Code (Anthropic) or Codex (OpenAI) — then click Next: install and sign in. The app installs that CLI and signs it in for you; the browser opens once more for the provider's own login.

The app installs that core for you, then asks it to sign in. A browser window opens at the provider's own sign-in page — authorize AG2 Space there, and it hands you back an authorization code. Paste that code into Authorization code and click Submit; if the provider signs you in directly, the card continues by itself.

Open the sign-in page again reopens that window if you closed it or it errored; Show details prints what the core is doing underneath.

Once the core is signed in, the app asks how will you use AG2 Space? — Engineering, Design, Research, Founder, Marketing, Operations, Sales, or Other. Your pick sets up your rooms and the skills your assistant starts with, and you can change it later. Skip takes the default setup.

If you have used Claude Code on this Mac, the next card offers to bring that history across — see Claude Code history for what it reads and what it asks you before anything is saved.

While your assistant starts up, five short cards explain how it works — rooms, talking to it, letting it see and act, what it can do on your Mac, and inviting your team. Next moves through them; the dots show where you are.

Card two turns on voice, so you can talk instead of typing. Your account can use a managed Gemini key — click Use managed key (recommended) and there is nothing to handle — or paste your own key and Save & activate; an explicit choice is never overridden. Not now is fine too: it all lives in Settings → Agent afterwards.

Card three is about what your assistant may do on this Mac, and it is optional. Screen recording lets it see your screen; Accessibility lets it operate other apps — both only when you ask it to. Click Allow on the rows you want; Not now skips them, and they live in System Settings → Privacy & Security whenever you change your mind. Skipping one just means fewer powers.

Card four is the plain statement of what your assistant can do on this machine: it runs code, reads and writes files in its workspace and your home folder, and uses the tools you install. Finer-grained controls for this are coming to Settings.

The last card is the one thing to remember about how AG2 Space works: rooms are shared, your assistant is yours alone. You can invite people into a room any time. While these cards run, the app is starting your assistant, creating its identity, opening the relay and joining AG2 Space — when that finishes, click Open AG2 Space to go into the app.

The app opens straight into your assistant's DM, with a short get-started panel over it: it greets you by name, confirms your assistant is ready, and carries the role you picked earlier in I'm a … so you can correct it here. Rooms worth joining offers the rooms that fit — Community Support is where the AG2 Space team and other users answer questions — or take I'll explore on my own and the panel gets out of the way.

Dismiss the panel and you are in your assistant's DM — its private space with you. It opens with a short hello, and the chips underneath are first moves you can take with one click: Find me something to hand off, Try some research, Email handling, Morning brief. Say hello and it answers there; the line under the composer tells you it is following the conversation.

Say hello and it introduces itself properly: what it is, where it runs, and four things worth asking it in the first minute. Your message shows Done · delivered with a View reply link while it works, so you are never left wondering whether it heard you.

That is setup done. Your assistant is running on this Mac, attached to your account, and reachable from any room you put it in.

If you ever want to check your assistant is actually alive — or something feels stuck — click the agent icon next to your name at the bottom of the left sidebar. The Runtime panel is the honest answer: a green online line at the top, your Claude Account as Connected (with Re-authenticate if it is not), and Engine and Remote Gateway each reading Running — the core that thinks, and the link that delivers rooms and tasks to it. Your agent's own row reads Ready. Anything not green there is the thing that is broken.

The same panel has Terminal, which attaches to your agent's core and streams what it is doing right now: the commands it runs, what it reads, what it concludes. You never need it to use AG2 Space — it is there for when you would rather look than guess.

The line at the bottom of that terminal is a prompt like any other: click it, paste, press Return.

Onboarding asks you to name your agent. When it's done, open your agent's DM and say hello — if your first message shows a pairing code, the agent echoes it back so you know you're talking to your own. Then hand it something real:

• "Research [a topic you're curious about] and come back with a short answer."
• "Summarize this link." (paste one)
• "Draft an email to [name] about [thing]."

It acknowledges straight away, goes off and does the work, then comes back with the answer in the same thread — you do not have to sit and watch it.

That's it — you're set up. Rooms with your team come next: see Using rooms.

Use it from your phone

Your assistant runs on your Mac, but you do not have to be at your Mac to reach it. AG2 Space for iPhone signs in to the same account and opens the same rooms and DMs, so you can hand it work from anywhere and read the answer when it is done.

Install it, then pair it with this Mac — you sign in on the phone by scanning, never by typing a password.

1. On your Mac, click your name and open Settings → Mobile pairing (called Mobile in versions before 0.6.12).
2. Click Pair under Pair Mobile Device.
3. On your phone, open AG2 Space and choose Pair with computer — that is the route that signs you in this way.
4. Tap Scan QR code and point the phone at your Mac, or paste the pairing code in instead.
5. Both screens then show a matching security code. Check they are the same, confirm, and the phone is paired.

The code expires in under two minutes and is single use. Treat it like a password: it signs your phone in. If it lapses before you scan, click New code. Copy pairing code is there for when you would rather type it than scan.

From then on your phone is another way into the same rooms: the work still happens on your Mac.

Bring your Claude Code history along

Your past Claude Code conversations, read once so your Sutando starts out knowing your projects, decisions and open threads — nothing saved until you approve the digest.

If you have been using Claude Code on this Mac, the next card offers to bring that history across, so your Sutando starts out knowing your projects, the decisions you already made, what is still open and who you work with. It only appears when there is something to import: the app counts the conversations under ~/.claude/projects and skips the card entirely when it finds none. Not now moves straight on and nothing is read. The card is part of AG2 Space 0.6.8 and newer.

It reads conversation text only: your messages and your assistant's replies. Tool output, attachments and the files themselves are never read, nothing in ~/.claude is changed, and API keys and tokens are stripped out before anything is written down. The conversations are processed by Anthropic's Claude API — the provider your Sutando already runs on, which does not train on them. Nothing is uploaded to AG2 Space except the people you approve at the end.

Import starts it in your assistant's DM. It says hello, tells you exactly what it took on — how many conversations, how many it skipped as empty, and the same privacy note from the card — then works in the background, roughly 10 to 20 minutes for 40-odd conversations.

What comes back is a digest to review, not a decision already taken: a paragraph per project with its open threads and decisions, the people it found split into ones already in your People store and ones that are new, and a list of anything it held back. Nothing is saved until you answer it.

• bring it in — land all of it
• bring in <project> — just that one; forget <project> drops one
• include personal, or include <date> — add something it held back; hold <date> takes it back out
• say nothing and nothing lands

Conversations that look personal — health, money, family, immigration and the like — are held back on their own. The digest lists them by date with a generic reason and never quotes them; they come in only if you ask for them.

What lands is a short summary in your assistant's memory, the full per-project notes in its workspace, and the people you approved in your People store. People you already have are never overwritten: the import appends what it learned and merges identifiers like emails and handles.

None of this has to happen during setup. Ask your Sutando to "import my Claude history" in any room at any time, or find it later under Settings → General → Claude Code history, which shows the same counts, an Import button and live progress.

Updating AG2 Space

Updates install in place — you never re-download the app.

Click the AG2 Space icon in your Mac's menu bar (top right of the screen, not the app window) and choose Check for Updates…. The version you are on is shown at the top of the same menu.

The Marketplace

Skills and cloud superpowers your agents can equip — from GTM lead sourcing to research briefs. Filter by category and install with one click; every cloud tool shows its price up front, either per result or per run. It lives in the desktop app.

In the app, click your name at the bottom of the left-hand sidebar to open Settings, then choose Marketplace. That is the catalog of skills and cloud tools your agents can equip.

Then click Connect AG2 Cloud at the top right of that page.

Until you do, search is plain keyword matching and your library and credits are not available. After you connect, the catalog ranks results for what you actually do, and anything you install shows up in Your library.

Once you are signed in it shows Connected with your credit balance beside it. The search box now ranks the catalog for whatever you ask for, and everything your agents have equipped is listed under Your library.

If you were already signed in to AG2 Space, the app connects on its own and you will land here without pressing anything.

How skills stay up to date on your machine

Cloud tools update themselves. Local skills are files on your Mac, and the app refreshes them for you the next time you open the Marketplace.

The two kinds of capability update differently, because they live in different places:

• Cloud tools (Activate) run on our servers. When a tool gets a new version you have nothing to do: the next call already uses it. The only thing that can lag is the tool's description your agent reads. Sign out of AG2 Space and back in and it refreshes.
• Local skills (Install) are downloaded onto your Mac, into your agent's skills folder. When you install one, the app fetches the package, checks its signature, and unpacks it; your agent notices the new folder within a second and equips it without a restart.

Here is exactly how a local skill gets updated afterwards:

1. The author publishes a new version to the Marketplace and it passes review.
2. Open the Marketplace in the app. That is the sync moment. The app compares the version of every skill in Your library against the version on your disk.
3. Anything that is missing or on an older version is downloaded again, verified and swapped in atomically. Your agent picks up the new files on its own.

So an update never arrives while you are mid-task or in the background; it happens when you visit the Marketplace, and it only touches skills you have already installed. A brand-new skill still needs one click on Install.

Your plan & spending

The app does the work; the dashboard is where you manage the plan behind it and watch what your AI teammates are spending.

Click your credit balance in the Marketplace header and the dashboard opens in your browser.

Scroll to Wallet activity to see exactly where credits went: every cloud-tool run shows when it ran, which tool, what it cost and your balance after it. A tool priced per result shows the credits it held when it started and a refund for anything it did not deliver, so you only ever pay for results. A run that fails shows as a refund, never a charge.

Learn more

Stuck? There's always a path

Join the support room, ask in the community Discord, or email support@ag2.space — a human reads everything. Full details: Get support.