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, and Python 3.11 or newer. Claude checks Python for you and tells you if it's missing.

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

Show the prompt
Set up bimai (https://docs.bimai.nl) in this project folder for me. Follow these steps in order and
don't skip the confirmation.

1. Check that Python 3.11 or newer is available. Then install bimai:
   pip install "git+https://github.com/StefanDaniels1/BIMAI.git"
   Check it worked with: bimai --version

2. Look at what's already in this folder, so you can suggest answers: models (.ifc, .rvt, .nwd,
   .dgn, .dwg), BCF issues, a BEP or EIR document, planning exports, Relatics exports and meeting
   transcripts.

3. Ask me these questions one at a time, in plain language, suggesting answers where you can:
   - The project name.
   - My name.
   - My role: design coordinator, BIM coordinator, BIM modeller or information manager.
   - What I want help with. Choose from: requirements, risks, planning, reporting, issues,
     model-checks, delivery, meetings.
   - Which tools and data the project uses. Choose from: revit, civil3d, openroads, navisworks,
     bonsai, ifc, autocad, acc, bcf, ids, bep, relatics, primavera, msproject.
   - Whether I'm new to VS Code.
   - The language for documents: en (English) or nl (Dutch).

4. Show me what bimai would do, without writing anything:
   bimai init --dry-run --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 and why each
   member is on it, in a few sentences.

5. Ask me: "Shall I set this up?" Only when I say yes, run the same command without --dry-run.

6. Run: bimai validate
   Then tell me to start a new Claude Code session, so my new 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 looks at your folder and asks the questions from the interview. Everything it finds (a BEP, Revit models, a planning export) is suggested as an answer.
  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?

pip install "git+https://github.com/StefanDaniels1/BIMAI.git"
cd your-project-folder
bimai init

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

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

pipx install bimai

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