OpenRoads bridge
Let your team read the drawing open in Bentley OpenRoads Designer, read-only. Beta.
Beta
The bimai OpenRoads bridge is a small add-in for Bentley OpenRoads Designer (2023 and newer, Windows). It lets your team read the drawing you have open, and never changes it. Bentley's own MicroStation server is early access only and has no road design tools, so bimai brings its own.
What your team can read
| Tool | What it gives |
|---|---|
get_drawing_info | the file, model, OpenRoads version, and how many alignments, corridors and terrains |
list_alignments | every alignment: name, length, start and end station, feature definition, active profile |
get_alignment | one alignment's elements and points along it (distance, station, x, y) |
locate_on_alignment | the station and offset of a point (right positive, left negative) |
list_profiles / get_profile | an alignment's profiles, and a profile's control points (station, elevation) |
list_corridors | every corridor with its alignment and station range |
list_terrains / get_terrain_elevation | terrain models, and the elevation at a point |
Distances and coordinates are in metres, as OpenRoads' civil model stores them. Stations are formatted the way OpenRoads shows them, including station equations.
Install it
On Windows, with OpenRoads Designer closed, in your project folder:
bimai connect openroadsIf you chose OpenRoads during onboarding, Claude offers this straight away. bimai then:
- Finds your OpenRoads Designer versions under
C:\Program Files\Bentley. - Builds the bridge on your PC. Bentley's programming files can't be shared, so bimai downloads the bridge's source (checked against a pinned fingerprint) and compiles it with the C# compiler that comes with Windows, against your own OpenRoads Designer. This also matches each OpenRoads version exactly.
- Registers it with one small file,
config\appl\bimai-openroads.cfg, in your OpenRoads folder. That is Bentley's documented way to load an add-in at startup.
Why Windows asks for permission
Windows asks "Do you want to allow this app to make changes to your device?" once. OpenRoads only loads
add-ins named in its configuration folder inside C:\Program Files, and only administrators may write
there. bimai writes that one text file and changes nothing else; the bridge itself goes into
C:\ProgramData\bimai\openroads. No admin rights? Choose No and ask IT to run the same command.
Then start OpenRoads Designer with a drawing, and start a new Claude Code session.
Check and remove
bimai bridge status openroads # installed for which OpenRoads versions, and whether it's running
bimai bridge uninstall openroads # removes the file and the bridgeThe bridge writes a log to %LOCALAPPDATA%\bimai\openroads-bridge.log. In OpenRoads you can also load it by
hand with the key-in mdl load BimaiOpenRoads.
Beta: help us verify it
The bridge follows Bentley's OpenRoads Designer SDK documentation, but nobody has run it inside OpenRoads yet. If you use OpenRoads, the test guide takes about 20 minutes. Report what you find in a GitHub issue.