Install
One binary, aibimtool. Install it, or run it with npx and skip the install entirely.
| npm install -g aibimtool-mcp |
| npx -y aibimtool-mcp --help |
Sign in
Signs in through your browser and stores the key in ~/.aibimtool/config.json, so there is nothing to copy and it never reaches your shell history. A key from the API keys tab works too, via AIBIMTOOL_API_KEY.
| aibimtool auth login |
Commands
| Command | What it does |
|---|---|
| aibimtool auth login | Sign in through your browser. A key is made from your session and handed back over loopback, so there is nothing to copy or paste. |
| aibimtool whoami | Which account the stored key belongs to, its plan and credits, verified against the server. |
| aibimtool build "<brief>" [options] | Start a new building. --wait follows it to the end, --yes approves its plan, --ifc writes the model when it is ready, --level picks easy, medium or high. |
| aibimtool send <id> "<message>" | Answer the agent's questions, or ask for a change. Add --wait to follow it. |
| aibimtool approve <id> | The go-ahead for the agent's plan. |
| aibimtool status <id> | State, the agent's reply, its questions and plan. --wait holds while it runs. |
| aibimtool ifc <id> -o <file> | Download the IFC4 model. Free. |
| aibimtool image <id> --storey 1 | Save a picture of the model: the plan of one storey (0 is the ground floor), or a 3D view without --storey. Free. |
| aibimtool projects | List the account's projects. |
| aibimtool stop <id> | Stop the running agent after its current step. |
- aibimtool auth login
Sign in through your browser. A key is made from your session and handed back over loopback, so there is nothing to copy or paste.
- aibimtool whoami
Which account the stored key belongs to, its plan and credits, verified against the server.
- aibimtool build "<brief>" [options]
Start a new building. --wait follows it to the end, --yes approves its plan, --ifc writes the model when it is ready, --level picks easy, medium or high.
- aibimtool send <id> "<message>"
Answer the agent's questions, or ask for a change. Add --wait to follow it.
- aibimtool approve <id>
The go-ahead for the agent's plan.
- aibimtool status <id>
State, the agent's reply, its questions and plan. --wait holds while it runs.
- aibimtool ifc <id> -o <file>
Download the IFC4 model. Free.
- aibimtool image <id> --storey 1
Save a picture of the model: the plan of one storey (0 is the ground floor), or a 3D view without --storey. Free.
- aibimtool projects
List the account's projects.
- aibimtool stop <id>
Stop the running agent after its current step.
Exit codes: 0 done, 1 an error, 2 out of credits or a plan is needed, 3 the agent is waiting for your answer or approval, so a script can stop and ask.
A batch, start to finish
Sign in once, then compare options. --level easy is the cheapest way to try three massings before you pick one to develop.
| 1 | aibimtool auth login |
| 2 | |
| 3 | # Three early massing options at the cheapest level, side by side |
| 4 | for form in "L-shaped" "courtyard" "linear bar"; do |
| 5 | aibimtool build "Office building, 2,400 m², 4 storeys, $form plan" \ |
| 6 | --level easy --title "Option: $form" --wait --yes --ifc "option-$form.ifc" |
| 7 | done |