bimai
Get started

Install bimai

Copy one prompt into Claude Code and it installs bimai and sets up your team.

Start here

Available

Available now. This works today: installing bimai and setting up your team with bimai init.

Open your project folder in VS Code, start Claude Code, and paste this prompt. Claude installs bimai, asks you a few questions, shows you the team it proposes, and only writes files after you say yes.

What you need: VS Code with Claude Code. That's all: bimai's installer brings everything else, without administrator rights.

Then paste it into Claude Code, in your project folder.

Show the prompt
Set up bimai (https://bimai.nl) in this project folder for me. Follow these steps in order.

1. Install bimai with its one-line installer (it needs no Python, git or administrator rights):
   - on Windows: powershell -ExecutionPolicy ByPass -c "irm https://bimai.nl/install.ps1 | iex"
   - on macOS or Linux: curl -LsSf https://bimai.nl/install.sh | sh
   If the bimai command isn't found afterwards, use the full path the installer printed (in the
   .local/bin folder in my user folder). Check it worked with: bimai --version

2. Get the interview: bimai init --interview
   It prints the questions as JSON, made for your AskUserQuestion tool. It also shows what bimai found
   in this folder through the suggested options.
   If it says this folder is already a bimai project, a colleague started it: follow the steps of the
   join prompt (https://bimai.nl/docs/start/join) instead, with bimai join in place of bimai init.

3. Ask me step 1 with the AskUserQuestion tool, in one call. Use each question's header, question text
   and options exactly as given, in the given order, and put "(Recommended)" after the recommended
   option. Use multiSelect where multi_select is true. Leave "Other" to me for my own answer.
   - If I answer with Other on a choice, map my words to the closest value in that question's
     "allowed" list. If you're not sure, ask me to confirm the mapping in plain language.
   - For text questions (kind "text"), my own words are the answer.

4. Get step 2 for my role: bimai init --interview --role "<my role>"
   Ask it the same way, in one call.

5. Show me what bimai would set up, without writing anything:
   bimai init --dry-run --json --yes --name "<project>" --person "<my name>" --role "<role>" --goals <goals, comma-separated> --tools <tools, comma-separated> --language <en|nl>
   Add --new-to-vscode if I said I'm new to VS Code. Explain the proposed team in a few short lines:
   who is on it and why.

6. Ask me with AskUserQuestion: "Set up this team?" with the options "Yes, set it up" and "No, change
   something". Only when I say yes, run the same command without --dry-run and --json.

7. Connect my tools. The dry run listed "connections" with a status for each tool I chose:
   - "ready": already connected by bimai init.
   - "needs-install": ask me with AskUserQuestion: "Install the <label> now?" with the options "Yes,
     install it" and "Not now". Explain its "message" first: Windows may ask permission once, and the program
     it runs in (such as Civil 3D, Revit or OpenRoads) must be closed. Only on yes, run its "command".
   - "needs-app", "other-platform", "unavailable": tell me its "message" in plain words. Don't suggest a
     command for these unless the connection gives one.

8. Run: bimai validate
   Then tell me to start a new Claude Code session so my team is loaded, and give me three example
   questions I can ask my team.

If a command fails, show me the error and explain it simply. Don't work around it by editing bimai's
files by hand.

What happens

  1. Claude installs bimai and checks that it works.
  2. It asks the interview questions as clickable choices, in two short rounds. Each option says what it means, the best fit for you is marked Recommended, and you can always pick Other and say it in your own words. What bimai finds in your folder (a BEP, Revit models, a planning export) is offered first.
  3. You see your team before anything is written: who is on it, why, and which files bimai would create. Say no, and nothing changes.
  4. After your yes, bimai writes your project files (.bimai/), your team (.claude/agents/) and the Coordinator's instructions (CLAUDE.md). It never overwrites files you already have.
  5. Start a new session and your team is there. Ask it something, for example "who is on my team?"

Want to change your team later? See Your team.

Prefer to type it yourself?

Install bimai with one line. It needs no Python, git or administrator rights:

powershell -ExecutionPolicy ByPass -c "irm https://bimai.nl/install.ps1 | iex"

Then, in your project folder:

bimai init

bimai init asks the same questions in the terminal. See Start a project.

What the installer does

It installs uv (a widely used Python tool manager) in your user folder if you don't have it yet, then installs bimai with it; uv brings its own Python when your computer has none. Nothing is installed for other users and nothing needs administrator rights. Run the line again, or bimai update, to update. Want to read the script first? Open install.ps1 or install.sh in your browser. Already use Python tools? uv tool install bimai or pipx install bimai works too.

Coming in v0.1: the full installer

Not built yet

Planned for v0.1. This page describes the target experience; commands may not exist yet. The steps below describe the finished installer. Until then, use the prompt above.

What you need

  • A Windows or Mac computer. (Revit, Civil 3D and OpenRoads connections only work on Windows, because those programs only run on Windows.)
  • A Claude account from your organization.
  • An account on your company's git host, usually GitHub or Azure DevOps. IT can arrange this; you'll never have to use git yourself.

Install

Install the bimai program

curl -LsSf https://bimai.nl/install.sh | sh

Run the setup

bimai setup

Setup checks that git and Claude Code are installed (and installs them if they're missing), signs you in to your git host once, and asks two questions: your language (Dutch or English) and your working hours.

Check that everything works

bimai doctor

Everything should be green. If something isn't, the message says what to do.

Where your files are

Everything bimai keeps is in one folder in your user folder, for example C:\Users\anna\bimai. It's deliberately not in Documents, because Documents is often synced by OneDrive, which doesn't work well with bimai's project history.

bimai/
├── desk/          private to you: your projects, plans and preferences
└── projects/      one folder per project, shared with that project's team

Next

On this page