bim · windows · per-user · offline

Hand your AI assistant the drawing set, the site and the model.

bim is a free tool your AI assistant runs on your Windows PC. Your files stay on your machine. No admin rights, no account.

Claude Code · Cursor · Codex · any tool that can run shell commands. Revit 2024, 2025, and 2026.

Paste this into your AI coding tool

paste into your AI coding tool
Install bim-cli on this Windows machine and then use it.
Step 1 — install. Run this exactly:
  powershell.exe -NoProfile -ExecutionPolicy Bypass -Command 'iwr -useb https://bimcli.com/install.ps1 -OutFile $env:TEMP\bim-install.ps1; powershell -NoProfile -ExecutionPolicy Bypass -File $env:TEMP\bim-install.ps1'
The installer is per-user (no admin), idempotent, and prints `BIM_INSTALLED_OK <version> <path>` as its final line on success.
Step 2 — refresh PATH in your current session:
  bash:  export PATH="$PATH:$LOCALAPPDATA/bim-cli"
  pwsh:  $env:Path += ";$env:LOCALAPPDATA\bim-cli"
Step 3 — orient:
  bim doctor --json     # environment readiness; each failed check has a fix field
  bim describe --json   # full driver/verb/arg schema; each driver has a docs URL
Fetch the docs URL for any driver you plan to use before issuing commands.
Calling convention: `bim <format> <verb> [args]`. stdout is JSON, stderr is human.
Error envelope: `{"ok":false,"error":{"kind":"...","message":"...","hint":"..."}}`.
Exit codes: 0 ok · 1 generic · 2 usage · 3 not-found · 4 permission · 5 conflict.
After describe + doctor, summarize what's installed and wait for my task.

It self-installs, then orients itself from bim describe --json — no configuration and nothing for you to decide. Agents can read the full reference at /llms.txt, and each driver's own /…/llms.txt.

What your assistant can do with bim

Check a drawing-set PDF

Find missing sheets, unresolved callouts and titleblock mismatches in a PDF drawing set, as JSON findings your assistant can act on.

bim pdf set.check drawings.pdf

Site report for a US address

Flood zone for any US address, plus zoning, landmark and transit layers where covered, in one PDF report.

bim site assess --address "350 Fifth Avenue, New York, NY"

Export Revit sheets without clicking through Revit

Export a whole sheet set to PDF from a prompt. Revit 2024, 2025 or 2026 must be installed; bim drives it for you.

bim revit export --all-sheets --output ./pdf

Compress a PDF on Windows

Shrink a PDF locally with one command: no upload, no Acrobat, drawings unchanged.

bim pdf optimize drawings.pdf

Revit to Excel and back

Pipe a Revit schedule into a spreadsheet, or read a spreadsheet and write the values back into the model.

bim revit schedule-read --name "Door Schedule" | bim excel write doors.xlsx

All jobs →

No Revit? Start here

Most of bim-cli works without Revit or any other desktop app. Each prompt installs bim-cli (if needed) and gets you a real result in about a minute.

site report for any US address
Install bim-cli if it is not installed yet (run exactly, then add %LOCALAPPDATA%\bim-cli to PATH):
  powershell.exe -NoProfile -ExecutionPolicy Bypass -Command 'iwr -useb https://bimcli.com/install.ps1 -OutFile $env:TEMP\bim-install.ps1; powershell -NoProfile -ExecutionPolicy Bypass -File $env:TEMP\bim-install.ps1'
Then run a site report for this address: 
  bim site assess --address "" > assess.json
  bim site flood.map --lat  --lon  --out flood.png   # lat/lon are top-level fields in assess.json
  bim pdf report --data assess.json --flood-map flood.png --out site-report.pdf
Summarize the flood zone, zoning, landmark status and transit for me, then open site-report.pdf.
inspect or shrink a drawing-set PDF
Install bim-cli if it is not installed yet (run exactly, then add %LOCALAPPDATA%\bim-cli to PATH):
  powershell.exe -NoProfile -ExecutionPolicy Bypass -Command 'iwr -useb https://bimcli.com/install.ps1 -OutFile $env:TEMP\bim-install.ps1; powershell -NoProfile -ExecutionPolicy Bypass -File $env:TEMP\bim-install.ps1'
Then work on this PDF: 
  bim pdf info --file ""        # pages, sheet sizes, text layer
  bim pdf optimize --file ""    # smaller copy, same drawings
Tell me the page count and sheet sizes, and how much smaller the optimized copy is.
check a building-code question
Install bim-cli if it is not installed yet (run exactly, then add %LOCALAPPDATA%\bim-cli to PATH):
  powershell.exe -NoProfile -ExecutionPolicy Bypass -Command 'iwr -useb https://bimcli.com/install.ps1 -OutFile $env:TEMP\bim-install.ps1; powershell -NoProfile -ExecutionPolicy Bypass -File $env:TEMP\bim-install.ps1'
Then answer my code question with citations: 
  bim code jurisdictions                 # pick nyc-2022, ibc-2021 or ca-2022
  bim describe code --json              # how to call rules / check
Quote the section numbers you used.

What it drives

One driver per app or data source, all under bim <format> <verb>.

Compose with pipes

Every command reads stdin and writes stdout as JSON, so drivers compose with standard pipes.

bim revit schedule export "Door Schedule" | bim excel write doors.xlsx
bim site flood lookup --address "..." --geocode | bim revit param set --by Mark
bim pdf marked drawings.pdf | bim excel write takeoff.xlsx --pivot category
bim revit warnings list | bim google sheets append --spreadsheet <id> --with-header

Task-focused workflows →  ·  FAQ →  ·  Changelog →

Windows 10/11 x64 · Revit 2024/2025/2026 for bim revit · no .NET, Python, or other runtime required · installs to %LOCALAPPDATA%\bim-cli\

no cloud · no admin rights · no account · per-user install · read the install script ↗ · uninstall in one line