@ifc-lite/cli

@ifc-lite/cli

BIM toolkit for the terminal. The ifc-lite command reads, queries, validates, exports, creates, merges, converts, and diffs IFC files, and can script them with the bim.* SDK. Output is pipe-friendly and every command supports --json for machine-readable results, which makes it a good fit for both humans and LLM terminals.

Install

npm install -g @ifc-lite/cli

Usage

ifc-lite info model.ifc
ifc-lite query model.ifc --type IfcWall --json
ifc-lite props model.ifc --id 42
ifc-lite export model.ifc --format csv --type IfcWall --columns Name,Type,GlobalId
ifc-lite create wall --height 3 --thickness 0.2 --start 0,0,0 --end 5,0,0 --out wall.ifc
ifc-lite eval model.ifc "bim.query().byType('IfcWall').count()"
ifc-lite view model.ifc

Commands

• info - model summary: schema, entities, storeys
• query - query entities by type, properties, quantities; supports --sum, --group-by, --spatial
• props - all properties for a single entity (--id N)
• export - export to csv, json, ifc, or hbjson
• ids - validate against buildingSMART IDS rules
• validate - structural validation checks
• stats - auto-calculated model KPIs and health check
• clash - geometric clash detection, --matrix, --bcf output
• bcf - create and inspect BCF collaboration files
• create - create IFC elements from scratch (walls, slabs, stairs, 30+ types)
• mutate - modify properties or attributes and save
• merge - merge multiple IFC files into one federated file
• convert - convert between IFC schema versions (--schema IFC4)
• diff - compare two IFC files
• eval / run - run SDK expressions or scripts against a model
• ask - natural language BIM queries
• view - interactive 3D viewer in the browser, controllable via REST (/api/command)
• analyze - query plus colorize/isolate/heatmap results in the running viewer
• mcp - start an MCP server bound to one or more IFC files (stdio or http)
• schema, bsdd, diagnose-geometry, extract-entities, generate-spaces, lod, ext - see ifc-lite --help

Global flags: --json, --out <file>, --verbose, --quiet, --debug, --log-level <level>.

Links

• Docs: https://ifclite.dev/docs/
• Source: https://github.com/LTplus-AG/ifc-lite

License

MPL-2.0