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 Mac running macOS 12 or newer, Apple Silicon or Intel. Here's the whole thing.

Meet AG2 Space

New here? Take the quick tour

A quick tour shows, with screenshots, where to connect your apps, create a room, bring your Sutando in, open Commons next to the chat, and find the rest of the settings.

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. It is one universal download for Apple Silicon and Intel Macs on macOS 12 or later, and it updates itself in the app from then on.

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.

Once you are signed in, the browser asks you to confirm two things. First, AG2 Space Synapse wants to access AG2 Space on your behalf: this lets the chat side of AG2 Space use the account you just signed in with. Click Allow.

Then Continue to your account shows the account the app is about to use. Click Continue and the browser hands the session back to the app.

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 Meet your Sutando: your personal AI, which runs on your Mac and keeps working between chats. It arrives already named after you, with a name you can change any time and a permanent handle: the address people and rooms use to reach it, and the one thing here you cannot change later. If the handle you want is taken, the card says so and suggests free ones. Pick a colour too if you like.

Under Runs on, pick the core it thinks with: Claude Code (Anthropic) or Codex (OpenAI). Each row says whether it is already installed and signed in. Then click Next.

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 (for Claude Code, Log in — Continue with your Claude.ai account). Authorize AG2 Space there, and it hands you back an authorization code.

Back in the app, the card is titled Set up Claude 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? Pick everything that fits: Engineering, Design, Research, Founder, Marketing, Operations, Sales, or Other. Your picks set up your rooms and the skills your assistant starts with, and the line under the grid shows which rooms they lead to. 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, Talk to it, turns on voice, so you can talk instead of typing. On a plan that includes it, the Sutando-managed Gemini key is saved for you and there is nothing to handle; otherwise you can bring your own key. Below it, Microphone access asks macOS for the mic; click Allow. 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; the Chrome extension lets it browse in your Chrome (it needs Google Chrome on this Mac, and offers Get Chrome if it is missing). All of them 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.

Next, Rooms to join offers the rooms that fit the roles you picked, grouped by role. Community Support is where the AG2 Space team and other users answer questions. Pick the ones you want and click Join selected, or Skip; you can join more later.

Then Connect your apps lists the apps people use most: Gmail, Google Calendar, Google Drive, Slack, Notion and GitHub. Connect opens each app's sign-in in your browser, and a connected app shows Connected ✓. Continue when you are done, or Skip: 1,500+ more apps are in the Marketplace, and you can connect any of them later in Settings → Apps → Integrations.

Then the app opens into 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, in a thread under your message: what it is, where it runs, and four things worth asking it in the first minute. Click 1 reply under your message to open the thread.

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 (Your agent) in your user card at the bottom left. It opens Settings → Agent → Runtime, and that page 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. Below them, Usage shows how much of your Claude session and weekly limits is used. Anything not green there is the thing that is broken.

The same settings have 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.

Your agent is set up. Open its DM any time (it is under Your Stands in the sidebar) and 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 → User → Mobile pairing (called Mobile in versions before 0.6.12).
2. Click Pair under Pair Mobile Device. If it says Verify this computer first, your account has device verification on: click Verify Manually (or verify from another signed-in device), then Check again.
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 → User → 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.

Click the plug icon in your user card at the bottom left: it opens Apps, and Marketplace sits right under Integrations. Clicking your name and choosing Apps → Marketplace gets you to the same place. That is the catalog of skills, cloud tools and connectors your agents can equip.

If you are signed in to AG2 Space, the Marketplace connects to AG2 Cloud on its own and shows Connected with your credit balance at the top right. If it shows Connect AG2 Cloud there instead, click it.

Until it is connected, search is plain keyword matching and your library and credits are not available. Once it is, the search box ranks the catalog for whatever you ask for, and everything your agents have equipped is listed under Your library.

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.

In the app, Settings → User → Plan & usage shows your plan, your usage credits and this period's usage, with Open web dashboard for the rest. You can also click your credit balance in the Marketplace header, and the dashboard opens in your browser.

Overview shows your plan (with Manage plan), your usage credits with Buy more usage and auto-reload, and this period's voice, phone, image and video usage against your allowance.

Usage shows the last 30 days: spend, events, your allowances, and daily activity.

On the web dashboard (Open web dashboard at the top of Overview), Wallet activity shows exactly where credits went: every cloud-tool run, 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.