> ## Documentation Index
> Fetch the complete documentation index at: https://docs.building58.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get started with Building58

> Start a Building58 room on your computer with one command, watch the built-in demo, then add your first Claude Code session to a desk in the room.

Building58 runs from its own folder on your computer, on Node with no packages to install. This page takes you from a clone of the repo to a room with a Claude Code session working at a desk.

## Before you begin

* macOS or Linux.
* Node 18 or later.
* `git`, and `python3`, which runs each session's terminal.
* Claude Code, signed in, with `claude` on your PATH. Claude Code needs a Claude subscription or an Anthropic Console account. Every person in the room is a Claude Code session on your own plan, and several run at the same time.
* The GitHub CLI, `gh`, signed in with `gh auth login`. Workers open pull requests, and the relay reads them with `gh` for reviews, CI and Autopilot. Without it the room opens, but no review starts.
* Internet access. The room page loads three.js and the terminal from CDNs.

## Start a room

**1. Get the code**

Clone Building58 into a folder of its own. The room runs from there, not from your project.

```bash theme={null}
git clone https://github.com/bfalkowski/building58
cd building58
```

**2. Watch the demo**

The demo plays three sample sessions for about two and a half minutes. It needs only Node, a browser and internet access, and it leaves your saved sessions alone.

```bash theme={null}
RELAY_KEY=pick-a-key npm run office:demo
```

**3. Start the room**

Pick a long random key, then start the room. The command starts the relay on port 8787 and opens the room in your browser. If no browser opens, open the link it prints and put your key in it.

```bash theme={null}
RELAY_KEY=pick-a-long-random-key npm run office
```

The relay also starts a Lead for the room. Press Ctrl+C to stop the room.

**4. Add a worker**

In the **Claude Code** panel, type a folder and press **Add worker**. The relay starts `claude` in that folder with the room's hooks for that session only, so you install nothing. In a git repo, the worker gets its own copy of the repo on a new branch, and your folder does not change.

## Run the room without the relay

To look around without Claude Code, serve the Building58 folder with any web server and open `office/`. The room works on its own and has a **Run a demo** button.

```bash theme={null}
python3 -m http.server
```

Then open `http://localhost:8000/office/`.

## Next steps

> [card] [Start a project](https://docs.building58.ai/guides/start-a-project.md)
>
> Give the room a repo and an idea.

> [card] [How a room works](https://docs.building58.ai/concepts/how-it-works.md)
>
> The page, the relay and the sessions.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.