# Set up your team
Source: https://isoplan.mintlify.app/admins/set-up-your-team

For admins: add your projects and invite your team.

**1. Add your projects**

In **Settings**, open **Repos**. Type each project's address, such as `github.com/team/app`, press **Add repo**, then **Save**.

Only these projects appear on the floor.

**2. Invite people**

Open **People**. Type their email and press **Add**, then **Invite**. Copy the link and send it to them.

**3. Send them the guide**

Share the [Quickstart](/quickstart) with the link.

> [!NOTE]
>
> Invite links work once, for about a week, and only for that email. Press **New link** to make another.

> [accordion] The one-click connect doesn't work on someone's computer
>
> The by-hand setup is under "Install the plugin" in the [plugin's README](https://github.com/adamlinscott/isoplan-plugin#install-the-plugin). On Linux, the connect window needs `zenity` installed.


# AI onboarding
Source: https://isoplan.mintlify.app/ai-onboarding

Everything your AI agent needs to set up Isoplan for you.

Your agent can install the Isoplan plugin. Two steps stay with you: joining your office and pressing **Connect**.

## What only you can do

> [!NOTE]
>
> Joining needs your invite link, and connecting needs your click. Nobody, person or agent, can connect a computer without you.

1. Join your office from your invite link.
2. After the agent finishes, press **Connect Claude Code** on the floor, then **Connect** in the window on your computer.

## Prompt for your agent

The floor's **Install the Isoplan plugin** button opens Claude Code with a message like this one. To do it by hand, copy this into Claude Code:

```text Prompt theme={null}
Install the Isoplan plugin for Claude Code by running:
claude plugin marketplace add adamlinscott/isoplan-plugin
claude plugin install isoplan@isoplan
Then tell me to type /reload-plugins and press Connect Claude Code on my Isoplan floor.
Do not edit any files in ~/.claude/isoplan/.
Guide: https://docs.isoplan.app/quickstart.md
```

## For agents

| Step | Who | How |
| - | - | - |
| Install the plugin | Agent | `claude plugin marketplace add adamlinscott/isoplan-plugin`, then `claude plugin install isoplan@isoplan` |
| Load the plugin | Person | Type `/reload-plugins`, or open a new Claude Code window |
| Join the office | Person | Invite link from their admin |
| Connect | Person | **Settings → Connect Claude Code** on the floor, then **Connect** on the computer |

* Requires Node.js on `PATH`.
* Never edit `~/.claude/isoplan/config.json` or `pairing.json` to connect. The Connect button does it after the person confirms.
* Updates are automatic. If the status line says **Isoplan updated**, run `/reload-plugins`.

## Docs for agents

* Every page is available as Markdown: add `.md` to its address.
* [llms.txt](https://docs.isoplan.app/llms.txt) lists every page.
* [llms-full.txt](https://docs.isoplan.app/llms-full.txt) holds all docs in one file.
* The plugin is open source (MIT): [github.com/adamlinscott/isoplan-plugin](https://github.com/adamlinscott/isoplan-plugin).


# Connect Claude Code
Source: https://isoplan.mintlify.app/guides/connect-claude-code

Show your Claude Code work on your office's floor. Two buttons, once per computer.

Both buttons are on the floor under **Settings → Connect Claude Code**. New members see them right after picking a job title.

## 1. Install the plugin

**1. Press Install the Isoplan plugin**

Allow your browser to open Claude Code. It opens with a message ready.

**2. Press Enter**

Read the message, then press Enter. Claude installs the plugin, and Node.js if your computer needs it.

**3. Say yes when Claude asks**

Claude Code asks before it changes anything on your computer.

**4. Type /reload-plugins**

Claude tells you when it's done. If it says to open Claude Code again instead, do that.

> [accordion] Nothing happened when I pressed Install
>
> Claude Code only opens from a link after you've used it once. Open Claude Code, send it any message (just "hi" is fine), then press the button again.
>
> Or, under **Nothing happened?**, press **Copy** and paste the message into Claude Code yourself.

## 2. Connect

**1. Press Connect Claude Code**

Allow your browser to open Isoplan. Some browsers call it "Node.js". That is the plugin's helper.

**2. Click Connect on your computer**

A small window names your office's address and the person your work will show as. Check both, then click **Connect**.

**3. Done**

The floor shows **✓ Connected** with your computer's name. Your work appears from your next message in Claude Code.

> [!WARNING]
>
> Only click Connect for a window you opened just now from your own floor. A link someone else sent you would show your work as theirs.

> [!NOTE]
>
> **Cancel** is selected at first, so pressing Enter cancels. Click **Connect**.

Only projects your admin has added to the office appear on the floor.

> [accordion] Prefer to install it by typing?
>
> In Claude Code, type each line and press Enter, then type `/reload-plugins`:
>
> ```bash Claude Code theme={null}
> /plugin marketplace add adamlinscott/isoplan-plugin
> /plugin install isoplan@isoplan
> ```


# Join your office
Source: https://isoplan.mintlify.app/guides/join-your-office

Sign in to your team's Isoplan office from your invite link.

**1. Open your invite link**

Your admin sends it. It works once, for about a week, and only for your email.

**2. Press Join**

Check the name shown for you, then press **Join**. If offered, you can use **Join with Google** or GitHub with the same email.

**3. Pick your job title**

Choose the closest one, or **Other** to type your own. Press **Go to the floor**.

Next time, open your office's address and you are still signed in.

> [!NOTE]
>
> Signed out? Sign in with Google or GitHub if your office offers it, or ask your admin for a new link.

> [card] [Next: Connect Claude Code](/guides/connect-claude-code)
>
> Show your agents' work on the floor.


# Updates
Source: https://isoplan.mintlify.app/guides/updates

The Isoplan plugin keeps itself up to date.

You don't need to do anything. The plugin checks for updates by itself.

When Claude Code's status line says **Isoplan updated: type /reload-plugins**, either:

* type `/reload-plugins` and press Enter, or
* open a new Claude Code window.


# Your computers
Source: https://isoplan.mintlify.app/guides/your-computers

See which of your computers are connected, and remove one.

Open **Settings → Machines** on the floor.

| You see | It means |
| - | - |
| **Reporting now** | Claude Code is open and your work is showing. |
| **Last seen** … | It isn't reporting right now. It stays connected for a while. |

## Remove a computer

Press **Revoke** next to it. To connect it again, follow [Connect Claude Code](/guides/connect-claude-code).

## New computer

Follow [Connect Claude Code](/guides/connect-claude-code) on it, then revoke the old one.


# Introduction
Source: https://isoplan.mintlify.app/introduction

Isoplan shows every AI agent your team runs, live, as an office floor.

Each Claude Code session is a room on the floor. See who is working on what, answer an agent's question, and hand work to a colleague in a click.

## Get started

> [card] [Quickstart](/quickstart)
>
> Join your office and connect Claude Code in five minutes.

> [card] [AI onboarding](/ai-onboarding)
>
> Let your AI agent set Isoplan up for you.

## Explore

> [card] [Join your office](/guides/join-your-office)
>
> Sign in from your invite link.

> [card] [Connect Claude Code](/guides/connect-claude-code)
>
> Show your agents' work on the floor.

> [card] [Your computers](/guides/your-computers)
>
> See and remove connected computers.

> [card] [Set up your team](/admins/set-up-your-team)
>
> For admins: invite people and add projects.


# Quickstart
Source: https://isoplan.mintlify.app/quickstart

Join your office and connect Claude Code in five minutes.

## Before you start

You need:

* An **invite link** from your office's admin.
* **Claude Code** on your computer.

Both buttons are under **Settings → Connect Claude Code**, and on the page after your job title when you first join.

## Set up

**1. Join your office**

Open your invite link, press **Join**, pick your job title, then press **Go to the floor**.

**2. Install the Isoplan plugin**

On the floor, press **Install the Isoplan plugin**. Claude Code opens with a message ready. Press Enter, and say yes when Claude asks to go ahead.

When it's done, type `/reload-plugins` as Claude tells you.

**3. Connect Claude Code**

Back on the floor, press **Connect Claude Code**. Allow your browser to open Isoplan, then click **Connect** in the window on your computer.

**4. See your work**

The floor shows **✓ Connected**. Send a message in Claude Code and your room appears.

> [!TIP]
>
> You do this once per computer. The plugin keeps itself up to date.

## Next steps

> [card] [Connect Claude Code](/guides/connect-claude-code)
>
> Each step in detail.

> [card] [Troubleshooting](/troubleshooting)
>
> If something doesn't look right.


# Troubleshooting
Source: https://isoplan.mintlify.app/troubleshooting

Fixes for common problems joining Isoplan and connecting Claude Code.

> [accordion] Nothing happens when I press Install the Isoplan plugin
>
> Open Claude Code, send it any message (just "hi" is fine), then press the button again. Or press **Copy** under **Nothing happened?** and paste the message into Claude Code. Don't have Claude Code? [Get it here](https://claude.com/product/claude-code).

> [accordion] Nothing happens when I press Connect Claude Code
>
> The plugin isn't installed yet. Do [step 1](/guides/connect-claude-code#1-install-the-plugin), open a new Claude Code window, then press the button again.

> [accordion] The floor says "That didn't finish in time"
>
> The window on your computer wasn't answered in time. Press **Connect Claude Code** again.

> [accordion] I pressed Cancel by mistake
>
> Press **Connect Claude Code** again.

> [accordion] My invite link doesn't work
>
> It has been used or has expired. Ask your admin for a new one.

> [accordion] My work isn't showing on the floor
>
> Check **Settings → Machines** says **Reporting now**. If it does, ask your admin to add the project under **Repos**.

> [accordion] Do I need to edit any settings files?
>
> No. **Connect Claude Code** sets everything up after you confirm on your computer.

Still stuck? Ask your office's admin.